Holarch

SysML v2

Échanger des modèles SysML v2

Importez des fichiers .sysml, des archives zip et du JSON SysML v2 dans un projet SysML v2 avec un aperçu, et exportez le modèle ou un package en texte .sysml ou en JSON SysML v2.

Utilisation →

Sur cette page
  1. Vue d'ensemble
  2. Concepts
    1. Formats de fichiers
    2. Id et correspondance
    3. Id des éléments dans le texte
    4. Les dossiers deviennent des packages
    5. Ce que compare l'aperçu
  3. Mode d'emploi
    1. Quand et pourquoi
    2. Importer des fichiers dans ce projet
    3. Importer des fichiers dans un nouveau projet
    4. Mettre à jour un package à partir d'une nouvelle version
    5. Renommer et déplacer des éléments dans le texte en conservant leurs id
    6. Imports volumineux sur le service hébergé
    7. Exporter le modèle ou un package
    8. Importer et exporter des exigences ReqIF
    9. Récupérer depuis un dépôt et y envoyer
    10. Exemple commenté : la démo Hybrid Car
    11. Conseils et bonnes pratiques
    12. Erreurs courantes
    13. Liens avec les autres fonctions
  4. La page Importer et exporter
    1. Import
    2. Export
  5. Dépôt
  6. Lecture des fichiers
    1. Éléments que Holarch n'interprète pas
  7. Messages
  8. Limites
  9. Pages associées

Vue d'ensemble

Les projets SysML v2 échangent des modèles avec d'autres outils SysML v2 sous forme de fichiers. La page Importer et exporter (Modèle → Importer et exporter) fait les deux :

  • Importer lit des fichiers .sysml, un .zip de fichiers .sysml ou un fichier JSON SysML v2. La page affiche un aperçu de ce qui change, puis l'applique à ce projet (une seule annulation défait le tout) ou crée un nouveau projet SysML v2.
  • Exporter écrit tout le modèle ou un package en texte SysML v2 (.sysml) ou en JSON SysML v2 (.json).
  • Les fichiers ReqIF (.reqif, .reqifz) issus d'outils de gestion des exigences s'importent comme exigences SysML v2, et les exigences s'exportent en ReqIF : voir Importer et exporter des exigences ReqIF.

Vous pouvez aussi créer un projet directement à partir de fichiers : dans Gérer les projets, cliquez sur Fichiers de projet ▾ → Importer des fichiers SysML v2….

Astuce : pour garder le modèle synchronisé avec un dépôt de modèles SysML v2 qui offre la Systems Modeling API, utilisez la section Dépôt de la même page : voir Récupérer depuis un dépôt et y envoyer.

Concepts

Formats de fichiers

FormatContenuImportExport
Texte SysML v2 (.sysml)La notation textuelle, un fichier par package de premier niveau.OuiOui
Archive zip (.zip)Plusieurs fichiers .sysml. Les dossiers deviennent des packages.OuiOui, lorsque plusieurs fichiers sont exportés
JSON SysML v2 (.json)Une liste plate d'éléments, chacun avec @id et @type, comme l'utilise la Systems Modeling API.OuiOui
ReqIF (.reqif, .reqifz)Des exigences avec leurs attributs, leur hiérarchie et leurs relations, issues de DOORS, Polarion, Jama, codebeamer et d'autres outils de gestion des exigences.Oui, convertis en exigencesOui, les exigences

Les fichiers KerML (.kerml) ne sont pas encore importés.

Id et correspondance

Chaque élément d'un projet SysML v2 a un id. Les deux formats le conservent différemment :

  • Le JSON conserve les id. Un élément importé de nouveau depuis du JSON correspond à l'élément ayant le même id.
  • Les références à la bibliothèque standard sont comprises. Le JSON issu de la Systems Modeling API, de la SysML v2 Pilot Implementation ou d'un autre dépôt nomme les éléments de la bibliothèque standard (unités telles que ISQ::mass, ScalarValues::Real, Parts::Part) par les id standard. L'import les lit comme les mêmes éléments de bibliothèque ; les unités et les types restent donc résolus.
  • Le texte conserve les id lorsque vous le demandez. Cochez Inclure les id des éléments lorsque vous exportez du texte .sysml. Chaque définition, usage et package nommé porte alors son id en première ligne de son corps, @HolarchMetadata::ElementId { id = "…"; }. Lorsque ce texte est importé de nouveau, chaque élément ayant un id correspond à l'élément ayant le même id, même s'il a été renommé, déplacé vers un autre propriétaire ou un autre package de premier niveau, ou réordonné. Ses positions dans les diagrammes, ses commentaires, ses traces et ses liens sont conservés.
  • Le texte sans id est mis en correspondance par nom. Holarch fait correspondre les packages de premier niveau par nom, et les éléments qu'ils contiennent par leurs noms et leurs positions. Les id sont conservés là où les éléments correspondent. Un élément renommé correspond toujours s'il garde sa place ; un élément renommé et déplacé en même temps devient un nouvel élément.

L'export l'indique sous les commandes d'export : « Les id des éléments sont conservés en JSON. Dans le texte .sysml, cochez Inclure les id des éléments pour les conserver : les éléments conservent alors leurs positions dans les diagrammes, leurs commentaires et leurs traces lorsque le texte modifié est importé de nouveau, même après un renommage ou un déplacement. Sans id, les éléments sont mis en correspondance par nom. »

Id des éléments dans le texte

@HolarchMetadata::ElementId { id = "…"; } est une métadonnée SysML v2 ordinaire : ElementId est une définition de métadonnée du package de bibliothèque propre à Holarch HolarchMetadata (dans la bibliothèque standard, sous Holarch), à côté de TBD et TBR. Les autres outils SysML v2 lisent la ligne comme une annotation de métadonnée ; pour résoudre son nom, ils ont besoin de HolarchMetadata.sysml issu de cette bibliothèque.

  • L'id appartient à l'élément dont le corps contient la ligne. Les éléments sans nom (connexions, successions, commentaires) ne portent pas d'id et sont mis en correspondance par leur contenu, comme auparavant.
  • Holarch ne conserve pas la ligne comme un élément. L'éditeur affiche le modèle sans ces lignes, et un élément dont le corps ne contenait que la ligne est affiché comme part engine : Engine;.
  • Les id doivent être uniques. Lorsque le même id apparaît deux fois (par exemple après la copie d'un bloc dans le texte), le premier élément le conserve et la copie devient un nouvel élément.
  • Un id qui n'est pas un UUID (par exemple "R-17") est converti en un UUID fixe ; la même chaîne donne donc toujours le même élément, comme dans un import JSON.
  • Un id que le projet ne possède pas est conservé pour le nouvel élément. Supprimer un élément dans Holarch puis réimporter le texte le fait revenir sous son ancien id.
  • Dans l'éditeur, une ligne collée fonctionne au sein du package que vous modifiez : un id qui appartient à un élément d'un autre package y est ignoré, et l'élément est mis en correspondance par nom. Pour déplacer des éléments d'un package à l'autre en conservant leurs id, exportez avec les id et importez les fichiers modifiés.

La définition de part Car de la démo Hybrid Car porte une telle ligne dans son fichier source ; son id est donc le même dans chaque copie de la démo.

Les dossiers deviennent des packages

Dans une archive zip, chaque dossier devient un package qui contient ses fichiers et ses sous-dossiers. Un fichier powertrain/engine.sysml de l'archive est lu comme s'il était écrit à l'intérieur de package powertrain { … }. Les fichiers à la racine de l'archive sont lus tels quels. Les dossiers et les fichiers sont lus dans l'ordre de leurs noms.

Ce que compare l'aperçu

L'aperçu a une ligne par package de premier niveau (ou, pour un nouveau projet, par élément de premier niveau). Chaque ligne a un résultat :

RésultatSignificationImporté par défaut
NouveauLe projet n'a pas de package de ce nom (ou de cet id). Il est ajouté.Oui
ModifiéLe projet a le package ; l'import y ajoute, modifie ou retire des éléments. Le détail indique combien, par exemple « 3 ajoutés, 1 modifié (id conservés là où les éléments correspondent) ».Oui
InchangéLe package est identique à celui de ce projet.Non (rien à faire)
ConflitLe package ne peut pas être fusionné. Le détail indique pourquoi et que faire.Non

Mode d'emploi

Quand et pourquoi

Utilisez Importer et exporter lorsqu'un modèle passe de Holarch à un autre outil SysML v2, ou d'un projet Holarch à un autre :

  • Démarrer un projet Holarch à partir d'un modèle écrit ailleurs.
  • Intégrer un package maintenu par une autre équipe, comme une bibliothèque de composants, et le mettre à jour lorsqu'elle envoie une nouvelle version.
  • Remettre un package à un fournisseur ou à un outil qui lit du texte ou du JSON SysML v2.
  • Conserver des fichiers .sysml dans votre propre gestion de versions à côté du projet Holarch.

Importer des fichiers dans ce projet

  1. Ouvrez Modèle → Importer et exporter.
  2. Sous Importer, choisissez Dans ce projet.
  3. Déposez les fichiers sur la zone de dépôt, ou cliquez dessus et choisissez-les.

    Vous voyez « Lecture des fichiers… », puis l'aperçu : le nombre de packages de premier niveau et de fichiers, les éventuels problèmes, et un tableau avec Importer, Package, Éléments et Résultat.

  4. Lisez la liste des problèmes, s'il y en a une. Elle nomme chaque fichier et chaque ligne qui ne s'analyse pas, ainsi que chaque fichier ignoré.
  5. Décochez tout package que vous ne voulez pas importer. Pour remplacer un package en conflit de nom, cochez-le.

    Sur une offre avec une limite d'éléments, l'aperçu compte les éléments que le projet aurait après l'importation (les relations ne comptent pas). Si ce nombre dépasse la limite, il l'indique, par exemple « Cette importation porterait le projet à 1 804 éléments ; l'offre Free en autorise 1 000. », et Importer N packages reste désactivé jusqu'à ce que vous ayez décoché assez de packages. Rien n'est appliqué ni envoyé au serveur. Les importations dans un nouveau projet sont contrôlées de la même façon par rapport à la limite par projet de votre offre.

  6. Cliquez sur Importer N packages.

    Le message indique « N packages importés. » La page indique « N packages importés (M éléments). Annuler défait l'importation en une étape. » Cliquez sur Ouvrir le texte pour les voir.

Importer des fichiers dans un nouveau projet

  1. Ouvrez Modèle → Importer et exporter et choisissez Dans un nouveau projet SysML v2.
  2. Déposez ou choisissez les fichiers.

    L'aperçu liste les éléments de premier niveau, tous cochés.

  3. Décochez ceux que vous ne voulez pas et modifiez le Nom du projet. Par défaut, c'est le nom du fichier unique ou du premier package.
  4. Cliquez sur Créer le projet.

    Le nouveau projet s'ouvre dans l'éditeur.

Depuis Gérer les projets, Fichiers de projet ▾ → Importer des fichiers SysML v2… fait la même chose en une étape. Si des parties des fichiers ne peuvent pas être lues, il demande d'abord : « N problèmes trouvés : des parties des fichiers sont omises. Créer le projet avec le reste ? Pour voir d'abord les problèmes, ouvrez un projet SysML v2 et utilisez Importer et exporter. » Cliquez sur Créer le projet pour continuer.

Mettre à jour un package à partir d'une nouvelle version

  1. Exportez ou recevez la nouvelle version sous forme de fichiers .sysml ou de JSON.
  2. Importez-la Dans ce projet.

    Le package affiche Modifié, avec le nombre d'éléments ajoutés, modifiés et supprimés.

  3. Cliquez sur Importer 1 package.

    Les éléments qui correspondent gardent leurs id, de sorte que les liens vers eux (liens d'exigences, risques, dispositions de vues, commentaires) restent. Les éléments qui ne figurent plus dans le fichier vont dans la corbeille.

Renommer et déplacer des éléments dans le texte en conservant leurs id

  1. Exportez les packages en texte SysML v2 avec Inclure les id des éléments coché.
  2. Modifiez les fichiers : renommez des éléments, déplacez-les vers d'autres propriétaires ou vers un autre fichier de package, réordonnez-les. Gardez chaque ligne @HolarchMetadata::ElementId dans le corps de son élément.
  3. Importez les fichiers modifiés Dans ce projet.

    Les packages affichent Modifié. Les éléments renommés et déplacés comptent comme modifiés, non comme ajoutés et supprimés.

  4. Cliquez sur Importer N packages.

    Les éléments gardent leurs id : leurs positions dans les diagrammes, leurs commentaires, traces et liens restent. Les éléments déplacés vers un autre package quittent le package où ils se trouvaient.

Imports volumineux sur le service hébergé

Sur le service hébergé, une importation de 5 000 éléments ou plus est appliquée par le serveur, et non par votre navigateur. Lorsque chaque package coché est Nouveau ou remplace un Conflit, le serveur lit lui-même les fichiers (étapes ci-dessous). Lorsqu'un package coché est Modifié, votre navigateur calcule la fusion comme d'habitude et téléverse les modifications une seule fois ; le serveur les écrit ensuite en une étape, avec la même carte de progression, Annuler l'importation et Défaire l'importation.

  1. Choisissez les fichiers et vérifiez l'aperçu comme pour toute importation.
  2. Cliquez sur Importer N packages (ou Créer le projet).

    Les fichiers sont téléversés une seule fois. Le serveur les lit avec les mêmes contrôles et les mêmes id d'éléments que l'aperçu, et écrit le résultat en une étape.

  3. Suivez la carte de progression en bas de la fenêtre : elle affiche l'étape (téléversement, lecture, contrôle, application, mise à jour de l'index du projet) et le temps restant.

    Vous pouvez quitter la page ou fermer l'onglet. L'importation continue sur le serveur, et lorsque vous rouvrez le projet, son résultat y est. Chaque copie ouverte du projet se recharge lorsque l'importation est appliquée ; les modifications non envoyées sont renvoyées après le rechargement.

  • Les autres membres voient « Nom importe fichier… » dans la même carte et sur la page Importer et exporter.
  • Une importation à la fois : une deuxième grande importation dans le même projet attend que la première soit terminée.
  • Annuler l'importation (la personne qui l'a lancée, ou un propriétaire) arrête l'importation avant qu'elle soit appliquée. Rien n'est modifié.
  • Défaire l'importation : ⌘Z / Ctrl+Z dans le navigateur ne défait pas une importation sur le serveur. Cliquez sur Défaire l'importation sur la page Importer et exporter pour ramener le projet à son état d'avant la dernière importation. L'état d'avant cette annulation est conservé dans l'Historique, de sorte que les modifications faites après l'importation peuvent y être récupérées.
  • Activité du projet et Historique listent l'importation comme une seule entrée, au nom de la personne qui l'a lancée.

Exporter le modèle ou un package

  1. Ouvrez Modèle → Importer et exporter.
  2. Sous Exporter, choisissez ce qu'il faut exporter : Le modèle entier, ou un package par son nom qualifié.
  3. Choisissez le format : Texte SysML v2 (.sysml ; un .zip pour plusieurs packages) ou JSON SysML v2 (.json).
  4. Pour un texte que vous modifierez et importerez à nouveau, cochez Inclure les id des éléments.
  5. Cliquez sur Exporter.

    Un fichier est téléchargé, ou un zip lorsque l'export contient plusieurs fichiers. Le message indique « <fichier> exporté. » ou « N fichiers exportés dans un zip. »

Pour exporter rapidement un package, utilisez le navigateur : le menu de ligne d'un package contient Exporter en .sysml et Exporter en JSON.

Importer et exporter des exigences ReqIF

ReqIF est le format d'échange des outils d'exigences. Un fichier ReqIF s'importe comme un package d'exigences SysML v2, et les exigences s'exportent à nouveau en ReqIF, de sorte qu'un outil d'exigences et un projet SysML v2 peuvent échanger les mêmes exigences dans les deux sens.

Importer un fichier ReqIF :

  1. Ouvrez Modèle → Importer et exporter (ou cliquez sur Importer… sur la page Exigences, ou choisissez Importer du ReqIF… dans ⌘K / Ctrl+K).
  2. Déposez le fichier .reqif ou .reqifz sur la zone, ou cliquez sur la zone pour le choisir. Un fichier ReqIF par importation.
  3. Le panneau ReqIF affiche le nombre d'exigences, de chapitres et de relations, combien ont été convertis, approchés ou omis, et si le texte SysML v2 se contrôle sans problème.
  4. Sous Noms courts depuis, choisissez ID externe (le numéro que voient les utilisateurs dans l'outil source, par exemple SRS-12) ou Identifiant ReqIF (l'id interne de l'outil). Les exigences sans ID externe prennent l'identifiant.
  5. Sous Types de relation, choisissez ce que devient chaque type de relation : Dériver, Raffiner, Dépendance ou Omettre. L'aperçu est recalculé, et le choix est conservé pour la prochaine importation du même fichier.
  6. Cliquez sur Importer 1 package. Une seule annulation défait toute l'importation. Le message indique « N exigences importées depuis <titre>. »

Ce que crée l'importation :

ReqIFSysML v2
Exigence (spec object)requirement, avec l'ID externe ou l'identifiant comme nom court, le nom, et le texte comme doc
Type d'exigencerequirement def, avec un attribut par attribut ReqIF
Type de données énumérationenum def
Attribut de statut (Draft, Proposed, Approved, etc.)Le statut de l'exigence dans Holarch
Titre de chapitrepackage avec le numéro de chapitre comme nom court
Exigence imbriquéerequirement imbriqué
Relation derived fromConnexion de dérivation
Relation refinesDépendance avec l'annotation Refinement
satisfies, verified by et autres relationsDépendance (le rapport indique pourquoi)
Spécificationpackage à l'intérieur du package du fichier

Les tableaux deviennent des lignes de texte avec | entre les cellules, les listes deviennent des lignes commençant par un tiret, et la mise en forme et les liens ne gardent que leur texte ; ces exigences sont Approchées. Les images et les objets incorporés ne sont pas importés ; l'exigence qui en contenait un est listée avec la raison, afin que vous puissiez y joindre le fichier. Télécharger le rapport enregistre chaque exigence et chaque relation avec son résultat au format CSV ; Télécharger le texte SysML v2 enregistre le texte.

Importer une copie plus récente du fichier : importez-la dans le même projet. Holarch trouve le package de l'importation précédente et compare exigence par exigence :

  • Les exigences gardent leurs id d'éléments, de sorte que les diagrammes, les liens satisfy et verify, les revues et l'historique restent rattachés. Les exigences renommées et déplacées sont mises à jour sur place.
  • Les exigences absentes du nouveau fichier sont conservées. Cochez Retirer les N exigences absentes de ce fichier pour les déplacer dans la corbeille.
  • Les parts, cas de vérification et liens que vous avez ajoutés dans Holarch sont conservés.
  • Une exigence modifiée uniquement dans Holarch garde votre modification. Une exigence modifiée à la fois ici et dans le fichier prend le texte du fichier ; le texte précédent reste dans l'historique. L'aperçu les liste sous Modifié ici et dans le fichier.

Exporter en ReqIF :

  1. Sous Exporter, choisissez un package ou Le modèle entier, et ReqIF (.reqif) ou Archive ReqIF (.reqifz).
  2. Cliquez sur Exporter. Le message indique « N exigences exportées dans <fichier>. »

Exporter… → Exigences (ReqIF) sur la base de données ou la page Exigences exporte de la même façon les exigences listées (ou sélectionnées).

Le fichier contient le nom court de chaque exigence (comme ReqIF.ForeignID), son nom, sa doc (en XHTML), son statut et ses valeurs d'attributs, la hiérarchie des packages comme spécification, ainsi que les relations derive, refine et dependency. Les exigences importées depuis ReqIF gardent leurs identifiants, types et types de relation d'origine, de sorte que l'outil source met à jour ses exigences au lieu d'en ajouter des copies ; exporter puis importer à nouveau le fichier affiche chaque package comme Inchangé. Les valeurs d'attributs calculées sont écrites sous forme de texte. Les liens satisfy et verify restent dans Holarch : ReqIF n'a ni parts ni cas de vérification.

Récupérer depuis un dépôt et y envoyer

Connectez le projet à une branche d'un dépôt de modèles SysML v2 pour lire son dernier commit et y renvoyer vos modifications.

  1. Ouvrez Modèle → Importer et exporter et trouvez la section Dépôt.
  2. Saisissez l'Adresse du dépôt (l'adresse https de son API Systems Modeling) et, si le dépôt en exige un, le Jeton d'accès.
  3. Cliquez sur Charger les projets, puis choisissez le Projet et la Branche. Pour démarrer un nouveau projet de dépôt à partir de ce modèle, cliquez plutôt sur Nouveau projet de dépôt.
  4. Cliquez sur Pull…. Holarch lit le dernier commit de la branche et liste chaque différence : Nouveau, Modifié, Supprimé ou Conflit. Vous voyez « À jour : aucune modification dans le dépôt. » lorsqu'il n'y a rien à récupérer.
  5. Décochez les différences que vous ne voulez pas, puis cliquez sur Appliquer le pull. Une seule annulation défait tout le pull.
  6. Après avoir modifié le modèle, cliquez sur Push. Vos modifications depuis le dernier commit synchronisé partent vers la branche sous la forme d'un nouveau commit. Vous voyez par exemple « 3 modifiés envoyés comme commit 1a2b3c4d. »

Un Conflit est un élément modifié à la fois ici et dans le dépôt depuis la dernière synchronisation. Un conflit décoché garde la version de ce projet.

Note : un push est refusé lorsque la branche a des commits que ce projet n'a pas récupérés : « La branche du dépôt a des commits que ce projet n'a pas récupérés. Faites d'abord un pull, puis un nouveau push. »

Exemple commenté : la démo Hybrid Car

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. Ouvrez Modèle → Importer et exporter. Sous Exporter, choisissez Le modèle entier et Texte SysML v2, puis cliquez sur Exporter.

    Un zip est téléchargé avec un fichier par package de premier niveau, par exemple Vehicles.sysml, VehicleRequirements.sysml, VehicleBehavior.sysml et VehicleViews.sysml.

  2. Ouvrez VehicleRequirements.sysml dans un éditeur de texte. Remplacez attribute maxCurbMass : MassValue = 1650 [kg]; par 1600 [kg] et enregistrez.
  3. De retour sur Importer et exporter, choisissez Dans ce projet et déposez VehicleRequirements.sysml.

    L'aperçu affiche VehicleRequirements comme Modifié, avec le nombre d'éléments modifiés. Les autres packages ne sont pas dans le fichier ; ils ne sont donc pas listés.

  4. Cliquez sur Importer 1 package.

    La valeur change dans le modèle. L'exigence Sedan Mass (VR-1.1) nomme maxCurbMass ; ses liens sont donc marqués pour revue (voir Exigences et vérification dans les projets SysML v2). Appuyez sur ⌘Z / Ctrl+Z pour annuler l'importation.

  5. Pour démarrer un deuxième projet à partir des mêmes fichiers, choisissez Dans un nouveau projet SysML v2, déposez le zip et cliquez sur Créer le projet.

Conseils et bonnes pratiques

  • Utilisez JSON pour transférer un modèle entre outils SysML v2 lorsque les id comptent, par exemple lorsque l'autre outil conserve les liens par id. Utilisez le texte lorsque des personnes lisent ou relisent les fichiers ; cochez Inclure les id des éléments lorsque le texte revient dans Holarch après modification.
  • Laissez les id de côté dans un texte que vous remettez à des personnes qui ne font que le lire : ces lignes en ajoutent une par élément.
  • Gardez un package de premier niveau par fichier. L'export écrit les fichiers ainsi, et une importation ultérieure fait alors la correspondance package par package.
  • Importez un package d'une autre équipe dans son propre package de premier niveau. Les mises à jour ne touchent alors que ce package.
  • Consultez la liste des problèmes avant d'importer. Les membres qui ne s'analysent pas sont omis.

Erreurs courantes

  • Un package affiche Conflit : « Un package nommé X avec d'autres id existe. » Le projet contient un package de ce nom qui n'a pas été importé depuis ce JSON. Cochez la ligne pour le remplacer (l'ancien package va dans la corbeille), ou importez dans un nouveau projet.
  • « L'importation contient deux packages de premier niveau nommés X ; seul le premier est importé. » Deux fichiers déclarent le même package de premier niveau. Fusionnez-les en un seul fichier, ou renommez-en un.
  • Un élément renommé a été importé comme nouveau. Le texte n'avait pas d'id d'éléments, et l'élément a été renommé et déplacé en même temps (ou son genre et son nom ont tous deux changé). Exportez avec Inclure les id des éléments, faites la modification et importez à nouveau.
  • Des éléments manquent après l'importation. Un membre qui ne s'analyse pas est omis : « Ce membre ne s'analyse pas et est omis. » Corrigez la ligne que nomme la liste des problèmes, puis importez à nouveau.
  • Une importation JSON est refusée. Importez un seul fichier JSON SysML v2 à la fois, sans fichiers .sysml.

Liens avec les autres fonctions

  • Éditeur : les packages importés s'y ouvrent ; les fichiers exportés sont le texte que vous y voyez.
  • Annulation et corbeille : une seule annulation défait toute une importation dans ce projet ; les éléments qu'elle supprime ou remplace vont dans la corbeille.
  • Contrôle des modifications : les valeurs et la documentation qui changent par une importation marquent les liens d'exigences pour revue, comme toute autre modification.
  • Fichiers de projet Holarch : Exporter ce projet… dans Gérer les projets enregistre tout le projet Holarch, avec les risques, documents et autres données Holarch. .sysml et JSON ne contiennent que le modèle.
  • Conversion : pour transférer un modèle entre LML et SysML v2, créez une copie convertie (voir Convertir entre LML et SysML v2).

La page Importer et exporter

Import

CommandeUsage
Dans ce projetFusionner les fichiers dans le projet ouvert. Non disponible pour les personnes qui peuvent seulement consulter le projet ; pour elles, les importations créent un nouveau projet.
Dans un nouveau projet SysML v2Créer un nouveau projet à partir des fichiers.
Zone de dépôt« Déposez les fichiers ici ou cliquez pour les choisir ». Accepte des fichiers .sysml, un .zip de fichiers .sysml, ou un fichier JSON SysML v2.
Tableau d'aperçuImporter (case à cocher), Package (nom et genre), Éléments (nombre), Résultat (Nouveau, Modifié, Inchangé ou Conflit, avec un détail).
Nom du projet(Nouveau projet uniquement) Le nom du nouveau projet, jusqu'à 200 caractères.
Importer N packages / Créer le projetAppliquer l'importation.
AnnulerFermer l'aperçu sans importer.

Les éléments hors de tout package dans le texte .sysml sont listés ensemble sur une ligne, Hors des packages.

Lorsque le modèle change pendant qu'un aperçu est ouvert (autre onglet, collaborateur ou Annuler), l'aperçu est recalculé.

Export

CommandeUsage
Exporter (portée)Le modèle entier, ou n'importe quel package par son nom qualifié.
comme (format)Texte SysML v2 (.sysml ; un .zip pour plusieurs packages) ou JSON SysML v2 (.json).
Inclure les id des éléments(Texte uniquement ; désactivé par défaut) Écrire l'id de chaque élément nommé dans le texte sous la forme @HolarchMetadata::ElementId { id = "…"; }, afin qu'une copie modifiée importée à nouveau garde les id malgré les renommages et les déplacements.
ExportTélécharger le fichier.

L'export texte écrit un fichier par package de premier niveau, nommé d'après lui (Vehicles.sysml). Les éléments hors des packages vont dans Outside packages.sysml. L'export JSON écrit un fichier nommé d'après le projet ou le package.

Dépôt

La section Dépôt relie le projet à une branche d'un dépôt qui offre l'API Systems Modeling.

  • Adresse du dépôt : l'adresse https de l'API du dépôt. Holarch se connecte uniquement à des adresses https sur des hôtes publics ; les administrateurs du site peuvent limiter les hôtes et les ports.
  • Jeton d'accès : stocké chiffré pour votre compte et ce projet, et envoyé uniquement à cette adresse. Il n'est plus jamais affiché ; laissez le champ vide pour garder le jeton stocké.
  • Charger les projets, Projet et Branche : choisissez où synchroniser. Nouveau projet de dépôt crée un projet dans le dépôt pour ce modèle.
  • Pull…, Appliquer le pull : lire le dernier commit, examiner les différences et les appliquer ; une seule annulation défait le tout. Holarch compare avec le dernier commit synchronisé, ce qui lui permet de distinguer vos modifications de celles du dépôt.
  • Push : envoyer les modifications depuis le dernier commit synchronisé en un seul commit. « Rien à envoyer : le modèle correspond au dernier commit synchronisé. » signifie qu'il n'y a rien de nouveau.
  • Paramètres… modifie la connexion. Déconnecter retire le jeton stocké et l'état de synchronisation ; le modèle reste.
  • Les opérations de dépôt exigent le rôle d'éditeur. Les lecteurs ne peuvent ni faire de pull ni de push.
  • Les push sont refusés pour les projets portant des marquages de données réglementées.

Lecture des fichiers

  • Les fichiers sont contrôlés avant toute lecture : leur taille, leur nombre, leur imbrication et la longueur des textes.
  • Dans un zip, les fichiers cachés et les dossiers __MACOSX sont ignorés. Les liens, les fichiers autres que .sysml et une deuxième copie du même chemin sont ignorés, et la liste des problèmes indique pourquoi.
  • Le texte doit être en UTF-8. Une marque d'ordre des octets (BOM) est acceptée.
  • Chaque élément importé est contrôlé avant d'être écrit. Un élément refusé entraîne avec lui ses membres possédés ; la liste des problèmes les compte.
  • En JSON, les éléments de genres que Holarch n'interprète pas sont conservés tels qu'ils ont été importés : voir Éléments que Holarch n'interprète pas.

Éléments que Holarch n'interprète pas

Le JSON SysML v2 peut contenir des genres d'éléments que Holarch ne modélise pas, comme des behaviors, steps ou interactions KerML. Holarch les conserve au lieu de les omettre :

  • Chacun reste dans le modèle avec son id, son nom, son propriétaire et son JSON d'origine, y compris ses relations (typages, spécialisations et autres) et ce qu'elles possèdent. Ses membres le gardent comme propriétaire.
  • Le navigateur affiche son genre d'origine avec une étiquette Non interprété ; pointez sur l'étiquette pour l'explication. L'inspecteur affiche son genre, son id dans le fichier et ce que visent ses relations.
  • Il ne peut pas être renommé ni modifié dans Holarch. Modifiez-le dans l'outil d'où il provient et importez-le à nouveau. Vous pouvez le déplacer ou le supprimer.
  • Il n'a pas de texte SysML. L'éditeur l'omet du texte, avec tout ce qu'il possède, et une note au-dessus du texte indique combien d'éléments ne sont pas affichés. Modifier le texte ne les supprime jamais. Un export .sysml les omet aussi.
  • Un export JSON le réécrit sans changement. Seul ce qui a changé dans le modèle est ajusté : un membre que vous avez supprimé, ajouté ou renommé, ou un nouveau propriétaire.
  • L'aperçu d'importation liste une fois chaque genre conservé, sous forme de note, par exemple 2 éléments Behavior sont conservés tels qu'importés. Les notes ne sont pas des problèmes.

Non conservés : l'espace de noms racine sans nom dans lequel certains outils enveloppent un export entier (ses membres deviennent des éléments de premier niveau), et les éléments non pris en charge à l'intérieur d'une valeur, qui sont listés comme problèmes. Un élément dont le JSON dépasse 256 Ko ne garde que son genre et son id.

Messages

MessageSignification et correction
Choisissez des fichiers .sysml, un .zip de fichiers .sysml ou un fichier JSON SysML v2.Aucun fichier n'a été choisi.
Aucun fichier .sysml trouvé. Choisissez des fichiers .sysml, un .zip de fichiers .sysml ou un fichier JSON SysML v2.L'archive ou la sélection ne contient aucun fichier .sysml.
Importez un seul fichier JSON SysML v2 à la fois, sans fichiers .sysml.Plusieurs fichiers JSON, ou du JSON mêlé à du texte, ont été choisis.
<file> n'est pas un fichier ReqIF (…). Exportez-le depuis l'outil source en ReqIF 1.0 ou ultérieur et importez-le à nouveau.Le fichier n'est pas du XML ReqIF, ou il contient un DOCTYPE, que Holarch ne lit pas.
<file> ne contient aucune exigence (aucun élément SPEC-OBJECT). Exportez les spécifications avec leurs objets et importez à nouveau le fichier.Le fichier ReqIF a des types mais aucune exigence.
<title> a N exigences, plus qu'une importation n'en accepte (environ M). Exportez les spécifications dans des fichiers ReqIF séparés.Le texte SysML v2 dépasserait la limite de 8 Mo. Importez les spécifications un fichier à la fois.
<file> n'est pas du texte UTF-8. Enregistrez-le en UTF-8 et importez-le à nouveau.Convertissez l'encodage du fichier.
<file> n'est pas une archive ZIP valide. Créez à nouveau l'archive.L'archive est endommagée.
<file> contient des fichiers chiffrés. Créez l'archive sans mot de passe.Les archives protégées par mot de passe ne sont pas lues.
<path> est compressé à plus de 200:1, ce qui est typique d'une bombe zip. Créez à nouveau l'archive.L'archive a été refusée par sécurité.
L'archive utilise une méthode de compression non prise en charge. Créez-la avec la compression ZIP standard.Utilisez la compression standard (deflate).
Les fichiers KerML ne sont pas encore importés.Les fichiers .kerml sont ignorés.
Seuls les fichiers .sysml sont importés depuis une archive.Les autres fichiers d'un zip sont ignorés.
Les liens ne sont pas importés.Les liens symboliques d'un zip sont ignorés.
L'archive contient ce fichier deux fois ; la première copie est importée.Deux entrées ont le même chemin.
<file> n'est pas du JSON valide. Exportez à nouveau le modèle.Le fichier JSON est endommagé.
<file> n'est pas du JSON SysML v2 (une liste d'éléments avec @id et @type). Choisissez un export JSON SysML v2.Le JSON est dans un autre format.
La ligne N de <file> dépasse 64 Ko. Coupez la ligne, puis importez à nouveau le fichier.Les lignes très longues sont refusées.
Ce membre ne s'analyse pas et est omis.Corrigez la ligne nommée dans la liste des problèmes.
Un élément avec cet id se trouve dans <element> dans ce projet. Déplacez-le d'abord au premier niveau, ou importez dans un nouveau projet.(Conflit) Le package de premier niveau du JSON existe déjà plus profondément dans le modèle.
N id d'éléments de ce package sont utilisés ailleurs dans ce projet. Importez plutôt dans un nouveau projet.(Conflit) Le JSON réutilise des id d'autres éléments.
Le texte du package ne s'analyse pas après impression. Importez-le dans un nouveau projet.(Conflit) Le package n'a pas pu être fusionné.
N éléments <kind> sont conservés tels qu'importés (non interprétés) : …(Note) Les éléments d'un genre que Holarch n'interprète pas sont conservés sans changement. Voir Éléments que Holarch n'interprète pas.
Un élément de genre <kind> à l'intérieur d'une valeur n'est pas pris en charge et est omis.Une valeur (une expression) contient un élément que Holarch ne peut pas lire. Le reste de la valeur est conservé sous forme de texte.
Un élément de genre <kind> est trop volumineux pour être conservé en entier ; seuls son genre et son id sont conservés.Son JSON dépasse 256 Ko.
L'importation n'a pas été appliquée : … Rien n'a été modifié.L'importation a échoué ; le projet est inchangé.
Le modèle est vide. Ajoutez un package, puis exportez à nouveau.Il n'y a rien à exporter.
Le package à exporter n'existe plus. Choisissez-en un autre.Le package a été supprimé pendant que la page était ouverte.

Limites

LimiteValeur
Fichiers par importation2,000
Texte .sysml par importation (décompressé)8 Mo
Archive zip16 Mo, 10 000 entrées
Imbrication de dossiers dans un zip32 dossiers
Éléments par importation (texte ou JSON)100,000
Fichier JSON24 Mo, imbrication de 64 niveaux
JSON d'un élément que Holarch n'interprète pas256 Ko, imbrication de 12 niveaux
Longueur de ligne64 Ko
Fichier ReqIF (.reqif, ou .reqif dans un .reqifz)64 Mo ; le texte SysML v2 qu'il produit doit tenir dans la limite de texte de 8 Mo (environ 8 000 à 20 000 exigences)
  • Les réponses du dépôt sont plafonnées à 64 Mo pour un pull entier, et chaque opération de dépôt s'arrête après 120 secondes.
  • Chaque compte peut exécuter au plus 300 opérations de dépôt par heure.
  • Les fichiers KerML (.kerml) ne sont pas encore importés.
  • Dans l'application hébergée, le serveur lit les importations jusqu'à 1,5 Mo de texte .sysml. Les importations plus volumineuses sont lues dans votre navigateur, avec le même résultat.
  • Les données Holarch à côté du modèle (statut des exigences, risques, budgets, paramètres du simulateur, dispositions des vues) ne font pas partie des fichiers .sysml ou JSON. Utilisez Exporter ce projet… dans Gérer les projets pour les conserver.

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