De SysML v1 à SysML v2
Faites passer votre modèle SysML v1 en SysML v2 sans le redessiner.
Déposez un modèle SysML v1 enregistré en XMI (.xmi, .xml, .uml) ou sous forme d'archive de projet .mdzip dans un projet SysML v2. Holarch le convertit en texte SysML v2, contrôle ce texte et indique pour chaque élément s'il est converti, approché ou laissé de côté, avec le motif, avant toute importation.
Le convertisseur fait partie de toutes les offres, Free compris. Les nouveaux comptes démarrent un essai Individual de 30 jours à leur première connexion : 10 000 éléments par projet, sans carte, retour à l'offre Free à la fin. Vous avez déjà un compte ? Démarrez l'essai.
Preuve : le modèle CubeSat EO-1
| Résultat | Éléments |
|---|---|
| Converti | 1,007 |
| Approché | 32 |
| Laissé de côté | 3 |
| Éléments lus | 1,042 |
| Problèmes dans le texte SysML v2 | 0 |
Le texte converti se contrôle sans erreur ni avertissement, et un même modèle donne toujours le même texte. Ce qui a été approché et laissé de côté
Importer un modèle SysML v1
Importez le fichier XMI ou le projet .mdzip d'un modèle SysML v1 dans un projet SysML v2. Avant toute création, un rapport de conversion liste chaque élément comme converti, approché ou laissé de côté, avec le motif, et s'enregistre en fichier CSV. L'exemple est le modèle CubeSat EO-1 : 1 042 éléments, importés sans problème.
Ce que vous obtenez du convertisseur
Un modèle SysML v2 dans lequel vous pouvez travailler, et une liste claire de ce qu'il faut examiner.
Rien à redessiner
Les blocs deviennent des part def, les ports, connecteurs et flux d'items sont repris, les exigences conservent leur identifiant et leur texte, et les relations satisfy, verify et allocate restent tracées.
Un rapport sur chaque élément
Chaque élément du modèle v1 est listé avec son genre v1, son résultat, le nom SysML v2 qu'il est devenu et, pour tout ce qui est approché ou laissé de côté, le motif en clair. Filtrez-le à l'écran ou téléchargez-le en CSV.
Contrôlé avant l'import
Le moteur qui contrôle l'Éditeur SysML v2 pendant la saisie contrôle le texte converti. Vous voyez d'abord le résultat, le texte et le rapport ; l'import constitue une seule étape d'annulation.
Réimporter quand le modèle v1 évolue
Les éléments prennent leur identifiant des identifiants XMI du modèle v1. Importez un export plus récent dans le même projet et les éléments sont mis à jour sur place, même lorsqu'ils ont été renommés ou déplacés, avec leurs dispositions de diagramme, commentaires, liens et historique.
Un modèle dans lequel vous pouvez travailler
L'Éditeur, les vues, les exigences, la vérification et les autres pages d'un projet SysML v2 lisent le modèle converti comme n'importe quel autre.
Votre modèle v1 reste tel quel
Holarch lit un export de ce modèle et n'écrit jamais en retour : le modèle v1 reste la référence pendant que l'équipe examine la version SysML v2.
Fonctionnement
- Déposez le fichier. Dans un projet SysML v2, cliquez sur Modèle → Importer et exporter, choisissez Dans ce projet ou Dans un nouveau projet SysML v2, et déposez le fichier
.mdzip,.xmi,.umlou.xml. Une carte de progression affiche la lecture, la conversion et le contrôle. - Examinez le rapport. Conversion depuis SysML v1 donne les décomptes, indique si le texte se contrôle sans problème, et liste les éléments approchés et laissés de côté avec le motif de chacun. Afficher le texte SysML v2 ouvre le résultat ; téléchargez le rapport ou le fichier
.sysmlpour les conserver. - Importez. Décochez les packages dont vous ne voulez pas et importez. Un seul Annuler retire de nouveau tout l'import.
Pas à pas, avec les paramètres d'export de chaque outil : Importer des modèles SysML v1 dans la documentation, et le guide de migration pour planifier le passage d'un programme entier.
Un bloc converti
part def Rover {
@SysMLv1Library::BlockData { isEncapsulated = true; }
part battery : Battery;
part computer : Computer;
attribute 'power budget' : Types::Power = 120 [SI::W];
connection 'power bus' connect battery.'out' to computer.'in';
satisfy Requirements::'Power Margin' by battery;
flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
}Sortie du convertisseur pour un bloc encapsulé avec deux parts, une propriété de valeur en watts, un connecteur entre ports proxy avec un flux d'item et une relation satisfy. Le guide de migration montre le petit modèle complet, avant et après.
Ce qu'il lit
- SysML v1 en XMI 2.x : UML 2.5 avec le profil SysML 1.x.
.xmi: un fichier XMI..xml: du XMI enregistré avec l'extension.xml..uml: un fichier de modèle XMI..mdzip: une archive de projet compressée qui contient le modèle en XMI ; Holarch lit le XMI qu'elle contient.- Autres formats de projet : un outil qui conserve les modèles dans son propre format de projet exporte d'abord le modèle en XMI.
Un fichier par import, jusqu'à 64 Mo, 250 000 éléments et 512 niveaux d'imbrication.
Ce qui en sort
- Du texte SysML v2 dans le projet ouvert ou dans un nouveau projet SysML v2, importé en une seule étape d'annulation.
- Un contrôle du texte, affiché avant l'import.
- Un rapport de conversion sur chaque élément, filtrable à l'écran et téléchargeable en CSV.
- Le fichier
.sysmlà télécharger, pour revue ou pour un autre outil SysML v2.
La conversion repose sur la transformation de SysML v1 vers SysML v2 décrite dans la spécification OMG SysML 2.0.
Converti, approché ou laissé de côté
Chaque élément du modèle v1 obtient l'un des trois résultats : vous savez exactement où regarder.
Converti
L'élément a un équivalent direct en SysML v2. Un bloc devient une part def, un bloc d'interface une port def, une exigence conserve son identifiant et son texte.
Approché
L'élément est conservé sous une forme modifiée. Un port complet typé par un bloc d'interface devient un port ; une transition passant par un choix devient une transition par chemin ; une unité qui n'est pas une unité SI correspondante devient un nombre réel avec l'unité dans sa documentation.
Laissé de côté
SysML v2 n'a pas d'équivalent, ou l'élément pointe vers quelque chose qui n'est pas dans le fichier. Exemples : nœuds de fin de flux, partitions d'activité, extensions de cas d'utilisation et relations vers des éléments sans nom.
Les propriétés SysML v1 sans mot-clé SysML v2, comme un bloc encapsulé, un port complet ou une relation refine, sont conservées comme métadonnées du package SysMLv1Library, que Holarch charge dans chaque projet SysML v2. Vos propres stéréotypes deviennent des définitions de métadonnées avec leurs valeurs étiquetées, et les comportements opaques, gardes et contraintes conservent leurs corps sous forme de représentations textuelles, comme language "OCL" /* … */.
Ce qui devient quoi
Les principales correspondances. La documentation les liste toutes.
| SysML v1 | SysML v2 |
|---|---|
| Package | package, imbriqué comme en v1 |
| Bloc, acteur | part def |
| Type de valeur, énumération | attribute def, enum def ; un type de valeur avec une unité SI connue spécialise la grandeur ISQ |
| Propriétés de part, de référence et de valeur | part, ref part, attribute, avec multiplicités et valeurs par défaut |
| Bloc d'interface, port proxy, propriété de flux | port def, port, item ou attribute orienté |
| Connecteur, connecteur de liaison, flux d'item | connect, bind, flow |
| Activité, actions, flux de contrôle et d'objets | action def, actions, successions avec gardes, flux entre paramètres |
| Machine à états, états, transitions | state def, états, transitions avec accept, gardes et effets |
| Exigence, satisfy, verify, derive | requirement avec son identifiant et son texte, satisfy, verify, connexions de dérivation |
| Allocate, refine, trace | allocate ; dependency avec des métadonnées SysMLv1Library |
| Cas d'utilisation, interaction, bloc de contraintes | use case def, occurrence def avec messages, constraint def |
| Stéréotypes et valeurs étiquetées | metadata def par stéréotype, appliquée avec ses étiquettes |
Un exemple détaillé : le modèle CubeSat EO-1
La démo CubeSat EO-1 exportée en XMI SysML 1.6 et importée dans un nouveau projet SysML v2 : 1 042 éléments lus, 1 007 convertis, 32 approchés, 3 laissés de côté. Le texte SysML v2 se contrôle sans erreur ni avertissement, et le nouveau projet s'ouvre avec la structure, les fonctions, les exigences et les traces du satellite. Chaque élément approché et laissé de côté, par motif :
| Éléments | Résultat | Motif |
|---|---|---|
| 10 connecteurs | Approché | Une extrémité de connecteur se trouve dans une part ; le chemin qui y mène a été déduit des types des parts. |
| 8 transitions | Approché | 4 déclencheurs de changement et de temps, comme when Undervoltage, sont conservés comme documentation ; 4 événements sans signal, comme Contact Start, ont reçu une définition d'item de ce nom. |
| 6 flux d'items | Approché | Le nom est utilisé deux fois au même endroit ; le flux a été renommé avec un suffixe. |
| 5 types de valeur | Approché | L'unité (%, GB, Mbps, mNms, W/m^2) n'est pas une unité SI que Holarch fait correspondre ; le type de valeur est un nombre réel avec l'unité dans sa documentation. |
| 2 flux de contrôle | Approché | Une branche sans garde à côté de branches gardées ; elle a reçu la garde true. |
| 1 état final | Approché | Un état final est devenu un état simple. |
| 1 extension de cas d'utilisation | Laissé de côté | SysML v2 n'a pas d'extensions de cas d'utilisation. |
| 2 relations trace | Laissé de côté | Elles pointent vers des éléments sans nom, auxquels le texte SysML v2 ne peut pas faire référence. |
Le fichier EO-1 est l'export SysML 1.6 de Holarch lui-même : il utilise la partie de SysML v1 qu'écrit Holarch. Un modèle provenant d'un autre outil utilise généralement davantage le langage, et ses chiffres seront différents : le rapport de votre propre modèle est la mesure qui compte, et vous le voyez avant tout import. Les modèles de test de Holarch, écrits dans les formes XMI de plusieurs outils SysML v1, se convertissent aussi en texte qui se contrôle sans problème, et un même modèle donne toujours le même texte.
Questions
Qu'est-ce qui se perd dans la conversion ?
Les diagrammes et leur disposition ne sont pas convertis : créez dans le projet SysML v2 des vues pour les diagrammes qui comptent. Les éléments sans équivalent en SysML v2 sont laissés de côté, comme les extensions de cas d'utilisation, les nœuds de fin de flux et les partitions d'activité, de même que les relations vers des éléments sans nom, car le texte SysML v2 fait référence aux éléments par leur nom (nommez les éléments vers lesquels vous tracez avant d'exporter). Les éléments approchés sont conservés sous une forme modifiée ; c'est là que le sens peut différer du modèle v1, examinez-les donc en premier. Le rapport les nomme tous, avec le motif.
Le modèle converti est-il prêt à l'emploi ?
Il se contrôle sans problème et toutes les pages d'un projet SysML v2 fonctionnent avec lui, mais considérez-le comme un point de départ. Certaines différences entre les langages méritent une décision de modélisation, pas seulement une traduction. Ce que prennent en charge les projets SysML v2, et les lacunes connues : couverture du langage SysML v2.
Quelle taille de modèle puis-je convertir ?
Un fichier d'au plus 64 Mo, avec au plus 250 000 éléments imbriqués sur au plus 512 niveaux, et au plus 8 Mo de texte converti. Exportez un modèle plus grand un package à la fois. Le nombre d'éléments par projet de votre offre s'applique au modèle converti : 1 000 en Free, 10 000 en Individual et 50 000 en Team. Voir ce qui compte comme un élément. Pour un modèle de plus de 10 000 éléments, demandez une évaluation Team.
Puis-je continuer à travailler dans mon outil SysML v1 ?
Oui. Holarch lit un export et ne modifie jamais le modèle v1. Lorsque le modèle v1 change, exportez-le de nouveau et importez le nouveau fichier dans le même projet : les éléments prennent leur identifiant du fichier XMI, ils sont donc mis à jour sur place, même après un renommage ou un déplacement. Les éléments de même nom au même endroit sont renommés avec un suffixe comme _2, et le rapport liste chaque renommage.
Où va mon fichier ?
Holarch lit et convertit le fichier XMI ou .mdzip dans votre navigateur ; le fichier lui-même n'est pas téléversé. Sur app.holarch.app, le texte SysML v2 converti est envoyé à Holarch pour préparer l'aperçu, et il n'est enregistré dans votre projet que lorsque vous importez. Le service hébergé n'accepte pas de CUI ni de données soumises au contrôle des exportations ; pour cela, Holarch s'exécute dans votre propre environnement (Enterprise). Plus d'informations dans Sécurité.
Et les exigences conservées dans un outil de gestion des exigences ?
Elles voyagent en ReqIF (.reqif, .reqifz), le format standard d'échange d'exigences. Holarch importe et exporte du ReqIF dans les projets LML et SysML v2. Dans un projet SysML v2, un fichier ReqIF devient des exigences, des définitions d'exigences et des packages, avec un rapport de ce qui a été converti, et les exigences se réexportent avec leurs identifiants d'origine. Lors de notre aller-retour de la démo CubeSat EO-1 de Holarch vers ReqIF et retour, les 407 éléments et les 979 valeurs d'attributs sont revenus à l'identique. ReqIF dans les projets LML · ReqIF dans les projets SysML v2
Combien coûte le convertisseur ?
Rien de plus : il fait partie de toutes les offres, Free compris. Les offres diffèrent par le nombre d'éléments par projet et par ce qu'elles incluent au-delà de la modélisation ; voir Tarifs.
Vous intégrez une migration à votre propre outil ?
Le convertisseur fait partie du Holarch Language Engine, le moteur des projets SysML v2 de Holarch, et il est proposé sous licence aux éditeurs d'outils et aux intégrateurs comme module de migration. C'est le même convertisseur que celui qui s'exécute dans Holarch.
- Votre produit lit le fichier XMI, le moteur convertit : envoyez le modèle v1 en JSON sous la forme neutre documentée, et recevez en JSON le texte SysML v2, le contrôle de ce texte par le moteur et le rapport sur chaque élément, avec un code de motif stable et le nom SysML v2 qu'il est devenu.
- S'exécute là où s'exécute votre produit : dans le navigateur en WebAssembly dans un Web Worker, ou sur votre serveur via Node.js ou l'extension Python avec l'usage serveur.
- Reproductible et borné : un même modèle donne toujours le même texte ; modèles jusqu'à 250 000 éléments, et un modèle plus grand reçoit une réponse d'erreur, jamais un blocage.
- Activé par votre jeton de licence, sans recompilation ni modification du code. L'évaluation gratuite de 60 jours s'exécute sur votre propre ordinateur, avec la documentation et les exemples.
Une requête et sa réponse
// Request (the model shortened)
{ "op": "v1_convert",
"model": { "format": "holarch-xmi-model", … } }
// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
"diagnostics": [],
"report": {
"summary": { "elements": 31, "converted": 27,
"approximated": 2, "dropped": 2 },
"items": [ { "kind": "Association",
"status": "dropped",
"reason": "association" }, … ] } }
La requête v1_convert dans la référence de l'API du moteur. Le moteur propose aussi la simulation et l'usage serveur comme modules complémentaires.
Voyez votre propre modèle en SysML v2.
Convertissez-le, lisez le rapport et n'importez que lorsque le résultat vous convient.
Les nouveaux comptes démarrent un essai Individual de 30 jours à leur première connexion : 10 000 éléments par projet, sans carte, retour à l'offre Free à la fin. Vous avez déjà un compte ? Démarrez l'essai dans Paramètres du compte → Offre et facturation.