Parcours 6. Migrer vers Holarch : fiche d'exercices
Pour les équipes qui viennent d'autres outils. Une tâche pratique et quelques questions par chapitre, à traiter après chaque vidéo. Imprimez cette page depuis votre navigateur, ou travaillez à l'écran. Le corrigé commence sur une nouvelle page à la fin.
Avant de commencer
- À suivre d'abord
- Parcours 1. Prise en main, chapitres 1.1 à 1.3.
- Offre
- Gratuit
- Projet
- Vos propres fichiers d'exigences, ou des fichiers que vous exportez de la démo EO-1 pour vous entraîner.
6.1 Planifier une migration
Regarder le chapitre 6.1 (3:00)
Pratique
Sur le projet de démonstration CubeSat EO-1 :
- Ouvrez votre projet de démonstration EO-1 (si vous n'en avez pas, créez-le : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat (ingénierie système guidée)).
- Ouvrez Paramètres → Schéma dans le rail, cliquez sur Requirement sous Classes, et listez les attributs qu'une feuille de calcul d'exigences pourrait remplir (par exemple Priority, Owner, Verification Method).
- Ouvrez la page Labels du schéma et trouvez où sont conservées des catégories telles que Performance Requirement.
- Imaginons que le suivi d'un fournisseur ait une colonne
Supplier Refsans équivalent : sur Requirement, cliquez sur + Attribut, nommez-leSupplier Ref, choisissez un type texte et cliquez sur Ajouter un attribut. - Ouvrez Besoins et exigences → Importer et exporter et lisez quels formats accepte la zone de dépôt et ce que propose la carte Exporter.
C'est terminé quand Supplier Ref est le dernier de la liste des attributs de Requirement et que vous pouvez dire où irait chaque colonne d'un suivi type.
Questions
- Pourquoi décider où va chaque type de données avant d'importer ?
- Une colonne n'a pas d'attribut correspondant. Quelles sont vos options ?
- Un import a mal tourné. Comment l'annuler ?
- Quand utiliser Gérer les projets → Importer un projet (.json)… plutôt que la page Importer ?
6.2 Exigences depuis Excel et CSV
Regarder le chapitre 6.2 (2:32)
Pratique
Sur le projet de démonstration CubeSat EO-1 :
- Ouvrez votre projet de démonstration EO-1 (si vous n'en avez pas, créez-le : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat (ingénierie système guidée)). Dans la Base de données, recherchez
class:Requirement, cliquez sur Exporter…, choisissez Tableau (CSV), cochez Status et Priority (gardez Labels coché) et cliquez sur Exporter. - Ouvrez le fichier dans un tableur. Gardez l'en-tête et les lignes des sections 1 et 2, puis ajoutez deux lignes en haut :
1,Mission Imaging, ClassStatement, et2,Attitude Determination and Control, ClassStatement. Enregistrez-le en .xlsx ou .csv. - Dans Gérer les projets, cliquez sur + Nouveau projet, nommez-le
EO-1 Import Practiceet cliquez sur Créer le projet. - Ouvrez Besoins et exigences → Importer et exporter, déposez le fichier, cliquez sur Continuer et vérifiez le Champ Holarch de chaque colonne (réglez sur Ignorer toute colonne dont vous ne voulez pas).
- Cliquez sur Continuer, gardez Create a document from these N items coché et cliquez sur Import N items.
- Dans le nouveau document, vérifiez que 1.6.1 et 1.6.2 sont sous 1.6, et sélectionnez 1.5 pour voir ses étiquettes et son état.
C'est terminé quand le nouveau document montre les sections 1 et 2 avec leurs exigences imbriquées selon leur numéro, étiquettes et états intacts.
Questions
- Comment Holarch reconstruit-il la hiérarchie des lignes d'une feuille de calcul ?
- Certaines lignes sont arrivées avec la mauvaise classe. Pourquoi ?
- Vous voulez mettre à jour les responsables de 50 exigences existantes à partir d'une feuille de calcul, sans créer de copies. Comment ?
6.3 Exigences depuis Word et ReqIF
Regarder le chapitre 6.3 (2:22)
Pratique
Sur le projet de démonstration CubeSat EO-1 :
- Ouvrez votre projet de démonstration EO-1 (si vous n'en avez pas, créez-le : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat (ingénierie système guidée)). Ouvrez Documents → EO-1 System Requirements Specification et cliquez sur Livrer ▾ → Spécification (Word).
- Dans le même document, cliquez sur Livrer ▾ → Exigences (ReqIF)… et cliquez sur Exporter.
- Dans Gérer les projets, cliquez sur + Nouveau projet, nommez-le
EO-1 Import Practiceet cliquez sur Créer le projet. Ouvrez Besoins et exigences → Importer et exporter, déposez le .docx, cliquez deux fois sur Continuer et importez-le. - Comparez le nouveau document à la SRS : notez quels titres sont devenus des Statements et quelles phrases « shall » sont devenues des Requirements, et comment ils ont été nommés.
- Importez le fichier .reqif dans le même projet, puis ouvrez le document qu'il crée et sélectionnez 1.6 Revisit Time pour vérifier ses enfants et ses étiquettes.
C'est terminé quand le projet contient deux documents, l'un issu de Word et l'autre de ReqIF, et que vous pouvez dire lequel a conservé les noms et numéros d'origine.
Questions
- Que lit l'import Word comme une section, et que lit-il comme une exigence ?
- Un fournisseur peut envoyer du Word ou du ReqIF. Pourquoi demander du ReqIF ?
- Une relation ReqIF porte un nom que Holarch ne connaît pas. Que se passe-t-il ?
6.4 Modèles issus d'autres outils
Regarder le chapitre 6.4 (2:44)
Pratique
Sur le projet de démonstration CubeSat EO-1 :
- Ouvrez votre projet de démonstration EO-1 (si vous n'en avez pas, créez-le : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat (ingénierie système guidée)). Ouvrez Besoins et exigences → Importer et exporter, cliquez sur Exporter UML/SysML (XMI)… dans la carte Exporter, laissez Format sur OMG XMI 2.5.1 (.xmi) et cliquez sur Exporter. Ce fichier remplace l'export d'un outil SysML tel que Cameo ou Enterprise Architect.
- Dans Gérer les projets, cliquez sur + Nouveau projet, nommez-le
EO-1 Import Practiceet cliquez sur Créer le projet. Ouvrez Besoins et exigences → Importer et exporter, déposez le fichier .xmi, vérifiez que Format affiche UML/SysML (.xmi, .uml, .mdzip), cliquez deux fois sur Continuer, lisez Revoir et cliquez sur Importer N éléments. - Dans la Base de données, recherchez
class:Asset, sélectionnez Payload Camera et vérifiez dans Traçabilité qu'elle fait partie d'EO-1 Spacecraft et quelles actions elle exécute. - Ouvrez Diagrammes, cliquez sur + Nouveau diagramme, choisissez Diagramme d'Asset, choisissez EO-1 Spacecraft dans Diagramme de et cliquez sur Créer.
- Activez Actions exécutées pour lister les fonctions de chaque sous-système.
C'est terminé quand le diagramme d'Asset du nouveau projet montre les sous-systèmes du satellite avec les actions qu'ils exécutent.
Questions
- Quels fichiers d'un outil SysML v1 Holarch peut-il importer, et comment les obtenir ?
- Pourquoi peut-on reconstruire rapidement des diagrammes après un import ?
- Vous importez un export plus récent du même modèle. Pourquoi n'obtenez-vous pas de copies ?
6.5 Nettoyer après l'import
Regarder le chapitre 6.5 (2:40)
Pratique
Sur le projet de démonstration CubeSat EO-1 :
- Ouvrez votre projet
EO-1 Import Practicedes chapitres précédents (ou importez un CSV des exigences d'EO-1 comme au chapitre 2). - Ouvrez Besoins et exigences → Qualité, choisissez l'un des documents importés dans la barre de portée et cliquez sur Contrôler la qualité.
- Si vous avez importé deux fois les mêmes exigences (Word et ReqIF), cochez la ligne d'un doublon dans la Base de données et supprimez-le avec Supprimer l'élément… dans la barre d'actions groupées. Réécrivez 2.5 Safe Mode Recovery pour la rendre mesurable, puis contrôlez de nouveau la qualité.
- Ouvrez Vérification → Contrôles du modèle et ouvrez la règle Requirement.8, Leaf requirements no design entity meets.
- Si vous avez aussi importé les assets (chapitre 4), sélectionnez 2.1 Pointing Accuracy et, dans Traçabilité, ajoutez satisfied by vers ADCS avec + → Lier un existant…. Relancez les contrôles du modèle.
C'est terminé quand 2.5 obtient un meilleur score qu'avant et que Requirement.8 ne liste plus 2.1.
Questions
- Qu'examine le contrôle qualité, et qu'examinent les contrôles du modèle ?
- Pourquoi le score de qualité automatique ne dépasse-t-il jamais 78 % ?
- Pourquoi relier les exigences et les parties juste après une migration ?
Corrigé
6.1 Planifier une migration
- Des données qui arrivent dans les bonnes classes, étiquettes, attributs et relations fonctionnent immédiatement pour la traçabilité, les contrôles qualité et les rapports. Les corriger après l'import oblige à modifier de nombreux éléments à la main.
- Ajoutez l'attribut dans Paramètres → Schéma avant l'import, ou associez la colonne à Nouvel attribut (ajouté au schéma) à l'étape Mapper.
- Appuyez une fois sur ⌘Z / Ctrl+Z : un import depuis la page Importer est une seule étape d'annulation.
- Pour restaurer un projet entier comme nouveau projet distinct. La page Importer fusionne les éléments d'un fichier dans le projet ouvert.
6.2 Exigences depuis Excel et CSV
- À partir d'une colonne Parent Row ID ou Parent Number si elle est associée, sinon à partir du numéro de plan : 1.2 va sous 1. Si le parent manque, l'ancêtre existant le plus proche est utilisé.
- Une colonne Class dont les noms sont inconnus du schéma se rabat sur la Classe des lignes sans classe, avec un avertissement. Utilisez les noms de classe de l'éditeur de schéma.
- Exportez-les avec la colonne ID, modifiez le fichier et importez-le avec la colonne ID associée à ID global et Match existing entities by réglé sur ID global. L'étape Examiner les liste alors sous Éléments mis à jour.
6.3 Exigences depuis Word et ReqIF
- Les paragraphes aux styles de titre Word deviennent des Statements (sections). Un paragraphe contenant shall, must, will ou should devient un Requirement, nommé d'après les premiers mots qui suivent le verbe. Les titres saisis en simple texte gras sont lus comme du texte ordinaire.
- ReqIF transporte l'identifiant, la hiérarchie, les attributs et les relations de chaque exigence. Quand le fournisseur envoie un fichier plus récent, l'importer met à jour les mêmes éléments au lieu d'ajouter des copies.
- Elle arrive en tant que traced to. Si le schéma n'autorise pas traced to entre les deux classes, la relation est ignorée avec un avertissement.
6.4 Modèles issus d'autres outils
- XMI 2.x avec le profil SysML 1.x de Cameo/MagicDraw, Enterprise Architect, Rhapsody ou Papyrus (à exporter depuis l'outil), un projet .mdzip de Cameo ou MagicDraw directement, et un fichier .uml de Papyrus. Les exigences seules peuvent aussi arriver en ReqIF, et les tableaux en Excel ou CSV.
- Les mises en page de diagramme d'un autre outil ne sont pas importées, mais les relations le sont. Holarch dessine les diagrammes d'assets, de hiérarchie et autres à partir de ces relations.
- Chaque élément importé garde son identifiant XMI, et Faire correspondre les entités existantes par prend par défaut l'ID XMI pour les fichiers XMI : l'import suivant met donc à jour ces éléments. Les relations déjà présentes ne sont pas ajoutées deux fois.
6.5 Nettoyer après l'import
- Le contrôle qualité note la formulation de chaque exigence au regard des qualités d'une bonne exigence. Les contrôles du modèle parcourent tout le modèle à la recherche de lacunes, comme des exigences que rien ne satisfait, des éléments isolés ou des actions que personne ne réalise.
- Correct et Feasible demandent le jugement d'une personne : le contrôle ne les marque donc jamais comme satisfaits. Vous les marquez après avoir examiné l'exigence.
- Elles arrivent de fichiers différents sans liens entre elles. Chaque lien satisfied by alimente dès lors la traçabilité, la couverture et les contrôles du modèle.
Publié par Holarch