SysML v2
Importer des modèles SysML v1
Convertissez un modèle SysML 1.x issu de Cameo, MagicDraw, Enterprise Architect, Rhapsody ou Papyrus en texte SysML v2, examinez ce qui a changé de forme et importez-le dans un projet SysML v2.
Sur cette page
Vue d'ensemble
Vous pouvez faire entrer un modèle SysML 1.x dans un projet SysML v2. Holarch lit le fichier XMI du modèle, le convertit en texte SysML v2, contrôle le texte et affiche un rapport de conversion avant toute modification.
- Entrée : un modèle SysML 1.x en XMI (
.xmi,.uml,.xml) ou un projet Cameo ou MagicDraw (.mdzip). - Sortie : du texte SysML v2 dans votre projet (une seule annulation défait le tout) ou un nouveau projet SysML v2.
- Rapport : chaque élément v1 avec son résultat : Converti, Approché ou Omis, et pourquoi.
La conversion suit la transformation de SysML v1 vers SysML v2 de la spécification OMG SysML 2.0, lorsqu'un modèle échangé en XMI porte assez de détails pour cela.
Concepts
Converti, approché et omis
Chaque élément du modèle v1 reçoit un résultat :
- Converti : l'élément a un équivalent SysML v2 direct, comme un bloc qui devient une
part def. - Approché : l'élément est conservé sous une forme modifiée. Par exemple, un full port typé par un interface block devient un port, et une transition passant par un pseudo-état choice devient une transition par chemin.
- Omis : SysML v2 n'a pas d'équivalent, ou l'élément pointe vers quelque chose qui n'est pas dans le fichier. Exemples : les flow final nodes, les activity partitions, les extensions de use case et les instance specifications.
Le rapport donne en mots la raison de chaque élément approché ou omis.
Le package SysMLv1Library
Certaines propriétés SysML v1 n'ont pas de mot-clé SysML v2, comme l'isEncapsulated d'un block ou une relation refine. Le convertisseur les conserve comme métadonnées du package SysMLv1Library, par exemple @SysMLv1Library::RefineData { isRefine = true; }. Le package fait partie de la bibliothèque de Holarch, de sorte que ces noms se résolvent dans chaque projet SysML v2.
Les corps opaques deviennent des représentations textuelles
Les opaque behaviors, opaque actions, gardes et constraint specifications portent du texte dans un langage tel qu'OCL ou l'anglais. Le convertisseur conserve chaque corps comme représentation textuelle : language "OCL" /* … */. Les corps en SysML ou KerML sont contrôlés comme le reste du texte. Voir Représentations textuelles.
Mode d'emploi
Quand et pourquoi
Utilisez l'importation lorsqu'une équipe fait passer un modèle SysML 1.x existant à SysML v2, ou veut en réutiliser des parties. Le texte converti est un point de départ : le rapport vous indique ce qu'il faut examiner à la main.
Importer un modèle SysML v1 dans un projet
- Ouvrez un projet SysML v2 et cliquez sur Modèle → Importer et exporter.
- Sous Importer, choisissez Dans ce projet ou Dans un nouveau projet SysML v2.
- Déposez le fichier
.xmi,.uml,.xmlou.mdzipsur la zone, ou cliquez sur la zone pour le choisir. Une carte de progression affiche les étapes Lecture du fichier XMI…, Conversion en SysML v2… et Contrôle du résultat…. - Lisez Conversion depuis SysML v1 en haut de l'aperçu. Il indique le nombre d'éléments convertis, approchés et omis, et si le texte SysML v2 se contrôle sans problème.
- Utilisez Afficher pour lister les éléments approchés et omis, une seule de ces catégories, ou tous les éléments. Chaque ligne donne l'élément, son genre SysML v1, le résultat avec le mot-clé SysML v2 et le nom qualifié, et Pourquoi.
- Ouvrez Afficher le texte SysML v2 pour lire le résultat avant de l'importer.
- Décochez dans le tableau ci-dessous les packages que vous ne voulez pas, puis cliquez sur Importer N packages (ou Créer le projet). Le modèle est importé, et une seule annulation défait le tout. Annuler le retire à nouveau.
Importer une version plus récente du même modèle
Lorsque le modèle SysML v1 change, exportez-le à nouveau et importez le nouveau fichier dans le même projet (Dans ce projet). Chaque élément converti prend son id de l'id de l'élément dans le fichier XMI (xmi:id), de sorte que l'importation met à jour les éléments sur place : un élément renommé ou déplacé vers un autre package dans l'outil SysML v1 reste le même élément, avec ses dispositions de diagrammes, ses commentaires, ses liens et son historique. Le rapport indique combien d'éléments prennent leur id du modèle SysML v1. Les éléments sans nom (connecteurs, successions) sont mis en correspondance par leur place dans le modèle.
Un projet importé d'un modèle SysML v1 avant que Holarch ne dérive les id du fichier XMI garde ses id : un export plus récent met à jour ses éléments par nom, et les éléments nouveaux dans le modèle SysML v1 en prennent leur id.
Conserver le rapport et le texte
- Cliquez sur Télécharger le rapport pour obtenir un fichier CSV avec chaque élément, son résultat, son chemin SysML v2 et la raison.
- Cliquez sur Télécharger le texte SysML v2 pour obtenir le fichier
.sysmlconverti.
Exporter le modèle depuis votre outil SysML v1
- Cameo Systems Modeler et MagicDraw : importez directement le projet
.mdzip, ou utilisez File → Export To → Eclipse UML2 (v5.x) XMI File et importez le fichier.xmi. - Enterprise Architect : sélectionnez le package, choisissez Publish → Export XML, sélectionnez XMI 2.1, et importez le fichier
.xml. Les fichiers de projet Enterprise Architect (.eap,.qea) ne peuvent pas être lus directement. - IBM Rhapsody : exportez le modèle avec le XMI toolkit (XMI 2.x) et importez le fichier.
- Eclipse Papyrus : importez le fichier
.umldu modèle.
Exemple détaillé : le modèle CubeSat EO-1
La démo CubeSat EO-1 est un projet LML. Son export SysML v1 constitue un modèle de test réaliste.
- Ouvrez la démo CubeSat EO-1 et exportez-la en XMI UML/SysML au format OMG XMI 2.5.1 (voir Exporter un modèle UML/SysML (XMI)).
- Ouvrez un projet SysML v2, cliquez sur Modèle → Importer et exporter, choisissez Dans un nouveau projet SysML v2 et déposez le fichier
.xmi. Le rapport indique : 1 042 éléments, 1 007 convertis, 32 approchés, 3 omis. Le texte SysML v2 se contrôle sans problème. - Réglez Afficher sur Omis. Les trois lignes sont une extension de use case, que SysML v2 n'a pas, et deux relations trace vers des éléments sans nom, auxquels le texte SysML v2 ne peut pas faire référence.
- Cliquez sur Créer le projet. Le nouveau projet SysML v2 s'ouvre dans l'éditeur avec la structure, les fonctions, les exigences et les traces du satellite.
Conseils et erreurs courantes
- Importez un seul fichier XMI à la fois, sans autres fichiers. Importez un seul fichier XMI SysML v1 à la fois, sans autres fichiers.
- Nommez les éléments vers lesquels vous tracez. Les relations vers des éléments sans nom sont omises, car le texte SysML v2 fait référence aux éléments par leur nom.
- Réimportez, ne recréez pas. Importez un export plus récent dans le même projet plutôt que dans un nouveau : les éléments ne gardent leurs id que dans le projet qui les contient.
- Vérifiez d'abord les approximations. Ce sont les endroits où le sens peut différer du modèle v1, comme des ports typés par des blocks ou des extrémités de connecteurs à l'intérieur de parts.
- Les éléments portant le même nom au même endroit sont renommés avec un suffixe tel que
_2. Le rapport liste chaque renommage. - Les exigences conservées dans un outil d'exigences (DOORS, Polarion, Jama, codebeamer) arrivent en ReqIF, et non en XMI. Importez le fichier
.reqifsur la même page : il devient des exigences SysML v2 avec le même type de rapport (Importer et exporter des exigences ReqIF).
Ce qui est converti
| SysML v1 | SysML v2 |
|---|---|
| Model, package | package |
| Bloc, acteur | part def |
| Value type, data type, enumeration | attribute def, enum def (les value types ayant une unité SI connue spécialisent la grandeur ISQ) |
| Signal | item def |
| Interface block | port def |
| Propriétés de part, de référence et de valeur | part, ref part, attribute, avec multiplicités et valeurs par défaut |
| Proxy port, flow property | port, item ou attribute in/out |
| Full port | part avec @SysMLv1Library::PortData |
| Connecteur, connecteur de liaison, flux d'item | connect, bind, flow |
| Generalization | :> |
| Activity, call behavior action, pins | action def, action, paramètres |
| Control flows et object flows, gardes | successions avec des gardes if et else, flux entre paramètres |
| Initial, final, decision, merge, fork, join | start, done, decide, merge, fork, join |
| State machine, states, regions | state def, state, états parallèles |
| Transitions, déclencheurs de signal et de temps | transition avec accept, accept after, gardes et effets |
| Interaction | occurrence def avec lifelines et messages |
| Use case, subject, include | use case def, subject, include |
| Requirement (id et texte) | requirement <'id'> Name { doc /* text */ } |
| Satisfy, verify, derive requirement | satisfy, verify dans un objectif de vérification, connexion de dérivation |
| Refine, trace | dependency avec des métadonnées SysMLv1Library |
| Allocate, dependency | allocate, dependency |
| Constraint block, constraint | constraint def, assert constraint |
| Stéréotypes et valeurs étiquetées | metadata def par stéréotype, appliquée avec ses étiquettes |
| Comment, documentation | doc, comment |
Limites
- Un fichier d'au plus 64 Mo.
- Au plus 250 000 éléments, imbriqués sur au plus 512 niveaux. Un modèle imbriqué plus profondément, ou comportant un cycle de possession, n'est pas importé.
- Dans le modèle converti, les éléments imbriqués sur plus de 128 niveaux sont omis avec la raison imbrication.
- Le texte converti fait au plus 8 Mo.
- Les diagrammes et leur disposition ne sont pas convertis. Créez des vues dans le projet SysML v2.
Messages
| Message | Que faire |
|---|---|
| Importez un seul fichier XMI SysML v1 à la fois, sans autres fichiers. | Importez le fichier XMI seul. |
| <file> ne contient aucun élément UML ou SysML. Exportez le modèle en XMI 2.x et importez-le à nouveau. | Exportez à nouveau le modèle en XMI 2.x. |
| Aucun modèle UML trouvé dans <file>. Dans Cameo ou MagicDraw, exportez le modèle en XMI Eclipse UML2 et importez le fichier .xmi. | Exportez le projet en XMI. |
| Le modèle SysML v1 a plus de 250 000 éléments. Exportez une partie plus petite du modèle. | Exportez un package à la fois. |
| Le texte SysML v2 converti dépasserait 8 Mo. Exportez une partie plus petite du modèle. | Exportez un package à la fois. |
Pages associées
- Échanger des modèles SysML v2
- Importer et exporter des exigences ReqIF : exigences issues de DOORS, Polarion et d'autres outils d'exigences.
- Notation textuelle SysML v2
- Convertir entre LML et SysML v2
SysML® et OMG® sont des marques déposées d'Object Management Group, Inc. aux États-Unis et dans d'autres pays.