Holarch

Exigences

Exigences

Écrivez, contrôlez, approuvez, figez en référence et importez des exigences, et suivez les éléments TBD/TBR ouverts et les liens à examiner.

Utilisation →

Sur cette page
  1. Vue d'ensemble
  2. Concepts
    1. Requirement et Statement
    2. Attributs d'exigence
    3. Étiquettes d'exigence
    4. Le flux de travail des exigences
    5. Éléments ouverts : TBD, TBR et TBS
    6. Références
  3. Mode d'emploi
    1. Quand et pourquoi
    2. Rédiger une exigence
    3. Contrôler la rédaction
    4. Rédiger avec les modèles EARS
    5. Approuver des exigences
    6. Figer un document pour une revue
    7. Traiter une modification après la référence
    8. Clore les éléments TBD et TBR
    9. Importer une spécification existante
    10. Exemple complet : la démo CubeSat EO-1
    11. Conseils et bonnes pratiques
    12. Erreurs courantes
    13. Liens avec les autres fonctions
  4. La page Exigences
  5. Qualité des exigences
    1. Disposition de la page
    2. Filtrer la page Qualité
    3. Critères et contrôles
    4. Deux exigences en une (R19)
    5. Exigences dans d'autres langues
    6. Corrections manuelles
    7. Résultats obsolètes
    8. Contrôler la qualité depuis un document
    9. Contrôle des exigences par l'IA
    10. Exports de qualité
  6. Approbations
    1. Le cadre d'approbation
  7. Registre TBD/TBR
  8. Liens à revoir
    1. Ce qui marque un lien à revoir
    2. Où apparaissent les liens à revoir
    3. La page Liens à revoir
  9. Références et comparaison de versions
    1. Références de document
    2. Comparer les versions
    3. Page Références et versions
  10. Importer des exigences
    1. Étape 1 : Fichier
    2. Étape 2 : Correspondance
    3. Étape 3 : Revue
    4. Comment chaque format est lu
    5. Mettre à jour des exigences depuis un tableur
    6. Messages d'importation
  11. Raccourcis des exigences
  12. Paramètres
  13. Messages
  14. Limites
  15. Voir aussi

Vue d'ensemble

Utilisez les pages d'exigences pour rédiger, contrôler, approuver et figer en référence les exigences, et pour suivre ce qui reste ouvert. Une exigence est une entité de la classe LML Requirement : une capacité, une caractéristique ou un facteur de qualité que le système doit posséder.

Les exigences se trouvent généralement dans un document d'exigences (voir Documents). Chacune reste une entité du modèle. La même exigence apparaît donc dans la base de données, dans les diagrammes, dans la matrice de traçabilité et dans la RVTM.

Le groupe Besoins et exigences du rail de navigation contient toutes les pages d'exigences :

PageCe qu'il affiche
DocumentsLes spécifications et leurs plans. C'est ici que les exigences sont rédigées.
ExigencesToutes les exigences dans un seul tableau (la base de données filtrée sur class:Requirement).
QualitéLa qualité des exigences : une note sur neuf critères par exigence.
TBD/TBRLe registre des valeurs ouvertes restant à déterminer ou à revoir.
Liens à revoirLes liens dont l'exigence amont a changé depuis la dernière revue du lien.
ApprobationsLes exigences dont le statut est En revue.
Import et exportL'importation pour Word, Excel, CSV, ReqIF, texte brut, XMI et fichiers de projet, par une seule zone de dépôt, et les exports du modèle.

Les références sont des instantanés figés pour les revues. Créez-les depuis un document ou depuis Contrôle et revues → Références et versions. Les liens vers les fonctions, les actifs et les tests sont traités dans Traçabilité.

Concepts

Requirement et Statement

Statement est la classe parente de Requirement.

  • Utilisez un Statement pour un texte non contraignant : titres de section, hypothèses, contexte.
  • Utilisez un Requirement pour chaque énoncé contraignant en « shall ».

Seuls les Requirements sont notés par le contrôle de qualité, listés dans le registre TBD/TBR, marqués à revoir lorsqu'ils changent et comptés dans la RVTM. Les Statements sont ignorés.

Une exigence possède les champs communs aux entités Numéro, Nom et Description. La description est l'énoncé de l'exigence lui-même, en texte enrichi. Les attributs ci-dessous ajoutent le reste.

Attributs d'exigence

AttributType et valeursSignification
JustificationTexte longLa raison d'être de l'exigence.
StatutBrouillon, En revue, Approuvé, RejetéL'étape de l'exigence dans le flux d'approbation.
PrioritéÉlevé, Moyen, FaibleL'importance de l'exigence pour les parties prenantes.
CriticitéÉlevé, Moyen, FaibleConséquence pour la mission ou la sécurité si l'exigence n'est pas satisfaite.
ResponsableTextePersonne ou équipe responsable de l'exigence.
SourceTextePartie prenante, document ou norme dont provient l'exigence.
Méthode de vérificationChoix multiple : Analyse, Démonstration, Inspection, TestLa manière dont l'exigence est vérifiée.
Niveau de vérificationComposant, Sous-système, SystèmeNiveau d'assemblage auquel l'exigence est vérifiée.
Critères de réussiteTexte longRésultat mesurable qui montre que l'exigence est satisfaite.
TBD/TBRAucun, TBD, TBRTBD = une valeur reste à déterminer ; TBR = une valeur reste à revoir. Remettez sur Aucun une fois clos.
Propriétaire TBDTextePersonne chargée de clore le TBD/TBR.
Échéance TBDDate et heureDate à laquelle le TBD/TBR doit être clos. Échéance dans le groupe Flux de travail affiche et définit la même date (voir Registre TBD/TBR).
Score de qualitéPourcentage, calculéRésultat du dernier contrôle de qualité.
Appropriée, Complète, Conforme, Correcte, Faisable, Nécessaire, Singulière, Non ambiguë, VérifiableOui/Non, calculé ou défini à la mainLes neuf critères de qualité.

L'inspecteur regroupe les champs d'une exigence (voir L'inspecteur) : Exigence (Numéro, Nom, Description, Étiquettes, Justification, Source, Critères de réussite), Flux de travail (le bandeau de revue avec Statut, Priorité, Criticité, Propriétaire, Responsable, Échéance, TBD/TBR, Propriétaire TBD, Échéance TBD), Vérification (méthode et niveau de vérification, Verified by, et les champs de clôture avec le programme formel), Valeurs (quantité budgétée, seuil, objectif et valeur actuelle, unités), Conformité (programme formel) et Qualité.

Le score et les neuf critères se trouvent dans le groupe Qualité, replié au départ. Son titre indique par exemple « 89 % · 8 sur 9 satisfaits », ou « pas encore contrôlée ». Holarch mémorise, par classe, si vous avez laissé le groupe ouvert.

Les projets peuvent ajouter leurs propres attributs et choix d'exigence ; voir Extensions du schéma.

Étiquettes d'exigence

Les étiquettes classent les exigences sans changer leur classe. Les étiquettes d'exigence intégrées sont :

  • Exigence fonctionnelle, Exigence de performance, Exigence d'interface.
  • Exigence environnementale, Exigence de fiabilité, Exigence de sécurité.
  • Verification Requirement.
  • Besoin des parties prenantes : un besoin exprimé par une partie prenante, avant sa transformation en exigences système.

Méthode de vérification est aussi un groupe d'étiquettes, avec les étiquettes Analyse, Démonstration, Inspection et Test. L'étiquette et l'attribut restent synchronisés, dans la même étape d'annulation :

  • Ajouter l'étiquette Test définit la méthode de vérification sur Test.
  • Choisir Test dans l'attribut ajoute l'étiquette.

Les projets plus anciens et les importations qui ne portent que les étiquettes sont fusionnés dans l'attribut à l'ouverture du projet.

Le flux de travail des exigences

Chaque exigence passe par quatre statuts :

  1. Brouillon : en cours de rédaction.
  2. En revue : en attente d'une décision. Listée sur la page Approbations.
  3. Approuvé ou Rejeté : décidée. Chaque décision enregistre qui l'a prise, quand, et un motif facultatif.

Après l'approbation, trois mécanismes garantissent la fiabilité de l'historique :

  • Nouvelle revue après modification. Modifier le nom ou la description d'une exigence approuvée la ramène à En revue, avec la note « Texte modifié après approbation ».
  • Qualité obsolète. Modifier le nom ou la description marque ses résultats de qualité comme obsolètes et efface les corrections manuelles de qualité.
  • Liens à revoir. Modifier le nom, la description ou un attribut clé marque à revoir les liens vers les éléments situés en aval.

Les trois font partie de la modification, donc une seule annulation (⌘Z / Ctrl+Z) les défait ensemble.

Éléments ouverts : TBD, TBR et TBS

Un élément ouvert est une valeur qui n'est pas encore arrêtée. Une exigence est un élément ouvert lorsque l'une des conditions est vraie :

  • Son attribut TBD/TBR vaut TBD ou TBR.
  • Son nom ou sa description contient le mot TBD, TBR ou TBS.

Les éléments ouverts figurent dans le registre TBD/TBR jusqu'à leur clôture.

Références

Une référence est un instantané en lecture seule. Il en existe deux sortes :

  • Une référence de document contient un document. Elle comprend l'artefact du document, ses éléments et leurs attributs, les relations qui les touchent, les entités situées à un saut, et les paramètres de plan du document.
  • Une référence de projet contient toutes les entités et relations du projet.

Les références peuvent porter des enregistrements d'approbation (nom, rôle, déclaration, date). Les enregistrements sont verrouillés une fois enregistrés.

Mode d'emploi

Quand et pourquoi

Le travail sur les exigences couvre le côté gauche du V de l'ingénierie système :

  1. Recueillir les besoins des parties prenantes.
  2. Dériver les exigences système.
  3. Contrôler que chaque énoncé est bien formé.
  4. Faire approuver les exigences.
  5. Les figer lors d'une revue (SRR, PDR, CDR).

Après la référence, le travail passe à la maîtrise des modifications. Chaque modification fait l'objet d'une nouvelle revue et son impact en aval est contrôlé. Les valeurs TBD/TBR ouvertes sont closes avant que la conception soit engagée.

Les pages d'exigences répondent à ces questions :

QuestionPage
Chaque exigence est-elle bien rédigée ?Qualité
Quelles valeurs sont encore inconnues, qui en est responsable, et sont-elles en retard ?TBD/TBR
Que faut-il recontrôler parce qu'une exigence a changé ?Liens à revoir
Qu'est-ce qui attend une décision ?Approbations
Qu'est-ce qui a changé depuis la revue ?Version ▾ → Comparer les versions… du document, Références et versions
Chaque exigence est-elle allouée et vérifiée ?Matrice de traçabilité et RVTM

Les pages Qualité, Liens à revoir, TBD/TBR et Approbations se suivent sous Besoins et exigences dans le rail. Parcourez de là les quatre contrôles l'un après l'autre.

Rédiger une exigence

  1. Ouvrez Besoins et exigences → Documents.
  2. Ouvrez le document d'exigences.

    Pour en créer un, cliquez sur + Nouveau document (voir Documents).

  3. Dans la barre Ajout rapide sous le document, choisissez l'emplacement de l'élément, par exemple Sous 3 Electrical Power.
  4. Saisissez l'énoncé de l'exigence et appuyez sur Enter.

    Holarch ajoute un élément de la classe par défaut du document (Requirement dans un document d'exigences). Il est numéroté à la suite de ses voisins.

  5. L'exigence étant sélectionnée, ouvrez l'inspecteur à droite.
  6. Renseignez Justification, Source et Critères de réussite dans le groupe Exigence, Priorité, Criticité et Propriétaire dans Flux de travail, et Méthode de vérification et Niveau de vérification dans Vérification.
  7. Ajoutez une étiquette de type avec + Étiquette dans le groupe Exigence de l'inspecteur, par exemple Exigence de performance. (La colonne Étiquettes se trouve sous Affichage ▾ → Colonnes ▸.)

L'exigence a le statut Brouillon et apparaît dans Besoins et exigences → Exigences.

Si une valeur n'est pas encore connue :

  1. Écrivez votre meilleure estimation dans l'énoncé.
  2. Définissez TBD/TBR sur TBD.
  3. Renseignez Propriétaire TBD, et définissez la date dans Échéance du groupe Flux de travail.

    L'exigence apparaît maintenant aussi dans le registre TBD/TBR, avec cette échéance.

Contrôler la rédaction

  1. Ouvrez Besoins et exigences → Qualité.

    Depuis un document, choisissez plutôt Contrôler ▾ → Contrôler la qualité.

  2. Dans la barre de portée, choisissez Toutes les exigences ou Document : <nom>.
  3. Cliquez sur Contrôler la qualité dans l'en-tête de la page.

    Le message indique « 32 exigences contrôlées » (ou votre nombre). Chaque exigence reçoit un score de 0 à 100 % et un ✔ ou un ✘ par critère.

    Au-delà de 2 000 exigences, le contrôle s'exécute en arrière-plan : la carte de progression affiche « Contrôle des exigences », le nombre et le temps restant, et vous pouvez continuer à travailler. Cliquez sur Annuler sur la carte pour arrêter ; rien ne change. La carte indique ensuite « Enregistrement des résultats de qualité » avec le nombre enregistré ; pendant l'enregistrement, les autres modifications sont refusées avec « Enregistrement des résultats de qualité. Réessayez quand il est terminé. » Seules les exigences dont les résultats ont changé sont enregistrées : contrôler à nouveau sans modification n'enregistre donc rien. Le contrôle entier est une seule étape : un ⌘Z / Ctrl+Z le supprime.

  4. Lisez les tuiles : Exigences, Score moyen, Bonne (≥ 67 %), À retravailler (< 67 %) et, s'il y en a, Obsolète (texte modifié).
  5. Pour chaque exigence sous 67 %, lisez la colonne Suggestions.

    Ou pointez sur un ✘ pour voir les messages de ce critère.

  6. Cliquez sur le nom de l'exigence pour l'ouvrir, et corrigez le texte.
  7. Relancez le contrôle.

Correcte et Faisable demandent toujours le jugement d'une personne. Le contrôle ne les marque jamais comme satisfaits, quels que soient les résultats des autres contrôles. Le contrôle automatique atteint donc au plus 7 critères sur 9 (78 %). Une exigence sans test ni exigence de vérification atteint 6 sur 9 (67 %). Pour chaque exigence, décidez-en vous-même :

  • Après avoir revu l'exigence, cliquez sur le ✘ pour marquer le critère Oui.
  • Pour un premier avis, utilisez ✦ IA ▾ → Vérifier avec l'IA (N exigences)… (le contrôle des exigences par l'IA).

Note : les scores enregistrés par des versions antérieures pouvaient compter Correcte ou Faisable comme satisfaits alors qu'un autre contrôle échouait. Relancez le contrôle pour les mettre à jour.

Rédiger avec les modèles EARS

EARS (Easy Approach to Requirements Syntax) écrit chaque exigence en une phrase : une condition facultative, puis « the [system] shall [response] ». Le premier mot de la condition détermine le modèle.

ModèleGabaritExemple
UbiquitousThe [system] shall [response].The pump controller shall record every start command with its time.
Event-drivenWhen [trigger], the [system] shall [response].When the tank level falls below 20 %, the pump controller shall start the backup pump.
State-drivenWhile [state], the [system] shall [response].While the vehicle is charging, the battery manager shall keep each cell below 45 °C.
Unwanted behaviorIf [unwanted condition], then the [system] shall [response].If the supply voltage drops below 10 V, then the flight computer shall switch to the reserve battery.
Optional featureWhere [feature is included], the [system] shall [response].Where a heated windshield is fitted, the climate controller shall clear frost within 5 minutes.
ComplexWhile [state], when [trigger], the [system] shall [response].While the drill is in standby, when the operator presses Start, the drill controller shall reach full speed within 3 s.
  1. Ouvrez une exigence dans l'inspecteur ou dans la vue d'élément.
  2. Cliquez sur EARS ▾ à côté de Description.

    La première ligne indique le modèle de l'énoncé (✓ Event-driven) ou ce qu'il faut corriger (Aucun modèle EARS : 1 à corriger).

  3. Choisissez un modèle.

    Son gabarit devient la description. Si l'exigence en a déjà une, confirmez avec Remplacer ; l'ancien énoncé reste dans l'historique de l'élément. Un ⌘Z / Ctrl+Z l'annule.

  4. Remplacez les mots entre crochets.

Pour contrôler toutes les exigences, réglez Requirement.11 sur Avertissement ou Erreur dans Contrôles du modèle → Paramètres. Ce contrôle est désactivé par défaut.

Dans un projet SysML v2, EARS ▾ se trouve sous la Documentation d'une exigence dans l'inspecteur et écrit son commentaire doc.

Approuver des exigences

  1. Lorsqu'une exigence est prête, réglez son Statut sur En revue.

    Faites-le dans l'inspecteur (le statut dans le bandeau de revue du groupe Flux de travail), dans la base de données ou dans une colonne de document.

  2. Le relecteur ouvre Besoins et exigences → Approbations.

    La page liste toutes les exigences dont le statut est En revue.

  3. Cliquez sur une ligne.

    Le groupe Flux de travail de l'inspecteur affiche le bandeau de revue : le statut, qui l'a défini et quand (« par J. Rivera · 9 mars 2026 à 9 h 58 ») et les boutons.

  4. Cliquez sur Approuver.

    Ou cliquez sur Rejeter… et saisissez un motif facultatif.

    Le message indique « Approuvé » ou « Rejeté ». La décision est enregistrée avec votre nom et l'heure, et l'exigence quitte la liste Approbations.

    Lorsque l'exigence fait partie d'une référence et que des éléments de vérification ou des documents la tracent, Approuver ouvre d'abord une boîte de dialogue qui les liste sous À revoir (Impact). Cliquez sur une ligne pour l'examiner, puis sur Approuver pour confirmer.

Pour renvoyer en revue une exigence décidée, cliquez sur Rouvrir. Le message indique « Passé à En revue ».

Si le projet a un flux de travail sur le Statut des exigences (Schéma → Workflow), le bandeau de revue affiche les transitions de ce flux au lieu de Approuver, Rejeter… et Rouvrir. Une transition qui demande une approbation se termine par … et ouvre Demander une approbation : voir Demander une approbation pour un changement d'état. Pour une exigence incluse dans une référence, Demander une approbation et la boîte de dialogue Approuver… de la demande de modification affichent la même liste À revoir.

Figer un document pour une revue

  1. Dans le cartouche du document, cliquez sur Version ▾.
  2. Choisissez Enregistrer la référence….

    Ou choisissez Livrer ▾ → Version ▸ Enregistrer la référence….

  3. Conservez ou modifiez le Nom. Par défaut : « <document> Baseline <n> ».
  4. Sous Approbations, remplissez une ligne par approbateur : Nom, Rôle et Déclaration (par défaut « Approuvé pour publication. »).

    + Ajouter un approbateur ajoute une ligne ; × en retire une.

  5. Cliquez sur Créer.

    Le message indique « Référence enregistrée ». Version ▾ indique « Actuel · dernière référence <nom> ».

Désormais, chaque ligne reçoit une barre de modification lorsqu'elle diffère de la dernière référence.

Traiter une modification après la référence

  1. Modifiez le texte de l'exigence dans le document.

    Un message résume ce qui s'est passé, par exemple « 1 exigence approuvée passée à En revue ; 6 liens marqués à revoir. » Dans le cadre de votre modification (une seule annulation défait le tout) :

    • Une exigence approuvée passe à En revue.
    • Ses résultats de qualité deviennent obsolètes (« Qualité : périmée — relancer »).
    • Ses liens en aval sont marqués à revoir.
  2. Ouvrez Besoins et exigences → Liens à revoir.
  3. Pour chaque ligne, cliquez sur Diff pour voir la modification du texte, et revoyez l'élément lié.
  4. Lorsqu'un élément lié reste valable, cliquez sur Marquer comme revu… sur sa ligne.

    Pour en marquer plusieurs à la fois, sélectionnez leurs lignes et cliquez sur Marquer la sélection comme revue….

  5. Indiquez ce que vous avez vérifié et cliquez sur Marquer comme revu.
  6. Relancez le contrôle de qualité.
  7. Soumettez de nouveau l'exigence à l'approbation.
  8. Cliquez sur Version ▾ → Comparer les versions…, choisissez la référence sous De et Version actuelle sous À.

    Le rapport liste toutes les modifications depuis la référence.

  9. Cliquez sur Modifications (Excel) pour le comité des modifications.

Clore les éléments TBD et TBR

  1. Ouvrez Besoins et exigences → TBD/TBR.
  2. Lisez les tuiles : TBD/TBR ouverts, En retard, Aucun propriétaire, et le nombre par document.
  3. Traitez d'abord les lignes en retard. Elles sont teintées, avec « En retard » sous l'échéance.
  4. Lorsque le propriétaire affiche « — », attribuez un Propriétaire TBD.
  5. Lorsqu'une valeur est arrêtée, modifiez le texte de l'exigence avec la valeur finale.
  6. Cliquez sur Clore sur la ligne.

    Clore règle TBD/TBR sur Aucun, et la ligne quitte le registre.

Pour envoyer le registre aux propriétaires, cliquez sur Exporter en XLSX.

Importer une spécification existante

  1. Ouvrez Besoins et exigences → Importer et exporter.
  2. Déposez le fichier sur la zone de dépôt, ou cliquez dessus pour choisir le fichier : Word (.docx), Excel ou CSV, ReqIF ou texte brut.

    La ligne d'état indique par exemple « “SRS.docx” analysé : 48 lignes, 5 colonnes. » Format affiche le format détecté.

  3. Cliquez sur Continuer.
  4. Vérifiez la correspondance de chaque colonne et réglez Classe des lignes sans classe sur Requirement.
  5. Cliquez sur Continuer.
  6. Laissez Créer un document d'exigences à partir de ces N exigences coché, vérifiez le type et le nom du document, et vérifiez les éléments nouveaux et mis à jour ainsi que les avertissements.
  7. Cliquez sur Importer N éléments.

    Sans avertissement, Holarch ouvre le nouveau document. Avec des avertissements, la carte Importation terminée les liste.

La carte Importation terminée a des boutons pour ouvrir le document, la base de données, un diagramme Spider ou en arbre, ou le contrôle de qualité. Un ⌘Z / Ctrl+Z supprime toute l'importation.

Exemple complet : la démo CubeSat EO-1

Créez le projet de démonstration CubeSat EO-1 — Earth Observation Demo depuis Gérer les projets. Il contient une spécification de 32 exigences, SRS-001 EO-1 System Requirements Specification, avec une référence SRR et des modifications faites après elle.

Qualité.

  1. Ouvrez Besoins et exigences → Qualité et cliquez sur Contrôler la qualité.

    Les tuiles affichent 32 exigences, une moyenne de 92 %, 29 bonnes et 3 à retravailler.

Les trois exigences faibles sont rédigées ainsi exprès. Chacune obtient 44 % :

  • 2.5 Safe Mode Recovery : « The spacecraft should recover from safe mode quickly and resume imaging as appropriate ». Les suggestions comprennent :
    • « R34 - Terme(s) de performance non mesurable(s) : [quickly] »
    • « R8 - Des clauses d'échappatoire affaiblissent l'exigence : [as appropriate] »
    • « R19 - Réunit deux exigences ; séparez-les en exigences distinctes : [and] »
    • « Terminez l'énoncé par un point. »
    • « Liez un Test Case ou une Requirement qui la vérifie. »
  • 3.5 Battery Thermal Control : « …keep the battery warm enough (TBD). » Les suggestions sont « R21 - Contient des parenthèses ; déplacez le texte entre parenthèses dans la justification. » et « Remplacez les marqueurs TBD/TBR. »
  • 6.4 Operator Interface : « …shall be user friendly and/or easy to use. » Les suggestions sont « R34 - Terme(s) de performance non mesurable(s) : [user friendly, easy to use] » et « R19 - « et/ou » est ambigu ; indiquez si les deux ou l'un des deux est visé : [and/or] ».

Pour corriger 2.5 :

  1. Réécrivez-la en « The spacecraft shall resume imaging within 6 hours of a safe mode entry. »
  2. Liez un cas de test avec verified by.
  3. Relancez le contrôle.

    Les messages de combinaison, de clause d'échappatoire et de terme vague disparaissent.

TBD/TBR. Ouvrez TBD/TBR. La page affiche trois éléments ouverts :

  • 3.5 Battery Thermal Control : un TBD dont le propriétaire est le Thermal Engineer. Il est en retard.
  • 2.4 Target Slew (ADCS Lead) et 5.3 Downlink Link Margin (Comms Lead) : des TBR à échéance plus tardive.

Modification après la référence. Le menu Version ▾ du document liste SRR Baseline. Elle a été approuvée par J. Rivera (Systems Lead), R. Okafor (Mission Principal Investigator) et L. Brandt (Program Manager).

Après la SRR, l'exigence 3.1 Orbit Average Power est passée de 28 W à 30 W. Comme 3.1 était approuvée, elle est revenue à En revue avec la note « Texte modifié après approbation ».

Liens à revoir liste six liens issus de 3.1 :

  • 1.3.1 Solar Arrays
  • F3 Generate and Store Power et F3.1 Convert Sunlight to Power
  • EQ-1.1 Solar Power Generation et EQ-1.4 Power Margin Check
  • TC-06 Solar Array Power Test

Cliquez sur Diff sur n'importe quelle ligne : « 28 W » est barré et « 30 W » inséré. Revoyez ensuite les éléments :

  • TC-06 attend une puissance crête ≥ 72 W et a mesuré 75,1 W. Par EQ-1.3 Orbit-Average Array Power (crête × 0,62 de fraction éclairée × 0,6 de rendement de la chaîne de puissance), 75,1 W donnent 27,9 W en moyenne orbitale, sous les nouveaux 30 W. Laissez ce lien non revu et ajoutez le commentaire « 75,1 W crête = 27,9 W en moyenne orbitale ; retester avec environ 80,6 W crête ». Le test a besoin d'un nouveau résultat attendu et d'une nouvelle exécution.
  • Vérifiez que le dimensionnement du panneau solaire tient toujours avant de marquer 1.3.1 comme revu.

Comparer à l'actuel. Choisissez SRR Baseline dans Version ▾, puis cliquez sur Comparer à l'actuel dans son bandeau. Le rapport liste :

  • Les modifications de description, de justification, de statut et de score de qualité de 3.1.
  • Le changement de statut de 2.4 Target Slew (Brouillon → En revue).
  • La nouvelle exigence 4.4 Downlink Encryption, avec ses deux nouveaux liens satisfies.

Approbations. Ouvrez Approbations. Neuf exigences sont En revue, dont 3.1, 1.5 Daily Collection Volume et 5.3 Downlink Link Margin.

Conseils et bonnes pratiques

  • Écrivez un seul « shall » par exigence, à la voix active, avec un nombre, une unité et une condition. Le contrôle de qualité récompense exactement cela.
  • Mettez la raison dans Justification, pas dans l'énoncé. Les expressions de but (« so that », « in order to ») et les parenthèses sont signalées comme R20 et R21.
  • Renseignez Méthode de vérification pendant la rédaction. Une exigence avec une méthode mais sans cas de test apparaît alors comme Prévu seulement dans la RVTM, au lieu de Non vérifié.
  • Définissez TBD/TBR avec un propriétaire et une échéance, plutôt que de taper seulement « TBD » dans le texte. L'attribut donne au registre un propriétaire et une échéance à suivre.
  • Créez une référence avant chaque revue. Les barres de modification et Comparer à l'actuel ne fonctionnent que par rapport à une référence.
  • Marquez les liens comme revus avec un commentaire. Le commentaire est ajouté à l'élément lié et enregistré sur le lien, si bien que la revue laisse une piste d'audit.

Erreurs courantes

SymptômeCauseCorrection
Une exigence n'est pas notée, n'est pas dans le registre ou n'est pas dans la RVTM.C'est un Statement, pas une Requirement.Changez sa classe en Requirement dans l'inspecteur.
Correcte et Faisable affichent ✘ sur chaque exigence.Ils demandent le jugement d'une personne (« Demande le jugement d'un relecteur »).Revoyez chacune et cliquez sur le ✘ pour la marquer Oui, ou lancez le contrôle des exigences par l'IA.
Le score affiche « Obsolète — relancer ».Le texte a changé depuis le dernier contrôle.Cliquez sur Contrôler la qualité, ou activez Recontrôler automatiquement quand le texte change.
Les corrections manuelles Oui/Non ont disparu.Modifier le texte les efface.Définissez-les de nouveau après la revue ; Annuler les rétablit, et elles restent dans l'historique.
Une exigence n'est plus approuvée après la correction d'une faute de frappe.Toute modification du nom ou de la description rouvre une exigence approuvée.Approuvez-la de nouveau. Corrigez les fautes de frappe avant l'approbation.
« Clore » manque sur une ligne TBD/TBR.L'élément ouvert vient uniquement du texte.Modifiez le texte pour retirer TBD, TBR ou TBS.
Une importation a créé des copies au lieu de mettre à jour.Rapprocher les entités existantes par n'a rien trouvé.Exportez avec la colonne ID, modifiez, puis importez avec Rapprocher les entités existantes par : ID global (voir Mettre à jour des exigences depuis un tableur).

Liens avec les autres fonctions

  • Alimenté par : les contributions des parties prenantes et les spécifications existantes par Importer, et les documents rédigés dans Documents.
  • Alimente :
  • IA : le menu ✦ IA ▾ du document et de la vue d'élément propose Reformuler clairement…, Ajouter des critères mesurables…, Simplifier…, Scinder une exigence composée…, Rédiger la justification…, Suggérer un nom… et Vérifier avec l'IA (le contrôle des exigences par l'IA). Les modifications de l'IA sont prévisualisées avant d'être appliquées. Voir Demander à l'IA et outils d'IA.

La page Exigences

Utilisez la page Exigences pour voir et modifier toutes les exigences dans un seul tableau. Besoins et exigences → Exigences est la base de données filtrée sur class:Requirement.

Toutes les fonctions de la base de données fonctionnent ici :

  • Trier et filtrer les colonnes, et modifier les cellules sur place.
  • Sélectionner des lignes pour la barre d'actions groupées, afin de définir des attributs ou des étiquettes sur de nombreuses exigences à la fois.
  • Exporter, et ouvrir la matrice de traçabilité pour les lignes sélectionnées.

Cliquez sur une ligne pour afficher l'exigence dans l'inspecteur. Double-cliquez dessus pour ouvrir sa vue d'élément. Une exigence ayant un lien à revoir affiche un badge ⚠ Revoir sur sa ligne. Cliquez avec le bouton droit sur une ligne pour son menu : jusqu'à trois actions suggérées avec leurs raisons (par exemple ✦ Ajouter des critères mesurables… lorsque l'exigence échoue au critère Non ambiguë, ✦ Générer un cas de test… lorsqu'elle n'est pas vérifiée), ✦ Plus d'IA ▸, puis Ouvrir, Renommer…, Dupliquer, Ajouter un enfant…, Statut ▸, Priorité ▸, Relier à ▸, Ajouter au document ▸, Afficher dans le diagramme ▸, Copier le lien, Copier le numéro et Supprimer… (voir Menu contextuel).

Voir Le modèle et la base de données pour le tableau, les requêtes et la modification groupée.

Requêtes utiles :

RequêteMontre
class:RequirementToutes les exigences.
Requirement:"Status=In Review"La liste Approbations.
Requirement:"Status=Draft"Les exigences pas encore envoyées en revue.
class:Requirement AND is:leafLes exigences feuilles (sans exigence enfant).
class:Requirement AND NOT relationship:"verified by"Les exigences sans élément de vérification.

Qualité des exigences

Utilisez la page Qualité (titre « Qualité des exigences ») pour trouver les exigences mal rédigées. Elle note chaque exigence selon neuf critères.

Les neuf critères et les numéros de règle des suggestions (R2, R19, etc.) suivent les caractéristiques et les règles du Guide to Writing Requirements de l'INCOSE. Les listes de mots et les motifs de Holarch approchent ces règles ; ils ne reprennent pas le texte du guide, et certaines règles demandent le jugement d'un relecteur.

  • Score = 100 × (critères satisfaits) / 9, arrondi. Un critère non contrôlé (–, voir Exigences dans d'autres langues) est exclu : 100 × satisfaits / 8.
  • 67 % ou plus est Bonne. Sous 67 %, c'est À retravailler.
  • La barre est rouge sous 34 %, jaune de 34 % à 66 %, et verte à partir de 67 %.

Disposition de la page

  • En-tête de la page :
    • Plus ▾ : Effacer les évaluations manuelles réinitialise tous les Oui/Non manuels des exigences affichées et relance le contrôle. Ouvrir dans Exigences ouvre les exigences affichées dans le tableau Exigences. Ouvrir le document apparaît lorsque la portée est un document.
    • Exporter ▾ : Excel (.xlsx) et CSV, des exigences affichées.
    • Contrôler la qualité : contrôle toutes les exigences de la portée, quels que soient les filtres (la règle des doublons compare chaque exigence aux autres exigences de la portée).
  • ✦ IA ▾ (dans la barre supérieure) : Vérifier avec l'IA (N exigences)…, le contrôle par l'IA des exigences affichées.
  • Barre de portée : Portée (Toutes les exigences ou Document : <nom>) et la case Recontrôler automatiquement quand le texte change. Liens à revoir, TBD/TBR et Approbations se trouvent à côté de Qualité dans le rail.
  • Barre de requête : + Filtre, les puces de filtre et le texte de recherche, Effacer, ? (syntaxe de recherche) et Vues ▾ : la même barre que sur la page Exigences (voir Filtrer la page Qualité).
  • Tuiles : Exigences (« 12 sur 40 » sous Exigences affichées lorsque des filtres en masquent), Score moyen, Bonne (≥ 67 %), À retravailler (< 67 %), et Obsolète (texte modifié) lorsqu'il y en a d'obsolètes. Les scores obsolètes sont exclus de la moyenne.
  • Note sous les tuiles : « Les contrôles automatiques atteignent au plus 7 attributs sur 9 (78 %) ; Correcte et Faisable exigent une vérification humaine — cliquez sur un ✘ pour le marquer Oui. Chaque clic passe successivement par Oui manuel, Non manuel et retour à l'automatique. »
  • Tableau : Numéro, Nom (avec la description en dessous), Score de qualité, une colonne par critère, et Suggestions. Suggestions liste tous les messages, précédés de leur critère. Les lignes sont triées par numéro. Cliquez avec le bouton droit sur une ligne, ou appuyez sur Shift+F10 dessus, pour le menu de ligne de la base de données : actions suggérées avec leurs raisons (la reformulation qui corrige un critère échoué vient en premier), ✦ Plus d'IA ▸, Ouvrir, Renommer…, Dupliquer, Ajouter un enfant…, Statut ▸, Priorité ▸, Relier à ▸, Ajouter au document ▸, Afficher dans le diagramme ▸, Copier le lien, Copier le numéro et Supprimer…. La ligne devient la sélection.
  • Plusieurs lignes : ⌘ / Ctrl-clic (Ctrl-clic sous Windows et Linux) bascule une ligne, ⇧ / Shift-clic sélectionne la plage depuis la dernière ligne cliquée, ⌘ / Ctrl+⇧ / Shift-clic ajoute cette plage, et ⌘A / Ctrl+A ou ⇧ / Shift+↑ / ⇧ / Shift+↓ sur une ligne active sélectionnent toutes les lignes ou étendent la sélection. La barre d'outils affiche le nombre ; Esc l'efface. Cliquez avec le bouton droit sur une ligne sélectionnée pour agir sur toutes : ✦ 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)… (chacune avec un seul aperçu ; voir L'IA sur plusieurs éléments sélectionnés), Dupliquer n entités, Définir le statut ▸, Définir la priorité ▸, Ajouter au document ▸ et Supprimer n éléments… ; une seule annulation défait chacune d'elles. Le registre TBD/TBR et Liens à revoir fonctionnent de la même façon ; dans Liens à revoir, la sélection coche aussi les lignes pour Marquer la sélection comme revue….

Cas particuliers :

  • Une ligne sans résultat affiche « Non exécuté » dans la colonne du score.
  • Une ligne obsolète affiche « Obsolète — relancer ».
  • Lorsque la portée ne contient aucune exigence, la page affiche « Aucune exigence » et « Seules les entités de la classe Requirement sont notées ; les Statements sont ignorés. »
  • Lorsque les filtres ou le texte de recherche masquent toutes les exigences, la page affiche « Aucune exigence correspondante » et « Aucune exigence ne correspond à la recherche ou aux filtres. Effacez-les pour voir toutes les exigences. »

Filtrer la page Qualité

La barre de requête fonctionne comme sur la page Exigences (voir Comment les filtres saisis deviennent des puces) : les termes de filtre saisis deviennent des puces lorsque vous appuyez sur Enter, le reste du texte est recherché dans le nom, le numéro et la description, Backspace dans une recherche vide retire la dernière puce, et Effacer les retire toutes. Les tuiles, le tableau, Exporter ▾ et ✦ IA ▾ → Vérifier avec l'IA suivent les filtres.

+ Filtre liste, avec les nombres pour la portée :

GroupeFiltresTerme
QualitéBonne (≥ 67 %), À retravailler (< 67 %), Non exécuté, Obsolète (texte modifié), Évaluations manuelles, Constat de l'IAquality:good, quality:rework, quality:notrun, quality:stale, quality:manual, quality:ai
Échoue à un critèreUn par critère : évalué Nonquality:Verifiable=no (=yes : évalué Oui)
Constat de règleLes règles trouvées dans la portée, comme R7 Formulation imprécise ou R30 Très ressemblant (doublons possibles)quality:R7
Structure, Classe, Attributs d'exigence, Étiquette, Relation, DiagrammeComme sur la page Exigences ; les attributs d'exigence sont listés sans puce de classeis:tbd, Requirement:"Status=Draft", label:"…"

Les filtres d'un même groupe se combinent avec ou ; les groupes différents se combinent avec et. Les plages de score utilisent l'attribut : Requirement:"Quality Score>=50". Les termes quality: fonctionnent aussi sur la page Exigences et dans la base de données.

Vues ▾ applique une vue intégrée (À retravailler, Pas encore contrôlée, Résultats obsolètes, Ambiguë, Non vérifiable, Doublons possibles, Évaluations manuelles) ou l'une de vos vues enregistrées. Enregistrer la vue… enregistre les filtres et le texte de recherche actuels dans ce navigateur, pour tous les projets ; Supprimer « <nom> » apparaît tant qu'une vue enregistrée est utilisée. Toutes les exigences efface les filtres. L'adresse quality?q=<query> ouvre la page filtrée.

Le filtrage lit les résultats enregistrés et ne recontrôle pas. Sur 50 000 exigences, un changement de filtre ou de recherche prend bien moins d'un dixième de seconde.

Critères et contrôles

Chaque critère affiche l'une de trois marques :

  • ✔ (Oui) : aucun message.
  • ✘ (Non) : au moins un message.
  • – : non contrôlé.

Les contrôles recherchent des mots et des expressions entiers, sans tenir compte de la casse. Seules les formes listées comptent : « effective » et « effectively » sont toutes deux listées, « effectiveness » ne l'est pas. Les mots entre guillemets comptent aussi. Les messages ci-dessous sont le texte exact affiché. La liste entre crochets à la fin d'un message nomme les mots trouvés.

Non ambiguë

RègleMessageSe déclenche sur
R6R6 - Unité(s) non reconnue(s) ; utilisez des unités SI, usuelles américaines ou impériales : [...]Un nombre suivi d'un mot qui n'est pas une unité connue (par exemple « 12 sorties »). Les unités connues comprennent les unités SI, usuelles américaines et impériales et leurs abréviations, %, les degrés, °C et °F.
R2R2 - Utilisez la voix active : [...]« shall/must/will/should be » suivi d'un participe passé (« shall be measured »).
R5R5 - Utilisez des articles définis (« le », « la ») au lieu de : [...]« a » ou « an ».
R7R7 - Formulation imprécise : [...]some, many, several, few, little, much, various, appropriate(ly), adequate(ly), efficient(ly), effective(ly), sufficient(ly), reasonable, reasonably, suitable, suitably, significant(ly), minimal(ly), maximal(ly), approximately, almost, nearly, generally, usually, typically, normally, robust(ly), flexible, flexibly, easy, easily, etc, similar, relevant, substantial(ly), large, small, good, bad, better, best, worst, proper, properly, acceptable, acceptably, accurate(ly), extreme, high-contrast, high contrast.
R8R8 - Des clauses d'échappatoire affaiblissent l'exigence : [...]if necessary, where possible, as appropriate, as practicable, as far as possible, if practical, as required, as needed, to the extent possible, if possible.
R10R10 - Proposition(s) infinitive(s) inutile(s) : [...]to be designed to, to be able to, to be capable of, to enable, to allow, be able to, be capable of.
R16R16 - Évitez la négation : [...]not, n't, never.
R17R17 - Évitez la barre oblique (« / »).Une barre oblique entre deux mots, sauf km/h, m/s, and/or et ses équivalents en allemand, français, espagnol, italien et néerlandais.
R24R24 - Pronom(s) au lieu de noms explicites : [...]it, its, they, them, their, he, she, him, her, someone, something, anyone, anything, anybody, somebody, this, these, those.
R32R32 - Utilisez « chaque » au lieu des quantificateurs universels : [...]all, any, both, every, everything, everyone.
R34R34 - Terme(s) de performance non mesurable(s) : [...]fast, quick, quickly, user friendly, user-friendly, high speed(s), high-speed, best practice(s), state of the art, state-of-the-art, seamless(ly), intuitive(ly), easy to use, timely, rapid, rapidly, real-time, real time. « Real-time clock » ne compte pas : il nomme un composant.
R35R35 - Mot(s) de temporalité peu clair(s) : [...]as, eventually, before, after, until, meanwhile, simultaneous(ly), soon, later, sometimes, occasionally, often, subsequently, previously.
—Remplacez les marqueurs TBD/TBR.TBD, TBR ou TBS dans la description (en majuscules).
—IA : ambiguë — <motif>Un constat de l'IA accepté depuis le contrôle des exigences par l'IA.
—Indique un maximum (« up to ») ; si un minimum est visé, utilisez « at least ».« up to » suivi d'un nombre, en chiffres ou en lettres (« up to 72 hours », « up to five tonnes »). « Up to date » ne compte pas.

Complète

RègleMessageSe déclenche sur
—Description manquante.Une description vide.
—Nom manquant.Un nom vide.
R9R9 - Formulation de liste ouverte : [...]including but not limited to, etc, and so on, and so forth, such as, among others.

Singulière

RègleMessageSe déclenche sur
R18R18 - Écrivez une seule phrase (N trouvées).Plus d'une phrase (y compris les phrases japonaises et chinoises se terminant par 。, ! ou ?).
—Terminez l'énoncé par un point.Une description qui ne se termine pas par « . » (ou 。).
R19R19 - Réunit deux exigences ; séparez-les en exigences distinctes : [...]and, or, but, however ou whereas reliant deux actions ou deux obligations (« shall log and report each fault », « … and the operator shall … »), « nor shall », une seconde proposition après « ; » ; « and/or » avant une seconde action. Voir Deux exigences en une (R19).
R19R19 - « et/ou » est ambigu ; indiquez si les deux ou l'un des deux est visé : [and/or]« and/or » entre des valeurs ou dans une condition.
R19R19 - Réunit deux valeurs ; séparez-les si chacune est vérifiée séparément : [...]and, or reliant deux objets ou valeurs après une même action (« measure the temperature and the humidity »). Une note : Singulière reste Oui.
R20R20 - Contient des expressions de but ; déplacez-les dans la justification : [...]purpose of, in order to, so that, for the purpose of, so as to.
R21R21 - Contient des parenthèses ; déplacez le texte entre parenthèses dans la justification.« ( » ou « [ » (y compris les crochets pleine chasse).

Conforme

MessageSe déclenche sur
Utilisez un verbe modal : [need, shall, will, should, must]Aucun de ces mots n'apparaît.

Appropriée

RègleMessageSe déclenche sur
R31R31 - Impose une solution : [...]using, by means of, utilizing, utilising, implemented in, implemented with, via a, via the, built with, written in.

Nécessaire

RègleMessageSe déclenche sur
R30R30 - Très ressemblant : [3.2 Battery Capacity (similaire à 81,3 %), ...]Une autre exigence de la portée dont la description est similaire à au moins 75 % (similarité par paires de caractères). Le constat en nomme jusqu'à cinq et compte les autres (« et 3 de plus »). Le parent direct et les enfants de l'exigence (decomposed by, decomposes) ne sont pas comparés : un raffinement reprend souvent la formulation de son parent. Les exigences sœurs et les exigences sans rapport le sont.

Vérifiable

MessageSe déclenche sur
Liez un Test Case ou une Requirement qui la vérifie.L'exigence n'a aucun lien verified by vers une Requirement ou un Test Case.
IA : non vérifiable telle que rédigée — <motif>Un constat de l'IA accepté depuis le contrôle des exigences par l'IA.

Réalisable

RègleMessageSe déclenche sur
R26R26 - Terme(s) absolu(s) rarement réalisable(s) : [...]always, never, 100%, 100 percent, all the time, totally, completely, absolutely, zero defects, forever, continuous, continuously, uninterrupted.
—Demande le jugement d'un relecteurAucun terme absolu ni quasi-doublon n'a été trouvé ; une personne doit décider.

Correcte

MessageSe déclenche sur
Demande le jugement d'un relecteurTous les contrôles de texte (Appropriée, Complète, Conforme, Nécessaire, Singulière, Non ambiguë) ont réussi ; une personne doit décider.

Comme Correcte et Faisable se terminent par « Demande le jugement d'un relecteur » tant que personne n'a décidé, le score automatique le plus élevé est de 7 sur 9 (78 %).

Deux exigences en une (R19)

Une exigence énonce une seule chose. R19 examine chaque « and », « or », « nor », « but », « however », « whereas », « as well as » et « and/or » et le classe dans l'une de ces catégories :

TypeExempleRésultat
Deux exigences« The unit shall log and report each fault. » « The pump shall stop, and the operator shall be alerted. » « … to acknowledge alarms and to silence the horn. » « …; it shall also … »Un constat. Singulière vaut Non.
« and/or » ambigu« The log shall record the user ID and/or the badge number. »Un constat : indiquez si les deux ou l'un des deux est visé. Singulière vaut Non.
Deux valeurs« The station shall measure the temperature and the humidity. »Une note : séparez-la si chaque valeur est vérifiée séparément. Singulière reste Oui ; la note s'affiche en gris et ne baisse pas le score.
Aucun constat« between 5 °C and 30 °C » ; « When A and B, the unit shall … » ; « … when the door is open and the fan is off » ; « requirements 2.1 and 2.2 » ; texte entre guillemets ; « The command and control unit shall … » ; « ASME Boiler and Pressure Vessel Code » ; « 5 Nm at 3000 rpm and 24 V » ; « including batteries and strap » ; « either open or closed »Rien.

Deux valeurs d'une même grandeur (« at -20 °C and 60 °C ») reçoivent la note. Un « , and » termine une condition : « … when the level falls below 10 %, and restart when … » est un constat. Un sujet qui agit comme un tout (« The Owner and the Contractor shall agree … », « The power and data connector shall … ») ne reçoit pas de note ; deux sujets qui agissent chacun (« The pump and the valve shall close … ») reçoivent la note. Les comparateurs (« 12 or more ») ne sont pas signalés. Un nom placé après l'action ne se distingue pas de deux valeurs : ajoutez-le donc sous Noms composés.

Noms composés. Sur la page Qualité, Plus ▾ → Noms composés… ouvre la liste du projet des noms qui contiennent « and » ou « or » mais désignent une seule chose, un par ligne (par exemple « power and data connector »). R19 ne les signale pas. Les formes développées du glossaire des acronymes du projet (statements Acronym, voir Trouver les acronymes) comptent aussi, et quelques noms courants sont intégrés (« command and control », « research and development », « operations and maintenance », …). La liste est enregistrée avec le projet et peut être annulée. Cliquez de nouveau sur Contrôler la qualité pour appliquer une modification.

Exigences dans d'autres langues

Holarch détecte la langue de chaque exigence d'après son texte. Les règles de mots (R2–R10, R16, R19, R20, R24, R26, R31–R35, « up to », le verbe modal, les unités) notent les exigences en anglais.

Allemand, français et espagnol (bêta). Ces exigences reçoivent les mêmes règles dans leur propre langue, par exemple « angemessen » ou « bei Bedarf » en allemand, « approprié » ou « si possible » en français, « adecuado » ou « según corresponda » en espagnol. Tant que les règles d'une langue sont en bêta :

  • chaque constat est une suggestion marquée (bêta). Elle s'affiche en gris avec les autres notes et ne baisse jamais un critère ni le score ;
  • la note « Les règles de rédaction de cette langue sont en bêta : suggestions seulement, sans note. Les contrôles de structure s'appliquent. » s'affiche, et Non ambiguë vaut – (non contrôlé) jusqu'à ce que la rédaction soit vérifiée avec l'IA ou évaluée à la main ;
  • les mots pour « each » (jede, chaque, cada) sont le bon choix et ne sont pas signalés, pas plus que « alle 5 s » ou « tous les 5 s » (every 5 s).

Une règle ne commence à compter pour une langue qu'après avoir été mesurée sur au moins 300 énoncés rédigés dans cette langue et revus par un ingénieur exigences de langue maternelle (au moins 90 % de constats corrects), et après validation par ce relecteur. Lorsque c'est le cas, les scores de cette langue peuvent changer au contrôle suivant ; les notes de version le signalent.

Les autres langues (japonais, italien, chinois et les autres) reçoivent :

  • la note « Les règles de rédaction couvrent l'anglais. Les contrôles de structure s'appliquent. » et – (non contrôlé) pour Non ambiguë : exclu du score jusqu'à ce que la rédaction soit vérifiée ou évaluée à la main. Un autre constat Non ambiguë, comme un TBD, le fait toujours échouer ;
  • les contrôles valables pour toutes les langues : R18 (y compris 。), le point final (y compris 。), R17, R21, TBD/TBR, R30, le nom, la description et le lien de vérification.

Toutes les langues, en bêta ou non, reçoivent aussi ces contrôles. Les suggestions sont enregistrées en anglais avec les mots cités tels qu'écrits (« R7 - Imprecise wording: [angemessen] (beta) »), si bien que le filtre quality:R7 et les exports fonctionnent de la même façon dans toutes les langues. L'API publique les renvoie avec leur règle, leurs mots et leur mode (findings).

Vérifier la rédaction avec l'IA. ✦ IA ▾ → Vérifier la rédaction avec l'IA… sur la page Qualité (ou ✦ Plus d'IA ▸ sur une exigence) applique les mêmes règles par l'IA configurée, dans la langue de chaque exigence. L'aperçu liste les constats et une reformulation facultative dans cette langue (non cochée). Appliquer la sélection ajoute les constats comme constats de l'IA et retire la note (les suggestions bêta restent des notes), en une étape d'annulation. Modifier le texte les efface. Il faut une offre avec IA.

Corrections manuelles

Corrigez un critère lorsque vous n'êtes pas d'accord avec le résultat automatique, ou pour consigner la décision d'un relecteur.

  • Sur la page Qualité : cliquez sur une cellule de critère pour la faire défiler : le premier clic définit un Oui manuel (✔), le suivant un Non manuel (✘), et le troisième efface la valeur manuelle pour que le contrôle automatique décide de nouveau. Une cellule manuelle affiche un marqueur manuel ; son infobulle indique « (défini manuellement) » et l'effet du clic suivant.
  • Dans l'inspecteur ou la vue d'élément : chaque critère est une liste avec Oui et Non. Un critère défini à la main propose aussi Automatique (contrôler à nouveau), qui le ramène au résultat automatique. Les valeurs définies à la main affichent « manuel ».

Une valeur manuelle est conservée lorsque le contrôle est relancé. Un Non manuel sans autre message affiche « Marqué Non manuellement. »

Les corrections sont effacées dans deux cas :

  • Le nom ou la description de l'exigence change. Les corrections restent dans l'historique, et Annuler les rétablit.
  • Vous choisissez Plus ▾ → Effacer les évaluations manuelles. Cela efface aussi les constats de l'IA acceptés.

Résultats obsolètes

Lorsque le nom ou la description d'une exigence change après un contrôle, ses résultats sont marqués obsolètes :

  • La page Qualité affiche « Obsolète — relancer » avec l'infobulle « Le texte a changé après le dernier contrôle. Relancez le contrôle de qualité. »
  • La colonne Score de qualité d'un document affiche une étiquette Périmé avec une icône d'horloge (pointez dessus pour le motif).
  • L'inspecteur affiche « Qualité : périmée — relancer ».

Activez Recontrôler automatiquement quand le texte change pour éviter les résultats obsolètes. Holarch relance alors immédiatement le contrôle des règles sur l'exigence modifiée. Le réglage est conservé dans ce navigateur.

Contrôler la qualité depuis un document

Dans un document, choisissez Contrôler ▾ → Contrôler la qualité. Lorsqu'une exigence est sélectionnée, l'élément du menu devient Contrôler la qualité de cette exigence et contrôle celle-ci. Sans exigence sélectionnée, il contrôle toutes les exigences visibles du document.

Les résultats s'ouvrent dans la boîte de dialogue Contrôler la qualité — <nom>, avec les tuiles et le tableau. Ses boutons sont Exporter en CSV, Exporter en XLSX, Ouvrir dans Qualité et Fermer.

Un document sans exigence affiche « Ce document n'a aucun Requirement à contrôler. Les Statements ne sont pas évalués. »

Contrôle des exigences par l'IA

Utilisez le contrôle des exigences par l'IA pour un premier avis sur les critères qu'une règle ne peut pas trancher : Correcte, Faisable et Nécessaire. Il recherche aussi les formulations que les règles manquent sous Non ambiguë (par exemple « up to 72 hours » là où un minimum semble visé, ou « accurately » sans mesure) et Vérifiable (aucun test, aucune analyse, inspection ou démonstration ne pourrait montrer que l'exigence est satisfaite telle que rédigée). L'IA reçoit les constats des règles et ne signale que ce qu'ils manquent.

  1. Choisissez ✦ IA ▾ → Vérifier avec l'IA (N exigences)….

    Pour une seule exigence, choisissez Vérifier avec l'IA (cette exigence)… dans son menu ✦ IA ▾, ou ✦ Plus d'IA ▸ → ✦ Vérifier avec l'IA… dans son menu contextuel.

    Claude revoit les exigences. Elles sont envoyées par groupes de 20, avec jusqu'à 300 autres exigences pour la recherche de doublons. Avec l'IA incluse, le contrôle compte une demande par tranche de 100 exigences (arrondi au supérieur) ; avant un contrôle de plus de 100 exigences, une boîte de dialogue indique combien il en utilise, par exemple « Cette revue utilise 3 des 52 demandes d'IA incluses qu'il vous reste ce mois-ci (1 demande par 100 exigences). » Un contrôle qui demande plus de demandes qu'il n'en reste ne démarre pas.

  2. Revoyez chaque exigence dans la boîte de dialogue.

    La ligne du haut indique ce qui est coché au départ : « Les éléments cochés sont appliqués. Les reformulations sont décochées au départ pour que vous les lisiez d'abord. Les exigences verrouillées, approuvées et incluses dans une référence sont décochées au départ. »

  3. Cochez les modifications et les reformulations que vous acceptez.

    La ligne au-dessus des boutons compte ce que fait Appliquer, par exemple « Applique 7 valeurs et 2 reformulations à 5 exigences. » Sans rien de coché, elle indique « Aucune sélection. » et Appliquer la sélection est grisé.

  4. Cliquez sur Appliquer la sélection.

    Les éléments cochés s'appliquent, et une seule annulation défait le tout. Le message indique « N modifications de l'IA appliquées ».

Pour chaque exigence, la boîte de dialogue affiche :

  • Un verdict Oui/Non et un motif pour Correcte, Faisable, Nécessaire, Non ambiguë et Vérifiable.
  • Sous chaque verdict, une case libellée avec ce que son application modifie, ou « aucune modification » sans case lorsque la valeur enregistrée correspond déjà :
    • Correcte, Faisable et Nécessaire : « Non → Oui » ou « Oui → Non » lorsque le verdict diffère de la valeur enregistrée, « Définir sur Oui » ou « Définir sur Non » lorsqu'il n'y en a pas.
    • Non ambiguë et Vérifiable : « Ajoute une constatation » lorsque l'IA a trouvé un problème, et « Efface la constatation précédente » lorsqu'un constat antérieur de l'IA n'est plus valable.
  • Un commentaire facultatif.
  • Lorsque l'IA en propose une, une case Appliquer la reformulation : avec un diff des mots.

Ce qui est coché au départ :

  • Toutes les modifications de valeur sont cochées au départ.
  • Les reformulations sont décochées au départ, pour que vous les lisiez d'abord.
  • Les exigences approuvées, incluses dans une référence et verrouillées sont décochées au départ et signalées.

Cocher une reformulation grise les cases Non ambiguë et Vérifiable de cette exigence et les libelle « Revérifié après la reformulation » : les contrôles des règles s'exécutent de nouveau sur le nouveau texte. Décocher la reformulation rétablit les cases telles qu'elles étaient. Correcte, Faisable et Nécessaire s'appliquent toujours.

BoutonEffet
Sélectionner toutes les modifications de valeurCoche toutes les modifications de valeur, sauf sur les exigences approuvées, incluses dans une référence et verrouillées.
Sélectionner toutes les reformulationsCoche toutes les reformulations, sauf celles qui sont signalées.
Ne rien sélectionnerDécoche tout.

Ce que fait Appliquer :

  • Correcte, Faisable et Nécessaire deviennent des valeurs Oui/Non manuelles.
  • Un Non à Non ambiguë ou Vérifiable devient un constat de l'IA : la page Qualité le liste avec les constats des règles, sous la forme « IA : ambiguë — <motif> » ou « IA : non vérifiable telle que rédigée — <motif> », et le critère affiche ✘. Un Oui retire un constat antérieur de l'IA.
  • Les constats de l'IA sont effacés lorsque le nom ou la description de l'exigence change (y compris par une reformulation acceptée) et par Plus ▾ → Effacer les évaluations manuelles.

Ce que fait Appliquer la sélection :

  • Les verdicts deviennent des valeurs manuelles, avec le message « IA : <motif> ». Ils sont conservés lorsque le contrôle est relancé.
  • Les reformulations remplacent la description et relancent le contrôle.

Exports de qualité

ExportContenu
Exporter ▾ → CSV (quality_report.csv)Une ligne par exigence et par critère : Numéro, Nom, Description, Score de qualité, Attribut, Message, Résultat.
Exporter ▾ → Excel (.xlsx) (quality_report.xlsx)Numéro, Nom, Description, Justification, Score de qualité, Attribut, Message, Résultat, avec les cellules de l'exigence fusionnées sur ses neuf lignes, Oui en vert et Non en rouge, et un Score du rapport (réponses Oui sur l'ensemble des réponses) à la fin.
Livrer ▾ → Tous les exports… → Constats de qualité (Excel) du documentLa même disposition pour un seul document, avec les colonnes d'affichage du document.

Approbations

Utilisez Besoins et exigences → Approbations pour voir tout ce qui attend une décision. La page ouvre la base de données avec la requête Requirement:"Status=In Review".

Elle a toutes les fonctions de la base de données :

  • Sélectionnez plusieurs lignes et utilisez la barre d'actions groupées pour définir ensemble le statut ou les étiquettes.
  • Exportez la liste.
  • Double-cliquez sur une ligne pour la vue d'élément et l'historique complet.

Le cadre d'approbation

Le cadre d'approbation apparaît dans l'inspecteur et dans la vue d'élément de chaque exigence. Il affiche :

  • Le statut actuel sous forme de puce colorée (Brouillon lorsqu'aucun n'est défini).
  • La dernière décision enregistrée : « <statut> par <nom> · <date et heure> », suivie de « — <note> » s'il y en a une (par exemple « — Texte modifié après approbation »), ou « Aucune approbation consignée ».
  • Les boutons qui s'appliquent au statut actuel :
BoutonAffiché lorsqueEffet
ApprouverLe statut n'est ni Approuvé ni RejetéDéfinit Approuvé et enregistre votre nom et l'heure. Message : « Approuvé ».
Rejeter…Le statut n'est ni Approuvé ni RejetéDemande un Motif (facultatif) dans la boîte de dialogue Rejeter l'exigence, puis définit Rejeté. Message : « Rejeté ».
RouvrirLe statut est Approuvé ou RejetéDéfinit En revue. Message : « Passé à En revue ».

Le nom enregistré est le nom de votre compte. Définir le statut à la main dans un tableau ou dans l'inspecteur enregistre aussi une décision avec votre nom et l'heure. Les lecteurs voient le cadre sans boutons.

Lorsqu'un flux de travail fait passer le passage à Approuvé par une demande de modification, le cadre affiche à la place la demande ouverte et son décompte, par exemple CR-4 : 1 approbation sur 3. Une fois appliquée, la décision nomme chaque approbateur et la demande : « Approuvé par Ann Lead, Bob Discipline · <date et heure> · CR-4 ».

Note : modifier le nom ou la description d'une exigence approuvée la passe à En revue, avec la note « Texte modifié après approbation ». Le message indique « N exigence(s) approuvée(s) passée(s) à En revue. » Modifier d'autres attributs ne la rouvre pas.

Registre TBD/TBR

Utilisez le registre pour suivre chaque élément ouvert jusqu'à sa clôture. Ouvrez Besoins et exigences → TBD/TBR. Depuis un document, choisissez Contrôler ▾ → Registre TBD/TBR pour ouvrir le registre limité à ce document.

  • En-tête de la page : Exporter en XLSX (désactivé lorsque le registre est vide).
  • Barre de portée : Portée (Toutes les exigences ou Document : <nom>).
  • Tuiles : TBD/TBR ouverts, En retard, Aucun propriétaire, et des puces Par document (« <document> : <nombre> ») qui ouvrent chaque document.
  • Éléments ouverts dans le temps : un burn-down du nombre d'éléments ouverts. Il est reconstruit à partir de l'historique des exigences, avec jusqu'à 60 points de la plus ancienne exigence à maintenant. Pointez sur un point pour sa date et son nombre. Avec trop peu d'historique, il affiche « Pas encore assez d'historique pour un burn-down. »
  • Colonnes du Tableau :
    • Numéro, et Nom avec la description.
    • Document.
    • Type : TBD, TBR ou TBS, avec « attribut », « dans le texte » ou les deux.
    • Propriétaire : le propriétaire TBD, sinon le propriétaire de l'exigence, sinon « — ».
    • Échéance : l'unique échéance de l'exigence, la même date que Échéance dans le groupe Flux de travail de l'inspecteur et dans la vue d'élément. C'est l'attribut Échéance TBD lorsqu'il contient une date, sinon l'échéance de l'exigence. Affiche « En retard » sous une date passée. Les lignes en retard sont teintées.
    • Âge : nombre de jours depuis l'ouverture de l'élément.
    • Clore.

Cliquez avec le bouton droit sur une ligne, ou appuyez sur Shift+F10 dessus, pour le même menu de ligne que dans la base de données : actions suggérées avec leurs raisons, ✦ Plus d'IA ▸, Ouvrir, Renommer…, Dupliquer, Ajouter un enfant…, Statut ▸, Priorité ▸, Relier à ▸, Ajouter au document ▸, Afficher dans le diagramme ▸, Copier le lien, Copier le numéro et Supprimer…. Dans les autres menus contextuels, une exigence avec un TBD ou un TBR ouvert commence par Résoudre le TBD…, qui ouvre ce registre avec l'exigence sélectionnée.

Le registre est en lecture seule. Pour changer une échéance, sélectionnez la ligne et définissez Échéance dans l'inspecteur. Holarch définit l'échéance de l'exigence et, lorsque l'attribut Échéance TBD contient une date, cet attribut aussi (en conservant son heure), et une seule annulation défait le tout. Effacer Échéance efface les deux.

Clore n'apparaît que lorsque l'attribut TBD/TBR est défini. Il règle l'attribut sur Aucun :

  • S'il ne reste rien dans le texte, le message indique « Clos ».
  • S'il reste TBD, TBR ou TBS dans le texte, le message indique « Attribut clos ; le texte contient encore TBD. »
  • Un élément issu uniquement du texte n'a pas de bouton Clore ; modifiez le texte pour le clore.

Lorsque rien n'est ouvert, la page affiche « Aucun TBD/TBR ouvert. Définissez l'attribut TBD/TBR d'une exigence, ou écrivez TBD, TBR ou TBS dans son texte, pour la lister ici. »

Exporter en XLSX écrit TBD-TBR Register.xlsx avec Numéro, Nom, Document, Type, Source (attribut, texte ou les deux), Propriétaire, Échéance, Ouvert le, Âge (jours), En retard (Oui en rouge) et Description.

Utilisez Liens à revoir (appelés aussi liens suspects dans d'autres outils) pour trouver ce qui doit être recontrôlé après la modification d'une exigence. Un lien doit être revu lorsque l'élément situé à son autre extrémité a changé depuis la dernière revue du lien : vérifiez que le lien tient toujours, puis marquez-le comme revu. Besoins et exigences → Liens à revoir les liste. Depuis un document, utilisez Contrôler ▾ → Liens à revoir.

Ces modifications d'une exigence marquent ses liens à revoir :

  • Nom ou Description.
  • Priorité, Criticité, Méthode de vérification ou Niveau de vérification.
  • Tout attribut numérique, en pourcentage ou de durée.

Holarch marque alors chacun des liens de l'exigence de ces types : decomposed by, derived by, refined by, satisfied by, verified by et traced to.

Une Méthode de vérification ou un Niveau de vérification modifié ne marque que les liens verified by. Définir la première méthode ou le premier niveau d'une exigence ne marque rien : cela planifie la vérification et ne change rien de ce qui a été revu.

L'autre extrémité de chaque lien est l'élément à revoir : l'exigence enfant, la fonction ou l'actif qui la satisfait, le cas de test qui la vérifie, etc. Les modifications suivantes de la même exigence s'ajoutent à la liste des champs modifiés de la même marque.

  • Page Liens à revoir : une ligne par lien à revoir.
  • Documents et base de données : un badge ⚠ Revoir sur la ligne de l'élément (« L'élément à l'autre extrémité a changé depuis la dernière revue de ce lien. Vérifiez que le lien tient toujours, puis marquez-le comme revu. Cliquez pour revoir. »).
  • Inspecteur et vue d'élément : un bandeau « ⚠ Revoir : <exigence> a changé depuis la dernière revue de ce lien. Vérifiez que le lien tient toujours, puis marquez-le comme revu. » Son bouton Revoir… ouvre la boîte de dialogue Liens à revoir — <élément> pour cet élément, avec Ouvrir les liens à revoir et Fermer.
  • La section Trace de l'inspecteur : un ⚠ à côté de chaque lien à revoir, avec les champs modifiés et la date dans son infobulle.
  • RVTM : un ⚠ après une exigence ayant un lien à revoir à l'une ou l'autre extrémité (elle a changé, ou l'élément en amont a changé) ; cliquez dessus pour revoir ces liens. Un ⚠ après un cas de test dans Verified by marque ce lien de vérification.

La page explique la règle en haut et affiche un tableau :

ColonneContenu
(case à cocher)Sélection pour Marquer la sélection comme revue…. La case de l'en-tête sélectionne tout.
ModifiéL'exigence qui a changé.
ModificationLes champs qui ont changé, par exemple « Description » ou « Priorité, Niveau de vérification ».
Quand / ParLa date et l'heure de la modification et son auteur.
RelationLe type de lien, lu depuis l'exigence modifiée (par exemple « satisfied by »).
Élément à revoirL'élément situé à l'autre extrémité du lien.
(actions)Diff et Marquer comme revu….

Cliquez avec le bouton droit sur une ligne, ou appuyez sur Shift+F10 dessus, pour le menu de ligne de l'élément, comme dans la base de données : actions suggérées, ✦ Plus d'IA ▸, Ouvrir, Renommer…, Dupliquer, Ajouter un enfant…, Statut ▸, Priorité ▸, Relier à ▸, Ajouter au document ▸, Afficher dans le diagramme ▸, Copier le lien, Copier le numéro et Supprimer…. Dans les autres menus contextuels (base de données, documents), un élément ayant un lien à revoir commence par Examiner le lien…, qui ouvre sa revue.

Diff ouvre Modification — <exigence> avec un diff des mots du nom et de la description. Lorsque seuls des attributs ont changé, il indique « Seuls des attributs ont changé : <champs>. Ouvrez l'historique de l'entité pour les détails. » Historique… ouvre l'historique de l'exigence.

Pour marquer des liens comme revus :

  1. Cliquez sur Marquer comme revu… sur une ligne, sur Marquer la sélection comme revue… pour les lignes cochées, ou sur Tout marquer comme revu (N)….

    Marquer N lien(s) comme revu(s) s'ouvre : « Confirmez que les éléments liés tiennent toujours après la modification. Un commentaire est ajouté à chaque élément lié. »

  2. Saisissez un commentaire facultatif, par exemple « Enfant toujours valable ; aucune modification nécessaire. »
  3. Cliquez sur Marquer comme revu.

    Le message indique « N liens marqués comme revus. »

Marquer la sélection comme revue… sans sélection affiche « Sélectionnez d'abord les liens à marquer comme revus. »

Marquer un lien comme revu enregistre la revue sur le lien : qui, quand, le commentaire et les champs. Si vous avez écrit un commentaire, Holarch ajoute aussi « Lien revu (<exigence> modifiée : <champs>) : <commentaire> » aux commentaires de chaque élément. Annuler l'inverse.

Sans lien à revoir, la page affiche « Aucun lien à revoir. Un lien doit être revu lorsque l'élément à son autre extrémité change après la dernière revue du lien. »

Références et comparaison de versions

Références de document

Créez et utilisez les références de document avec Version ▾ dans le cartouche du document. Le menu liste :

  • Version actuelle : le document en cours.
  • Chaque référence de ce document, de la plus récente à la plus ancienne, avec sa date.
  • Sous Références du projet, toutes les références de projet.
  • Enregistrer la référence… et Comparer les versions… (grisé tant que le document n'a pas de référence : « Enregistrez d'abord une référence »).

Enregistrer la référence… ouvre Enregistrer la référence :

  • Nom * (obligatoire).
  • Approbations : des lignes Nom, Rôle et Déclaration, avec + Ajouter un approbateur. La première ligne est remplie avec votre nom. « Aucun approbateur. » lorsqu'elle est vide.
  • 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. »

Choisissez une référence dans Version ▾ pour la consulter. Le document passe en lecture seule, avec le bandeau « Référence « <nom> », lecture seule, enregistrée le <date> » et la liste des approbations. Ces boutons apparaissent :

BoutonEffet
Revenir à l'actuelRevient au document en cours.
ModifierModifier la référence : la renommer et ajouter des enregistrements d'approbation. Approbations (verrouillées) liste les enregistrements existants, qui ne peuvent pas changer ; les nouveaux enregistrements « sont datés de maintenant et ajoutés à la liste ». Références de document uniquement.
Comparer à l'actuelOuvre Comparer les versions à partir de cette référence. Références de document uniquement.
Restaurer la référenceRéférence de document : « Remplacer les entités, l'ordre et la structure de ce document par la référence « <nom> » ? Les entités ajoutées depuis sont retirées du document (pas supprimées). L'annulation est possible. » Référence de projet : Remplacer le projet par la référence, « Remplacer l'ensemble du projet par la référence de projet « <nom> » ? L'annulation est possible. »
Supprimer« Supprimer la référence « <nom> » ? »

Dans le document en cours, chaque ligne porte une barre de modification : nouvelle depuis la référence, modifiée depuis la référence, ou inchangée. La comparaison se fait avec la dernière référence du document, ou avec la dernière référence de projet lorsque le document n'en a pas.

Comparer les versions

Utilisez le rapport de modifications pour voir exactement ce qui a changé depuis une revue.

  1. Cliquez sur Version ▾ → Comparer les versions…, ou sur Comparer à l'actuel dans le bandeau d'une référence.

    Comparer les versions s'ouvre.

  2. Choisissez De : une référence.
  3. Choisissez À : une référence ultérieure, ou Version actuelle.

    Le tableau liste Numéro, Nom, Type de modification, Champ et Modification (un diff des mots pour le texte modifié).

Types de modification :

Type de modificationSignification
Ajouté / RetiréL'entité est entrée dans le document ou en est sortie.
ModifiéUn champ a changé : Nom, Numéro, Description, Classe, Image ou tout attribut (le champ est nommé).
Étiquette ajoutée / Étiquette retiréeUne étiquette a été ajoutée ou retirée.
Relation ajoutée / Relation retiréeUn lien touchant le document a été ajouté ou retiré.
Attribut de relationLes attributs d'une relation ont changé.

Modifications (Excel) écrit « <document> (Changes).xlsx » avec Numéro, Nom, Classe, Type de modification, Champ, Ancienne valeur et Nouvelle valeur. Version avec modifications (Word) écrit la même comparaison sous forme de modifications suivies Word.

Livrer ▾ → Modifications (Excel)… du document (aussi dans Tous les exports…) exporte le même rapport avec De et À. Il échoue avec « Ce document n'a pas de référence. Enregistrez-en d'abord une. » lorsqu'il n'y en a pas.

Document (Word) remplit les tableaux Historique des révisions et Approbations de la sortie Word à partir des références du document.

Page Références et versions

Utilisez Contrôle et revues → Références et versions pour gérer toutes les références du projet. Les références de projet contiennent toutes les entités ; les références de document contiennent un seul document et se créent avec Version ▾ → Enregistrer la référence… du document. L'en-tête de la page propose Restaurer une version précédente…, qui rétablit un enregistrement automatique antérieur de tout le projet, et + Enregistrer une référence….

Pour créer une référence de projet :

  1. Cliquez sur + Enregistrer une référence… dans l'en-tête de la page.

    La boîte de dialogue Enregistrer une référence du projet affiche les nombres actuels d'entités et de relations. Le nom par défaut est « Baseline <n> » ; le texte indicatif est « Nom, par exemple « SRR » ».

  2. Saisissez un nom, puis appuyez sur Enter ou cliquez sur Enregistrer la référence. Un nom vide est refusé (« Saisissez un nom. »).

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

Les cartes de la page :

  • Carte Références : les nombres actuels (« Actuel : <n> éléments, <n> relations ») et un filtre : Toutes les références, Références de tout le projet ou Document : <nom>. Colonnes :
    • Nom.
    • Document : un lien pour consulter le document dans cette référence, ou « Projet ».
    • Créée le.
    • Approbations : « ✔ » et les noms des approbateurs. Pointez dessus pour le rôle, la date et la déclaration. « par <nom> » nomme le créateur.
    • Entités et Relations.
    • Comparer : définit cette référence comme De et la copie de travail actuelle comme À.
    • ⋯ (Plus d'actions) :
      • Renommer… : Renommer la référence.
      • Exporter (JSON) : télécharge « <nom>.json » (format holarch-baseline, avec l'instantané et les approbations).
      • Restaurer la référence… (référence de projet) : « Remplacer toutes les entités et relations actuelles par la référence « <nom> » ? L'annulation est possible (⌘Z / Ctrl+Z). » Message : « « <nom> » restaurée ».
      • Rétablir le document… (référence de document) : « Restaurer le document « <doc> » à la référence « <nom> » ? Seules les entités et la structure de ce document changent. L'annulation est possible. » Désactivé lorsque le document a été supprimé.
      • Supprimer…. Sur le service hébergé, seuls les propriétaires du projet renomment ou suppriment une référence ; pour les autres, ces éléments sont grisés avec le motif.
  • Références orphelines (affiché si nécessaire) : « N références de documents supprimés ». Chacune propose Restaurer le document, qui recrée l'artefact du document et ses entités à partir de la référence, et Supprimer.
  • Carte Comparer : choisissez De (plus ancienne) et À (plus récente). À est Version actuelle ou une autre référence de la même portée.
    • Tuiles : Entités ajoutées, Entités retirées, Entités modifiées, Modifications de relations.
    • Le tableau affiche Entité, Modification, Champ et Différence (diff des mots). Les attributs de date s'affichent au format de date de l'application.
    • Exporter en CSV et Exporter en XLSX écrivent « Changes <from> to <to> ».
    • Sans rien à afficher : « Aucune différence entre « <from> » et « <to> ». »

Sans référence : « Aucune référence. Créez-en une pour enregistrer l'état actuel du projet. »

Note : les références sont enregistrées dans le projet et le suivent dans un export de projet. Une référence de projet contient des entités et des relations. Une référence de document contient aussi les paramètres de plan du document.

Importer des exigences

Utilisez Besoins et exigences → Importer et exporter pour importer des exigences depuis des fichiers. L'opération se fait en quatre étapes : Fichier → Correspondance → Revue → Importation.

  • Retour et Continuer passent d'une étape à l'autre. Importer N éléments à l'étape Revue importe, et une seule annulation défait le tout.
  • Une seule zone de dépôt accepte tous les formats. Le format est détecté à partir du fichier (son nom, et son contenu lorsque le nom ne suffit pas) et s'affiche sous Format, où vous pouvez le changer.

Les formats sont Word (.docx), les fichiers de projet Holarch (.holarch, .json), Excel / CSV (.xlsx, .csv), Texte brut (.txt), UML/SysML (.xmi, .uml, .mdzip) et ReqIF (.reqif).

Cette section couvre les formats d'exigences. Pour les fichiers de projet, XMI et toutes les autres importations et exportations, voir Importer et exporter.

Étape 1 : Fichier

Déposez un fichier sur « Déposez un fichier ici ou cliquez pour en choisir un », ou collez du texte dans la zone et cliquez sur Analyser le texte (CSV avec une ligne d'en-tête, XML ReqIF, XMI, JSON ou texte de document).

OptionValeursEffet
FormatLes six formats ci-dessusAffiche le format détecté. Choisissez-en un autre pour lire le même contenu autrement.
Encodage du texte (CSV, texte)Automatique, UTF-8, ISO-8859-1 / Windows-1252, Shift_JIS, Big5, UTF-16La manière dont les octets du fichier sont lus. Le changer relit le fichier.
Feuille (classeurs)« <nom> (N lignes) »La feuille à importer. La première feuille contenant des données est présélectionnée.
  • Texte brut : la zone garde le contenu importé modifiable. Modifiez-le et cliquez sur Relancer l'analyse.
  • La ligne d'état indique « “<fichier>” analysé : N lignes, M colonnes. » (plus « (feuille “<nom>”) » et, pour Word, « , N tableau(x) »).

Étape 2 : Correspondance

Chaque colonne du fichier occupe une ligne : Colonne du fichier (titre et position), Exemples de valeurs (les trois premières lignes) et Champ Holarch. Choisissez Ignorer pour laisser une colonne de côté. Les champs rapprochés d'après le titre de la colonne sont marqués auto.

Champ HolarchContenu
Nom, Numéro, DescriptionLes champs propres de l'élément.
Classe, ÉtiquettesLe nom de la classe ; les noms d'étiquettes séparés par ; , ou |.
Numéro parent, ID globalLe numéro du parent ; l'ID utilisé pour rapprocher les entités existantes.
Un attributTout attribut de la classe des lignes sans classe.
Une relationSéparez plusieurs cibles par ;.
ID de ligne, ID de la ligne parente, Nouvel attribut (ajouté au schéma)La structure des fichiers ReqIF et XMI, et les nouveaux attributs.

✦ IA ▾ → Suggérer une correspondance propose un champ pour chaque colonne. Correspondance suggérée liste les modifications, cochées, avec le motif de l'IA ; Appliquer la sélection cochée modifie la correspondance. Rien n'est encore importé.

Holarch déduit la correspondance de l'en-tête :

En-têteCorrespond à
Number, No, Num, #, ID Number, Req Number, Requirement NumberNuméro
Name, Title, Short Name, Requirement NameNom
Description, Text, Requirement, Requirement Text, Statement, DescDescription
Class, Type, Entity ClassClasse
Labels, Label, TagsÉtiquettes (séparez les valeurs par ; , ou |)
Parent, Parent NumberNuméro parent
Global ID, ID, GUID, UUIDID global
Un nom d'attribut (par exemple Priority, Rationale, Status)Cet attribut. « Method » et « Verification » correspondent à Méthode de vérification.
Un nom de groupe d'étiquettes (par exemple Verification Method lorsqu'aucun attribut de ce nom n'existe)Étiquettes
Un nom de relation (par exemple satisfied by)Cette relation ; séparez plusieurs cibles par ;
Object Identifier, Origin IDID global
Object Number, ReqIF.ChapterName, ReqIF.ForeignIDNuméro
Object Heading, ReqIF.Name, Long NameNom
Object Text, ReqIF.Text, ReqIF.DescriptionDescription
ReqIF.CategoryClasse
ReqIF ID, XMI ID, Row ID / Parent IDID de ligne / ID de la ligne parente

Nouvel attribut crée un attribut portant le nom de la colonne, sur chaque classe importée. Son type dépend des valeurs :

  • Nombre, lorsque chaque valeur est un nombre.
  • Une liste de choix, lorsqu'il y a peu de valeurs distinctes courtes.
  • Texte long, pour les valeurs de plus de 120 caractères.
  • Texte sinon.

Les critères de qualité, les attributs calculés et les attributs de fichier ne peuvent pas être mis en correspondance.

Sous les colonnes :

OptionValeursEffet
Classe des lignes sans classeToute classe ; Requirement par défautLa classe des lignes sans valeur dans la colonne Classe et sans règle de classe correspondante.
Règles de classeLa description contient un mot ou une expression → une classe+ Règle en ajoute une, × la retire. La première règle correspondante s'applique aux lignes sans valeur de classe.
Rapprocher les entités existantes parID global, Nom, NuméroLes lignes qui correspondent à une entité existante la mettent à jour au lieu d'en créer une copie. Les rapprochements par nom et par numéro exigent aussi la même classe.
Rapprocher les entités liées parID global, Nom, NuméroLa manière dont les valeurs des colonnes de relation trouvent leurs cibles.
Format de date des colonnes de date (CSV)Automatique, yyyy-MM-dd HH:mm:ss, dd/MM/yyyy, MM/dd/yyyy, yyyyMMdd, Personnalisé…La manière dont les cellules de date sont lues. Personnalisé… affiche un champ pour votre propre modèle (par exemple dd.MM.yyyy HH:mm) avec yyyy, MM, dd, HH, mm et ss.
Modèle de numérotation (Word, texte)Vide (automatique), ou des marqueurs comme 1. a) (i), ou des numéros de chemin comme 1.1 ou 1.1.aLa manière dont les paragraphes numérotés deviennent le plan. Pour le texte, le modèle est détecté à partir de la numérotation et rempli. Les styles de titre Word et la numérotation des listes n'ont pas besoin de modèle. Voir Modèle de numérotation.
Numéroter les enfants sous leur parent (1 → 1.1) (Word, texte)Activé par défautLes numéros d'enfants générés deviennent « 3.1 », « 3.2 » au lieu de « 1 », « 2 ».

Hiérarchie. Les numéros de plan reconstruisent la hiérarchie : « 1.2.3 » devient un enfant de « 1.2 ». Une colonne Numéro parent, ou une paire ID de ligne et ID de la ligne parente, définit le parent explicitement. Les éléments sans parent deviennent les éléments de premier niveau du document.

Tableaux Word. Pour un fichier Word, la section Tableaux Word liste chaque tableau. Les tableaux qui se répètent avec le même en-tête d'une section à l'autre partagent une même correspondance. La section explique : « Importez un tableau d'exigences sous forme d'entités, une par ligne, et mettez ses colonnes en correspondance. Les autres tableaux restent des tableaux dans la description de l'élément qu'ils suivent. »

  • Réglez chaque tableau sur Entités (une par ligne) ou Tableau dans la description.
  • Mettez ses colonnes en correspondance avec Numéro, Nom, Description, Classe, Étiquettes, Attribut, Nouvel attribut ou Ignorer.
  • Les en-têtes comme ID, Req ID, Requirement ID, Ref ou Paragraph correspondent à Numéro.
  • Shall, Shall Statement, Requirement Statement, Requirement Text, Statement ou Text correspondent à Description.

Un tableau avec une colonne de numéro ou de description et des lignes en « shall » démarre comme entités.

Les avertissements trouvés jusqu'ici apparaissent sous les colonnes, ou « Aucun avertissement. »

Étape 3 : Revue

Vérifiez le résultat avant que quoi que ce soit ne change. La revue affiche les modifications de la même façon que Références et versions compare les versions (voir Références et comparaison de versions) :

  • La première ligne nomme le fichier, le format et le nombre d'éléments par classe.
  • Créer un document d'exigences à partir de ces N exigences apparaît, coché, lorsque chaque élément est un Statement ou une Requirement (ou une sous-classe). Pour les autres fichiers, il devient Créer un document à partir de ces N éléments, non coché. Une fois coché, choisissez le Type de document (par défaut Document d'exigences), le Nom (par défaut : le nom du fichier) et s'il faut Renuméroter tout le document après l'importation.
  • Les avertissements suivent.
  • Des tuiles comptent les Nouveaux éléments, les Éléments mis à jour, les éléments Rapproché, inchangé et les Relations du fichier.
  • Le tableau des modifications liste chaque nouvel élément avec sa description, et chaque champ modifié d'un élément mis à jour avec un diff des mots de l'ancienne et de la nouvelle valeur (les 500 premières modifications).

Cliquez sur Importer N éléments. Le message indique « N nouveaux importés, M mis à jour ».

  • Sans avertissement, Holarch ouvre le nouveau document d'exigences (ou la base de données).
  • Sinon, la carte Importation terminée liste les avertissements (« L'importation n'a signalé aucun avertissement. » lorsqu'il n'y en a pas). Ses boutons sont Ouvrir le document, Ouvrir la base de données, Diagramme Spider, Diagramme en arbre, Contrôler la qualité et Lancer une autre importation.

La description du nouveau document liste les avertissements de l'importation.

Comment chaque format est lu

Word (.docx) :

  • Les titres et la numérotation des listes Word deviennent le plan et conservent leurs numéros.
  • Un titre devient un Statement. Le corps de texte qui le suit devient sa description.
  • Un paragraphe contenant shall, must, will ou should devient une Requirement enfant, nommée d'après les mots qui suivent le verbe modal. Un élément de liste numérotée aussi ; sans verbe modal, il devient un Statement.
  • Les éléments à puces, les images et les tableaux rejoignent la description de l'élément qu'ils suivent, en conservant le gras, l'italique, les listes et les tableaux.
  • Le .docx d'origine est joint au nouveau document lorsqu'il ne dépasse pas la limite de pièce jointe par fichier.
  • Les images PNG, JPEG, GIF, WebP et SVG sont conservées. Les autres formats d'image sont ignorés avec un avertissement.

Excel (.xlsx, .xlsm) et CSV :

  • Une ligne par entité, colonnes libres. La première ligne est l'en-tête.
  • Les cellules sur plusieurs lignes conservent leurs sauts de ligne.
  • Les fichiers Excel 97-2003 (.xls) ne sont pas lus. Enregistrez-les d'abord en .xlsx ou en .csv.

ReqIF (.reqif, .reqifz) :

  • Chaque SPEC-OBJECT devient une ligne avec ReqIF ID, Parent ID (d'après la hiérarchie de la spécification), Type (son type d'objet, mis en correspondance avec Classe), Long Name et une colonne par définition d'attribut.
  • Les colonnes sans correspondance prennent par défaut Nouvel attribut. Les attributs XHTML deviennent des attributs en texte enrichi, et les attributs d'énumération deviennent des listes de choix.
  • Les SPEC-RELATIONs deviennent des relations par leur nom. Lorsque le nom ne correspond à aucune relation autorisée par le schéma, elles deviennent traced to.
  • Une archive .reqifz est décompressée automatiquement.

Texte brut (.txt) ou texte collé :

  • Une ligne numérotée (« 3.1 Battery »), ou une ligne courte sans point, devient un titre (Statement).
  • Chaque phrase contenant shall, must, will ou should devient une Requirement sous le titre courant.
  • Le reste du texte rejoint la description de l'élément précédent.
  • Avec un modèle de numérotation (détecté dans le texte, ou saisi), le modèle détermine les niveaux.

Mettre à jour des exigences depuis un tableur

Utilisez cette méthode pour modifier de nombreuses exigences à la fois dans un tableur.

  1. Dans la base de données (ou la page Exigences), cliquez sur Exporter… et choisissez Tableau (CSV).
  2. Cochez les attributs à modifier. Sous Inclure, cochez ID, puis cliquez sur Exporter.
  3. Modifiez les valeurs dans le tableur. Ne modifiez pas la colonne ID.
  4. Importez le fichier. Dans Mapper, vérifiez que la colonne ID correspond à ID global et réglez Rapprocher les entités existantes par sur ID global.
  5. Dans Revue, décochez Créer un document….

    Les lignes rapprochées comptent comme Éléments mis à jour, avec chaque champ modifié listé.

  6. Cliquez sur Importer N éléments.

Une valeur I_… issue d'un fichier exporté avant cette version ne correspond pas ; utilisez la colonne ID. Pour chaque étape et option, voir Importer et exporter.

Ce qu'écrit une mise à jour :

  • Uniquement les colonnes mises en correspondance. Sans colonne Description, chaque description existante est conservée.
  • Les étiquettes du fichier s'ajoutent aux étiquettes existantes.
  • Sans colonne Classe, une ligne rapprochée par ID global conserve la classe de son entité.

Messages d'importation

MessageSignification et correction
Aucune colonne ne correspond à Nom ou Numéro. Faites correspondre l'une d'elles.Mettez au moins une colonne en correspondance avec Nom ou Numéro.
Ligne N : classe inconnue « X », <classe> utilisée.La valeur de Classe ne correspond à aucune classe. Corrigez la valeur ou réglez la colonne sur Ignorer.
Ligne N : étiquette inconnue « X » ignorée.Créez d'abord l'étiquette dans le schéma, ou corrigez la valeur.
Ligne N : « <attribut> » ne s'applique pas à la classe <classe>.La classe de la ligne n'a pas cet attribut.
Ligne N : « <valeur> » n'est pas un(e) <type> valide pour « <attribut> ».La valeur ne peut pas être lue comme un nombre, une date, un choix, etc. Vérifiez l'option de format de date.
Ligne N : le nom dépasse 255 caractères et a été raccourci. / Ligne N : le numéro dépasse 255 caractères et a été raccourci.Les noms et les numéros sont limités à 255 caractères.
Numéro X en double (lignes A et B).Deux lignes partagent un numéro ; la hiérarchie peut rattacher les enfants à la première.
Ligne N : numéro parent P manquant pour X ; rattaché à Q. / … ; importé au premier niveau.Le numéro du parent direct n'est pas dans le fichier.
Ligne N : numéro parent P introuvable. / Ligne N : parent P introuvable.Le numéro parent ou l'ID de la ligne parente renvoie à une ligne absente du fichier.
Ligne N : cible « X » de « <relation> » introuvable.La colonne de relation nomme une entité qui n'existe pas. Vérifiez Rapprocher les entités liées par.
Ligne N : « <relation> » de A vers B n'est pas autorisée par le schéma (créée quand même).Le lien a été créé bien que le schéma ne le liste pas.
La relation « X » entre A et B n'est pas autorisée par le schéma ; ignorée.Une relation ReqIF ou XMI n'a pas pu être créée, même en traced to.
Image X : les images .ext ne sont pas prises en charge et ont été ignorées. Enregistrez l'image en PNG ou en JPEG dans Word pour la conserver.Image Word dans un format non pris en charge.
L'image X (taille) dépasse la limite de pièce jointe de <limite> et a été ignorée.L'image dépasse la limite par fichier.
Aucune ligne de données trouvée.Le fichier ou la feuille n'a qu'un en-tête, ou est vide.
Impossible de lire le fichier : les fichiers Excel 97-2003 (.xls) ne sont pas pris en charge. Dans Excel, enregistrez le fichier en .xlsx ou en .csv, puis importez-le de nouveauConvertissez le fichier.
Impossible de lire le fichier : le XML contenant une déclaration DOCTYPE ou ENTITY n'est pas accepté. Enregistrez le fichier sans elle et importez-le de nouveauRetirez la déclaration du fichier ReqIF ou XML.
Impossible de lire le fichier : XML non valideLe fichier ReqIF n'est pas un XML bien formé.
Échec de l'importation : <motif>L'importation s'est arrêtée ; rien n'a été modifié.

Raccourcis des exigences

TouchesOùAction
EnterSaisie rapide du documentAjouter l'exigence saisie.
⌘ / Ctrl+Enter / ⌥ / Alt+⌘ / Ctrl+EnterDocument, élément sélectionnéAjouter un élément de même niveau / un enfant.
Enter ou SpaceLignes Qualité, TBD/TBR et Liens à revoirAfficher dans l'inspecteur l'exigence ou l'élément à revoir de la ligne.
↑ / ↓Mêmes lignes, ligne activePasser à la ligne précédente ou suivante.
⌘ / Ctrl-clic, ⇧ / Shift-clic, ⌘ / Ctrl+⇧ / Shift-clicLignes Qualité, TBD/TBR et Liens à revoir ; lignes de la base de données ; éléments de documentBasculer une ligne, sélectionner la plage depuis la dernière ligne cliquée, ajouter cette plage.
⌘A / Ctrl+A, ⇧ / Shift+↑ / ⇧ / Shift+↓Mêmes lignes, ligne activeSélectionner toutes les lignes affichées ; étendre la sélection depuis la ligne active.
Clic droit, Shift+F10 ou la touche MenuLignes Exigences, Qualité, TBD/TBR et Liens à revoir ; éléments de document et entrées du planOuvrir le menu de la ligne : d'abord les actions suggérées avec leurs raisons et ✦ Plus d'IA ▸, puis les commandes de l'élément.
EscQualité, TBD/TBR, Liens à revoir, RVTMDésélectionner la ligne.
EnterChamp de nom de Références et versionsCréer la référence de projet.
⌘Z / Ctrl+ZPartoutAnnuler la dernière modification, y compris une importation entière, le marquage de liens comme revus ou un changement de statut.

Pour tous les raccourcis de l'application, voir Raccourcis clavier.

Paramètres

RéglageOùPar défautPortée
Recontrôler automatiquement quand le texte changeBarre de portée de la page QualitéDésactivésCe navigateur
Groupes de l'inspecteur repliés ou ouverts (Qualité et les autres)Cliquez sur le titre d'un groupe dans l'inspecteur, ou sur Tout réduire / Tout développer à la fin de ses liensQualité repliée, le reste ouvertCe navigateur, par classe
Votre nom sur les approbations, les décisions et les commentairesLe nom de votre compte—Compte
Statut de traçabilité (points sur les exigences)Affichage ▾ du documentSurDocument

Messages

MessageOùSignification
N exigences contrôléesQualitéLe contrôle a porté sur la portée.
Aucune exigence dans cette portée.QualitéLa portée ne contient aucune exigence.
Ce document n'a aucun Requirement à contrôler. Les Statements ne sont pas évalués.Contrôle de qualité du documentChangez des éléments en Requirement ou contrôlez un autre document.
Obsolète — relancer / Périmé / Qualité : périmée — relancerQualité, documents, inspecteurLe texte a changé depuis le dernier contrôle.
Demande le jugement d'un relecteurQualité (Correcte, Faisable)Une personne doit décider ; cliquez sur ✘ pour marquer Oui.
Marqué Non manuellement.QualitéUn relecteur a réglé le critère sur Non.
N exigence(s) approuvée(s) passée(s) à En revue ; N lien(s) marqué(s) à revoir.Après une modificationLa modification a rouvert des approbations et marqué des liens à revoir.
Approuvé / Rejeté / Passé à En revueCadre d'approbationLa décision a été enregistrée.
N liens marqués comme revus.Liens à revoirLes revues ont été enregistrées.
Sélectionnez d'abord les liens à marquer comme revus.Liens à revoirCochez des lignes avant Marquer la sélection comme revue….
Clos / Attribut clos ; le texte contient encore TBD.TBD/TBRL'attribut a été réglé sur Aucun.
Le texte contient encore TBD. Modifiez le texte pour le clore.TBD/TBRAffiché lors de la clôture d'un élément issu uniquement du texte.
Référence enregistréeDocuments, Références et versionsL'instantané a été enregistré.
Ce document n'a pas de référence. Enregistrez-en d'abord une.Comparer à l'actuel, rapports de modificationsLe document n'a pas de référence.
Rétabli à « <nom> » / « <nom> » restauréRéférencesLe document ou le projet a été ramené en arrière ; l'annulation est possible.
Aucune exigence à examiner. Sélectionnez ou ouvrez d'abord des exigences.Contrôle des exigences par l'IAAucune exigence dans la portée.

Limites

  • Contrôle de qualité : chaque exigence de la portée est comparée aux autres pour détecter les doublons (seuil de similarité de 75 %).
  • Contrôle des exigences par l'IA : 20 exigences par demande d'IA, avec jusqu'à 300 autres exigences comme contexte.
  • Le diff de revue de lien conserve les 500 premiers caractères de l'ancien nom et les 4 000 premiers de l'ancienne description.
  • Burn-down TBD/TBR : jusqu'à 60 points.
  • Importation :
    • Noms et numéros jusqu'à 255 caractères.
    • L'aperçu affiche les 500 premières lignes. Les 50 premiers avertissements sont listés (« …et N de plus »).
    • Un modèle de numérotation a au plus 6 niveaux (« Le modèle de numérotation a plus de 6 niveaux. Utilisez au plus 6 marqueurs. »).
    • Fichiers ReqIF/XML jusqu'à 100 millions de caractères et 3 000 000 d'éléments.
    • Archives .reqifz et .docx jusqu'à 10 000 entrées, 300 Mo par entrée et 600 Mo au total.
    • Les images et le fichier Word d'origine ne sont conservés que dans la limite de pièce jointe par fichier (10 Mo avec l'offre Free, 25 Mo avec Individual, 100 Mo avec Team).