Chapitres du cours
Formation · Parcours 6. Migrer vers Holarch · Chapitre 6.3 sur 5
6.3 Exigences depuis Word et ReqIF 2:22
Importer une spécification Word comme document, et le fichier ReqIF d'un fournisseur avec sa hiérarchie et ses liens.
Montre Holarch 2.21.
Ce que vous allez apprendre
- Expliquer quelles parties d'un fichier Word deviennent des sections et lesquelles deviennent des exigences
- Importer une spécification Word comme document d'exigences numéroté
- Importer un fichier ReqIF avec sa hiérarchie, ses attributs et ses relations
- Vérifier une relation importée dans la section Traçabilité
Importez depuis Word la spécification de la charge utile du Plant Inspection Drone, dont les titres deviennent des sections et les phrases « shall » des exigences, et depuis ReqIF les exigences du fournisseur de batteries, avec leur hiérarchie, leurs attributs et une relation refines.
Fichiers de projet
- Projet de départ (.holarch.json ; Gérer les projets → Fichiers de projet ▾ → Importer un projet (.json)…)
- Projet terminé (.holarch.json ; Gérer les projets → Fichiers de projet ▾ → Importer un projet (.json)…)
La vidéo est diffusée depuis holarch.app ; voir la Politique de confidentialité.
Pratique
Faites-le vous-même dans Holarch, 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.
Vérifiez vos connaissances
- 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 ?
Afficher les réponses
Que lit l'import Word comme une section, et que lit-il comme une exigence ?
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.
Un fournisseur peut envoyer du Word ou du ReqIF. Pourquoi demander du ReqIF ?
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.
Une relation ReqIF porte un nom que Holarch ne connaît pas. Que se passe-t-il ?
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.
Pour aller plus loin
Transcription
Afficher la transcription (narration et contenu de l'écran)
Introduction
Chapter three: requirements from Word and ReqIF. Many specifications live in Word, and many suppliers exchange requirements as ReqIF files. Both come in through the same Import and Export page.
We import the payload specification and the battery supplier's requirements into the Plant Inspection Drone project.
Word
The Word file uses heading styles for its sections, and plain sentences with shall for its requirements. That is what the Word import reads. Heading styles or Word's list numbering matter: headings typed as ordinary bold text are read as ordinary text.
On screen: Card: what Holarch reads in Word.
Open Import and Export, and drop the file. Holarch detects Word from the file and analyzes it.
On screen: Import and Export → drop the .docx → Word detected.
Click Continue. The numbering pattern stays automatic, which uses numbered headings and shall sentences. Click Continue for the review: Holarch creates a requirements document with the name of the file, and lists the sections and the requirements under them.
On screen: Continue → Map: numbering → Continue → Review.
Click Import. The document opens, numbered from the Word headings, with each shall sentence as a requirement you can now trace and check.
On screen: Import → the document.
ReqIF
Now the supplier's file. ReqIF is the standard exchange format between requirements tools. Open Import and Export again, and drop the file.
On screen: Import and Export → drop the .reqif → ReqIF detected.
Click Continue. Each requirement in the file is a row. Its ReqIF identifier and its parent rebuild the hierarchy, its type becomes the class, and its attributes map by name: the chapter name to the number, the name, and the text to the description.
On screen: Continue → Map.
Click Continue, check the review, and click Import.
On screen: Continue → Review → Import.
Check the result
The supplier's relations come in as relationships. Select Charge Time, and open Trace: it refines Pack Capacity, just as the file says.
On screen: Select B.4 Charge Time → Trace.
Recap
Let's recap. You imported a Word specification, where headings became sections and shall sentences requirements, and a supplier's ReqIF file, with its hierarchy, attributes and relations.
Next, a whole model from another tool.