Holarch

SysML v2

Convertir entre LML et SysML v2

Faites une copie SysML v2 d'un projet LML, ou une copie LML d'un projet SysML v2, avec un rapport de ce qui est converti et de ce qui ne l'est pas.

Utilisation →

Sur cette page
  1. Vue d'ensemble
  2. Concepts
    1. Une copie, et non un changement de type
    2. Correspondance entre les deux langages
    3. Les données Holarch suivent
    4. Ce qui n'est pas converti
  3. Mode d'emploi
    1. Quand et pourquoi
    2. Créer une copie convertie
    3. Vérifier la copie
    4. Exemple détaillé : la démo Hybrid Car en copie LML
    5. Conseils et bonnes pratiques
    6. Erreurs courantes
  4. Référence du rapport
    1. De LML vers SysML v2
    2. De SysML v2 vers LML
    3. CSV du rapport
  5. Messages
  6. Limites
  7. Pages associées

Vue d'ensemble

Le type d'un projet, LML ou SysML v2, est fixé à sa création. Pour travailler sur un modèle LML en SysML v2, ou sur un modèle SysML v2 avec les pages LML, créez une copie convertie :

  • Créer une copie SysML v2… sur un projet LML écrit son modèle sous forme de texte SysML v2 dans un nouveau projet SysML v2.
  • Créer une copie LML… sur un projet SysML v2 transforme son modèle en entités et relations LML dans un nouveau projet LML.

Le projet d'origine n'est jamais modifié. Avant que la copie soit créée, un rapport liste ce qui est converti, avec les nombres, et ce qui ne l'est pas, avec la raison. Le même rapport est enregistré dans le nouveau projet.

Concepts

Une copie, et non un changement de type

La conversion crée toujours un nouveau projet. Vous pouvez continuer à travailler dans l'original et convertir à nouveau plus tard ; chaque conversion crée un autre nouveau projet. Rien ne relie la copie à l'original.

Correspondance entre les deux langages

LML et SysML v2 décrivent beaucoup des mêmes choses de manières différentes. La conversion utilise cette correspondance dans les deux sens :

LMLSysML v2
AssetDéfinition de part, avec un usage de part partout où elle est utilisée
Décomposition d'un Asset (decomposed by)Usage de part dans la définition du parent
PortUsage de port
Characteristic d'un AssetUsage d'attribut
ConduitUsage de connexion, ou usage d'interface lorsque les deux extrémités sont des ports
Input/OutputDéfinition d'item, avec des paramètres d'item in et out et des flux
Requirement (Number, Name, Description)Usage d'exigence (nom court, nom, doc)
satisfied bysatisfy
Test CaseUsage de vérification avec un objectif verify
Test SuitePackage de cas de vérification
Action, avec son fluxUsage d'action avec des successions
SYNC et blocs parallèlesFork et join
ORDecide et merge
LOOPAction de boucle
performed byperform
Caractéristiques d'état et transitionsDéfinition d'état avec des transitions, que la part présente (exhibit)
Equation et ses variablesDéfinition de contrainte avec ses paramètres

Les données Holarch suivent

Certaines données n'ont de place dans aucun des deux langages. Ce sont des données Holarch, et elles sont copiées avec leurs liens :

  • Les risques, décisions, tâches, coûts, plannings, problèmes, documents et tableaux blancs sont copiés et restent liés aux éléments convertis.
  • Le statut des exigences et les méthodes de vérification restent avec chaque exigence ; les résultats de test restent avec chaque cas de test. Les états personnalisés des workflows de classes sont aussi conservés.
  • Les modifications du schéma sont reportées dans les deux sens, y compris les workflows de classes avec leurs états, états retirés, transitions et approbateurs.
  • Les commentaires de discussion suivent leur élément.
  • Les probabilités de branches des décisions restent avec leurs branches, pour le simulateur.
  • Une copie LML faite à partir d'une copie SysML v2 récupère les attributs et étiquettes LML que la première conversion a conservés.

Ce qui n'est pas converti

  • Les dispositions des diagrammes. Les vues et les diagrammes sont redessinés dans la copie.
  • L'historique, les références et les demandes de modification. La copie démarre sans eux.
  • Les éléments pour lesquels un langage n'a pas de place, comme les Measures et Resources LML, ou les énumérations, calculs et cas d'analyse SysML v2.

Le rapport nomme chacun de ces éléments et en donne la raison. Voir Référence du rapport.

Mode d'emploi

Quand et pourquoi

Convertissez lorsque le langage du projet ne convient plus au travail :

  • De LML vers SysML v2 : votre équipe ou un client travaille désormais en SysML v2, ou le modèle doit être échangé avec des outils SysML v2. Convertissez, puis exportez en .sysml ou JSON (voir Échanger des modèles SysML v2).
  • De SysML v2 vers LML : vous avez besoin d'une page ou d'un diagramme LML que les projets SysML v2 n'ont pas, ou vous voulez le modèle sous la forme cycle de vie de Holarch pour une revue.

Convertissez une fois le modèle stable, et lisez le rapport avant de vous fier à la copie.

Créer une copie convertie

  1. Dans Gérer les projets, cliquez sur ⋯ sur la ligne du projet.
  2. Choisissez Créer une copie SysML v2… (pour un projet LML) ou Créer une copie LML… (pour un projet SysML v2).

    Holarch contrôle la conversion ; sur un grand projet, une barre de progression en bas de la fenêtre indique « Contrôle de la conversion… ». La boîte de dialogue s'ouvre ensuite avec le rapport.

  3. Lisez le rapport :
    • Converti liste chaque genre d'élément, leur nombre et ce qu'il devient, par exemple « Exigences 24 usages d'exigence ».
    • Non converti liste chaque genre d'élément qui n'est pas converti, leur nombre et pourquoi.
  4. Cliquez sur Télécharger le rapport (CSV) pour enregistrer le rapport avec une ligne par élément, si vous en avez besoin hors de Holarch.
  5. Saisissez le Nom du nouveau projet. Par défaut, c'est le nom de l'original suivi de « (SysML v2) » ou « (LML) ».
  6. Cliquez sur Créer une copie.

    Le message indique « « <name> » créé ». La copie s'ouvre sur sa page d'accueil.

  7. Ouvrez le document Rapport de conversion dans la copie. Il liste chaque élément qui n'a pas été converti, par numéro et par nom.

Vérifier la copie

  1. Dans une copie SysML v2, ouvrez Modèle → Éditeur.

    Le modèle est un package de premier niveau nommé d'après le projet. Il contient les packages Architecture, System, Items, Requirements, Verification, Behavior, Constraints et Views (seulement ceux qui ont du contenu).

  2. Cherchez les marques de problème dans la marge. Si le texte converti a des problèmes, la boîte de dialogue l'a indiqué avant que vous ne créiez la copie : « Le texte converti a N problèmes. La copie les affiche dans son éditeur. »
  3. Ouvrez les vues dans Vues (Architecture Overview, System Connections) pour voir la structure redessinée.
  4. Dans une copie LML, ouvrez la base de données et les diagrammes pour vérifier les Assets, les Requirements et les flux d'actions.

Exemple détaillé : la démo Hybrid Car en copie LML

Créez d'abord la démo : dans Gérer les projets, cliquez sur Fichiers de projet ▾ → Nouveau projet de démonstration → Hybrid Car (SysML v2).

  1. Dans Gérer les projets, cliquez sur ⋯ sur Hybrid Car (SysML v2 demo) et choisissez Créer une copie LML…. La copie sera nommée « Hybrid Car (SysML v2 demo) (LML) ».
  2. Lisez le rapport.

    Sous Converti : les usages de part deviennent des Assets, les usages de port des Ports, les attributs des Characteristics, les usages de connexion et d'interface des Conduits, les usages et définitions d'exigence des Requirements, les usages de vérification des Test Cases, les actions des Actions, et les états et transitions leurs équivalents LML.

    Sous Non converti, entre autres :

    • Spécialisations : LML n'a pas de spécialisation ; les parts reçoivent une copie des features de leurs définitions générales. SportCar :> Car en est une.
    • Redéfinitions : la feature qui redéfinit remplace la feature héritée dans chaque part copiée. La batterie de la berline est copiée avec 48 kg.
    • Énumérations (DriveMode, FuelKind) : les valeurs d'attributs sont conservées sous forme de texte.
    • Calculs (PowerToWeight, ElectricRange) et cas d'analyse (PowerToWeightAnalysis).
    • Connecteurs de liaison (bind output = transmission.output;) : LML n'a pas de liaison entre features.
    • Valeurs d'attributs : conservées sous forme de texte dans la Value de chaque Characteristic ; les unités et les expressions ne sont pas évaluées.
    • Vues : les diagrammes sont redessinés dans la copie LML.
  3. Cliquez sur Créer une copie.

    La copie LML s'ouvre. fleet.sedan et ses parts sont des Assets ; l'exigence Sedan Mass (VR-1.1) est un Requirement satisfait par l'Asset de la berline. Les risques, décisions et tâches de la démo sont aussi copiés, liés aux éléments convertis.

Pour essayer l'autre sens, créez la démo CubeSat EO-1 (un projet LML) et choisissez Créer une copie SysML v2… sur celle-ci.

Conseils et bonnes pratiques

  • Rangez un projet LML avant de le convertir : connectez chaque Conduit à exactement deux Assets ou Ports, rattachez chaque Characteristic à un Asset ou à une Equation, et retirez les Test Suites vides. Sinon, ils sont signalés comme non convertis.
  • En LML, écrivez les étiquettes des branches OR comme expressions booléennes sur des valeurs du modèle (par exemple speed > 3) si vous voulez qu'elles deviennent des gardes. Les autres étiquettes deviennent des commentaires doc sur les successions.
  • En SysML v2, donnez aux acteurs un type de définition de part et aux paramètres d'item un type de définition d'item. Ceux qui ne sont pas typés ne sont pas convertis.
  • Gardez l'original. Convertissez à nouveau à partir de lui après des modifications importantes plutôt que de modifier les deux projets en parallèle.

Erreurs courantes

  • S'attendre à ce que l'original change. Il ne change pas. La copie est un projet distinct.
  • S'attendre à ce que les diagrammes gardent leur disposition. Les dispositions ne sont pas converties ; réorganisez les nouvelles vues ou les nouveaux diagrammes.
  • Des parts manquent dans une copie LML. Une définition de part qu'aucune part n'utilise n'a pas d'Asset en LML, car LML n'a que des instances. Utilisez la définition dans une part, puis convertissez à nouveau.
  • Un élément « does not resolve » dans le rapport. Un nom dans le texte SysML v2 ne pointe vers rien. Corrigez le nom dans l'éditeur, puis convertissez à nouveau.

Référence du rapport

De LML vers SysML v2

Les éléments convertis comprennent les Assets (définitions de part avec leurs usages de part), les Characteristics (attributs), les Ports, les Conduits (connexions ou interfaces), les Input/Outputs (définitions d'item), les Requirements, les Actions et les use cases, les flux d'items entre actions, les States, les Transitions, les Equations (définitions de contrainte), les Performs, les Test suites, les Test Cases, les Verifies, les Satisfies, et les éléments Holarch (copiés avec leurs liens) : artefacts, déclarations, tâches, risques, éléments de planning, coûts, problèmes, décisions, dangers et modes de défaillance. Les workflows de classes (les modifications du schéma du projet) sont reportés avec leurs états personnalisés, transitions et approbateurs, de sorte que les exigences et cas de test gardent leurs valeurs de Status personnalisées. La copie conserve les réglages Programme formel et Sécurité et fiabilité du projet.

Non convertiMotif
Assets dans une boucle de décompositionUn asset qui se contient lui-même n'a pas de place dans un arbre de parts. Sa définition de part est convertie ; elle n'est pas utilisée comme part.
Conduits sans exactement deux extrémitésUne connexion SysML joint deux extrémités. Connectez le conduit à deux assets ou ports, puis convertissez à nouveau.
Items transférés par un conduitDans cette conversion, les connexions ne transportent pas d'items. Les items sont convertis en définitions d'item et en flux entre actions.
Conduits décomposés en d'autres conduitsLes connexions SysML ne sont pas imbriquées ici ; chaque conduit devient sa propre connexion.
Nombres de passages et scripts de boucleIci, une boucle SysML se répète jusqu'à une condition ; le nombre est conservé comme donnée Holarch et restauré par Créer une copie LML.
Étiquettes et probabilités des branches de décisionLorsque chaque étiquette d'une décision est une expression booléenne sur des valeurs du modèle, les étiquettes deviennent ses gardes ; sinon, elles deviennent des commentaires doc sur les successions. Les probabilités sont conservées comme données Holarch pour le simulateur, et les deux sont restaurées par Créer une copie LML.
Éléments OR, SYNC et LOOPLes constructions sont converties en nœuds decide/merge, fork/join et de boucle ; les éléments qui les nommaient ne sont pas conservés.
Actions entry, do et exit des étatsLes actions sont converties en actions ; cette conversion ne remplit pas les corps des états SysML.
Transitions sans deux états d'une même machineUne transition SysML joint deux états de la même définition d'état.
Gardes et déclencheurs des transitionsIls sont écrits en LML en texte libre ; ils sont conservés comme données Holarch, et non comme expressions SysML, et restaurés par Créer une copie LML.
États non spécifiés par un assetUn état a besoin de l'asset dont il décrit le comportement.
Expressions des équationsLes expressions utilisent des noms qui ne sont pas des features SysML ; chacune est conservée comme commentaire dans sa définition de contrainte.
Test suites sans cas de testUne suite devient le package de ses cas de vérification ; une suite vide n'a rien à contenir.
Cas de test vérifiant autre chose qu'une exigenceUn cas de vérification SysML ne vérifie que des exigences.
Cycles de testLes exécutions de test enregistrées sur une suite ne font pas partie du modèle ; le dernier résultat de chaque cas est conservé.
Exigences satisfaites par d'autres genres d'élémentsPar exemple, en SysML, une exigence ne satisfait pas une autre exigence ; utilisez une dérivation dans le texte.
Autres relationsCette conversion n'a pas de relation SysML pour elles ; le rapport nomme chacune d'elles.
MeasuresLes mesures d'efficacité n'ont pas d'élément SysML dans cette conversion.
ResourcesLes quantités de ressources (consumes, produces) relèvent du simulateur LML et n'ont pas d'élément SysML ici.
Characteristics non rattachées à un asset ou à une équationUn attribut a besoin d'un propriétaire : spécifiez-le par un asset ou faites-en une variable d'équation.
Éléments d'autres classesCette classe n'a ni élément SysML ni place Holarch dans un projet SysML v2.
Caractéristiques et configurationsPas encore : les caractéristiques et configurations d'une ligne de produits ne deviennent pas des points de variation, variantes et configurations SysML v2. Le rapport les liste comme éléments Feature et éléments Configuration ; modélisez à nouveau les variantes dans la copie (voir Variantes et configurations SysML v2).
RéférencesLes références du projet LML ne s'appliquent pas au nouveau modèle ; la copie démarre sans références.
HistoriqueL'historique des modifications repart de zéro dans la copie.
Demandes de modificationLes demandes de modification LML proposent des modifications d'éléments LML, que la copie n'a pas.
Dispositions des diagrammesLes diagrammes sont redessinés comme vues SysML v2 ; les positions ne sont pas reportées.
Éléments convertis dans les plans des documentsLes documents sont copiés ; les exigences et autres éléments du modèle de leurs plans sont désormais des éléments SysML et apparaissent dans le modèle, et non dans le plan.

De SysML v2 vers LML

Chaque usage de part devient un Asset, avec une copie des parts, ports et attributs de sa définition (et des définitions qu'elle spécialise). Les redéfinitions remplacent ce qu'elles redéfinissent. Les connexions et interfaces deviennent des Conduits entre ces Assets. Les exigences, cas de vérification, satisfy, verify, perform, paramètres d'item, états et transitions sont reconvertis comme dans le tableau ci-dessus. Les successions deviennent des flux d'actions ; les gardes d'une décision (ou les commentaires doc de ses successions) deviennent les étiquettes des branches OR, avec leurs probabilités. Les modifications du schéma du projet sont reportées, y compris les workflows de classes avec leurs états personnalisés, transitions et approbateurs, de sorte que les exigences et cas de test gardent leurs valeurs de Status personnalisées.

Non convertiMotif
Connexions dont les extrémités ne se résolvent pasCorrigez les noms des extrémités dans le texte, puis convertissez à nouveau.
Connexions dans des définitions qu'aucune part n'utiliseChaque connexion devient un conduit entre les parts de chaque part qui la possède ; rien n'utilise cette définition.
Connecteurs de liaisonLML n'a pas de liaison (égalité) entre features.
Relations verify qui ne se résolvent pasCorrigez le nom de l'exigence dans l'objectif de vérification, puis convertissez à nouveau.
Paramètres d'item sans définition d'itemTypez le paramètre avec un item def pour le convertir.
Acteurs sans définition de part dans le modèleTypez l'acteur avec un part def pour le convertir.
Usages perform qui ne se résolvent pas en une action et une partFaites effectuer (perform) une action par une définition de part ou un usage de part, puis convertissez à nouveau.
Relations satisfy qui ne se résolvent pasCorrigez les noms dans l'instruction satisfy, puis convertissez à nouveau.
Successions qui ne forment pas un flux structuréLes flux d'actions LML sont des séquences avec des blocs parallèles, de décision et de boucle ; les autres graphes de successions sont linéarisés.
Définitions d'état qu'aucune part ne présente (exhibit)Les états sont convertis sans l'asset dont ils décrivent le comportement.
Transitions qui ne se résolvent pas en deux étatsCorrigez les noms des états, puis convertissez à nouveau.
Déclencheurs de transition (accept)Les transitions LML ne conservent le déclencheur qu'en texte libre ; le signal accepté n'est pas lié.
Définitions de port, d'interface et de connexionElles sont converties en Ports et Conduits là où des parts les utilisent ; LML n'a pas de types de port, d'interface ou de connexion.
Définitions d'attribut (value types)Les characteristics LML n'ont pas de types.
Énumérations et valeurs d'énumérationLML n'a pas d'énumérations ; les valeurs d'attributs sont conservées sous forme de texte.
Calculs, cas d'analyse, préoccupationsLML n'a ni calculs, ni cas d'analyse, ni préoccupations des parties prenantes.
Vues et points de vueLes diagrammes sont redessinés dans la copie LML.
Actions d'affectation, if, send et acceptLes actions LML n'ont pas d'instructions.
DépendancesLML n'a pas de dépendance générique.
AllocationsUtilisez perform dans le texte pour les actions effectuées par des parts.
MétadonnéesLML n'a pas de métadonnées.
OccurrencesLML n'a pas d'occurrences.
Use cases inclusLes relations include entre use cases ne sont pas converties.
AliasLes entités LML ont chacune un seul nom.
Usages de référence (paramètres des calculs et des cas)LML n'a pas de paramètres, à part les variables d'équation.
SpécialisationsLML n'a pas de spécialisation ; les parts reçoivent une copie des features de leurs définitions générales.
RedéfinitionsLa feature qui redéfinit remplace la feature héritée dans chaque part copiée.
Sous-ensembles (subsettings)LML n'a pas de subsetting.
ImportsLML n'a pas d'espaces de noms ; chaque entité est visible dans le projet.
Définitions distinctes des usagesLML n'a que des instances : une définition de part devient les Assets des parts qui l'utilisent, et son texte va dans leurs descriptions.
Multiplicités autres que celles des partsSeules les multiplicités de parts ont une place en LML (la Multiplicity de decomposed by).
Valeurs d'attributsLes valeurs sont conservées sous forme de texte dans la Value de chaque characteristic ; les unités et les expressions ne sont pas évaluées.
RéférencesLes références du projet SysML v2 ne s'appliquent pas à la copie LML ; elle démarre sans références.
HistoriqueL'historique des modifications repart de zéro dans la copie.
Demandes de modificationLes demandes de modification SysML proposent des modifications de texte qui ne s'appliquent pas aux entités LML.

CSV du rapport

Télécharger le rapport (CSV) écrit une ligne par genre d'élément converti et une ligne par élément non converti. Ses colonnes sont Résultat (Converti ou Non converti), Quoi, Nombre, Devient ou raison, Numéro et Nom.

Messages

MessageSignification et correction
Contrôle de la conversion… (barre de progression)Le rapport est en préparation.
Ceci est déjà un projet SysML v2. Choisissez plutôt Créer une copie LML…Le mauvais sens a été choisi.
Ceci est déjà un projet LML. Choisissez plutôt Créer une copie SysML v2…Le mauvais sens a été choisi.
Le texte converti a N problèmes. La copie les affiche dans son éditeur.La copie peut être créée ; corrigez les problèmes dans son éditeur.
Le texte converti ne s'analyse pas (…). Le projet n'a pas été copié ; signalez-le avec le fichier du projet.La conversion a échoué. Contactez le support avec le fichier du projet.
Le vérificateur SysML n'a pas démarré. Rechargez la page et réessayez.Rechargez et réessayez.
Le projet n'a pas pu être lu. Rechargez la page et réessayez.Rechargez et réessayez.
La copie n'a pas été créée : … Rechargez la page et réessayez.Rechargez et réessayez.
« <name> » crééLa copie a été créée et ouverte.

Limites

  • Les dispositions des diagrammes, l'historique, les références et les demandes de modification ne sont pas convertis.
  • Pas encore : la conversion d'une ligne de produits LML (caractéristiques et configurations) en variantes SysML v2.
  • Le document de rapport liste jusqu'à 500 éléments par genre.

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