Holarch

Exigences

Documents

Écrivez, structurez, numérotez, figez en référence et publiez des spécifications sous forme de vues vivantes du modèle, avec des modèles de document, du texte enrichi, des rapports et une sortie Word.

Utilisation →

Sur cette page
  1. Vue d'ensemble
  2. Concepts
    1. Ce qui fait d'un élément un document
    2. Types de document
    3. Chiffres
    4. Références
  3. Mode d'emploi
    1. Quand et pourquoi
    2. Créer une spécification d'exigences à partir d'un modèle
    3. Rédiger des exigences
    4. Ajouter rapidement de nombreuses exigences
    5. Restructurer
    6. Revoir, figer en référence et publier
    7. Exemple complet : la démo CubeSat EO-1
    8. Conseils et bonnes pratiques
    9. Erreurs courantes
    10. Liens avec les autres fonctions
  4. La liste des documents
  5. La page du document
    1. En-tête de page
    2. Barre d'outils
    3. Volet du plan
    4. Le corps du document
    5. Menu contextuel
    6. Ajout rapide
    7. Inspecteur
  6. Ajouter des éléments
    1. Nouveaux éléments
    2. Autres classes
    3. Documents structurés avec des titres
    4. Entités existantes
  7. Restructurer
    1. Indenter, désindenter et déplacer
    2. Glisser-déposer
    3. Déplacer sous
  8. Numérotation
    1. Renumérotation automatique
    2. Règles du numéro suivant
    3. Renuméroter
    4. Numérotation du document (méta-numéros)
  9. Modèles
    1. Modèles intégrés
    2. Enregistrer un document comme modèle
    3. Gérer les modèles
    4. Modèles enregistrés dans ce navigateur
    5. Appliquer un modèle à un document existant
  10. Éditeur de texte enrichi
    1. Barre d'outils
    2. Tableaux
    3. Images et fichiers
    4. Texte alternatif
    5. Liens et liens intégrés
    6. Contenu dynamique
    7. Outils de texte de l'IA
    8. Coller
    9. Raccourcis du texte enrichi
  11. Rechercher dans le document
  12. Rechercher et remplacer
  13. Menu Rédiger
    1. Définir un attribut sur cette branche
    2. Découper en plusieurs éléments
  14. Menu Contrôler
    1. Statut de traçabilité
    2. Trouver les acronymes
  15. Menu Livrer
    1. Modèles Word
    2. Fichiers Word de l'entreprise
  16. Menu Affichage
  17. Références
    1. Créer une référence
    2. Consulter une référence
    3. Comparer les versions
  18. Rapports
  19. Sortie Word
    1. Légendes, listes et renvois
    2. Configuration du livrable
    3. Format de page
    4. Conversion du texte enrichi
    5. Version avec modifications
    6. Imprimer / PDF
  20. Commentaires
  21. Compilations
    1. Sections générées
    2. Compilation dans Word
  22. Outils d'IA
  23. Raccourcis clavier
  24. Réglages mémorisés dans ce navigateur
  25. Messages
  26. Limites
  27. Voir aussi

Vue d'ensemble

Un document est une spécification, un plan ou une procédure dont les sections et les exigences sont des entités du modèle. Utilisez la page du document pour les rédiger et les restructurer, les numéroter, les figer en référence et les publier vers Word, Excel, ReqIF, Markdown et d'autres formats.

Chaque élément d'un document est une entité. La même exigence apparaît donc aussi dans la base de données, dans les diagrammes, dans la matrice de traçabilité et dans le contrôle de qualité. Une modification faite à l'un de ces endroits apparaît dans le document.

Concepts

Ce qui fait d'un élément un document

  • Un document est une entité Artifact qui remplit l'une de deux conditions :
    • Elle porte une étiquette de type de document : toute étiquette dont le nom se termine par « Document ».
    • Elle est la source of d'au moins un Statement ou un Heading.
  • Ses éléments de premier niveau sont les entités dont le document est source of. Les éléments plus profonds s'y rattachent par des relations decomposed by. Le plan que vous voyez est cet arbre de décomposition.
  • Les éléments sont généralement des Statements (sections, titres, notes, hypothèses) et des Requirements (et leurs sous-classes). Ajoutez toute autre classe avec Autre classe….
  • Les Headings (documents structurés LML 2.0) sont des sections qui contiennent des éléments de n'importe quelle classe. Une sous-section est un Heading sous un Heading (decomposed by). Tout autre élément sous un Heading constitue le contenu de la section : le Heading le contains, l'élément garde son propre numéro, et il est listé avant les sous-sections. Voir Documents structurés avec des titres.
  • Retirer un élément d'un document ne supprime pas l'entité. La supprimer de la base de données, si.

Types de document

Le type est l'étiquette de type de document du document. Il détermine les modèles proposés en premier et si le document s'ouvre en mode papier.

TypeModèles intégrés
Document d'exigencesSpécification d'exigences ; spécification des exigences des parties prenantes (StRS) ; spécification des exigences système (SyRS) ; spécification des exigences logicielles (SRS) ; spécification des exigences d'interface (IRS)
Document de contrôle d'interfaceDocument de contrôle d'interface (ICD)
Document de concept d'opérationsConcept d'opérations
Document d'analyse des besoinsAnalyse des besoins
Document d'exploration de conceptsExploration de concepts ; rapport d'étude de compromis
Document de définition du conceptDéfinition du concept ; description de l'architecture
Document de plan de management de l'ingénierie systèmePlan de management de l'ingénierie système
Document de plan de testPlan de test ; plan de vérification et de validation ; procédure de test ; rapport de test
Document de plan de vérification et validation indépendantesPlan IV&V
Document de plan de management de projetPlan de management de projet ; plan de management des risques ; plan de gestion de configuration
Document de plan de soutien logistique intégréPlan de soutien logistique intégré
Document de procédure opératoire normaliséeProcédure opératoire normalisée

Les modèles des autres types sont listés sous Autres modèles : n'importe quel modèle peut donc lancer n'importe quel document.

Pour ajouter un type de document, ajoutez à la classe Artifact une étiquette dont le nom se termine par « Document » (voir Extensions du schéma). Un document étiqueté Dossier de revue assemble d'autres documents ; voir Compilations.

Chiffres

Chaque élément a un numéro, comme 3.2, affiché avant son nom. Les numéros sont enregistrés sur l'entité : la même exigence affiche donc le même numéro partout. L'exception est la numérotation du document, qui conserve des numéros distincts par document.

Holarch maintient les numéros dans l'ordre pour vous tant que Renuméroter automatiquement après l'ajout ou le déplacement d'éléments est activé (par défaut ; la case se trouve dans Rédiger ▾ → Renuméroter…).

Références

Une référence est un instantané en lecture seule du document. Elle contient :

  • Les éléments du document, leurs attributs et leurs relations, y compris les liens vers les entités situées à un pas en dehors du document.
  • Les paramètres du document.
  • Des enregistrements d'approbation datés, qui ne peuvent pas être modifiés ensuite.

Les références alimentent les rapports de modifications ainsi que les tableaux Historique des révisions et Approbations de la sortie Word.

Sur le service hébergé :

  • Chaque enregistrement d'approbation reçoit l'heure du serveur et le compte qui l'a enregistré, et non l'horloge du navigateur. L'enregistrement affiche « (heure du serveur) · enregistré par {name} », et l'enregistrement est écrit dans le journal d'audit.
  • Seuls les propriétaires du projet peuvent renommer ou supprimer une référence. Pour les autres, Supprimer et le champ de nom sont grisés avec « Seul un propriétaire du projet peut renommer ou supprimer une référence. » La restauration et le rétablissement fonctionnent comme avant.

Dans l'application de bureau, les enregistrements portent la date à laquelle votre ordinateur les a enregistrés.

Mode d'emploi

Quand et pourquoi

Utilisez un document lorsque le livrable est une spécification que quelqu'un lira, revoira et signera. Exemples :

  • Une spécification des exigences système pour la SRR.
  • Un concept d'opérations au début du développement du concept.
  • Un plan de test avant le début de la vérification.
  • Une procédure d'exploitation.

Rédigez les exigences ici, puis tracez-les vers les fonctions, les actifs et les tests ailleurs dans le modèle. Le document répond à la question « Que dit cette spécification, dans quel ordre, et qu'est-ce qui a changé depuis son approbation ? »

Dans le déroulement de l'ingénierie système, les documents viennent en premier : besoins des parties prenantes et exigences système. Ils alimentent l'analyse fonctionnelle et l'allocation. Lors des revues, ils reviennent sous forme de livrables approuvés et figés en référence, avec des rapports de traçabilité.

Créer une spécification d'exigences à partir d'un modèle

  1. Dans le rail de navigation, ouvrez Besoins et exigences → Documents.
  2. Cliquez sur + Nouveau document dans l'en-tête de la page.

    Nouveau document s'ouvre.

  3. Saisissez le Nom (obligatoire). Le numéro et la description peuvent être ajoutés plus tard dans l'inspecteur.
  4. Sous Modèle, Modèles pour affiche les modèles d'un type de document, par exemple Document d'exigences. Chaque carte montre les premières sections en aperçu. Choisissez l'un des éléments suivants :
    • Vierge : un document vide du type affiché.
    • Une entrée Modèles de l'organisation (serveurs Holarch, hébergés ou auto-hébergés), publiée par les administrateurs de votre organisation. Le modèle par défaut de l'organisation pour ce type est présélectionné.
    • Une entrée Modèles de projet, enregistrée dans ce projet.
    • Une entrée Modèles intégrés.
    • Un modèle d'un autre type de document, sous Autres modèles.

      Le document prend le type du modèle choisi.

  5. Sélectionnez Inclure les consignes de rédaction pour ajouter un court guide de rédaction à chaque section d'un modèle intégré.
  6. Cliquez sur Créer.

    Le document s'ouvre avec les sections numérotées du modèle, par exemple 1 Document Control, 1.1 Revision History, 1.2 Approvals, 2 Introduction … Si vous avez inclus les consignes de rédaction, supprimez-les au fur et à mesure que vous rédigez chaque section.

Rédiger des exigences

  1. Cliquez sur la ligne d'une section pour la sélectionner.
  2. Cliquez sur + Enfant, ou appuyez sur ⌥⌘↵ / Ctrl+Alt↵.

    Une nouvelle ligne nommée « Nouvelle exigence » apparaît avec son numéro, et son nom est prêt à être saisi.

  3. Saisissez le nom et appuyez sur Enter.
  4. Cliquez sur la description et rédigez l'énoncé en « shall ».
  5. Appuyez sur ⌘↵ / Ctrl↵ ou cliquez ailleurs pour enregistrer la description.
  6. Pour ajouter l'exigence suivante au même niveau, appuyez de nouveau sur ⌘↵ / Ctrl↵.

+ Nouveau … (en-tête de la page) ajoute l'élément à la fin du document ; + Après et + Enfant l'ajoutent à côté de l'élément sélectionné (l'infobulle de + Nouveau … le précise). Les trois ajoutent la dernière classe choisie dans leurs menus ▾ (Requirement par défaut). Ce navigateur mémorise le choix.

Ajouter rapidement de nombreuses exigences

Utilisez Ajout rapide en bas du document pour saisir des exigences l'une après l'autre.

  1. Dans la barre Ajout rapide, choisissez la section, par exemple Sous 4 Command and Data Handling.
  2. Saisissez le texte de l'exigence.
  3. Appuyez sur Enter.

    Holarch ajoute l'exigence et la nomme d'après les mots qui suivent « shall ». Le curseur reste dans le champ pour la suivante.

Restructurer

Modifiez le plan avec les touches, par glisser-déposer ou depuis le menu contextuel. Avec la renumérotation automatique activée, les numéros se mettent à jour après chaque déplacement.

  • Avec les touches : sélectionnez une ligne, puis appuyez sur :
    • ⌥⇧→ / Alt+Shift+→ pour l'indenter sous l'élément du dessus.
    • ⌥⇧← / Alt+Shift+← pour la désindenter.
    • ⌥ / Alt+↑ ou ⌥ / Alt+↓ pour la déplacer parmi les éléments de même niveau.
    • Tab ne sert pas à indenter : il passe donc toujours au champ suivant.
  • Par glisser-déposer : faites glisser des lignes dans le volet Plan. Déposez sur le bord supérieur ou inférieur d'une ligne pour placer l'élément avant ou après elle. Déposez au milieu pour en faire un enfant.
  • Depuis le menu : cliquez avec le bouton droit sur la ligne et choisissez Déplacer sous ▸, puis choisissez le nouveau parent dans la liste (saisissez du texte pour la filtrer). Les enfants suivent.

Revoir, figer en référence et publier

  1. Choisissez Contrôler ▾ → Contrôler la qualité et corrigez les exigences faibles (voir Exigences).
  2. Choisissez Contrôler ▾ → Statut de traçabilité… et liez les exigences qui ne sont pas encore allouées ou vérifiées.
  3. Soldez les éléments ouverts dans Contrôler ▾ → Registre TBD/TBR.
  4. Passez en revue Contrôler ▾ → Liens à revoir.
  5. Dans le cartouche, cliquez sur Version ▾ et choisissez Enregistrer la référence….
  6. Saisissez un nom, par exemple « SRR Baseline ».
  7. Ajoutez une ligne d'approbation par approbateur, avec le nom, le rôle et la déclaration.
  8. Cliquez sur Créer.

    La référence apparaît dans Version ▾, et le bouton la nomme comme dernière référence.

  9. Cliquez sur Livrer ▾ → Spécification (Word).

    Le fichier Word se télécharge avec les options du modèle Spécification, y compris les tableaux Historique des révisions et Approbations remplis à partir des références.

  10. Ouvrez le fichier dans Word et acceptez la demande de mise à jour des champs.

    La table des matières se remplit.

Pour faire revoir le document avant la référence, cliquez sur Demander une revue à côté du type de document. Les relecteurs du projet le trouvent sous Documents à revoir dans Mon travail et l'approuvent ou le rejettent à cet endroit ou dans le bandeau sous le titre.

Après des modifications ultérieures, voyez ce qui a changé :

  1. Cliquez sur Version ▾ → Comparer les versions….
  2. Choisissez la référence sous De et Version actuelle sous À.

    Le rapport liste chaque ajout, suppression et modification. Cliquez sur Modifications (Excel) pour le télécharger, ou sur Version avec modifications (Word) pour un fichier Word avec suivi des modifications.

Exemple complet : la démo CubeSat EO-1

Créez la démonstration depuis Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration. Ouvrez ensuite Besoins et exigences → Documents → EO-1 System Requirements Specification (numéro SRS-001).

Lire la structure. Six sections contiennent les exigences :

  • 1 Mission Imaging
  • 2 Attitude Determination and Control
  • 3 Electrical Power
  • 4 Command and Data Handling
  • 5 Communications
  • 6 Ground Segment and Operations

L'exigence 1.6 Revisit Time a deux enfants, 1.6.1 Ground Track Repeat et 1.6.2 Off-Nadir Imaging. La colonne Score de qualité affiche des barres. 2.5 Safe Mode Recovery et 6.4 Operator Interface ont un score faible.

Corriger une formulation faible :

  1. Appuyez sur ⌘F / Ctrl+F et saisissez should.

    Le compteur affiche les correspondances.

  2. Appuyez sur Enter jusqu'à ce que 2.5 soit marquée.

    Son texte est « The spacecraft should recover from safe mode quickly and resume imaging as appropriate ».

  3. Réécrivez-la, par exemple « The spacecraft shall resume imaging within 24 hours of a safe mode entry. »

    La colonne du score affiche une étiquette Périmé jusqu'à ce que vous relanciez le contrôle.

Découper une exigence composée :

  1. Sélectionnez 6.4 Operator Interface (« …shall be user friendly and/or easy to use. »).
  2. Cliquez dessus avec le bouton droit et choisissez Découper en plusieurs éléments….
  3. Cliquez sur ✦ Proposer un découpage.

    Vous obtenez une exigence mesurable par ligne.

  4. Décochez les lignes dont vous ne voulez pas, ou cliquez sur Joindre pour fusionner une ligne avec la suivante, puis cliquez sur Appliquer.

Ajouter rapidement une exigence :

  1. Dans Ajout rapide, choisissez Sous 3 Electrical Power.
  2. Saisissez « The EPS shall provide a 5 V regulated bus within 3%. » et appuyez sur Enter.

    Elle est ajoutée en 3.7, nommée « Provide A 5 V Regulated ».

Voir ce qui a changé depuis la SRR :

  1. Cliquez sur Version ▾ dans le cartouche et choisissez SRR Baseline.

    Le bandeau indique « Référence « SRR Baseline », lecture seule, enregistrée le {date} ». Les approbateurs sont J. Rivera, Systems Lead ; R. Okafor, Mission Principal Investigator ; et L. Brandt, Program Manager.

  2. Cliquez sur Comparer à l'actuel.

Le rapport liste :

  • 3.1 Orbit Average Power : description passée de 28 W à 30 W, et nouvelle justification.
  • 2.4 Target Slew : statut Brouillon → En revue.
  • L'ajout de 4.4 Downlink Encryption, avec ses deux nouveaux liens satisfies.
  • Vos propres modifications de cette session.

Publier :

  1. Cliquez sur Revenir à l'actuel.
  2. Cliquez sur Livrer ▾ → Spécification (Word).

    Le fichier Word commence par le titre et « Requirements Document · No. SRS-001 ». Suivent une ligne d'historique des révisions pour SRR Baseline (« Référence initiale ») et les trois approbations, puis les exigences numérotées.

Conseils et bonnes pratiques

  • Rédigez une exigence par ligne, avec un seul « shall ». Découper en plusieurs éléments… et le contrôle de qualité aident à garder les exigences singulières.
  • Gardez les sections comme Statements et les exigences comme Requirements. Le contrôle de qualité ne note que les Requirements. Les rapports réservés aux exigences (RVTM, VCRM, RTM) ignorent les Statements.
  • Créez une référence avant chaque revue et avant les réécritures importantes. Le rétablissement et les rapports de modifications en dépendent.
  • Un clic sur une ligne la sélectionne. Pour modifier, cliquez sur le champ lui-même, ou appuyez sur Enter ou F2 sur la ligne sélectionnée.
  • Utilisez Affichage ▾ → Papier pour lire le document comme une page, sans colonnes d'attributs. Désactivez-le pour modifier les attributs en colonnes.
  • Surveillez les points de statut de traçabilité : une exigence est prête pour la revue lorsque son point est vert.

Erreurs courantes

  • L'ajout est grisé. Un filtre ou un tri est actif (Vue filtrée : édition désactivée. Effacer le filtre dans la barre d'outils), ou vous consultez une référence. Cliquez sur l'avertissement, ou cliquez sur Revenir à l'actuel.
  • Les numéros ont sauté après un déplacement. La renumérotation automatique réécrit les numéros du groupe d'éléments de même niveau. Pour garder des numéros définis à la main, décochez Renuméroter automatiquement après l'ajout ou le déplacement d'éléments dans Rédiger ▾ → Renuméroter…, ou verrouillez les éléments dont les numéros ne doivent pas changer.
  • Un élément retiré est toujours dans la base de données. Retirer le sort seulement du document. Pour le supprimer, choisissez Supprimer l'élément… dans le message qui suit, faites ⇧ / Shift-clic sur Retirer, ou appuyez sur ⇧Delete / Shift+Delete.
  • Une numérotation en lettres ou en chiffres romains est devenue décimale. La renumérotation automatique et Renuméroter… produisent des numéros décimaux (1, 1.1, 1.1.1). Pour garder des annexes numérotées par lettres, désactivez la renumérotation automatique et numérotez-les à la main.

Liens avec les autres fonctions

  • Entrées :
    • Importer crée des documents à partir de Word, Excel, CSV, ReqIF, XMI et texte.
    • Les modèles créent le squelette.
    • Les générateurs d'IA ajoutent des exigences.
  • Sorties :
  • Partout ailleurs : chaque élément est une entité. Il apparaît dans la base de données, la vue d'élément et des diagrammes comme Spider et Tree.

La liste des documents

La liste des documents affiche chaque document du projet sous forme de carte, dans la même galerie que la page Diagrammes. Ouvrez-la avec Besoins et exigences → Documents.

Chaque carte affiche :

  • Une vignette du plan du document.
  • Le nom, le type et la date de la dernière modification (la plus récente modification du document ou de l'un de ses éléments).
  • « N éléments · N exigences ».
  • Qualité moyenne N %, lorsque les exigences ont des scores.
  • N TBD/TBR : les éléments ouverts.
CommandeCe qu'il fait
Rechercher des documents…Affiche les cartes dont le nom, le numéro ou la description contient le texte.
TriModifiés récemment (par défaut), Numéro (ordre du plan), Nom, Classe.
Pastilles de typeTous et une pastille par type de document avec son nombre.
Afficher plus (N)Affiche plus de cartes.
Importer (en-tête de la page)Ouvre la page d'importation (Importer et exporter).
+ Nouveau document (en-tête de la page)Ouvre Nouveau document.
⋯ sur une carteOuvrir, Ouvrir dans ▸ Vue d'élément, Dupliquer… et Supprimer….

Supprimer… ouvre Supprimer le document : « Supprime « … ». Ses N sections restent dans le projet comme éléments. » Lorsque certaines sections ne figurent dans aucun autre document, Supprimer aussi les N sections qu'aucun autre document n'utilise les supprime aussi. Annuler restaure tout.

Cliquez sur une carte pour ouvrir le document.

L'adresse documents/<id> ouvre directement un document. Ajoutez ?baseline=<id> ou ?baseline=latest pour ouvrir une référence, ?find=<text> pour lancer une recherche, ou ?comments=1 pour afficher les commentaires du document dans l'inspecteur.

La page du document

La page du document affiche un document sous forme de plan et de tableau, avec l'élément sélectionné dans l'inspecteur.

  • + Nouveau {Class} ajoute un élément de la classe courante à la fin du document. Son ▾ ouvre le menu des classes :
    • Ajouter un élément existant….
    • Insérer un document… et Insérer une section générée… (compilations uniquement).
    • Sous l'en-tête Ajouter à la fin : chaque classe Statement et Titre (la classe courante porte un ✔), et Autre classe….
  • ✦ IA ▾ (dans la barre supérieure) regroupe les outils d'IA du document (voir Outils d'IA).

Barre d'outils

CommandeCe qu'il fait
+ AprèsAjoute un élément après l'élément sélectionné, au même niveau (⌘↵ / Ctrl↵). Son ▾ ajoute Ajouter un élément existant…, Ajouter un enfant (⌥⌘ / Ctrl+Alt↵) et la liste des classes sous Ajouter après l'élément sélectionné.
+ EnfantAjoute un enfant à l'élément sélectionné (⌥⌘↵ / Ctrl+Alt↵). Son ▾ propose Ajouter un élément existant… et la liste des classes sous Ajouter un enfant.
⇤ / ⇥Désindenter (⌥⇧← / Alt+Shift+←) / indenter (⌥⇧→ / Alt+Shift+→) l'élément sélectionné.
↑ / ↓Monter ou descendre l'élément sélectionné parmi les éléments de même niveau (⌥ / Alt+↑ / ⌥ / Alt+↓).
RetirerSort d'un coup du document les éléments sélectionnés et leurs sous-arbres (Delete fait de même). Retiré du document. propose Annuler et Supprimer l'élément…. ⇧ / Shift-clic ou ⇧Delete / Shift+Delete supprime les éléments et leurs enfants après une confirmation qui nomme ce qui est supprimé. Esc ou le × de l'inspecteur efface la sélection.
Rédiger ▾Ajouter, insérer, générer et modifier du contenu (voir Menu Rédiger).
Contrôler ▾Qualité, contrôles du modèle, statut de traçabilité, liens à revoir, TBD/TBR et commentaires de ce document, avec les nombres (voir Menu Contrôler).
Livrer ▾Configuration du livrable et de la page, modèle Word, versions et exports regroupés par sortie (voir Menu Livrer).
Affichage ▾Bascules directes pour ce document : Papier, Volet du plan, Statut de traçabilité et Colonnes (voir Menu Affichage).
Vue filtrée : édition désactivée. Effacer le filtreApparaît tant qu'un filtre de classe ou d'étiquette ou un tri de colonne est actif. Cliquez pour les effacer.
RechercherOuvre la zone de recherche (⌘F / Ctrl+F).

Les boutons de structure sont désactivés lorsque :

  • Rien n'est sélectionné.
  • L'élément sélectionné est verrouillé.
  • Un filtre ou un tri est actif.
  • Vous consultez une référence.

Volet du plan

Le volet du plan, à gauche, affiche la hiérarchie du document, avec un filtre en haut. Il n'y a pas d'onglets : les références se trouvent dans Version ▾ du cartouche, et les commentaires s'ouvrent dans l'inspecteur.

  • ‹ masque le volet, et › sur le bord gauche le réaffiche (aussi Affichage ▾ → Volet du plan).
  • Faites glisser son bord droit pour le redimensionner (de 180 à 500 px).
  • Sélectionner un élément ouvre l'inspecteur à côté du volet ; le volet reste ouvert.
  • Lorsque le volet et le document disposent ensemble de moins de 900 px (en comptant l'inspecteur comme ouvert, pour que la sélection d'un élément ne change rien), le volet se replie. Il s'ouvre alors en superposition depuis ›. Cliquez à l'extérieur pour le fermer.

Filtrer en haut du volet :

  • Filtrer le plan restreint le plan aux éléments dont le numéro ou le nom contient le texte, y compris ceux qui sont réduits. Leurs parents restent dans le plan, estompés, pour le contexte. Le document n'est pas filtré.
  • Puces de classe, une par classe du document avec son nombre (affichées lorsque le document contient plus d'une classe). Cliquez sur une puce pour n'afficher que cette classe et ses sous-classes dans le document ; cliquez de nouveau pour afficher toutes les classes. Cliquez avec le bouton droit sur une puce pour {Class} et sous-classes, {Class} seulement et Effacer le filtre de classe.
  • Puces d'étiquette, une par étiquette utilisée dans le document, avec les nombres. Cliquez sur des puces pour n'afficher que les éléments portant toutes les étiquettes choisies. Pour les éléments portant l'une de plusieurs étiquettes, utilisez une requête de la base de données.
  • Au-delà de six puces, elles se replient derrière Filtrer par classe ou label (n) ; repliées, seules les puces actives restent visibles. Moins de filtres les replie de nouveau. Ce navigateur mémorise le choix.
  • Effacer le filtre apparaît tant qu'un filtre ou un tri est actif. Les lignes filtrées conservent leur indentation. L'édition est désactivée tant qu'un filtre ou un tri est actif.

Le plan :

  • Chaque élément a sa pastille de couleur, son numéro et son nom, 🔒 lorsqu'il est verrouillé, et les bascules ▾/▸.
  • Cliquez sur une entrée pour sélectionner l'élément et y faire défiler le document.
  • Faites glisser pour réordonner (voir Glisser-déposer). Les cibles de dépôt non valides sont marquées et refusées : un élément ne peut pas aller sous son propre enfant, sous un élément verrouillé, ni sous une classe qui ne peut pas être decomposed by lui.
  • Les lignes de la partie visible du document sont mises en évidence, et le plan défile avec le document. Il reste en place tant que vous pointez dessus, y travaillez ou l'avez fait défiler dans les deux dernières secondes.
  • Les niveaux profonds qui ne tiennent pas affichent une étiquette de niveau L{n} au lieu d'une indentation supplémentaire.

Le corps du document

Le corps commence par le cartouche : le type et les étiquettes du document, le nombre d'éléments, « numéroté par document » lorsque les numéros de document sont activés, 💬 n commentaires ouverts (s'il y en a ; voir Commentaires) et Version ▾ (voir Références). Version ▾ indique Version actuelle, Actuel · dernière référence {name} ou Référence : {name}. En dessous :

  • N° et le titre : cliquez pour modifier le numéro et le nom du document, ou atteignez-les avec Tab et appuyez sur Enter ou F2.
  • La description du document : cliquez pour la modifier dans l'éditeur de texte enrichi, ou atteignez-la avec Tab et appuyez sur Enter ou F2.
  • Le tableau. La colonne Entité contient chaque élément : bascule, numéro, nom, badges et description. Les autres colonnes sont les colonnes d'attributs choisies dans Affichage ▾ → Colonnes ▸ : Statut, Méthode de vérification et Score de qualité tant que vous ne les changez pas. La vue Papier n'en a aucune.

Chaque ligne affiche :

  • ▾/▸ pour réduire ou développer ses enfants.
  • Le numéro et le nom. Cliquez pour modifier, ou atteignez l'un d'eux avec Tab et appuyez sur Enter ou F2. Enter enregistre et Esc annule ; le focus reste sur le champ. Les sauts de ligne collés deviennent des espaces.
  • Badges :
    • 🔒 : l'élément est verrouillé.
    • ⚡ : l'élément porte des consignes. Pointez dessus pour les lire.
    • 💬 n : commentaires non résolus. Cliquez pour les ouvrir dans l'inspecteur.
    • ⚠ Revoir : une exigence amont a changé.
    • Le badge de classe.
    • Le point de statut de traçabilité (exigences uniquement ; voir Statut de traçabilité).
  • La description, modifiée dans l'éditeur de texte enrichi.
  • Une barre colorée sur le bord gauche : bleue lorsque l'élément n'a pas changé depuis la dernière référence, ambre lorsqu'il est nouveau ou modifié.
  • Cellules d'attributs :
    • Étiquettes affiche des puces avec × pour retirer et + pour ajouter. Le menu liste les étiquettes que la classe autorise, ou « Plus d'autres étiquettes ».
    • Les attributs texte se modifient sur place. Les autres attributs utilisent l'éditeur de leur type.
    • Score de qualité affiche une barre colorée : verte à partir de 67 %, ambre de 34 % à 66 %, rouge en dessous. Elle affiche une étiquette Périmé avec une icône d'horloge lorsque le texte a changé depuis le dernier contrôle ; pointez dessus pour le motif.
    • « — » signifie que la classe n'a pas cet attribut.

Tri et largeur des colonnes :

  • Cliquez sur un en-tête de colonne pour trier par ordre croissant, de nouveau pour l'ordre décroissant, et une troisième fois pour désactiver le tri.
  • Le tri liste les éléments à plat, sans hiérarchie, et suspend la rédaction.
  • Faites glisser le bord droit d'un en-tête pour redimensionner la colonne. La colonne Entité fait au moins 300 px de large, les autres au moins 80 px. Les largeurs sont conservées par document dans ce navigateur.
  • Une ligne vide sépare les sections de premier niveau.

Sélection des lignes :

  • Cliquez sur une ligne pour la sélectionner. Un clic ne fait que sélectionner ; pour modifier, cliquez sur le champ, ou appuyez sur Enter ou F2 sur la ligne.
  • Pour désélectionner, cliquez dans l'espace vide sous le tableau, appuyez sur Esc ou cliquez sur ✕.
  • ↑ et ↓ déplacent la sélection d'une ligne à l'autre.
  • ⌘ / Ctrl-clic (Ctrl-clic sous Windows et Linux) ajoute un élément à la sélection ou l'en retire.
  • ⇧ / Shift-clic sélectionne la plage allant du dernier élément cliqué à celui-ci, dans l'ordre affiché (avec tri ou filtre éventuels). ⌘ / Ctrl+⇧ / Shift-clic ajoute cette plage à la sélection.
  • ⌘A / Ctrl+A sur un élément actif (hors édition) sélectionne tous les éléments affichés. ⇧ / Shift+↑ et ⇧ / Shift+↓ étendent la sélection depuis l'élément actif.
  • Les mêmes gestes fonctionnent dans le Plan. La barre d'outils affiche le nombre (« 21 sélectionnés »). Un simple clic, ou Esc, revient à un seul élément.
  • Les clics dans un champ en cours de modification gardent leur comportement de texte : ⇧ / Shift-clic y étend la sélection de texte.

Menu contextuel

Cliquez avec le bouton droit sur un élément du document (son numéro, son nom, ses badges ou l'espace autour) ou sur une entrée du Plan pour ouvrir son menu au pointeur. Au clavier, placez le focus sur la ligne ou l'entrée du plan et appuyez sur Shift+F10 ou la touche Menu ; le menu s'ouvre à l'élément et Esc y ramène le focus. Sur un écran tactile, touchez l'élément de façon prolongée. L'élément devient la sélection.

Le menu commence par jusqu'à trois actions suggérées choisies d'après l'état de l'élément, chacune avec sa raison à droite : par exemple ✦ Ajouter des critères mesurables… (échec : Non ambiguë), ✦ Générer un cas de test… (non vérifiée), Examiner le lien… (amont modifié) ou Résoudre le TBD… (TBD ouvert). S'il n'y a rien à corriger, il propose ✦ Vérifier avec l'IA… et ✦ Interroger l'IA sur cet élément…. ✦ Plus d'IA ▸ liste toutes les actions d'IA de l'élément. Les règles et la liste complète se trouvent dans Modèle et base de données. Chaque action d'IA affiche son résultat pour revue avant toute modification. Lorsque l'IA est désactivée, la partie IA est une seule ligne grisée qui en donne la raison.

Les commandes après le séparateur. Une touche affichée à droite d'une commande fait la même chose au clavier (voir Raccourcis clavier) :

CommandeCe qu'il fait
Aller àPlan uniquement. Fait défiler le document jusqu'à l'élément et y place le focus (Enter sur l'entrée du plan).
OuvertureOuvre la Vue de l'élément.
Renommer…Change le nom. F2 sur un élément actif du document modifie le nom sur place.
Ajouter {class} aprèsAjoute un élément de la classe courante après celui-ci, comme + Après (⌘↵ / Ctrl↵).
Ajouter un enfant {class}Ajoute un élément de la classe courante sous celui-ci, comme + Enfant (⌥⌘↵ / Ctrl+Alt↵).
Indenter, DésindenterComme ⇥ et ⇤ dans la barre d'outils (⌥⇧→ / Alt+Shift+→ et ⌥⇧← / Alt+Shift+←).
Monter, DescendreComme ↑ et ↓ dans la barre d'outils (⌥ / Alt+↑ et ⌥ / Alt+↓).
Status ▸, Priorité ▸Définit l'attribut ; la valeur actuelle est cochée.
Relier à ▸Liste d'abord les relations les plus utilisées pour la classe, puis Toutes les relations ▸ avec chaque relation que la classe autorise. En choisir une ouvre un sélecteur pour les entités cibles.
Afficher dans le diagramme ▸Liste les types de diagramme qui peuvent afficher l'élément ; en choisir un l'ouvre.
Copier le lienCopie un lien vers la vue d'élément de l'élément.
Copier le numéroCopie le numéro de l'élément.
Ouvrir dans ▸Vue d'élément, Historique…, les diagrammes qui peuvent afficher l'élément (Hierarchy, Tree, Spider, Action, Asset, Risk, Timeline), Matrice de traçabilité, Qualité des exigences et Analyse fonctionnelle.
Déplacer sous ▸Une liste filtrable à la saisie des éléments qui peuvent contenir celui-ci, indentés dans l'ordre du document, et Niveau supérieur du document lorsqu'il a un parent. Les enfants suivent.
Découper en plusieurs éléments…Voir Découper en plusieurs éléments.
Changer de classe…Ouvre Changer de classe (la même boîte de dialogue que dans la base de données ; voir Modèle et base de données).
Renuméroter à partir d'ici…Ouvre Renuméroter pour cet élément, les éléments de même niveau qui le suivent et leurs enfants.
Définir un attribut sur cette branche…Voir Définir un attribut sur cette branche.
Verrouiller / DéverrouillerVerrouille l'élément contre les modifications, ou le déverrouille.
Retirer de ce documentSort l'élément et ses enfants du document (Delete). Les entités restent dans le projet ; le message propose Annuler et Supprimer l'élément….
Supprimer l'élément…Supprime l'élément et ses enfants après confirmation (⇧Delete / Shift+Delete).

Chaque commande peut être défaite par une seule annulation. Les commandes qui ne peuvent pas s'appliquer sont grisées, et leur infobulle en donne la raison :

  • Dans une référence, ou avec un accès en lecture seule, seuls Aller à, Ouvrir, Afficher dans le diagramme ▸, Copier le lien et Copier le numéro fonctionnent. Dans une référence, les suggestions et les actions ✦ IA sont aussi grisées.
  • Sur un élément verrouillé, Renommer…, Statut ▸, Priorité ▸, Relier à ▸, les déplacements et Supprimer l'élément… sont grisés.
  • Tant qu'un filtre ou un tri est actif, l'ajout et le déplacement sont grisés (« Effacez d'abord le filtre ou le tri »).
  • Les commandes qui déplaceraient l'élément au-delà du début ou de la fin de son niveau sont grisées (par exemple Monter sur le premier élément).

Plusieurs éléments sélectionnés. Un clic droit sur un élément de la sélection agit sur tous les éléments sélectionnés. Le menu affiche N sélectionnés et propose les actions groupées ✦ (✦ Vérifier avec l'IA (n exigences)…, ✦ Reformuler (n) ▸, ✦ Générer des cas de test (n)…, ✦ Interroger l'IA sur ces éléments (n)…, ✦ Suggérer des traces (n)… ; voir L'IA sur plusieurs éléments sélectionnés), Définir le statut ▸, Définir la priorité ▸, Ajouter au document ▸, Retirer n de ce document et Supprimer n éléments… (après confirmation ; les enfants des éléments sélectionnés partent avec eux). Les commandes portant sur un seul élément (Aller à, Ouvrir, Renommer…, l'ajout, l'indentation et le déplacement) restent listées mais grisées, avec la raison « Agit sur une seule entité ». Chaque commande est une étape d'annulation. Un clic droit sur un élément hors de la sélection en fait le seul élément sélectionné.

La description et tout champ en cours de modification gardent le menu propre au navigateur, pour que vous puissiez y copier, coller et vérifier l'orthographe. ⌥ / Alt-clic droit affiche le menu du navigateur n'importe où.

Ajout rapide

Ajout rapide vous permet de saisir des exigences à la suite sans utiliser la barre d'outils. La barre sous le document contient Ajout rapide, la liste des sections, le champ de texte et Ajouter. La liste des sections propose Fin du document et Sous {number name} pour chaque section de premier niveau.

Saisissez une exigence et appuyez sur Enter ou cliquez sur Ajouter. Le nouvel élément reçoit :

  • La classe courante.
  • Le texte comme description.
  • Un nom formé des premiers mots qui suivent « shall », « must », « will » ou « should » : jusqu'à cinq mots, avec une majuscule à chaque mot.

Le champ accepte jusqu'à 2 000 caractères. Tant qu'un filtre ou un tri est actif, le champ indique « Effacez le filtre ou le tri pour ajouter des entités ».

Inspecteur

L'élément sélectionné s'ouvre dans l'inspecteur à droite, avec le panneau d'entité complet (voir Modèle et base de données).

  • Dans un document, les relations decomposed by et decomposes y sont en lecture seule, car c'est le plan qui les contrôle.
  • Le × de l'en-tête (Esc) efface la sélection. Affichage ▾ → Réduire les enfants replie les sections sous l'élément sélectionné.
  • Les éléments verrouillés s'ouvrent en lecture seule.

Ajouter des éléments

Nouveaux éléments

  • + Nouveau {Class} ajoute à la fin.
  • + Après ajoute après l'élément sélectionné.
  • + Enfant ajoute le dernier enfant de l'élément sélectionné, et le parent se développe.
  • Sans sélection, + Après et + Enfant ajoutent à la fin.

Un nouvel élément est nommé « Nouveau {Class} ». Il est sélectionné, et son nom s'ouvre en modification.

Autres classes

Autre classe… ouvre Ajouter un élément au document avec Classe (n'importe quelle classe) et Nom. Utilisez-le pour des éléments qui ne sont pas des Statements, comme la description d'un Asset ou un Test Case dans un plan de test.

Documents structurés avec des titres

Un Heading est une section d'un document (l'approche des artefacts structurés de LML 2.0). Utilisez des Headings lorsqu'une section mélange des classes, par exemple des exigences, des actions et des risques, ou lorsque la même exigence figure dans plusieurs documents.

  1. Choisissez Titre dans un menu de classes (+ Nouveau ▾, + Après ▾ ou + Enfant ▾). Un Heading de premier niveau a le document comme source of ; sous un autre Heading, c'est une sous-section numérotée.
  2. Sélectionnez le Heading et utilisez + Enfant ▾ pour ajouter son contenu : un nouvel élément de n'importe quelle classe, ou Ajouter un élément existant…. Le Heading contains l'élément.
  3. Le contenu garde son propre numéro : l'ajout, le déplacement et Renuméroter… numérotent les Headings et laissent les numéros du contenu tels quels, si bien qu'une exigence comme RQ.CLN.1 se lit de la même façon dans tous les documents. Le contenu d'une section est listé avant les sous-sections.

Déplacer du contenu vers un autre Heading (glisser, Déplacer sous ▸) déplace son lien contains. Les contrôles du modèle comptent une exigence contenue par un Heading comme placée dans un document.

Pour consigner l'origine d'une exigence, liez-la à l'Artifact source avec originated by (inspecteur → Relations ; l'Artifact la liste sous originates). Un projet créé avant les Headings garde son schéma ; Schéma → Ajouter les nouveaux éléments intégrés… ajoute Heading, contains et originates.

Exemple dans la démonstration CubeSat EO-1 : la section 7 Applicable Documents de EO-1 System Requirements Specification est un Heading. Son contenu est formé des deux normes du projet, qui gardent leurs numéros STD-1 et STD-2. STD-1 originates l'exigence 3.4 Bus Regulation et STD-2 originates 5.2 UHF Command Uplink.

Entités existantes

Ajouter un élément existant… ouvre un sélecteur d'entités. Le sélecteur exclut le document et ses éléments actuels. L'entité est ajoutée avec toute sa décomposition. Lorsqu'elle apporte des enfants, le message indique « {entity} ajouté avec N entités enfants ».

Restructurer

Indenter, désindenter et déplacer

  • Indenter fait de l'élément le dernier enfant de l'élément de même niveau situé au-dessus. Le premier élément d'un groupe ne peut pas être indenté.
  • Désindenter fait de l'élément l'élément de même niveau qui suit son parent.
  • Monter/Descendre échange l'élément avec son voisin. Les éléments verrouillés et les voisins verrouillés ne bougent pas.
  • Lorsqu'un déplacement n'est pas possible, le message indique « L'entité sélectionnée ne peut pas aller plus loin dans ce sens. »

Glisser-déposer

Faites glisser dans le volet Plan. La liste défile lorsque vous approchez de son bord supérieur ou inférieur. L'endroit où vous déposez détermine le résultat :

  • 28 % supérieurs d'une ligne : l'élément se place avant elle.
  • 28 % inférieurs d'une ligne : l'élément se place après elle.
  • Milieu d'une ligne : l'élément devient son enfant.
  • Le nom du document en haut : l'élément devient un élément de premier niveau, à la fin.

Déplacer sous

Cliquez avec le bouton droit sur un élément et choisissez Déplacer sous ▸. La liste contient les éléments qui peuvent le prendre comme enfant, indentés dans l'ordre du document, et Niveau supérieur du document lorsque l'élément a un parent. Saisissez du texte pour filtrer la liste, puis choisissez le nouveau parent. Les enfants suivent ; le message indique « {item} déplacé ».

La liste exclut le sous-arbre de l'élément lui-même, son parent actuel, les éléments verrouillés et les parents que le schéma n'autorise pas. Lorsque le déplacement échoue, le message indique « L'élément ne peut pas aller là : le nouveau parent se trouve à l'intérieur, ou l'élément est verrouillé. Choisissez un autre parent ou déverrouillez-le. »

Numérotation

Renumérotation automatique

Renuméroter automatiquement après l'ajout ou le déplacement d'éléments est activé par défaut ; modifiez-le dans Rédiger ▾ → Renuméroter…. Tant qu'il est activé, ces actions renumérotent le groupe d'éléments de même niveau concerné et tous les descendants : ajout, déplacement, indentation, désindentation, retrait et découpage.

  • Les éléments de premier niveau reçoivent le modèle de numérotation du document avec un numéro courant. Il commence au premier numéro du document : 1, sauf modification dans Renuméroter….
  • Les enfants reçoivent le numéro de leur parent, un point et un numéro courant (3, 3.1, 3.1.1).
  • Les éléments verrouillés et les entrées de glossaire (éléments étiquetés Acronym, dont le numéro est le terme) gardent leurs numéros mais occupent quand même une position.

Lorsqu'elle est désactivée :

  • Un nouvel élément reçoit le numéro qui suit celui de l'élément précédent. Un premier enfant reçoit le numéro du parent suivi de .1.
  • Les numéros existants ne changent pas.
  • Déplacer un élément ne renumérote que le sous-arbre déplacé.
  • Monter/Descendre échange les deux numéros.

Règles du numéro suivant

Pour poursuivre une séquence, Holarch incrémente la dernière partie du numéro précédent. Il conserve les séparateurs et un point, deux-points ou une parenthèse final.

  • Chiffres : 1.9 → 1.10, 2. → 3.
  • Lettres : a → b, z → aa, Z → AA, Appendix A → Appendix B
  • Chiffres romains de deux lettres ou plus : IV → V, IX → X. Une seule lettre compte comme une lettre (I → J).
  • Tout le reste reçoit .1 en suffixe.

Renuméroter

Rédiger ▾ → Renuméroter… renumérote tout le document en une étape. Renuméroter à partir d'ici… dans le menu contextuel d'un élément renumérote cet élément, les éléments de même niveau qui le suivent et tous leurs enfants.

La boîte de dialogue contient :

  • Modèle de numérotation : {n} est la position et {n:3} la complète à trois chiffres. SYS-{n:3} donne SYS-001, SYS-002 ; leurs enfants sont numérotés en dessous, SYS-001.1, SYS-001.2. Un modèle sans {n} reçoit le numéro à sa fin. Depuis un élément, le modèle et le premier numéro sont préremplis d'après son numéro.
  • Premier numéro (chiffres uniquement). Toute autre saisie affiche « Saisissez le premier numéro en chiffres, par exemple 1. »
  • Un tableau d'aperçu avec Élément, Actuel et Nouveau (les numéros modifiés sont mis en évidence ; jusqu'à 400 lignes), et un décompte comme « 12 numéros sur 40 changent. »
  • Renuméroter automatiquement après l'ajout ou le déplacement d'éléments (document entier uniquement).
  • La note « Les éléments verrouillés gardent leurs numéros. Une seule annulation défait toute la renumérotation. » Les entrées de glossaire gardent aussi les leurs.
  • Renuméroter. Le message indique « Numéros de document mis à jour ».

Une exécution sur tout le document enregistre le modèle et le premier numéro avec le document. La renumérotation automatique les utilise ensuite.

Numérotation du document (méta-numéros)

La numérotation du document conserve des numéros distincts par document. Utilisez-la lorsque la même exigence figure dans deux documents sous des numéros différents.

Activez-la avec Livrer ▾ → Configuration du livrable… → Numérotation → Numéros de document (conservés dans ce document uniquement). Numéros du modèle (les numéros propres des éléments) la désactive.

  • À l'activation, le numéro actuel de chaque élément est copié dans le document.
  • Dès lors, les modifications de numéro ne changent que ce document.
  • Le cartouche affiche « · numéroté par document » tant qu'elle est activée.
  • Les exports et les rapports utilisent les numéros du document.

Modèles

Les modèles proviennent de quatre endroits. Nouveau document et Utiliser le modèle les listent dans cet ordre, les modèles de ce type de document en premier :

GroupeOù il est conservéQui peut l'ajouter ou le modifier
Modèles d'organisation : {name}Sur les serveurs Holarch (hébergés ou auto-hébergés), pour l'organisationLes administrateurs de l'organisation
Modèles de projetDans le fichier du projet ; tous les membres du projet les voientLes propriétaires du projet (dans l'application de bureau : toute personne qui ouvre le projet)
Modèles intégrésDans HolarchPersonne
Enregistré dans ce navigateurDans ce navigateur uniquement (modèles enregistrés avant la version 1.8.0)Les importer dans un projet

Modèles intégrés

Chaque modèle intégré a des sections numérotées avec des tableaux de départ (par exemple les tableaux Historique des révisions et Approbations). Avec Inclure les consignes de rédaction, chaque section commence aussi par un court guide de rédaction.

Nouveau document affiche le nombre de sections de chaque modèle, par exemple « 39 sections » pour la spécification d'exigences.

Les modèles suivent la pratique courante de l'ingénierie système pour chaque sorte de document : spécifications des exigences des parties prenantes, système, logicielles et d'interface, document de contrôle d'interface, description de l'architecture, vérification et validation, plans de test et de risques, procédures et rapports de test, études de compromis et gestion de configuration.

De nombreuses sections contiennent des blocs dynamiques qui se mettent à jour à partir du modèle chaque fois que le document est affiché ou exporté :

BlocDans
VCRM, VCRM par niveau, RVTM et RTM des exigences propres au documentSpécifications d'exigences (sections Vérification et Traçabilité)
VCRM et RVTM de tout le projetPlan de test, plan de vérification et de validation, procédure de test, rapport de test
Matrice d'interfaces et liste des conduitsDocument de contrôle d'interface, description de l'architecture
Matrice d'allocation (fonctions vers composants)Définition du concept, description de l'architecture
Statements étiquetés AcronymChaque section Acronyms
Artifacts étiquetés ReferenceChaque section References
Risks ; Artifacts Trade StudyPlan de management des risques ; rapport d'étude de compromis

Une matrice qui couvre « ce document » pointe vers le nouveau document. Pour le rapport de test, ajoutez les résultats d'un cycle de test avec Insérer ▸ Matrice… ▸ Test Report et choisissez la suite et le cycle de test.

Enregistrer un document comme modèle

Enregistrez la structure d'un document comme modèle pour lancer de nouveaux documents à partir de celui-ci.

  1. Choisissez Rédiger ▾ → Modèles ▸ Enregistrer comme modèle….

    Enregistrer {Type} comme modèle s'ouvre.

  2. Saisissez le Nom du modèle.
  3. Dans Enregistrer dans, choisissez :
    • Ce projet : tous les membres du projet peuvent l'utiliser. Seuls les propriétaires du projet voient ce choix.
    • Organisation : {name} (serveurs Holarch, administrateurs de l'organisation) : tous les membres de l'organisation peuvent l'utiliser. Cochez En faire le modèle par défaut de l'organisation pour {Type} pour le présélectionner dans Nouveau document.
  4. Cochez Inclure les fichiers et images si le modèle doit les conserver.
  5. Cliquez sur Enregistrer.

Un modèle enregistre la classe, le nom, le numéro, la description, le niveau, les étiquettes et les valeurs d'attributs simples de chaque élément. Les résultats de qualité sont exclus. Une matrice qui couvre le document enregistré couvre le nouveau document lorsque le modèle est appliqué.

Si vous ne pouvez enregistrer ni l'une ni l'autre sorte, la boîte de dialogue le signale : demandez à un propriétaire du projet ou à un administrateur de l'organisation.

Gérer les modèles

Rédiger ▾ → Modèles ▸ Gérer les modèles… liste les modèles du projet. Les propriétaires peuvent les Renommer et les Retirer ; Annuler restaure un modèle retiré. Les documents créés à partir d'un modèle ne changent pas.

Les administrateurs d'organisation gèrent les modèles de l'organisation dans Paramètres de l'organisation → Modèles de documents : ouvrez l'organisation et utilisez Modèles de documents pour renommer un modèle, activer ou désactiver Par défaut (un modèle par défaut par type de document) ou le retirer.

Modèles enregistrés dans ce navigateur

Avant la version 1.8.0, les modèles personnalisés étaient enregistrés dans le navigateur. La première fois qu'un propriétaire du projet ouvre la liste des modèles, Holarch propose de les copier dans le projet : Importer dans le projet ou Pas maintenant. D'ici là, ils restent listés sous Enregistré dans ce navigateur. Gérer les modèles… propose pour eux Importer dans le projet et Retirer du navigateur.

Appliquer un modèle à un document existant

Rédiger ▾ → Modèles ▸ Appliquer un modèle… ouvre Utiliser le modèle avec Type de document, Modèle, Enregistrer ce document comme modèle… et Gérer les modèles….

Appliquer ajoute les sections du modèle, avec leurs numéros et leur imbrication, à la fin du document. Le message indique « N sections ajoutées. » Annuler les retire.

Éditeur de texte enrichi

L'éditeur de texte enrichi modifie les descriptions avec mise en forme, tableaux, images et contenu dynamique. Cliquez sur une description (ou sur la description du document) pour la modifier. Au clavier, atteignez la description avec Tab et appuyez sur Enter ou F2 ; les lecteurs d'écran l'annoncent comme un champ de texte nommé d'après son élément (« Description de 1.2 Power Budget »).

L'éditeur s'ouvre sur place avec une barre d'outils, un compteur de mots et de caractères (« mots : N · caractères : N ») et l'indication « ⌘↩ / Ctrl+Enter enregistrer · Esc annuler · Tab quitter ».

  • Pour enregistrer, appuyez sur ⌘↵ / Ctrl↵, cliquez sur ✓, cliquez en dehors de l'éditeur, ou appuyez sur Tab pour le quitter.
  • Pour annuler, appuyez sur Esc. Le focus revient à la description.
  • Chaque enregistrement peut être défait par une seule annulation.
  • Tab n'indente jamais : il ne peut donc pas vous bloquer dans l'éditeur. Indentez les listes avec ⌘ / Ctrl+] / ⌘ / Ctrl+[ ou ⇤ / ⇥.

Barre d'outils

BoutonCe qu'il fait
+Menu Insérer : ✦ Rédiger avec l'IA…, Image…, Texte alternatif… (lorsque le texte contient des images), Tableau…, Bloc de code, Ligne, Lien…, Lien vers un document…, Fichier…, Diagramme…, Valeur dynamique…, Nombre ou total…, Tableau dynamique…, Matrice…, Renvoi…, Symbole…, et Mettre à jour les figures de diagramme lorsque le texte contient des images de diagramme
✦Outils de texte de l'IA (voir ci-dessous)
¶ ▾Style de paragraphe : Texte, Titre 1 à Titre 4, Citation, Bloc de code
G / I / SGras (⌘B / Ctrl+B), italique (⌘I / Ctrl+I), souligné (⌘U / Ctrl+U)
⋯Souligné (⌘U / Ctrl+U), Barré, Exposant, Indice, Code en ligne, Surligner, Effacer la mise en forme (⌘⇧M / Ctrl+Shift+M)
• / 1.Liste à puces (⌘⇧8 / Ctrl+Shift+8) / liste numérotée (⌘⇧7 / Ctrl+Shift+7)
⇤ / ⇥Désindenter (⌘[) / indenter (⌘])
≡ ▾Alignement : Gauche, Centre, Droite, Justifier
▦Insérer un tableau… et, à l'intérieur d'un tableau, les opérations de tableau
🔗Lien (⌘K / Ctrl+K)
ANuanciers Couleur du texte et Arrière-plan (dix couleurs chacun) et Retirer la couleur
AaPolice (Arial, Brush Script MT, Comic Sans MS, Garamond, Georgia, Helvetica, Impact, monospace, Times New Roman) et Taille (de 10 à 60 px) pour la sélection
↶ / ↷Annuler (⌘Z / Ctrl+Z) / rétablir (⇧⌘Z / Ctrl+Shift+Z) dans l'éditeur
</>Source HTML (⌘/ / Ctrl+/) ; la source est assainie lorsque vous revenez en arrière
⤢Plein écran ; Esc quitte d'abord le plein écran
✓Enregistrer (⌘↵ / Ctrl↵)

La police, la taille et les styles qui s'appliquent à la sélection exigent une sélection. Sans elle, le message indique « Sélectionnez d'abord du texte. »

Tableaux

Insérer un tableau demande Lignes (2 par défaut), Colonnes (3 par défaut) et Ligne d'en-tête (activée). Tab et Shift+Tab passent d'une cellule à l'autre. Tab dans la dernière cellule (ou Shift+Tab dans la première) quitte l'éditeur.

À l'intérieur d'un tableau, cliquez sur ▦ ou cliquez avec le bouton droit sur une cellule pour les opérations de tableau :

  • Ajouter une ligne au-dessus, Ajouter une ligne en dessous, Ajouter une colonne avant, Ajouter une colonne après.
  • Ajouter une ligne d'en-tête, Ajouter une légende, Fusionner avec la cellule de droite.
  • Supprimer la ligne, Supprimer la colonne, Retirer la ligne d'en-tête, Retirer la légende, Supprimer le tableau.

Images et fichiers

  • Image… insère un fichier image comme figure. La boîte de dialogue Insérer une image demande un Texte alternatif (ce que montre l'image), ou Décorative (pas de texte alternatif nécessaire) pour une image qui n'apporte aucune information.
  • Vous pouvez aussi coller une image, ou déposer un fichier image dans l'éditeur. Ces images démarrent sans texte alternatif ; le message indique « Image ajoutée sans texte alternatif. Ajoutez-le avec le menu + (Texte alternatif…). »
  • Coller l'adresse d'une image (se terminant par .png, .jpg, .jpeg, .gif ou .webp) insère l'image.
  • Les images de plus de 4 000 px sur leur plus grand côté sont réduites pour tenir. L'avis indique « Image réduite à L × H px (la limite est de 4000 px sur le plus grand côté). »
  • Un fichier image au-delà de la limite par fichier est redessiné à 1 600 px de large en JPEG. S'il est encore trop grand, le message indique « L'image dépasse la limite de N Mo. »
  • Fichier… joint n'importe quel fichier sous forme de lien de téléchargement, avec une icône pour son type. Les fichiers au-delà de la limite affichent « Le fichier dépasse la limite de N Mo. »

Texte alternatif

Le texte alternatif décrit une image pour les lecteurs d'écran et dans le vérificateur d'accessibilité de Word.

  • + → Texte alternatif… liste chaque image du texte avec son texte alternatif et une case Décorative. Il avertit lorsqu'une image n'a pas de texte alternatif ou lorsque le texte alternatif est un nom de fichier.
  • Double-cliquez sur une image, ou cliquez dessus avec le bouton droit et choisissez Modifier le texte alternatif…, pour ne modifier que celle-ci.
  • Les images de diagramme (Diagramme…) tirent leur texte alternatif de la légende : le type de diagramme et le nom de l'entité.
  • La sortie Word écrit le texte alternatif dans la description de chaque image. Une image décorative est marquée comme décorative.
  • Lien… (Insérer un lien) demande une URL et un Texte. Les adresses sans http:, https:, mailto: ou # reçoivent https://. Les liens s'ouvrent dans un nouvel onglet.
  • Lien vers un document… (Insérer un lien vers un document) crée un lien vers un autre document. Il demande un Document, une Version (Actuelle ou Référence : {name}) et un Texte.
    • Dans la sortie Word, les documents liés de cette façon peuvent être ajoutés en annexes.
    • Sans autre document, le message indique « Ce projet n'a aucun autre document. Créez-en d'abord un. »

Contenu dynamique

Le contenu dynamique reste à jour avec le modèle partout où le texte est affiché : dans le document, dans l'inspecteur, dans les exports et dans la recherche.

  • Diagramme… (Insérer un diagramme) : choisissez le Type de diagramme et l'entité (ou un tableau blanc ou un cadre). Il insère une image du diagramme, avec une légende, qui renvoie au diagramme.
    • L'image est dynamique. Lorsque le modèle change, le document affiche la nouvelle image après un instant, et Word et les autres exports la redessinent.
    • Pour conserver l'image actuelle, double-cliquez sur la figure dans l'éditeur (Figure de diagramme) et désactivez Mettre à jour l'image quand le modèle change. La figure devient alors un instantané.
    • Mettre à jour les figures de diagramme (dans +) redessine immédiatement toutes les figures dynamiques du texte.
    • Lorsque l'entité du diagramme est supprimée, la figure conserve sa dernière image.
  • Valeur dynamique… : choisissez une entité et un Attribut. L'éditeur affiche sa « Valeur dynamique ». Pour changer l'attribut, double-cliquez sur la valeur dynamique (Modifier la valeur dynamique).
  • Nombre ou total… insère un nombre recalculé à partir du modèle, pour une synthèse ou une ligne d'état comme « 12 exigences sur 40 sont vérifiées » (deux nombres). Ses champs :
    • Requête : les entités à compter, par exemple class:Requirement AND Requirement:"Status=Approved". Voir la syntaxe de recherche.
    • Portée : Projet entier, ce document, ou un autre document. Une compilation comme portée couvre toutes ses parties.
    • Fonction : Nombre, Somme, Moyenne, Minimum ou Maximum. Toutes sauf Nombre demandent un Attribut numérique, comme le montant d'un Cost. Sans nombre à totaliser, la valeur est N/A.
    • La valeur actuelle. Pour modifier un nombre plus tard, double-cliquez dessus.
  • Matrice… insère une RTM, une RVTM, une VCRM, une matrice d'allocation ou une autre matrice dynamique. Voir Génération de documents.
  • Tableau dynamique… insère un tableau d'entités issu d'une requête. Les lignes sont recalculées chaque fois que le texte est affiché ou exporté. Ses champs :
    • Requête, par exemple class:Requirement AND label:"Functional Requirement". La valeur par défaut est order:modified-. Voir la syntaxe de recherche.
    • Portée : Projet entier, ce document, ou un autre document ou une compilation.
    • Colonnes (dans l'ordre) : Numéro, Nom par défaut. + Ajouter un attribut… ajoute une colonne d'attribut. + Ajouter une colonne de relation… ajoute une colonne qui liste les entités liées, par exemple Verified by.
    • Limite : 10 par défaut. Toutes les lignes liste toutes les correspondances.
    • Un aperçu de 50 lignes au plus.
    • Pour modifier un tableau dynamique plus tard, double-cliquez dessus.
  • Plage de feuille de calcul… insère des cellules d'une feuille de calcul sous forme de tableau, ou de graphique d'un type de votre choix (ou de l'un des graphiques de la feuille), avec une légende. Choisissez la feuille de calcul, la feuille et la plage, et éventuellement une vue partagée à suivre. Le tableau et le graphique affichent les valeurs actuelles et se mettent à jour lorsque les cellules changent ; Word et les autres exports utilisent les valeurs au moment de l'export. Lorsque la plage est supprimée, le tableau garde ses dernières lignes et est marqué comme manquant.
  • Renvoi… (Insérer un renvoi) renvoie à une partie du document ouvert par son numéro actuel :
    • Section ou élément affiche le numéro et le nom de l'élément, par exemple « 3.2 Frost Warning ». Autre entité… choisit une entité en dehors du document.
    • Figure et Tableau listent les figures et les tableaux du document qui ont une légende, sous la forme « Figure 2 » ou « Tableau 1 ». En choisir un qui n'a pas encore de clé de référence lui en ajoute une.
    • Le texte suit la renumérotation. Dans la sortie Word, les renvois deviennent des champs que Word met à jour avec les numéros de légende. Un renvoi dont la cible a été supprimée garde son texte et est marqué.
  • Symbole… insère l'un des symboles suivants : ± ° µ Ω ≈ ≠ ≤ ≥ × ÷ √ ∞ ∑ π Δ, des flèches, • … — –, © ® ™ § ¶, € £ ¥ ¢, ½ ¼ ¾ ² ³, ✓ ✗.

Outils de texte de l'IA

✦ réécrit la sélection, ou le paragraphe courant lorsque rien n'est sélectionné. Sans texte à traiter, le message indique « Il n'y a aucun texte à réécrire. »

Les outils :

  • Améliorer la formulation, Simplifier, Corriger l'orthographe et la grammaire, Raccourcir, Ajouter un détail, Terminer la phrase.
  • Réécrire sur un ton… : académique, affirmé, décontracté, confiant, constructif, empathique, enthousiaste, fluide, formel, amical, inspirant, professionnel.
  • Traduire… et Traduire tout le texte… : arabe, chinois, anglais, français, allemand, grec, italien, japonais, coréen, portugais, russe, espagnol, suédois, ukrainien.
  • Rédiger avec l'IA….

L'aperçu affiche Actuel, Suggéré et Modifications. Choisissez Remplacer, Réessayer ou Abandonner.

Coller

Le texte mis en forme collé conserve sa structure : titres, listes, tableaux et liens. Il perd les classes, les styles en ligne (sauf sur les cellules de tableau) et le balisage Office. Les scripts, les cadres et les liens dangereux sont retirés de tout texte enrichi.

Raccourcis du texte enrichi

TouchesAction
⌘↵ / Ctrl↵Enregistrer et fermer
EscAnnuler (ou quitter le plein écran)
⌘B / Ctrl+B / ⌘I / Ctrl+I / ⌘U / Ctrl+UGras / italique / souligné
⌘K / Ctrl+KLiaison
⌘⇧7 / Ctrl+Shift+7 / ⌘⇧8 / Ctrl+Shift+8Liste numérotée / à puces
⌘] / ⌘[Indenter / désindenter
Tab / Shift+TabCellule de tableau suivante / précédente ; ailleurs, quitter l'éditeur (avec enregistrement)
⌘⇧M / Ctrl+Shift+MSupprimer la mise en forme
⌥⌘0 / Ctrl+Alt+0Paragraphe de texte
⌥⌘1 / Ctrl+Alt+1 à ⌥⌘4 / Ctrl+Alt+4Titre 1 à Titre 4
⌘/ / Ctrl+/Source HTML
⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+ZAnnuler / rétablir dans l'éditeur

Rechercher dans le document

Cliquez sur Rechercher ou appuyez sur ⌘F / Ctrl+F pour rechercher dans le document. La zone de recherche affiche « n sur m ».

La recherche porte sur le numéro, le nom et la description de chaque élément, sur les valeurs des colonnes affichées et sur les messages du contrôle de qualité. Elle ignore les éléments masqués par un filtre.

  • Enter ou ▼ passe à la correspondance suivante.
  • Shift+Enter ou ▲ passe à la correspondance précédente.
  • Esc efface le texte, et × ferme la zone.

Les sections réduites s'ouvrent pour montrer une correspondance. Les lignes correspondantes sont mises en évidence, et la ligne courante est marquée.

Rechercher et remplacer

Rédiger ▾ → Rechercher et remplacer… ouvre Rechercher et remplacer. La boîte de dialogue contient :

  • Rechercher et Remplacer.
  • Les champs où chercher : Nom, Numéro et Description. Numéro est désactivé par défaut.
  • Respecter la casse et Mots entiers uniquement.

La ligne sous les champs indique « N entités correspondent (les entités verrouillées sont ignorées). » Tout remplacer modifie chaque correspondance dans les éléments du document, et une seule annulation défait le tout. Le message indique « N entités mises à jour », ou « Aucune correspondance ». Dans le texte enrichi, seul le texte change : la mise en forme, les liens et les notations restent intacts.

Menu Rédiger

Rédiger ▾ regroupe les commandes qui ajoutent et modifient du contenu. Les commandes qui ajoutent des éléments sont grisées dans une référence, avec un accès en lecture seule et tant qu'un filtre ou un tri est actif ; l'infobulle en donne la raison.

ItemCe qu'il fait
Ajouter un élément ▸Les classes Statement et Autre classe…. Ajoute l'élément après l'élément sélectionné, ou à la fin si rien n'est sélectionné. La classe choisie devient la classe courante.
Ajouter un élément existant…Voir Entités existantes.
Insérer ▸Du contenu dynamique dans la description de l'élément sélectionné : Valeur dynamique…, Nombre ou total…, Tableau dynamique…, Matrice…, Image de diagramme…, Plage de feuille de calcul… et Renvoi…. L'éditeur de description s'ouvre à la fin du texte avec la boîte de dialogue choisie (voir Contenu dynamique). Grisé tant qu'aucun élément non verrouillé n'est sélectionné (« Sélectionnez d'abord un élément non verrouillé »). Dans une compilation, il propose aussi Document… et Section générée… (voir Compilations).
✦ Générer des exigences…Générateur d'IA, sous l'élément sélectionné ou pour tout le document. Chaque résultat est prévisualisé avant d'être ajouté.
✦ Générer des exigences enfants…Avec un Statement ou une exigence sélectionné : de nouveaux enfants de celui-ci.
✦ Générer des risques…Avec un élément sélectionné : des risques pour celui-ci.
✦ Générer un cas de test…Avec une exigence sélectionnée : un cas de test qui la vérifie.
✦ Résumer…Rédige un élément de synthèse, maintenu en tête du document, sans numéro.
✦ Traduire…Traduit le texte du document, avec un aperçu.
Rechercher et remplacer…Voir Rechercher et remplacer.
Renuméroter…Voir Renuméroter.
Modèles ▸Appliquer un modèle… (Appliquer un modèle), Enregistrer comme modèle… (Enregistrer un document comme modèle) et Gérer les modèles… (Gérer les modèles).

Définir un attribut sur cette branche

Cliquez avec le bouton droit sur un élément et choisissez Définir un attribut sur cette branche… pour définir une même valeur sur l'élément et tous ses descendants. Choisissez Ajouter une étiquette, Retirer l'étiquette ou un attribut, puis la valeur. La boîte de dialogue précise « S'applique à {item} et à ses N descendants. Les entités verrouillées sont ignorées. » Le message indique « N entités mises à jour (k verrouillées ignorées) ».

Découper en plusieurs éléments

Cliquez avec le bouton droit sur un élément et choisissez Découper en plusieurs éléments… pour scinder une exigence composée en exigences singulières. La boîte de dialogue s'intitule Découper en plusieurs éléments : {item}.

  1. Choisissez Couper aux phrases ou Couper aux paragraphes, et Nouveaux éléments comme ses enfants ou Nouveaux éléments après lui.

    Le tableau affiche un élément proposé par partie, avec son numéro, un Nom et un Texte modifiables.

  2. Ou cliquez sur ✦ Proposer un découpage pour que l'IA propose des exigences singulières (jusqu'à 20).
    • Les lignes dont le texte contient une adresse web sont décochées au départ.
    • Lorsque l'original est approuvé, inclus dans une référence ou verrouillé, le remplacement de son texte est une option à cocher, décochée au départ.
    • Un diff compare la ligne 1 à l'original.
  3. Modifiez les noms et le texte. Joindre fusionne une partie avec la suivante.
  4. Décochez les parties dont vous ne voulez pas et cliquez sur Appliquer.

La partie 1 (« conserve ») reste dans l'élément d'origine. Chaque partie cochée devient un nouvel élément de la même classe avec les mêmes étiquettes. Les numéros sont proposés automatiquement ; avec la renumérotation automatique activée, ils sont réattribués après le découpage. Une seule annulation défait tout le découpage ; le message indique « Découpé en N éléments ».

Menu Contrôler

Contrôler ▾ liste ce qui demande votre attention dans ce document, avec les nombres à droite :

ItemCe qu'il fait
Contrôler la qualitéContrôle toutes les exigences du document qui passent le filtre actuel, et ouvre les résultats. Lorsqu'une exigence est sélectionnée, l'élément du menu est Contrôler la qualité de cette exigence. Sans exigence : « Ce document n'a aucun Requirement à contrôler. Les Statements ne sont pas évalués. »
Contrôles du modèle pour ce document…Ouvre Contrôles du modèle pour ce document : les constats des contrôles du modèle pour le document et ses éléments (règle, élément, constat) et le contenu dynamique qui pointe vers quelque chose de manquant. Cliquez sur un élément pour le sélectionner. Sans constat : « Aucun constat pour ce document. » Ouvrir les contrôles du modèle ouvre la page pour tout le projet.
Statut de traçabilité…Affiche « N sur M complets » et ouvre Statut de traçabilité : les exigences pas encore allouées ou vérifiées, chacune avec son point et ce qui manque (satisfied by, verified by). Cliquez sur l'une d'elles pour la sélectionner. Ouvrir la RVTM ouvre la page RVTM. Affiché lorsque le document contient des exigences.
Liens à revoirOuvre Liens à revoir pour ce document.
Registre TBD/TBROuvre le registre TBD/TBR pour ce document.
Rechercher les acronymes…Voir Trouver les acronymes.
CommentairesAffiche le nombre de commentaires ouverts et les ouvre dans l'inspecteur (voir Commentaires).

Statut de traçabilité

Un point après les badges de chaque exigence indique son statut de traçabilité :

  • Vert : l'exigence est satisfied by quelque chose (allouée) et verified by quelque chose.
  • Ambre : l'un des deux manque.
  • Rouge : aucun des deux liens n'existe.

Pointez sur le point pour le statut et ce qui manque, par exemple « Statut de traçabilité : Partiellement tracée. Manque : aucun lien verified by (non vérifiée). » Cliquez dessus pour un menu avec les éléments sous Satisfied by (allocation) et Verified by (cliquez sur l'un d'eux pour l'ouvrir), Ouvrir dans la RVTM et Relier à ▸. Les Statements et les autres classes n'ont pas de point. Dans une référence, les points montrent les liens de la référence. Désactivez les points avec Affichage ▾ → Statut de traçabilité.

Trouver les acronymes

Contrôler ▾ → Rechercher les acronymes… trouve les acronymes dans les numéros, les noms et les descriptions du document et les ajoute à sa section Glossaire, dans une seule liste de revue.

  • Un acronyme se compose d'au moins deux majuscules, jusqu'à huit caractères, et n'est pas formé uniquement de chiffres.
  • La forme développée vient de l'entrée existante du projet, ou des mots voisins du terme dont les initiales l'épellent (« Concept of Operations » → CONOPS).
  • Chaque ligne comporte Conserver, le Terme, le Développé et ses Occurrences (cliquez sur « N occurrences » pour voir chaque endroit où il apparaît). Une note signale les termes déjà « dans le glossaire », ceux dont une « entrée existe dans le projet », ou ceux pour lesquels « aucune forme développée trouvée ».
  • Les termes avec une forme développée qui ne sont pas encore dans le glossaire sont cochés au départ. La case de l'en-tête coche ou décoche tout.
  • Lier chaque occurrence dans le texte à son entrée de glossaire (valeur dynamique) (activé) transforme chaque occurrence dans les descriptions en valeur dynamique du numéro de l'entrée, liée à l'entrée.

Cliquez sur Ajouter au glossaire. Chaque terme coché devient un Statement étiqueté Acronym avec Numéro = terme et Nom = forme développée, sous la section de premier niveau Glossary du document (une section existante nommée Glossary ou Acronyms est utilisée ; sinon, une section est ajoutée à la fin). Une entrée déjà présente dans le projet est réutilisée au lieu d'en créer une seconde. Une seule annulation défait le tout. Si rien n'est trouvé, vous voyez « Aucun acronyme dans ce document. Les acronymes sont des mots d'au moins deux majuscules, comme CONOPS. » ; si rien n'est coché, « Cochez au moins un terme. » La renumérotation ne touche pas aux entrées de glossaire.

Menu Livrer

Livrer ▾ configure le livrable et l'exporte, avec un regroupement par sortie :

ItemCe qu'il fait
Configuration du livrable…Numérotation, page de titre, en-tête courant et bloc de signatures (voir Configuration du livrable).
Mise en page…Marquage, page de couverture et numéros de page (voir Format de page).
Modèle Word ▸Les modèles Word, avec un ✔ sur celui qu'utilise ce document, et Modifier les modèles Word…. En choisir un en fait le modèle de ce document.
Version ▸Enregistrer la référence… et Comparer les versions… (voir Références).
Word : un {template} (Word) par modèle WordTélécharge immédiatement le document en Word avec les options de ce modèle ; le modèle propre au document affiche « ce document ». Depuis une référence, la sortie est la référence.
Plan (Word)…Le plan sous forme de titres, éventuellement avec une table des matières.
Version avec modifications (Word)…Voir Version avec modifications. Nécessite une référence.
Excel : Matrice de traçabilité…Une matrice standard en Excel, Word, CSV ou page web (voir Génération de documents).
Modifications (Excel)…Les modifications d'une référence à une référence ultérieure ou à la version actuelle. Nécessite une référence.
Échange : Exigences (ReqIF)…, Données du document (JSON)…Formats d'échange (voir Rapports).
Imprimer ou PDF…Voir Imprimer / PDF.
Tous les exports…Chaque export avec ses options (voir Rapports).

Modèles Word

Un modèle Word est un ensemble nommé d'options d'export Word et de la page. Il façonne le fichier Word, pas le contenu (les modèles de document remplissent le contenu ; voir Modèles). Chaque document en utilise un ; par défaut, c'est Spécification. Choisissez-le dans Livrer ▾ → Modèle Word ▸.

Modèles intégrés :

GabaritOptions
SpécificationSommaire jusqu'au niveau 3, légendes numérotées, listes des figures et des tableaux, historique des révisions et approbations issus des références, documents liés en annexes. Colonnes d'attributs lorsque le document en affiche.
Livrable par chapitreComme Spécification, avec des légendes numérotées par chapitre (Figure 3-1) et les titres contenus dans les descriptions repris dans le sommaire.
Copie de revuePages en paysage avec les colonnes d'attributs du document sous chaque élément ; sommaire jusqu'au niveau 2, sans tableaux liminaires.
SimpleTitre, titres de section et texte : ni sommaire, ni numéros de légende, ni tableaux liminaires.

Tous les modèles intégrés utilisent des pages Letter.

Modifier les modèles Word… ouvre Modèles Word. Les modèles intégrés proposent Copier ; une copie devient un modèle de projet, conservé dans le projet pour tous les membres. Sélectionnez un modèle de projet pour modifier :

  • Nom, Format de page (Letter (8,5 × 11 in) ou A4 (210 × 297 mm)) et Orientation (Portrait ou Paysage).
  • Sommaire (Aucun, Niveau 1, Niveaux 1–2, Niveaux 1–3, Niveaux 1–4, Tous les niveaux) et Numéros de légende (Figure 1, Tableau 1, Par chapitre : Figure 3-1 ou Désactivé).
  • Liste des figures et liste des tableaux (quand il y a des légendes), Les titres dans les descriptions apparaissent dans le sommaire, Les colonnes d'attributs affichées dans le document, sous chaque élément, Documents liés en annexes et Historique des révisions et approbations issus des références.
  • Supprimer le modèle.

Cliquez sur Enregistrer (une seule annulation la défait ; le message indique « Modèles Word enregistrés. »). Un document dont le modèle a été supprimé revient à Spécification.

Fichiers Word de l'entreprise

Un modèle de projet peut porter le fichier Word propre à votre organisation (.docx ou .dotx, jusqu'à 5 Mo). L'export utilise alors, de ce fichier :

  • Les styles : polices, couleurs, styles de titre et de corps de texte. Les styles absents du fichier (légendes, entrées du sommaire) sont ajoutés ; la numérotation des titres du fichier est abandonnée, car Holarch numérote les titres.
  • La page : format, orientation et marges. Choisir le fichier règle en conséquence le Format de page et l'Orientation du modèle.
  • Les en-têtes et pieds de page, avec leurs logos et numéros de page. Le marquage du projet ou du document est ajouté à chacun.
  • La page de titre : le contenu du fichier avant son premier saut de section, ou tout le fichier s'il n'en a pas. Elle remplace la page de titre de Holarch.

Sur la page de titre et dans les en-têtes et pieds de page, ces espaces réservés sont remplis : {{Title}}, {{Type}}, {{Number}}, {{Version}}, {{Date}}, {{Project}}, {{Organization}}, {{Contract}}, {{CDRL}}, {{Prepared For}}, {{Prepared By}} et {{Baseline}}. La casse et les espaces n'ont pas d'importance. Tout autre texte entre accolades reste tel qu'écrit.

Pour en ajouter un :

  1. Choisissez Livrer ▾ → Modèle Word ▸ → Modifier les modèles Word….
  2. Cliquez sur Choisir… dans la ligne Fichier Word de l'entreprise, ou sélectionnez un modèle de projet et cliquez sur Choisir… sous Fichier Word de l'entreprise.
  3. Choisissez le fichier. Cliquez sur Enregistrer.

Remplacer… change de fichier et Retirer revient aux styles et à la page de titre de Holarch. Un fichier qui n'est pas un document Word est refusé avec « Le fichier n'est pas un document Word (.docx ou .dotx). » Le contenu qui renvoie hors du document est exclu : images liées, objets et contrôles incorporés, et champs INCLUDETEXT, INCLUDEPICTURE, DDE, LINK et IMPORT. Les macros ne sont jamais lues.

La page du modèle fixe aussi la largeur de la vue Papier : les pages Letter font 816 px de large, A4 794 px, davantage en paysage. Dans Tous les exports… → Document (Word), les options partent du modèle du document ; Modèle Word à cet endroit les remplit à partir d'un autre modèle, et vous pouvez les modifier pour un seul export.

Menu Affichage

Affichage ▾ regroupe des bascules directes pour ce document :

  • Papier (✔ lorsqu'il est activé) : affiche le document sous forme de pages, aussi larges que la page du modèle Word, sans colonnes d'attributs. Les documents d'exigences démarrent avec ce mode désactivé ; les autres types démarrent avec ce mode activé.
  • Volet du plan : affiche ou masque le volet du plan.
  • Statut de traçabilité : affiche ou masque les points de statut de traçabilité. Activé par défaut.
  • Colonnes ▸ (grisé en vue Papier) : chaque attribut des classes du document et les champs de l'élément (Classe, Numéro, Créé le, Modifié le, Étiquettes), avec un ✔ sur les colonnes affichées. Choisissez-en une pour l'afficher ou la masquer ; une nouvelle colonne s'ajoute à la fin. Colonnes par défaut rétablit Statut, Méthode de vérification et Score de qualité.
  • Tout réduire, et Tout développer lorsque quelque chose est réduit.
  • Réduire les enfants : replie les sections sous l'élément sélectionné (grisé tant qu'aucun élément avec des sous-sections n'est sélectionné).
  • Réinitialiser la vue : efface la réduction, les filtres, le tri et la recherche. Affiche aussi le volet du plan à sa largeur par défaut, réinitialise la largeur des colonnes et rétablit les colonnes par défaut.
  • Ouvrir dans ▸ : ouvre l'élément sélectionné, ou le document si rien n'est sélectionné, dans une autre vue : Vue d'élément, Historique… (chaque modification enregistrée, avec un diff des mots par champ), les diagrammes qui peuvent l'afficher, Matrice de traçabilité (le document comme axe des lignes), Qualité des exigences (limitée au document) et Analyse fonctionnelle.
  • Aide.

Cliquez avec le bouton droit sur un en-tête de colonne pour Déplacer à gauche, Déplacer à droite et Masquer la colonne.

Les colonnes sont mémorisées par document dans ce navigateur. Le dernier choix sert de point de départ pour les documents que vous n'avez pas configurés. Papier et Statut de traçabilité sont enregistrés avec le document. La position de défilement horizontal reste en place lorsque vous sélectionnez une ligne.

Références

Version ▾ dans le cartouche liste Version actuelle, les références de ce document et, sous Références du projet, les références du projet (chacune avec sa date ; un ✔ marque celle qui est affichée). Il se termine par Enregistrer la référence… et Comparer les versions…. Livrer ▾ → Version ▸ propose les deux mêmes commandes.

Créer une référence

  1. Cliquez sur Version ▾ → Enregistrer la référence… (grisé lorsqu'une référence est affichée : « Revenez d'abord à la version actuelle »).

    Enregistrer la référence s'ouvre avec la note « La référence conserve cette version du document (ses éléments, leurs attributs et leurs relations) pour la consulter, la comparer et la restaurer plus tard. Les enregistrements d'approbation sont datés de maintenant et ne peuvent plus être modifiés ensuite. »

  2. Saisissez le Nom (obligatoire). Par défaut : « {document} Baseline N ».
  3. Sous Approbations, remplissez une ligne par approbateur : Nom, Rôle et Déclaration. La première ligne est préremplie avec votre nom. La déclaration par défaut est « Approuvé pour publication. »
  4. Cliquez sur + Ajouter un approbateur pour ajouter des lignes, ou sur × pour en retirer une. Les lignes sans nom sont ignorées.
  5. Cliquez sur Créer.

    Le message indique « Référence enregistrée ».

Consulter une référence

Choisissez une référence dans Version ▾. Le bandeau indique « Référence « {name} », lecture seule, enregistrée le {date} » (avec « · référence de projet » pour une référence de projet), avec les approbateurs. Il propose :

  • Revenir à l'actuel : revient à la copie de travail.
  • Modifier (références de document) : ouvre Modifier la référence. Renommez la référence, ou ajoutez des enregistrements d'approbation sous Ajouter des approbations. « Les nouveaux enregistrements sont datés de maintenant et ajoutés à la liste. Les enregistrements existants ne peuvent pas être modifiés. »
  • Comparer à l'actuel (références de document) : ouvre Comparer les versions à partir de cette référence.
  • Restaurer la référence : demande « Remplacer les entités, l'ordre et la structure de ce document par la référence « {name} » ? Les entités ajoutées depuis sont retirées du document (pas supprimées). L'annulation est possible. »
    • Pour une référence de projet, ouvre Remplacer le projet par la référence : « Remplacer l'ensemble du projet par la référence de projet « {name} » ? L'annulation est possible. »
  • Supprimer : demande « Supprimer la référence « {name} » ? »

Dans une référence, l'édition, l'ajout rapide et les outils de structure sont désactivés, et le plan affiche 🔒. Livrer ▾ produit les sorties à partir de la référence (« Exporter (référence « {name} ») »).

Le contenu dynamique d'une référence affiche le modèle de la référence, à l'écran et dans les sorties : les valeurs dynamiques, les nombres et totaux, les tableaux dynamiques, les matrices et les renvois sont résolus sur l'instantané, et les figures de diagramme conservent les images enregistrées avec la référence. Une référence de document contient le document, ses éléments et les entités situées à une relation : un nombre ou un tableau qu'elle contient porte donc sur ces entités ; une valeur dynamique d'une entité hors de la référence affiche sa valeur actuelle.

Comparer les versions

Version ▾ → Comparer les versions… ouvre Comparer les versions. Il compare De (une référence) avec À : une référence ultérieure ou Version actuelle. Sans référence, il affiche « Ce document n'a pas de référence. Enregistrez-en d'abord une. »

Il liste « N modifications », avec Numéro, Nom, Type de modification, Champ et Modification. Pour un texte modifié, Modification affiche un diff des mots.

Types de modification :

  • Ajouté et Retiré.
  • Modifié : le champ est Nom, Numéro, Description, Classe, Image ou tout attribut.
  • Étiquette ajoutée et Étiquette retirée.
  • Relation ajoutée, Relation retirée et Attribut de relation.

Modifications (Excel) le télécharge avec Numéro, Nom, Classe, Type de modification, Champ, Ancienne valeur et Nouvelle valeur. Version avec modifications (Word) télécharge la même comparaison sous forme de version Word avec modifications (voir Version avec modifications).

Rapports

Livrer ▾ exporte le document vers Word, PDF, des tableurs et d'autres formats. Les éléments {template} (Word) se téléchargent immédiatement (voir Modèles Word) ; chaque élément Word a une description d'une ligne sous son nom. Supprimer le document…, à la fin du menu, supprime le document, éventuellement avec les sections qu'aucun autre document n'utilise (voir La liste des documents), puis revient à la liste. Plan (Word)…, Version avec modifications (Word)…, Modifications (Excel)…, Exigences (ReqIF)…, Données du document (JSON)… et Imprimer ou PDF… ouvrent la boîte de dialogue Exporter avec ce choix ; Tous les exports… l'ouvre avec votre dernier choix.

  1. Cliquez sur Livrer ▾ → Tous les exports….

    Exporter s'ouvre.

  2. Choisissez quoi exporter dans Exporter en. Les choix sont nommés « <contenu> (<format>) » et regroupés par sortie : Word, Excel, CSV, page web, texte, échange et impression.
  3. Définissez ses options.
  4. Modifiez le Nom du fichier (jusqu'à 99 caractères).
  5. Cliquez sur Exporter.

Aperçu affiche les 60 premières lignes des rapports en tableur. Pour les autres exports, il affiche « L'aperçu ne montre que les exports en tableur. Choisissez un export Excel. » Les rapports utilisent les numéros du document et, dans une référence, le contenu de la référence.

RapportSortieOptions
Document (Word)Le document dans Word (voir Sortie Word)Modèle Word (celui du document ; en choisir un autre remplit à partir de lui les options ci-dessous), Ajouter une table des matières, Profondeur du sommaire de 1 à 6, Numéros de légende (Figure 1, Tableau 1, Par chapitre : Figure 3-1, Tableau 3-1 ou Désactivé), Liste des figures et liste des tableaux (quand le document a des légendes), Les titres dans les descriptions apparaissent dans la table des matières, Inclure les colonnes d'attributs affichées dans le document, Ajouter les documents liés en annexes, Remplir les tableaux Historique des révisions et Approbations à partir des références. Les valeurs par défaut viennent du modèle ; avec Spécification : sommaire jusqu'au niveau 3, numéros de légende simples, listes, colonnes lorsqu'elles sont affichées, annexes et tableaux de référence activés, titres désactivés. Le format et l'orientation de la page sont ceux du modèle.
Modifications (Excel)Chaque élément, attribut et relation ajouté, retiré ou modifié entre deux versionsDe (une référence, la plus ancienne sélectionnée d'abord), À (Version actuelle ou une référence) ; « Ce document n'a pas de référence. Enregistrez-en d'abord une. » sans référence
Tableau (CSV)Une ligne par élémentAttributs (dans l'ordre des colonnes) (par défaut Numéro, Nom, Description et les colonnes affichées ; aussi toute Relation : {name}, qui liste les éléments liés), Trier par Hiérarchique, Numéro ou Nom
Commentaires (Excel)Une ligne par commentaire sur le document et ses éléments, avec l'auteur du commentaireInclure la classe, le nom, le numéro et la description, Date, Résolu (tous activés)
Données du document (JSON)Le document en vue d'une réimportationEntités directement liées (désactivé), Commentaires (activé), Références (désactivé), Historique (désactivé)
Plan (Word)Titres uniquement, numérotésAjouter une table des matières (désactivé)
Document (Markdown)Le document sous forme de titres et de texte Markdownaucune
Document (Imprimer ou PDF)La boîte de dialogue d'impression du navigateur ; choisissez-y Enregistrer au format PDFaucune
Version avec modifications (Word)Le document avec suivi des modifications Word (voir Version avec modifications)Depuis la référence (la plus récente), Cible (une référence ultérieure ou Actuelle)
Constats de qualité (Excel)Neuf lignes par exigence (une par critère) avec le message et un Oui vert ou un Non rouge, et un « Score du rapport » finalPlus d'attributs, Inclure Créé le, Modifié le et l'ID global
Exigences (ReqIF)XML ReqIF avec la hiérarchie et les liens traced to, satisfied by, verified by, satisfies, verifies et traced from internes au documentaucune
RSM (Excel)Requirement → éléments satisfied byAttributs d'exigence (Numéro, Nom), Attributs de l'entité liée (Classe, Numéro, Nom, Description)
RTM (Excel)Requirement → éléments traced tocomme RSM
RVM (Excel)Requirement → éléments verified bycomme RSM
RVTM (Excel)Requirement → Test Cases qui la vérifient, toutes les lignes du document inclusesAttributs d'exigence (Numéro, Nom, Description, Méthode(s) de vérification), Attributs de Test Case (Numéro, Nom, Description, Statut)
TVM (Excel)Test Cases du document → les exigences qu'ils vérifientAttributs de Test Case (Numéro, Nom, Statut), Attributs d'exigence (Numéro, Nom, Description)
VCRM (Excel)Exigences × méthodes de vérification, avec un XAttributs d'exigence (Numéro, Nom), Méthodes de vérification (toutes)
Matrice de traçabilité (Excel), (Word), (CSV), (HTML)Une matrice standard du document ou de tout le projet (voir Génération de documents)Matrice, Portée (Ce document ou Projet entier)

Dans les rapports en matrice :

  • Une exigence sans élément lié est ombrée en rouge. Dans la VCRM, une exigence sans méthode est ombrée en rouge.
  • Les cellules de l'exigence sont fusionnées sur ses lignes liées.
  • Les deux lignes d'en-tête sont figées.

Sortie Word

Document (Word) construit un fichier Word dans cet ordre :

  1. La page de titre (avec Page de garde activée dans Mise en page, ou Page de titre dans Configuration du livrable), ou sinon le titre et une ligne en italique avec le type et « N° {number} ». Depuis une référence, la ligne ajoute « Référence : {name} ({date}) ». Un avis de marquage (Mise en page) apparaît dans un cadre sous le titre.
  2. Historique des révisions (Version, Date, Auteur, Modifications) : une ligne par référence du document, de la plus ancienne à la plus récente, jusqu'à la référence exportée.
    • La première ligne indique « Référence initiale ». Les lignes suivantes indiquent « N ajoutés, N retirés, N modifiés » ou « Aucune modification ».
    • L'auteur est le créateur de la référence ou ses approbateurs.
  3. Approbations (Rôle, Nom, Déclaration, Date), à partir de la référence la plus récente (ou exportée). Sans enregistrement d'approbation, les approbateurs prévus dans Configuration du livrable reçoivent un bloc de signatures : Rôle, Nom, Signature et Date avec des lignes vides à signer.
  4. La description du document, puis la table des matières, la Liste des figures et la Liste des tableaux, et un saut de page.
  5. Chaque élément sous forme de titre Word avec son numéro et son nom, puis sa description. Les styles Titre 1 à Titre 6 suivent la profondeur ; les niveaux plus profonds restent en Titre 6. Un tableau Attribut/Valeur liste les colonnes choisies qui ont une valeur.
  6. Annexes : chaque document lié par un lien intégré commence sur une nouvelle page avec « Annexe {document} » et son contenu, un niveau plus bas.

Les tableaux générés peuvent être placés dans une section au lieu du début. C'est le cas lorsque le document a une section portant l'un de ces noms (les modèles intégrés les utilisent) :

  • Historique des révisions : « Revision History » ou « Document Revision History ».
  • Approbations : « Approvals », « Approval », « Sign-off », « Signoff », « Signatures » ou « Signature ».

Légendes, listes et renvois

  • Les légendes de figure (la légende d'une image, une figure de diagramme) se lisent « Figure 1 : {caption} » sous l'image. Les légendes de tableau (le titre d'un bloc matrice, la légende d'un tableau) se lisent « Tableau 1 : {caption} » au-dessus du tableau.
  • Par chapitre les numérote par section de premier niveau : « Figure 3-1 » est la première figure de la section 3. Les tableaux sans légende ne sont pas numérotés.
  • Les numéros sont des champs SEQ de Word, et la Liste des figures et la Liste des tableaux sont des champs Word portant sur les légendes. Elles n'apparaissent que lorsque le document a des légendes de figure ou de tableau. Tant que Word n'a pas mis à jour les champs, les listes affichent les légendes sans numéros de page.
  • Chaque titre, légende de figure et légende de tableau porte un signet. Un renvoi dans une description devient un champ REF de Word vers le signet : il affiche donc le titre actuel (« 3.2 Frost Warning ») ou l'étiquette (« Figure 2-1 ») après la mise à jour des champs par Word. Un renvoi vers un élément absent du document exporté garde son texte.
  • Les titres dans les descriptions apparaissent dans la table des matières transforme les titres d'une description en vrais titres Word, un niveau sous l'élément. Désactivé, ils restent des paragraphes en gras.

Configuration du livrable

Livrer ▾ → Configuration du livrable… contient les données qu'un livrable contractuel affiche habituellement. Appliquer les enregistre ; ⌘Z / Ctrl+Z les annule en une étape.

ChampOù cela apparaît
NumérotationNuméros du modèle (les numéros propres des éléments) (par défaut) ou Numéros de document (conservés dans ce document uniquement) (voir Numérotation du document).
Page de titreActive la page de titre (le même interrupteur que Page de garde dans Mise en page).
Version, Préparé parPage de titre et en-tête courant (les mêmes champs que dans Mise en page).
Organisation, Préparé pour, Numéro de contrat, Élément CDRL, Numéro DIDPage de titre. L'élément CDRL apparaît aussi dans le pied de page courant.
LogoHaut de la page de titre. PNG, JPEG ou GIF, jusqu'à 400 Ko.
Mention de la page de titreUn cadre au bas de la page de titre, par exemple une mention de diffusion. Vide : la mention de marquage de Mise en page.
En-tête et pied de page courantsActivé par défaut. L'en-tête affiche « {number}, Version {version} » et le titre ; le pied de page affiche la date, « Page X sur Y » et « CDRL {item} ». Il faut un numéro de document ou une version.
Approbateurs prévusRôle et nom de chaque approbateur. Ils reçoivent des lignes de signature jusqu'à ce qu'une référence enregistre des approbations.

Le numéro du document est le champ N° à côté du titre du document.

Format de page

  • La page du modèle Word : US Letter ou A4, portrait ou paysage, avec des marges haute et basse de 1 pouce et des marges latérales de 0,875 pouce.
  • Calibri 11 pt.
  • De vrais styles de titre, pour que le volet de navigation et la table des matières de Word fonctionnent.
  • Les lignes d'en-tête des tableaux sont ombrées et répétées sur chaque page.
  • Les bandeaux de page (marquages) se répètent dans l'en-tête et le pied de page de chaque page, page de titre comprise.
  • Avec une page de titre, le fichier a trois sections : la page de titre (bandeaux seulement, sans en-tête courant ni numéro de page), les pages liminaires (historique des révisions, approbations, description, sommaire et listes, numérotées i, ii, iii) et le corps (numéroté à partir de 1 ; « Page X sur Y » compte le corps).
  • Word propose de mettre à jour les champs à l'ouverture du fichier. D'ici là, la table des matières affiche « Cliquez avec le bouton droit et choisissez Mettre à jour les champs pour construire la table des matières. »

Conversion du texte enrichi

  • Conservés : gras, italique, souligné, barré, exposant, indice, code en ligne (Consolas), surlignage, couleur du texte et liens web.
  • Les titres dans les descriptions deviennent des paragraphes en gras, ou des titres Word avec l'option ci-dessus.
  • Les listes deviennent des paragraphes indentés « • » ou « 1. ».
  • Les blocs de code deviennent des lignes ombrées à chasse fixe. Les citations deviennent de l'italique indenté.
  • Les tableaux conservent les colonnes fusionnées et l'ombrage d'en-tête.
  • Les images PNG, JPEG et GIF sont incorporées, jusqu'à environ 6,5 pouces de large, avec leur texte alternatif comme description de l'image. Les images SVG et WebP sont exclues des fichiers Word.

Version avec modifications

Livrer ▾ → Version avec modifications (Word)… écrit le document avec suivi des modifications Word. Choisissez Depuis la référence et la Cible (une référence ultérieure ou Actuelle). Version avec modifications (Word) dans Comparer les versions fait de même pour les deux versions qui y sont affichées.

  • Le fichier commence par un tableau Résumé des modifications : chaque modification du rapport de modifications, y compris les attributs, les étiquettes et les relations.
  • Vient ensuite le document dans sa version cible : un élément ajouté est une insertion suivie ; un élément retiré est une suppression suivie, placée après l'élément qui le précédait ; un nom ou une description modifié montre les mots supprimés et insérés.
  • Acceptez ou refusez les modifications dans l'onglet Révision de Word. Les descriptions modifiées apparaissent en texte brut ; les descriptions inchangées conservent leur mise en forme.
  • Les modifications sont attribuées au créateur de la référence cible, ou à votre nom pour Actuelle.

Imprimer ou PDF… imprime la page du document avec le navigateur. Les bandeaux s'impriment en haut et en bas de chaque page. Avec un en-tête courant (Configuration du livrable), « {number}, Version {version} » et le titre se répètent en haut de chaque page, et la date et l'élément CDRL en bas. Dans une compilation, chaque partie commence sur une nouvelle page. Les numéros de page, la table des matières et les numéros de légende n'existent que dans la sortie Word.

Commentaires

Commentez un élément dans son panneau d'entité de l'inspecteur (la partie Discussion). Contrôler ▾ → Commentaires, ou 💬 n commentaires ouverts dans le cartouche, affiche les commentaires dans l'inspecteur :

  • Tous les commentaires sur le document et ses éléments, regroupés par élément, avec « (N ouverts) ». Les réponses sont indentées sous le commentaire auquel elles répondent. Cliquez sur le nom d'un élément pour le sélectionner.
  • Afficher les résolus inclut les commentaires résolus.
  • Chaque fil a Résoudre/Rouvrir sur son premier commentaire, et chaque commentaire a × (supprimer).
  • Pour commenter le document lui-même, saisissez du texte dans Commenter ce document… et cliquez sur Ajouter un commentaire.
  • × en haut ferme les commentaires ; sélectionner un élément affiche à la place son panneau d'entité.
  • Une ligne avec des commentaires non résolus affiche 💬 n ; cliquez dessus pour ouvrir la discussion de l'élément.
  • Résolvez, rouvrez et supprimez les commentaires à l'un ou l'autre endroit.
  • Commentaires (Excel) dans Tous les exports… les rassemble.

Voir Commentaires et revues.

Compilations

Une compilation assemble d'autres documents. Les nouvelles compilations créées sur la page Revues ou par Créer un dossier de revue sont étiquetées Dossier de revue ; les dossiers créés auparavant sont étiquetés Compilation et fonctionnent de la même façon. Voir Revues.

Insérer un document… ajoute un document. Il se trouve dans Rédiger ▾ → Insérer ▸ et dans le menu ▾ de + Nouveau.

  • Il liste les documents pas encore inclus.
  • Le document inséré apparaît comme élément de premier niveau, avec son propre contenu en dessous. Le message indique « {document} inséré ».
  • Sans autre document, vous voyez « Aucun autre document à insérer. »

Sections générées

Insérer une section générée… (dans Rédiger ▾ → Insérer ▸ et dans le menu ▾ de + Nouveau) ajoute une partie dont le contenu est reconstruit à partir du modèle chaque fois que la compilation est affichée ou exportée.

ContenuCe que contient la partie
Matrice ou rapport de test…Insérer ouvre Insérer une matrice ; choisissez-y la matrice (ou un rapport de test) et sa portée. La portée Compilation (toutes les parties) couvre chaque partie. Laissez Nom de la section vide pour utiliser le nom de la matrice.
Liste des acronymesUn tableau des statements étiquetés Acronym (Numéro, Nom), trié par numéro.
Tableau de requêteUn tableau des entités correspondant à la Requête, avec les Colonnes que vous listez (noms d'attributs, séparés par des virgules).

La partie est numérotée après la dernière partie, si bien que les documents des parties gardent leurs numéros. ⌘Z / Ctrl+Z la retire en une étape. Sans nom, vous voyez « Saisissez un nom de section. » ; un tableau de requête sans requête ni colonnes affiche « Saisissez une requête et au moins une colonne. »

Compilation dans Word

L'export Word d'une compilation exporte chaque élément de premier niveau comme une partie :

  • Le titre de la partie indique « Partie A : {document} » (Titre 1), avec une ligne pour le type, le numéro et la référence épinglée du document.
  • Les numéros de section à l'intérieur d'une partie reçoivent la lettre de la partie : « A.1 Scope », « B.1 Scope ». Aucun numéro de section ne se répète.
  • Chaque partie après la première commence sur une nouvelle page.
  • Avec les légendes Par chapitre, les figures de la partie B se lisent « Figure B-1 ».

Configuration du livrable… dans une compilation ajoute Parties de la compilation :

RéglageChoix
Étiquettes de partiePartie A, Partie B, … (par défaut), Volume 1, Volume 2, …, Annexe A, Annexe B, … ou Pas d'étiquettes de partie
Numéros de sectionPar partie, avec la lettre ou le numéro de la partie (A.1, B.1) (par défaut), Continu sur toutes les parties (1, 2, 3) ou Chaque document garde ses propres numéros
Commencer chaque partie sur une nouvelle pageActivé par défaut
Page de titre pour chaque partieLe titre de la partie et sa ligne sur une page à part
Exporter chaque partie depuisActuelle, ou l'une des références du document de la partie. Une partie épinglée affiche 📌 et le nom de la référence sur sa ligne, et exporte le contenu de cette référence.

Outils d'IA

Le menu ✦ IA ▾ de la barre supérieure liste les outils d'IA pour la sélection et le document. Chaque résultat de l'IA est d'abord prévisualisé, et une seule annulation défait le tout. Dans une référence, les outils sont désactivés. Voir IA.

  • Pour une Requirement ou un Statement sélectionné : Reformuler clairement…, Ajouter des critères mesurables… (exigences), Simplifier…, Scinder une exigence composée…, Rédiger la justification…, Suggérer un nom…, Vérifier avec l'IA (cette exigence)…, Générer des exigences enfants… et Générer un cas de test… (exigences).
  • Pour tout élément sélectionné : Générer des risques….
  • Pour le document : Générer des exigences…, Résumer le document…, Traduire le document… et Vérifier avec l'IA (N exigences)….

Raccourcis clavier

TouchesAction
⌘F / Ctrl+FRechercher dans le document
Enter / Shift+EnterCorrespondance suivante / précédente (dans la zone de recherche)
⌘↵ / Ctrl↵Ajouter un élément après l'élément sélectionné
⌥⌘↵ / Ctrl+Alt↵Ajouter un enfant à l'élément sélectionné
⌥⇧→ / Alt+Shift+→ / ⌥⇧← / Alt+Shift+←Indenter / désindenter l'élément sélectionné
⌥ / Alt+↑ / ⌥ / Alt+↓Monter / descendre l'élément sélectionné
↑ / ↓Sélectionner la ligne précédente / suivante ; le focus suit
TabChamp suivant : la ligne sélectionnée, puis son numéro, son nom et sa description
Enter / F2Sur une ligne, modifier son nom ; sur un numéro, un nom ou une description, le modifier
Delete ou BackspaceRetirer les éléments sélectionnés du document (Annuler dans le message)
⇧Delete / Shift+DeleteSupprimer les éléments sélectionnés et leurs enfants, après une confirmation
EscDésélectionner ; dans la zone de recherche, effacer la recherche
Enter / EscEnregistrer / annuler la modification d'un numéro ou d'un nom (le focus reste sur le champ)
↑ ↓ Home End dans le planParcourir les éléments du plan
→ / ← dans le planDévelopper / réduire un élément, ou aller à son premier enfant / à son parent
Enter / Space dans le planOuvrir l'élément dans le document (le focus passe à sa ligne) / le sélectionner
⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+ZAnnuler / rétablir (hors d'un éditeur)

Sous Windows et Linux, utilisez Ctrl pour ⌘ / Ctrl et Alt pour ⌥ / Alt. Les raccourcis de ligne fonctionnent lorsqu'aucun champ n'a le focus. ⌘↵ / Ctrl↵ et ⌥⌘↵ / Ctrl+Alt↵ fonctionnent aussi pendant la modification d'un numéro ou d'un nom. Voir Raccourcis clavier et les touches du texte enrichi ci-dessus.

Réglages mémorisés dans ce navigateur

Conservé dans ce navigateur :

  • Si le volet du plan est masqué, et sa largeur.
  • Les colonnes et leurs largeurs par document.
  • Le tri de la liste.
  • La classe courante des nouveaux éléments.
  • Le dernier type de rapport.
  • Les modèles enregistrés avant la version 1.8.0, jusqu'à ce que vous les importiez dans un projet.

Enregistrés avec le document et partagés avec tous les membres du projet : Papier, Statut de traçabilité, le modèle Word, la numérotation du document, le modèle de numérotation et le premier numéro, et la renumérotation automatique. Les modèles Word du projet sont enregistrés avec le projet.

Messages

MessageSignification et correction
Aucun document / « Créez un document avec + Nouveau document, ou importez Word, Excel, CSV ou ReqIF avec Importer. »Le projet n'a encore aucun document.
« Aucun document ne correspond. Effacez la recherche ou choisissez Tous. »Effacez Rechercher des documents… ou cliquez sur Tous.
Document introuvableL'adresse pointe vers un document supprimé. Utilisez Retour aux documents.
Ce document est vide / « Ajoutez une exigence avec “+ Nouvelle exigence”, ou remplissez le document à partir d'un modèle avec Rédiger → Appliquer un modèle…. »Ajoutez des éléments ou appliquez un modèle.
« Aucun élément ne correspond au filtre. Effacez le filtre pour voir tous les éléments. »Modifiez ou effacez les puces de classe et d'étiquette.
Vue filtrée : édition désactivée. Effacer le filtre / « Effacez le filtre ou le tri pour ajouter des entités »La rédaction est suspendue ; cliquez sur l'avertissement pour effacer.
« Saisissez d'abord le texte. »L'ajout rapide a été validé vide.
« L'entité sélectionnée ne peut pas aller plus loin dans ce sens. »L'élément est le premier ou le dernier, il est verrouillé, ou il est à côté d'un élément verrouillé.
« Une entité ne peut pas aller sous son propre enfant. Choisissez un autre parent. »Choisissez une cible en dehors du sous-arbre de l'élément.
Périmé (colonne Score de qualité)Le texte a changé depuis le dernier contrôle de qualité. Relancez-le.
« Impossible de charger les modèles de documents. »Le catalogue des modèles n'a pas pu être chargé ; rechargez la page.
« L'aperçu ne montre que les exports en tableur. Choisissez un export Excel. »L'aperçu ne fonctionne que pour les rapports Excel.
« Ce document n'a pas de référence. Enregistrez-en d'abord une. »Créez une référence avant de lancer des rapports de modifications.
« Échec de l'export : … Vérifiez le modèle Word, puis exportez à nouveau. »Un export Word en un clic a échoué ; vérifiez le modèle dans Modifier les modèles Word….
« L'image dépasse la limite de N Mo. » / « Le fichier dépasse la limite de N Mo. »Le fichier dépasse la limite par fichier du serveur.

Limites

Limite : les noms modifiés dans une ligne de document sont limités à 200 caractères, et les numéros à 139. L'ajout rapide accepte 2 000 caractères.

Limite : les images sont réduites à 4 000 px sur leur plus grand côté. Les fichiers et images joints sont limités par la limite par fichier du serveur (10 Mo avec l'offre Free, 25 Mo avec Individual, 100 Mo avec Team) et par le quota de stockage du projet.

Limite : la sortie Word n'incorpore que les images PNG, JPEG et GIF. Les niveaux de titre au-delà de 6 s'affichent en Titre 6.

Limite : les modèles d'organisation existent sur les serveurs Holarch (hébergés ou auto-hébergés), pas dans l'application de bureau ; l'application de bureau conserve les modèles de projet dans le fichier du projet. Une organisation contient jusqu'à 200 modèles de 3 000 sections chacun au plus. Les modèles enregistrés dans un projet ne sont pas proposés dans les autres projets : enregistrez le modèle dans l'organisation, ou enregistrez-le de nouveau dans l'autre projet.