Import et export
Formats d'import et d'export
Importez des spécifications, des tableurs, des fichiers d'échange d'exigences et des modèles dans un projet Holarch, et sortez le modèle sous forme de documents, de tableaux, d'images, de fichiers d'échange et de fichiers de projet complets. Cette page liste chaque format, son sens, ce qu'il transporte et ses limites connues.
Fonctionnement des imports et des exports
- Les exports sont ouverts à tous les membres du projet, lecteurs compris. Les imports nécessitent le rôle Propriétaire ou Éditeur, car ils modifient le projet.
- Un import depuis la page Importer et exporter affiche un aperçu, attribue de nouveaux identifiants aux éléments importés et constitue une seule étape d'annulation. Pour mettre à jour des éléments existants au lieu d'en ajouter, faites-les correspondre par identifiant, nom ou numéro.
- Le contenu importé est nettoyé : le texte enrichi perd ses scripts et ses liens dangereux, les images SVG perdent leurs scripts et leurs références externes, et le XML contenant des déclarations DOCTYPE ou ENTITY est refusé.
- Les exports CSV neutralisent le texte qu'un tableur exécuterait comme formule. Les noms de fichiers sont nettoyés pour chaque système d'exploitation.
- Chaque projet est un projet LML ou un projet SysML v2. Les imports Word, tableur, texte et ReqIF concernent les projets LML. Les projets SysML v2 importent du texte et du JSON SysML v2, ainsi que des modèles SysML 1.x en XMI ou .mdzip, convertis en SysML v2. Les projets LML importent aussi du XMI. Les fichiers de projet, et les exports Word, Excel et CSV des pages communes, fonctionnent dans les deux.
Aller à : Exigences et spécifications · Modèles · Tableurs et tableaux · Documents et rapports · Images · Fichiers de projet · API et MCP
Exigences et spécifications
| Format | Sens | Ce qu'il couvre | Limites connues |
|---|---|---|---|
| Word (.docx) | Import | Une spécification devient un document numéroté. Les titres deviennent des Statements imbriqués par niveau ; les paragraphes contenant « shall », « must », « will » ou « should » et les éléments de listes numérotées deviennent des Requirements. Les tableaux donnent un élément par ligne, ou restent des tableaux dans une description. Gras, italique, listes et images sont conservés, les insertions en suivi des modifications sont lues, et le fichier d'origine est joint. | Les images en EMF, WMF et autres formats que PNG, JPEG, GIF, WebP et SVG sont ignorées. Le texte supprimé en suivi des modifications n'est pas importé. |
| Texte brut (.txt ou collé) | Import | Les lignes numérotées et les phrases avec « shall » deviennent un document numéroté de Statements et de Requirements. La numérotation hiérarchique est détectée ou choisie : décimale, romaine, alphabétique, niveaux mixtes, style DoD ou motif personnalisé. | La structure ne provient que de la numérotation et de la formulation. |
| ReqIF (.reqif, .reqifz) | Import et export | Import : chaque SPEC-OBJECT devient un élément, avec la hiérarchie de la spécification, son type comme classe, et les attributs chaîne, XHTML, booléen, date, énumération, entier et réel. Les SPEC-RELATION deviennent des relations ; satisfy, verify et deriveReqt deviennent satisfies, verifies et traced from ; trace et refine deviennent traced to. Export depuis la Base de données ou un document : un type par classe avec numéro, nom, description et chaque attribut, les relations en SPEC-RELATION et la décomposition comme hiérarchie. | Les types de relation sans correspondance deviennent traced to ; les liens que le schéma n'autorise pas sont ignorés avec un avertissement. |
Modèles
| Format | Sens | Ce qu'il couvre | Limites connues |
|---|---|---|---|
| XMI UML et SysML 1.x (.xmi, .uml, .xml, .mdzip) | Import et export | Import : XMI 2.x avec UML 2.5 et le profil SysML 1.3 à 1.7, et archives de projet .mdzip. Exigences avec leurs identifiants et leur texte, blocs, parts, ports, propriétés de valeur, types de valeur avec unités, généralisations, connecteurs et flux d'items, activités avec leur flux de contrôle, machines à états avec états parallèles et transitions choice, junction, fork et join, diagrammes de séquence, cas de test, packages, stéréotypes et valeurs étiquetées. Satisfy, verify, deriveReqt, refine, trace, copy et allocate deviennent des relations Holarch. Les diagrammes de blocs, de blocs internes, de machine à états et d'action sont dessinés à partir du modèle importé. Export : XMI SysML 1.6 (XMI 2.5.1) pour Cameo/MagicDraw, Enterprise Architect et Rhapsody, ou Papyrus (Eclipse UML, .uml) pour Papyrus, avec exigences, blocs, parts, ports, types de valeur avec unités, blocs de contraintes, connecteurs avec flux d'items, activités, cas d'utilisation, cas de test, machines à états et relations de traçabilité. Les éléments importés conservent leurs identifiants XMI et l'export les réécrit : importer une version ultérieure du même modèle met à jour les éléments au lieu d'ajouter des copies. Avec les attributs et étiquettes Holarch activés, le fichier se réimporte dans Holarch sans perte. | Les dispositions des diagrammes et les opérations ne sont pas importées ; la revue liste ce qui est laissé de côté. Le flux d'une activité n'est dessiné que s'il est bien structuré. Les artefacts, tâches, risques, problèmes, décisions, éléments de temps et de coût ne sont pas exportés. |
| Code source Java (.java) | Import | Sur un diagramme de classes : les classes, interfaces et énumérations deviennent des Assets, les champs des Characteristics, et les méthodes des Actions avec leurs paramètres et résultats sous forme d'Input/Outputs. | Un fichier ou un code source collé à la fois. |
| Texte SysML v2 (.sysml, ou un .zip de fichiers .sysml) | Import et export | Import dans un projet SysML v2 ou dans un nouveau, avec un aperçu par package : nouveau, modifié, inchangé ou en conflit. Les dossiers d'un zip deviennent des packages. Exportez le modèle entier ou un package ; plusieurs packages se téléchargent en zip. | Le texte ne contient pas d'identifiants d'éléments : une réimportation fait correspondre les éléments par leur nom. Les fichiers KerML (.kerml) ne sont pas importés. Jusqu'à 2 000 fichiers, 8 Mo de texte et un zip de 16 Mo par import ; le texte doit être en UTF-8. |
| JSON SysML v2 (.json) | Import et export | La liste plate d'éléments avec @id et @type qu'utilise la Systems Modeling API. Les identifiants des éléments sont conservés : une réimportation fait correspondre par identifiant. | Jusqu'à 24 Mo et 100 000 éléments. Les genres d'éléments que Holarch n'interprète pas sont conservés tels qu'importés, marqués Non interprété, et réécrits sans changement. |
| Dépôt de modèles SysML v2 | Récupération et publication | Connectez un projet SysML v2 à une branche d'un dépôt qui propose la Systems Modeling API. Récupérez le dernier commit et examinez chaque différence avant de l'appliquer ; publiez vos modifications en un seul commit. | Adresses https sur des hôtes publics uniquement. Une publication est refusée tant que la branche a des commits non récupérés. 64 Mo par récupération, 120 secondes par opération et 300 opérations par compte et par heure. Nécessite le rôle Éditeur. |
| Systems Modeling API dans Holarch | Lecture et commits par d'autres outils | D'autres outils SysML v2 lisent les éléments d'un projet SysML v2 en JSON SysML v2 via REST, avec un jeton d'accès personnel, et valident des modifications dans des branches de demandes de modification. | main est en lecture seule ; les commits deviennent des demandes de modification qu'un approbateur applique dans Holarch. Uniquement les têtes de branches ; ni étiquettes, ni fusions, ni requêtes enregistrées. |
| De SysML v1 à SysML v2 (.xmi, .uml, .xml, .mdzip) | Import | Un modèle SysML 1.x de Cameo ou MagicDraw, Enterprise Architect, Rhapsody ou Papyrus est converti en texte SysML v2, contrôlé et importé dans un projet SysML v2 ou un nouveau, en une seule étape d'annulation. Un rapport de conversion liste chaque élément comme converti, approché ou laissé de côté, avec le motif, et se télécharge en CSV. | Les diagrammes et leur disposition ne sont pas convertis. Les relations vers des éléments sans nom sont laissées de côté. |
| De LML à SysML v2 et retour | Copie convertie, dans les deux sens | Un nouveau projet dans l'autre langage : Assets, ports, Conduits, Input/Outputs, exigences, liens satisfy, cas de test, Actions avec leur flux, états et équations. Risques, décisions, tâches, documents, tableaux blancs, statut des exigences et résultats de test sont repris. Un rapport liste ce qui a été converti et ce qui ne l'a pas été, et se télécharge en CSV. | Les dispositions des diagrammes, l'historique, les références et les demandes de modification ne sont pas convertis. Les éléments qui n'ont pas de place dans l'un des langages, comme les Measures et Resources LML ou les calculs et cas d'analyse SysML v2, sont listés dans le rapport. |
Les données Holarch associées à un modèle SysML v2, comme le statut des exigences, les risques, les budgets et les dispositions des vues, ne font pas partie des fichiers .sysml ni JSON SysML v2. Un export de projet les conserve.
Tableurs et tableaux
| Format | Sens | Ce qu'il couvre | Limites connues |
|---|---|---|---|
| Excel (.xlsx, .xlsm) et CSV | Import | Éléments nouveaux ou mis à jour de n'importe quelle classe, avec une correspondance de colonnes proposée à partir des en-têtes. Attributs, étiquettes, relations, hiérarchie à partir d'une colonne parent ou des numéros, et nouveaux attributs créés à partir des données. Faites correspondre les éléments existants par identifiant, nom ou numéro pour les mettre à jour. | Excel 97-2003 (.xls) et le CSV séparé par points-virgules ne sont pas lus. Les noms et numéros sont tronqués à 255 caractères. |
| Excel et CSV depuis la Base de données | Export | Tout ensemble d'éléments sous forme de tableau avec les attributs et relations choisis, avec hiérarchie et consolidations, sous forme de définitions, de matrice de relations, d'historique des modifications ou de commentaires. | Les cellules Excel contiennent jusqu'à 32 000 caractères ; un texte plus long est tronqué. |
| Excel et CSV depuis d'autres pages | Export | RVTM, VCRM, RVM, RTM, RSM et TVM ; résultats de qualité des exigences ; registre TBD/TBR ; registre des interfaces ; matrices N² et I² ; budgets et TPM ; registre des risques ; études de compromis ; tableaux d'analyse fonctionnelle ; comparaisons de références ; données des graphiques ; chronologies, journaux d'événements et exécutions du simulateur. | Chaque page exporte ses propres colonnes. |
| Matrice de traçabilité (.xlsx, .csv) | Import et export | Exportez n'importe quelle relation sous forme de matrice. Modifiez le classeur dans un tableur et réimportez-le : l'aperçu liste les liens à ajouter, les liens à retirer et les cellules ignorées. | L'import n'ajoute et ne retire que des liens entre éléments existants. Les cellules que le schéma n'autorise pas sont ignorées et listées. |
Documents et rapports
| Format | Sens | Ce qu'il couvre | Limites connues |
|---|---|---|---|
| Word (.docx) | Export | Documents et plans avec styles de titres Word, marquages, pages de couverture et numéros de page ; redlines avec suivi des modifications entre références ; décompositions d'entités ; rapports de diagrammes ; ICD ; cas de test ; RVTM et matrices de traçabilité ; synthèses d'études de compromis ; rapports d'analyse fonctionnelle ; le dossier d'architecture DoDAF. | Les pages sont au format US Letter. |
| PowerPoint (.pptx) | Export | Présentations, une diapositive par page, avec zones de texte, formes et notes de l'orateur. Les présentations s'exportent aussi en HTML et en Word. | Aucune signalée. |
| Markdown (.md) | Export | Un document sous forme de titres et de texte Markdown. | Aucune signalée. |
| HTML | Export | Pages web de diagrammes, rapports de diagrammes, graphiques, présentations et matrices de traçabilité. | Aucune signalée. |
| Impression et PDF | Export | Documents, tableaux et diagrammes via la boîte de dialogue d'impression du navigateur, qui enregistre en PDF. Les tableaux blancs s'exportent directement en PDF. | Les pages PDF des tableaux blancs sont des images. |
Images
| Format | Sens | Ce qu'il couvre | Limites connues |
|---|---|---|---|
| PNG et SVG | Export | Diagrammes, graphiques, diapositives, panneaux du simulateur et fiches de galerie. PNG à l'échelle choisie, avec ou sans arrière-plan ; SVG en image vectorielle redimensionnable. | Aucune signalée. |
| Tableaux blancs : PNG, JPG, SVG, PDF | Export | Une planche, une sélection, la vue actuelle, un cadre ou toutes les planches. Le SVG conserve formes et texte modifiables dans les outils vectoriels. | Les pages PDF sont des images. |
| Images et fichiers joints | Import | Images dans le texte enrichi, images d'entités, attributs de fichier, tableaux blancs et diapositives. Graphiques PNG, JPEG ou SVG pour les produits DoDAF, comme un OV-1 avec zones actives. | Les images de plus de 4 000 px sur le plus grand côté sont réduites. Les fichiers sont limités à 10 Mo avec l'offre Free, 25 Mo avec Individual et 100 Mo avec Team, et les projets à 100 Mo avec l'offre Free. |
Fichiers de projet
| Format | Sens | Ce qu'il couvre | Limites connues |
|---|---|---|---|
| Sauvegarde Holarch (.holarch) et fichier de projet (.json) | Import et export | Un projet entier, pour sauvegarde ou pour le déplacer vers un autre serveur Holarch : éléments, relations, diagrammes, références, commentaires, historique et préférences d'Accueil, avec pièces jointes et images. Une sauvegarde .holarch porte une somme de contrôle pour chaque partie et est vérifiée avant import. S'importe comme nouveau projet dont vous êtes propriétaire. Les formats de sauvegarde et JSON sont documentés. | Toujours un nouveau projet ; pour fusionner dans un projet ouvert, utilisez l'import par fusion ci-dessous. |
| Fusion dans un projet (.holarch, .json) | Import | Sauvegardes et paquets Holarch avec leurs fichiers joints, et exports Holarch de projet, de Base de données et de document, fusionnés dans le projet ouvert. Classes, attributs, étiquettes et relations sont mis en correspondance par nom, et les éléments de schéma manquants peuvent être ajoutés au préalable. Commentaires, historique et dispositions des diagrammes sont repris si vous le choisissez. | Les scripts de simulation provenant d'un fichier sont marqués comme importés, et le simulateur demande confirmation avant de les exécuter. |
| Paquet de projet (.holarch) | Export | Les éléments choisis avec leurs relations, diagrammes, commentaires et schéma, et chaque fichier joint, avec un contrôle de dommages à l'import. | Contient les éléments choisis ; les références et l'historique ne sont pas inclus. |
| Schéma (.json) | Import et export | Les classes, relations, attributs et étiquettes d'un projet. L'import fusionne ce qui manque au projet, ou remplace le schéma. | Aucune signalée. |
| Références et données de document (.json) | Export ; les données de document s'importent aussi | Une référence avec sa date, son document, ses approbations et son instantané. Les éléments, relations et état d'un document, qui peuvent être fusionnés dans un autre projet. | Aucune signalée. |
| Produits DoDAF (JSON) et sous-ensemble DM2 PES (XML) | Export | La description d'architecture, chaque produit avec ses données, et le dictionnaire. Le XML écrit le dictionnaire selon les termes du DoDAF Meta Model. | Le XML utilise l'espace de noms propre à Holarch et n'est pas validé par rapport au schéma DM2 PES. |
| Planning MS Project (.xml) | Export | Les lignes de Gantt d'une exécution de simulation sous forme de planning XML MS Project. | Uniquement à partir d'exécutions du simulateur. |
API et MCP
Les scripts lisent et modifient les projets via l'API REST, avec un jeton d'accès personnel et une description OpenAPI. Les outils d'IA comme Claude se connectent via le Model Context Protocol (MCP) ; leurs modifications arrivent sous forme de propositions que vous examinez avant qu'elles ne s'appliquent. Voir API et MCP.