Holarch

SysML v2

Variantes et configurations SysML v2

Modélisez une ligne de produits dans un projet SysML v2 : points de variation, variantes, règles et configurations dans le navigateur et l'inspecteur, Nouvelle configuration…, vues affichées pour une seule configuration et études de compromis entre configurations.

Utilisation →

Sur cette page
  1. Vue d'ensemble
  2. Concepts
    1. Points de variation et variantes
    2. Lignes de produits
    3. Règles
    4. Configurations
  3. Mode d'emploi
    1. Quand et pourquoi
    2. Marquer un point de variation
    3. Ajouter une règle
    4. Créer une configuration
    5. Modifier les choix d'une configuration
    6. Afficher le modèle selon une seule configuration
    7. Comparer des configurations dans une étude de compromis
    8. Exemple commenté : la démo Hybrid Car
    9. Conseils et bonnes pratiques
    10. Erreurs courantes
    11. Liens avec les autres fonctions
  4. Navigateur
  5. Inspecteur
    1. Ligne de produits
    2. Configuration
    3. Point de variation et variante
  6. Afficher comme configuration
  7. Messages
  8. Limites
  9. Pages associées

Vue d'ensemble

Une ligne de produits est une conception unique comportant quelques points où ses produits diffèrent, comme la taille de la batterie ou la présence d'un chargeur. Vous modélisez la ligne une seule fois, puis vous examinez, contrôlez et comparez n'importe quel produit sans copier le modèle.

SysML v2 intègre cela dans le langage. Holarch l'affiche dans toute l'application :

  • Le Navigateur signale les lignes de produits, les points de variation, les variantes et les configurations, et liste les configurations de chaque ligne de produits.
  • L'inspecteur affiche les points, règles et configurations d'une ligne de produits avec un verdict pour chacun, et vous permet de modifier les choix d'une configuration.
  • Nouvelle configuration… crée une configuration depuis une boîte de dialogue qui contrôle les règles au fil de vos choix.
  • Afficher comme ▾ dans la barre du haut affiche les vues, la base de données, l'inspecteur et la page Ligne de produits selon une seule configuration.
  • Les Études de compromis peuvent comparer les configurations d'une ligne de produits ou les variantes d'un point.

La variabilité dans le texte est disponible dans toutes les offres. Dans l'offre Free, la page Ligne de produits, Nouvelle configuration… et la modification des choix d'une configuration dans l'inspecteur sont en lecture seule ; leur modification fait partie des offres Individual et Team. Voir Lignes de produits : offres.

Concepts

Points de variation et variantes

Un point de variation est un endroit de la conception où les produits diffèrent. Ses variantes sont les choix autorisés.

  • Un usage de variation est un point à l'intérieur d'une conception : variation part charger : Component { variant part noCharger; variant part wallbox; }.
  • Une définition de variation est un ensemble de choix réutilisable : variation part def BatteryPack { variant part standardPack; variant part largePack; }. Un usage typé par elle, tel que part pack : BatteryPack;, est aussi un point.

Lignes de produits

Une ligne de produits est une définition ou un usage qui possède ou hérite de points de variation. Dans la démo Hybrid Car, CarLine est la ligne de produits : elle spécialise Car et ajoute les points pack et charger. Une définition qui spécialise une ligne de produits est aussi une ligne de produits.

Règles

Une règle est une assert constraint de la ligne de produits. Elle exclut des combinaisons de variantes. Dans la démo, wallboxNeedsLargePack indique que le chargeur mural nécessite la grande batterie :

assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }

Tant qu'un point n'a pas de choix, une règle qui le concerne n'est ni respectée ni enfreinte : son verdict est inconnu.

Configurations

Une configuration est un produit de la ligne. C'est un usage typé par la ligne de produits qui lie une variante à chaque point. Holarch la marque avec @HolarchConfiguration (package HolarchVariability), de sorte que l'éditeur signale chaque point qu'elle n'a pas encore choisi :

part plugInHybrid : CarLine {
  @HolarchConfiguration;
  part :>> pack = BatteryPack::largePack;
  part :>> charger = charger::wallbox;
}

Chaque configuration a un verdict :

VerdictSignification
ValideUne variante est choisie pour chaque point, et chaque règle est respectée.
Enfreint la règle …Une règle est enfreinte ; le verdict la nomme.
IncomplèteUn point n'a pas encore de variante choisie ; le verdict le nomme.
InconnuUne règle n'a pas pu être évaluée, par exemple parce qu'une valeur qu'elle lit manque.

Holarch compte aussi les combinaisons de variantes et combien d'entre elles les règles autorisent. Pour une très grande ligne de produits, il ne contrôle que les premières combinaisons et indique combien il en a contrôlé.

Mode d'emploi

Quand et pourquoi

Utilisez la variabilité lorsque plusieurs produits partagent l'essentiel d'une même conception : finitions d'un véhicule, versions d'exportation, ensembles de capteurs, un produit avec et sans une option. Modélisez la conception commune une seule fois, marquez les points où les produits diffèrent et ajoutez une configuration par produit. Chaque produit reste alors en phase avec chaque modification de la conception commune.

Marquer un point de variation

  1. Ouvrez l'Éditeur et le package qui contient la conception.
  2. À l'intérieur de la définition de la ligne de produits, choisissez Insérer ▾ → Variation. Renseignez le nom et le type du point.
  3. À l'intérieur de la variation, choisissez Insérer ▾ → Variante une fois pour chaque choix.
  4. Pour réutiliser un ensemble de choix, choisissez Insérer ▾ → Variation au niveau du package. Cela écrit une définition de variation ; typez une part par celle-ci.

Le Navigateur affiche maintenant la ligne de produits avec l'icône de boîtes empilées, et le point avec un losange.

Ajouter une règle

  1. À l'intérieur de la définition de la ligne de produits, écrivez une assert constraint sur ses points, par exemple assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack }.
  2. Sélectionnez la ligne de produits dans le Navigateur.

Vous voyez la règle sous Règles dans la section Ligne de produits de l'inspecteur, ainsi que le nombre de combinaisons qu'elle exclut.

Créer une configuration

  1. Dans le Navigateur, ouvrez le menu de ligne (⋯, clic droit ou Shift+F10) de la ligne de produits, ou de son groupe Configurations.
  2. Choisissez Nouvelle configuration….
  3. Vérifiez Configure : la ligne de produits à laquelle appartient la configuration.
  4. Saisissez un Nom, par exemple longRangeHybrid.
  5. Sous Choix de variantes, choisissez une variante pour chaque point de variation. Le verdict s'affiche immédiatement sous les choix, par exemple Valide : respecte toutes les règles ou Enfreint la règle wallboxNeedsLargePack.
  6. Cliquez sur Créer.

La configuration est écrite dans le texte après la dernière configuration de la ligne de produits, marquée @HolarchConfiguration, et une seule annulation défait le tout. Le Navigateur la sélectionne dans le groupe Configurations de la ligne de produits.

Vous pouvez aussi ouvrir la boîte de dialogue avec Nouvelle configuration… dans la section Ligne de produits de l'inspecteur, ou depuis ⌘K / Ctrl+K.

Modifier les choix d'une configuration

  1. Sélectionnez la configuration dans le Navigateur (ou dans une vue).
  2. Dans la section Configuration de l'inspecteur, choisissez une autre variante dans la liste d'un point.

La liaison dans le texte est réécrite (part :>> pack = BatteryPack::standardPack;) et le verdict se met à jour ; une seule annulation défait le tout. Choisissez Non choisi pour retirer le choix. Un choix qui ajouterait une erreur au modèle est refusé avec la raison.

Afficher le modèle selon une seule configuration

  1. Dans la barre du haut, cliquez sur Afficher comme ▾ (il indique Toutes les configurations ▾ tant que vous n'en avez pas choisi une) et choisissez une configuration. Un bandeau sous la barre du haut indique, par exemple, Affichage de la configuration plugInHybrid. et combien d'éléments s'appliquent. Dans les vues générales, d'interconnexion et grille, les variantes qu'elle ne choisit pas et les autres configurations sont masquées, et chaque point de variation affiche son choix, par exemple pack : BatteryPack = largePack. La base de données, l'inspecteur et la page Ligne de produits suivent le même choix.
  2. Pour revenir, choisissez Afficher comme ▾ → Toutes les configurations, ou cliquez sur Quitter dans le bandeau.

Dans les offres Individual et Team, vous pouvez modifier pendant qu'une configuration est affichée ; chaque modification est une modification du texte SysML v2, contrôlée avant d'être appliquée, et une seule annulation défait chacune :

  • Choisir une variante écrit la liaison dans la configuration (part :>> pack = BatteryPack::largePack;).
  • Une valeur d'attribut modifiée devient la valeur propre de la configuration ; la définition conserve sa valeur.
  • Les nouvelles parts et actions appartiennent à la configuration.
  • Supprimer un élément hérité qui peut être omis écrit part :>> roofBox[0]; dans la configuration. Un élément hérité obligatoire ne peut pas y être supprimé ; modifiez-le dans l'éditeur.
  • Un risque, une tâche ou un autre élément Holarch que vous créez s'applique à la configuration.

Dans l'offre Free, la vue de configuration est en lecture seule. Depuis l'inspecteur d'une configuration, Afficher dans la vue ▾ ouvre une vue de sa ligne de produits affichée selon cette configuration.

Comparer des configurations dans une étude de compromis

  1. Ouvrez Risques, problèmes et décisions → Études de compromis et une étude (ou cliquez sur + Nouvelle étude de compromis).
  2. Sous Alternatives, cliquez sur + À partir de la ligne de produits….
  3. Sous De, choisissez Configurations de … (une ligne de produits) ou Variantes de … (un point de variation).
  4. Décochez les éléments dont vous ne voulez pas, puis cliquez sur Ajouter.

Chaque configuration ou variante devient une alternative, liée à l'élément du modèle. Ajoutez des critères et des valeurs comme dans toute étude de compromis, ou utilisez Récupérer les valeurs du modèle.

Exemple commenté : la démo Hybrid Car

Créez la démo avec Fichiers de projet ▾ → Nouveau projet de démonstration → Hybrid Car (SysML v2) sur la page Gérer les projets.

  1. Ouvrez Modèle → Navigateur et développez Vehicles. BatteryPack et CarLine portent les icônes de ligne de produits ; CarLine a un groupe Configurations avec longRangeHybrid, plugInHybrid et selfChargingHybrid.
  2. Sélectionnez CarLine. La section Ligne de produits liste les points pack (standardPack, largePack) et charger (noCharger, wallbox), la règle wallboxNeedsLargePack et les trois configurations, toutes Valide. Elle indique 4 combinaisons : 3 autorisées par les règles, 1 exclue (le chargeur mural avec la batterie standard).
  3. Sélectionnez selfChargingHybrid et changez charger en wallbox. Le verdict devient Enfreint la règle wallboxNeedsLargePack. Appuyez sur ⌘Z / Ctrl+Z pour annuler.
  4. Ouvrez la vue carLineVariants (Diagrammes). Choisissez Afficher comme ▾ → plugInHybrid. La boîte BatteryPack ne garde que largePack, et la boîte CarLine affiche pack : BatteryPack = largePack et variation charger : Component = wallbox.
  5. Ouvrez Études de compromis → Configuration Line-up (TR-2). Ses alternatives sont les trois configurations, notées sur le prix, l'autonomie électrique et la commodité de recharge.

Conseils et bonnes pratiques

  • Gardez la conception commune dans la ligne de produits et seulement les différences dans les variantes. Une variante redéfinit ce qu'elle change (attribute :>> capacity = 12 [kW*h];).
  • Écrivez les règles dès que vous savez qu'une combinaison n'est pas autorisée. Les verdicts repèrent alors immédiatement une mauvaise configuration.
  • Nommez les configurations d'après le produit, pas d'après les choix (plugInHybrid, pas largePackWallbox).
  • Utilisez une vue par ligne de produits et basculez-la d'une configuration à l'autre, au lieu d'une vue par configuration.

Erreurs courantes

  • Une configuration n'est pas listée sous sa ligne de produits. Elle doit être typée par la ligne de produits (part x : CarLine). Vérifiez son Type dans l'inspecteur.
  • Un verdict reste Inconnu. Une règle lit une valeur qui n'en a pas dans cette configuration. Choisissez une variante pour chaque point, ou donnez une valeur par défaut à la valeur.
  • Un choix est refusé. La variante ne fait pas partie des variantes de ce point. Choisissez dans la liste de l'inspecteur, ou corrigez le nom dans le texte.

Liens avec les autres fonctions

  • Éditeur : Insérer ▾ écrit Variation, Variante, Configuration et Choix de variante. Tout ici est du texte SysML v2 ordinaire ; les imports, les exports et les autres outils SysML v2 le lisent donc.
  • Études de compromis : configurations et variantes comme alternatives.
  • Diagrammes de fiabilité : les variantes d'un point de variation sont des alternatives ; le diagramme ne compte donc que la variante choisie par la configuration dans Afficher comme ▾. Lorsque toutes les configurations sont affichées, le point est un seul bloc avec ses propres valeurs, et le volet indique de choisir une configuration.
  • Contrôles du modèle : Vérification → Contrôles du modèle signale chaque configuration qui enfreint une règle ou laisse un point de variation sans variante (ProductLine.3, une erreur). La note est le verdict, par exemple Enfreint la règle wallboxNeedsLargePack, et les règles enfreintes sont listées comme éléments associés. Corriger → Ouvrir l'élément ouvre la configuration. L'API et MCP signalent le même constat (run_model_checks, GET …/model-checks).
  • Demandes de modification et historique : chaque modification est une modification ordinaire du modèle, et une seule annulation défait chacune d'elles.

Navigateur

  • Icônes : des boîtes empilées pour une ligne de produits, un losange pour un point de variation, un losange plein pour une variante, des curseurs pour une configuration. Chaque icône a une info-bulle.
  • Groupe Configurations : le premier membre de la ligne d'une ligne de produits. Il liste les configurations de la ligne de produits, où qu'elles soient déclarées ; chaque ligne y représente la configuration elle-même. Son menu de ligne contient Nouvelle configuration….
  • Menu de ligne : Nouvelle configuration… sur une ligne de produits et sur chacune de ses configurations.
  • Lecteurs d'écran : le nom d'une ligne indique ce qu'elle est, par exemple CarLine, part def, product line ou plugInHybrid, part, configuration of CarLine.

Inspecteur

Ligne de produits

  • Points de variation : chaque point avec les variantes parmi lesquelles il choisit.
  • Règles : les assert constraints de la ligne de produits, ou Aucune règle : toutes les combinaisons de variantes sont autorisées.
  • Configurations : un tableau des configurations et de leurs verdicts.
  • Combinaisons : combien de combinaisons de variantes existent et combien les règles en autorisent, en excluent ou laissent inconnues.
  • Nouvelle configuration…

Configuration

  • Configure : la ligne de produits.
  • Statut : le verdict, annoncé aux lecteurs d'écran lorsqu'il change.
  • Une liste par point de variation : la variante choisie, ou Non choisi. Une seule annulation défait une modification.
  • Règles : chaque règle comme Satisfait, Enfreinte ou Inconnu.
  • Afficher dans la vue ▾ : les vues générales, d'interconnexion et grille qui montrent la ligne de produits, ouvertes selon cette configuration.

Point de variation et variante

  • Un point de variation liste ses Variantes et, sous Choisi par, ce que choisit chaque configuration.
  • Une variante indique, sous Variante de, de quoi elle est une variante, et quelles configurations la choisissent.

Afficher comme configuration

  • Où : la barre du haut, dès que le modèle a une configuration. Un choix par onglet du navigateur : les vues générales, d'interconnexion et grille, la base de données, l'inspecteur et la page Ligne de produits le suivent.
  • Commande : Afficher comme ▾ (il indique Toutes les configurations ▾ tant que vous n'en avez pas choisi une). Le menu liste Toutes les configurations, les configurations de chaque ligne de produits avec leurs verdicts, Applicabilité ▸ (afficher le modèle pour un numéro de série, une date de fabrication, ou les deux : Numéro de série et date… est une unité portant ce numéro fabriquée à cette date) et Gérer la ligne de produits. Le bandeau sous la barre du haut contient Changer ▾ et Quitter.
  • Ce qui change : les variantes que la configuration ne choisit pas et les autres configurations de la même ligne de produits sont masquées, avec ce qu'elles possèdent. Les points de variation affichent leur choix. Les dispositions ne sont pas réorganisées et sont partagées par toutes les configurations.
  • Édition : offres Individual et Team. Les modifications suivent les règles de Afficher le modèle selon une configuration. Dans l'offre Free, et pour les personnes disposant d'un accès en lecture, la vue est en lecture seule et le bandeau indique pourquoi.
  • Grille : le tableau omet les éléments masqués et nomme les choix au-dessus du tableau. La matrice montre toute la ligne de produits.
  • Par onglet : le choix est conservé pour l'onglet du navigateur jusqu'à ce que vous le changiez. Les images de la vue dans la liste Diagrammes montrent toute la ligne de produits.
  • Lecteurs d'écran : le changement annonce la configuration et le nombre d'éléments qui s'appliquent, par exemple Affichage de la configuration plugInHybrid. … éléments s'appliquent., avec Lecture seule. ajouté lorsque vous ne pouvez pas modifier.

Messages

MessageQue faire
Le modèle n'a pas encore de points de variation. Ajoutez une variation dans l'éditeur (Insérer ▾ → Variation), puis réessayez.Marquez d'abord un point de variation.
Le modèle n'a pas encore de configurations ni de variantes. … (+ À partir de la ligne de produits…)Ajoutez d'abord un point de variation ou une configuration.
Saisissez un nom pour la configuration.Saisissez un nom dans Nom.
… est déjà utilisé dans …. Choisissez un autre nom.Un autre élément du même package porte ce nom.
Les noms comptent de 1 à 1 000 caractères, sans saut de ligne. Modifiez le nom.Raccourcissez le nom ou retirez le saut de ligne.
Un choix ou une configuration refuséIl ajouterait une erreur au modèle ; le message nomme l'erreur. Corrigez le texte, ou choisissez une autre variante.
Le vérificateur SysML n'est pas disponible ; les points de variation ne peuvent donc pas être lus.Rechargez la page, ou créez la configuration dans l'éditeur avec Insérer ▾ → Configuration.

Limites

  • Pour une très grande ligne de produits, le décompte des combinaisons ne contrôle que les premières combinaisons ; les configurations sont toujours contrôlées entièrement.
  • Dans l'offre Free, une vue affichée selon une configuration est en lecture seule.
  • Pas encore : publier ou retirer une configuration SysML v2. Chaque configuration SysML v2 est à l'état Draft ; la gestion de configuration n'en verrouille donc aucune.
  • La variabilité couvre le modèle SysML v2. Les éléments Holarch qui l'accompagnent (risques, tests, tâches, sections de documents) s'appliquent à toutes les configurations, sauf ceux créés pendant qu'une configuration est affichée : ils s'appliquent à cette configuration. Leur champ S'applique à n'est pas encore modifiable dans un projet SysML v2.

SysML® et OMG® sont des marques déposées d'Object Management Group, Inc. aux États-Unis et dans d'autres pays.