Vérification
Contrôles du modèle
Exécutez 75 contrôles fondés sur des règles et vos propres jeux de règles sur l'ensemble du modèle, filtrez les constats par gravité, classe, règle et étiquette, corrigez-les sur place, ignorez ceux qui sont voulus et réglez la sévérité de chaque règle.
Sur cette page
Vue d'ensemble
Vérification → Contrôles du modèle exécute un catalogue de règles sur chaque élément du projet et liste ce que chaque règle trouve. Les règles recherchent les lacunes qui rendent un modèle difficile à croire ou à examiner : noms et numéros manquants, éléments isolés, actions que personne n'exécute, interfaces qui ne transportent rien, exigences non allouées ou non vérifiées, risques sans plan de traitement et mesures qui manquent leur seuil.
Les contrôles s'exécutent à nouveau chaque fois que le modèle change ; la page, la carte Contrôles du modèle de l'accueil et le badge de Vérification concordent donc toujours.
Concepts
- Règle : un contrôle avec un numéro (par exemple Requirement.10), un titre qui nomme ce qu'il trouve, une description de ce à quoi ressemble un bon modèle, et une correction. Les règles sont regroupées par classe contrôlée : Global (chaque élément), Action, Asset, Conduit, Input/Output, Requirement, Risk, Test Case et Measure.
- Constat : un élément qui enfreint une règle. Un constat peut nommer des éléments liés, par exemple les doublons d'un nom ou les enfants d'un parent.
- Gravité : chaque règle signale en Erreur ou en Avertissement, ou est réglée sur Ignorer et ne s'exécute pas. La valeur par défaut est Avertissement, sauf pour les règles LML 2.0 Global.10 et Global.11 dans un projet dont la copie du schéma est antérieure à LML 2.0 (voir Règles).
- Constat ignoré : un constat que vous avez accepté pour un élément. Il ne compte plus, et Afficher les ignorés le liste avec Restaurer.
- Contrôle applicable : une règle qui s'est exécutée sur au moins un élément de sa classe. La ligne d'en-tête compte combien de contrôles applicables n'ont aucun constat.
- Jeu de règles : un groupe nommé de vos propres règles, stocké dans le projet et activé ou désactivé d'un bloc. Ses règles s'exécutent avec les contrôles intégrés, et leurs constats utilisent la même liste, Corriger et Ignorer. Voir Jeux de règles.
Mode d'emploi
Exécutez les contrôles avant chaque revue, après une importation importante, et chaque fois que l'accueil affiche des erreurs de contrôle du modèle. Ils répondent à une question : qu'est-ce qui, dans le modèle, demande de l'attention avant que quelqu'un d'autre ne le lise ?
Traiter les constats
- Ouvrez Vérification → Contrôles du modèle. La ligne d'en-tête affiche par exemple « 84 % des contrôles applicables réussissent », suivi du nombre d'erreurs et d'avertissements et de l'évolution depuis la dernière exécution.
- La liste est regroupée par règle, les erreurs en premier. Cliquez sur le titre d'une règle pour l'ouvrir ; sa description explique pourquoi la règle est importante.
- Pour chaque constat, cliquez sur Corriger. La boîte de dialogue de correction affiche l'élément, la règle et la correction suggérée : un champ à remplir, des relations à ajouter, des doublons à fusionner, ou un bouton qui ouvre l'élément ou son diagramme.
- Enregistrez la correction. Le constat disparaît et les décomptes se mettent à jour.
- Lorsqu'un constat est voulu (par exemple une action réutilisée sous deux parents), cliquez sur Ignorer.
Se concentrer sur un domaine
- Dans les facettes à gauche, cochez Erreurs sous Gravité pour ne voir que les erreurs.
- Cochez une classe sous Classe (la classe de l'élément qui a le constat), une règle sous Règle ou une étiquette sous Étiquette. Les coches d'une même facette se combinent par OR ; les facettes se combinent par AND. Chaque valeur indique son nombre de constats.
- Saisissez du texte dans Filtrer les constatations pour rechercher un nom d'élément ou un titre de règle.
- Cliquez sur Effacer les facettes pour tout afficher à nouveau.
Examiner ensemble les constats d'un élément
- Choisissez Regrouper par entité à côté du filtre.
- Chaque élément est listé une fois avec tous ses constats, dans l'ordre des numéros. Un élément qui a une erreur affiche un badge Erreur dans son titre.
Exemple complet : la démo CubeSat EO-1
- Ouvrez le projet de démonstration CubeSat EO-1 et allez dans Vérification → Contrôles du modèle.
- Cochez Requirement sous Classe. Les règles restantes montrent quelles exigences n'ont pas de parent, pas d'allocation (Requirement.8) ou pas de cas de test de vérification (Requirement.10).
- Ouvrez Requirement.10, cliquez sur Corriger sur un constat, et liez le cas de test qui la vérifie. Le constat quitte la liste, et la ligne d'en-tête progresse.
- Choisissez Regrouper par entité pour voir d'un coup tous les constats restants d'une exigence.
Écrire votre propre règle
- Cliquez sur Jeux de règles… dans l'en-tête de la page, puis sur + Nouveau jeu de règles. Nommez le jeu, par exemple « Program Rules », et cliquez sur OK.
- Sous le jeu, cliquez sur + Ajouter une règle. L'éditeur de règles s'ouvre avec l'ID R1.
- Saisissez un Nom qui dit ce que la règle trouve, par exemple « Exigences sans cas de test de vérification ».
- Dans S'applique à, choisissez Requirement.
- Dans Signaler un élément quand, choisissez Une relation est absente, puis choisissez verified by dans Relation.
- Réglez Gravité sur Erreur et rédigez le Message, par exemple « Liez le cas de test qui vérifie l'exigence. »
- Lisez l'aperçu sous les champs, par exemple « Signale 3 éléments maintenant : SYS-2 Top Speed, … ». Cliquez sur Enregistrer.
- Cliquez sur Fermer. Les constats de la règle apparaissent dans la liste sous R1, les erreurs en premier. Cliquez sur Corriger pour lier un cas de test ; le constat quitte la liste.
Contrôler un budget de masse avec unités
- Dans la démo CubeSat EO-1, ouvrez Jeux de règles…, cliquez sur + Nouveau jeu de règles et nommez-le « Mass Budget ».
- Cliquez sur + Ajouter une règle. Nommez-la « Assemblages au-dessus de leur allocation de masse » et choisissez Asset dans S'applique à.
- Dans Signaler un élément quand, choisissez Un total de valeurs liées comparé à une valeur. Réglez Fonction sur Total, Relation sur decomposed by, Valeur de chaque élément lié sur Mass, Comparaison sur est supérieur à et Comparer avec sur Mass Allocation.
- Réglez Gravité sur Erreur et cliquez sur Enregistrer, puis sur Fermer.
- Un assemblage dont les parties pèsent plus que son allocation est listé, par exemple « Total Mass of « decomposed by » 2.34 kg is more than Mass Allocation 1.35 kg ». Les masses en grammes et en kilogrammes s'additionnent ; une masse saisie en mètres est listée comme « Cannot add mass and length: the dimensions differ (kg vs m). »
Partager des règles avec un autre projet
- Dans Jeux de règles…, cliquez sur Exporter à côté du jeu. Un fichier nommé par exemple
program-rules.holarch-rules.jsonest téléchargé. - Dans l'autre projet, ouvrez Jeux de règles…, cliquez sur Importer…, puis sur Choisir un fichier… (ou collez le texte du fichier) et cliquez sur Importer.
- Pour partager par une bibliothèque, gardez les jeux de règles dans le projet de bibliothèque et publiez une version. Dans un projet qui utilise la bibliothèque, cliquez sur Depuis une bibliothèque…, cochez les jeux et cliquez sur Copier.
- Lorsque la bibliothèque publie une version plus récente contenant le jeu, Jeux de règles… affiche « Une version plus récente est disponible » à côté de la copie. Cliquez sur Mettre à jour…, examinez les modifications, choisissez Garder la mienne ou Prendre celle de la bibliothèque pour chaque règle modifiée des deux côtés, et cliquez sur Mettre à jour. Vos autres modifications de la copie sont conservées.
Conseils
- Réglez sur Erreur dans Paramètres les règles que votre équipe considère comme bloquantes, pour que l'accueil les liste comme des problèmes.
- N'ignorez un constat que lorsqu'il est voulu, et expliquez pourquoi dans la description de l'élément ou dans un commentaire. Afficher les ignorés permet aux relecteurs de voir ce qui a été accepté.
- Une longue liste de constats de nommage après une importation se corrige généralement le plus vite en modifiant les noms dans la base de données.
- Exécutez les contrôles avant d'enregistrer une référence, pour que la référence ne porte pas de lacunes connues.
La page
En-tête de page
| Commande | Ce qu'il fait |
|---|---|
| Exporter… | Ouvre la boîte de dialogue Exporter avec Constats (CSV) : chaque constat non ignoré, avec la règle, la gravité, le titre, l'id de l'élément, le numéro, le nom, la classe, la note et les éléments liés. |
| Paramètres | Définit la gravité de chaque règle et le nombre d'enfants par niveau (voir Paramètres). |
| ↻ Lancer les contrôles | Réexécute tous les contrôles et enregistre les décomptes comme dernière exécution. |
Ligne d'en-tête
- « N % des contrôles applicables réussissent » : en rouge lorsqu'un constat est une erreur, en ambre lorsqu'il n'y a que des avertissements, en vert lorsqu'il n'y a rien à corriger.
- Le nombre de constats, d'erreurs et d'avertissements.
- L'évolution depuis la dernière exécution sur cet appareil, par exemple « 3 constats de moins que lors de la dernière exécution. » La dernière exécution est enregistrée lorsque vous ouvrez ou quittez la page et lorsque vous cliquez sur ↻ Lancer les contrôles. La première visite indique « Première exécution sur cet appareil. »
Sur un grand projet, les contrôles s'exécutent en arrière-plan pour que la page reste utilisable : la première visite affiche « Exécution des contrôles du modèle… », les visites suivantes affichent les constats précédents jusqu'à ce que les nouveaux soient prêts, et une carte de progression s'affiche pour une exécution qui dure plus d'une seconde.
Barre d'outils
- Regrouper par règle (par défaut) ou Regrouper par entité. Le choix est mémorisé sur cet appareil.
- Filtrer les constatations : recherche dans les noms d'éléments, les numéros de règles et les titres de règles.
- Tout développer et Tout réduire ouvrent ou ferment tous les groupes.
Facettes
| Facette | Valeurs |
|---|---|
| Gravité | Erreurs, Avertissements |
| Classe | La classe de chaque élément qui a un constat |
| Règle | Chaque règle qui a un constat, par numéro et titre |
| Libellé | Chaque étiquette d'un élément qui a un constat |
| Ignoré | Afficher les ignorés ajoute à la liste les constats ignorés, marqués Ignoré, avec Restaurer |
Les décomptes suivent les autres facettes et le filtre : ils montrent ce qui resterait si vous cochiez une valeur.
Constats
Chaque constat affiche l'élément (ou, en regroupement par entité, la règle), la note (par exemple « Mots vagues : adequate, TBD » ou « 14 enfants »), les éléments liés, et les boutons Corriger et Ignorer, ou Restaurer pour un constat ignoré. Une seule annulation défait un Ignorer ou un Restaurer.
Corrections
| Correction | Utilisé par | Ce qu'il fait |
|---|---|---|
| Modifier un champ | Nom, numéro ou description manquant ; contrôles de verbe et de nom | Ouvre le champ avec la valeur actuelle. |
| Mettre une majuscule | Noms en minuscules | Propose le nom avec une majuscule initiale. |
| Ajouter des relations | Parent, exécutant, entrées, sorties, conduits, normes, traces manquants | Liste les éléments que le schéma autorise pour la relation ; cochez-les et cliquez sur Ajouter des relations. |
| Fusionner | Noms similaires, enfants uniques | Garde un élément, lui transfère toutes les relations des autres, combine les descriptions et supprime les autres (une seule annulation défait le tout). |
| Supprimer les éléments liés | Actions dont une entrée est produite après son utilisation | Supprime les entrées/sorties consommées avant d'exister. |
| Ajouter traced to | Exigences nommant des entités non reliées | Ajoute traced to de l'exigence vers chaque élément que son texte nomme. |
| Créer une Issue | Cas de test en échec sans problème lié | Crée une Issue liée au cas de test et aux exigences qu'il vérifie. |
| Ouverture | Longues listes d'enfants, échanges, normes, seuils, relations que le schéma n'autorise pas | Ouvre l'élément ou son diagramme. |
| Ouvrir la vue UAF | Vues UAF impossibles à afficher | Liste les vues de la racine avec leurs problèmes et ouvre la première. |
Paramètres
- Enfants par niveau : Action.9 et Asset.9 signalent un parent ayant plus d'enfants que ce nombre. La valeur par défaut est 9, d'après le principe selon lequel on gère environ 7 ± 2 éléments à un même niveau. Les valeurs autorisées vont de 2 à 99 ; une autre valeur affiche « Le nombre d'enfants par niveau doit être un nombre entier de 2 à 99. »
- Gravité par règle : Erreur, Avertissement ou Ignorer. Une règle ignorée ne s'exécute pas.
- Rétablir les valeurs par défaut remet chaque règle à sa valeur par défaut (Avertissement ; Requirement.11 sur Ignorer ; Global.10 et Global.11 sur Ignorer dans un projet dont la copie du schéma est antérieure à LML 2.0) et le nombre d'enfants par niveau à 9.
Les paramètres sont stockés dans le projet, partagés avec tous ses membres, et peuvent être annulés.
Jeux de règles
Jeux de règles… dans l'en-tête de la page ouvre la boîte de dialogue Jeux de règles. Vos propres règles s'exécutent dans les contrôles du modèle avec les contrôles intégrés : leurs constats affichent l'ID de la règle (par exemple R1) et son nom, comptent dans la ligne d'en-tête, apparaissent sous Règle dans les facettes, et utilisent Corriger, Ignorer et Exporter… comme tout constat. Les jeux de règles sont stockés dans le projet, partagés avec tous ses membres, et chaque modification est une étape d'annulation.
La boîte de dialogue Jeux de règles
| Commande | Ce qu'il fait |
|---|---|
| + Nouveau jeu de règles | Demande un nom et ajoute un jeu vide, activé. |
| Importer… | Ajoute les jeux de règles d'un fichier de jeux de règles : Choisir un fichier… ou collez son texte, puis Importer. Chaque règle est d'abord contrôlée ; un fichier qui présente un problème est refusé et les problèmes sont listés. Un nom déjà utilisé reçoit « (2) ». |
| Depuis une bibliothèque… | Liste les jeux de règles des versions des bibliothèques que ce projet utilise ; cochez-les et cliquez sur Copier. La copie mémorise sa bibliothèque et sa version. |
| Mettre à jour… | À côté d'un jeu copié lorsque sa bibliothèque a publié une version plus récente contenant le jeu (« Une version plus récente est disponible »). Prévisualise les règles ajoutées, modifiées et retirées dans la bibliothèque, les modifications que vous avez faites et qui sont conservées, et les règles modifiées ici et dans la bibliothèque ; choisissez Garder la mienne ou Prendre celle de la bibliothèque pour chacune d'elles, puis cliquez sur Mettre à jour. Une seule annulation défait le tout. |
| Case à cocher à côté d'un jeu | Active ou désactive le jeu. Un jeu désactivé ne s'exécute pas. |
| Renommer… | Renomme le jeu. |
| Export | Télécharge le jeu sous forme de fichier de jeu de règles JSON. |
| Supprimer | Supprime le jeu et ses règles après confirmation. L'annulation les restaure. |
| + Ajouter une règle, Modifier, Supprimer | Ajouter une règle au jeu, la modifier ou la supprimer. |
Une règle qui ne peut pas s'exécuter dans ce projet, par exemple une règle qui nomme une classe ou une relation absente du schéma, affiche le problème en rouge sous son nom et ne signale rien.
L'éditeur de règles
| Champ | Ce qu'il définit |
|---|---|
| Nom | Le titre des constats de la règle : ce que la règle trouve. |
| ID | Court et unique dans le jeu, par exemple R1 ou SYS-NUM ; jusqu'à 40 lettres, chiffres, points, tirets et traits de soulignement. |
| S'applique à | N'importe quel élément, une classe (sous-classes comprises : un Test Case est aussi une Action), ou, dans un projet SysML v2, un type de modèle comme Part ou Requirement. |
| Uniquement les éléments correspondant à | Facultatif : un filtre dans le langage de filtre de la base de données qui restreint d'abord les éléments, par exemple is:leaf. |
| Signaler un élément quand | La condition, ci-dessous. |
| Gravité | Erreur ou Avertissement. |
| Message | La correction à apporter, affichée dans la boîte de dialogue Corriger. |
La ligne sous les champs indique combien d'éléments la règle signale actuellement et nomme les cinq premiers.
| Condition | Champs | Signale un élément lorsque |
|---|---|---|
| Un attribut est vide | Attribut | L'attribut n'a pas de valeur. |
| Un attribut correspond à un motif | Attribut, Motif, Ignorer la casse | Le texte de l'attribut contient une correspondance du motif, une expression régulière. |
| Un attribut ne correspond pas à un motif | Attribut, Motif, Ignorer la casse | Le texte de l'attribut n'a aucune correspondance, par exemple ^SYS-\d+$ pour des numéros qui doivent commencer par SYS-. |
| Une relation est absente | Relation, Des éléments de | L'élément n'a aucun lien de cette relation (vers des éléments de cette classe). |
| Une relation est présente | Relation, Des éléments de | L'élément a un tel lien. |
| Au moins N éléments liés | Relation, Des éléments de, N | L'élément a N éléments liés ou plus, par exemple plus de 9 enfants. |
| Au plus N éléments liés | Relation, Des éléments de, N | L'élément a N éléments liés ou moins. |
| Une valeur est hors d'une plage | Attribut, Minimum, Maximum, Unité | Le nombre de l'attribut est inférieur au minimum ou supérieur au maximum. Laissez une borne vide pour une plage ouverte. |
| Une valeur est dans une plage | Attribut, Minimum, Maximum, Unité | Le nombre de l'attribut est dans la plage, bornes comprises. |
| Un total de valeurs liées comparé à une valeur | Fonction, Relation, Des éléments de, Valeur de chaque élément lié, Comparaison, Comparer avec | Le Total, le Plus petit ou le Plus grand d'une valeur sur les éléments liés (ou le Nombre d'éléments) est supérieur, au moins égal, inférieur, au plus égal, égal ou différent d'un attribut de l'élément (par exemple Mass Allocation) ou d'une valeur avec son unité (12 kg). Les éléments liés sans cette valeur sont ignorés. |
| Une expression correspond | Expression | L'élément correspond à l'expression. |
Les attributs sont nommés comme sur l'élément : Nom, Numéro et Description (dans un projet SysML v2, Nom court et Documentation) ou tout attribut de la classe. Dans un projet SysML v2, un usage d'attribut de l'élément, tel que mass, peut aussi être nommé. Un élément dont la classe n'a pas cet attribut est ignoré. Les valeurs d'un élément LML incluent aussi les characteristics par lesquelles il est specified by (une characteristic Mass de Value 2.4 et d'Units kg se lit 2,4 kg) et ses allocations budgétaires (Mass Allocation, issue des budgets). Sans Unité, une plage lit le nombre en tête de la valeur (1,500 kg et 1500 [kg] se lisent 1500) et ignore les valeurs qui ne sont pas des nombres. Avec une Unité telle que kg, les valeurs sont d'abord converties (25000 g se lit 25 kg), et une valeur d'une autre nature, comme 3 m, est un constat à part entière : « Cannot compare length and mass: the dimensions differ (m vs kg). » Les totaux et les expressions convertissent les unités de la même façon et signalent une incohérence de la même façon, jamais par une comparaison silencieuse.
Règles par expression
Une expression s'écrit dans le langage de filtre de la barre de filtre de la base de données : un filtre qui y trouve les éléments problématiques fonctionne donc comme une règle, et chaque élément correspondant est signalé. Exemples :
| Expression | Rapports |
|---|---|
class:Requirement is:leaf NOT relationship:"verified by" | Exigences feuilles qu'aucun cas de test ne vérifie. |
class:Requirement Requirement:"Status=Draft" | Exigences encore au statut Draft. |
class:Action is:root NOT relationship:"performed by" | Actions de premier niveau que rien n'exécute. |
class:Asset (name:%TBD% OR description:TBD) | Actifs comportant TBD dans le nom ou la description. |
class:Asset value:"sum(decomposed by → Mass) > Mass Allocation" | Assemblages dont les parties pèsent plus que leur allocation, quelle que soit la combinaison d'unités. |
Arithmétique avec unités : value:"Mass * 1.1 <= 12 kg" ou value:"sum(decomposed by → Mass) > Mass Allocation" compare des valeurs de l'élément et des totaux sur ses éléments liés (sum, min, max, count), avec +, -, *, /, des parenthèses et des unités après les nombres (12 kg, 9.81 [m/s^2]). Les comparaisons d'attributs avec une unité, comme Asset:"Mass>2 kg", convertissent aussi.
Termes : texte libre, name: (% correspond à n'importe quel texte), number: (* correspond à n'importe quel texte), description:, class:, label:, relationship:"…", status:, id:, under:"<number>", is:root, is:leaf, is:orphan, is:top, is:locked, is:diagram, les comparaisons d'attributs telles que Requirement:"Priority>=3" (=, ~ contient, <, <=, >, >= ; = sans valeur signifie vide), AND, OR, NOT et les parenthèses. Un terme qui ne nomme rien dans le projet, comme une classe inconnue, est affiché comme un problème.
Fichiers de jeux de règles
Un fichier de jeu de règles est un JSON avec "format": "holarch-rule-set", "version": 1, un name, une description facultative et une liste de rules, chacune avec id, name, severity, message, une target facultative ({"class": "Requirement"}), un filtre where facultatif et un check. Exportez un jeu pour voir la forme exacte. Les mêmes fichiers s'exécutent dans les contrôles du modèle de l'API publique et du MCP. Ils s'exécutent aussi sur les projets SysML v2 : l'API et le MCP n'y exécutent que les jeux de règles du projet (les règles intégrées s'exécutent dans l'application), et une règle portant sur les relations que Holarch lit à partir des connexions et des flux (connected by, transfers, generates, receives) ne s'exécute que dans l'application.
Règles
| Règle | Heading | Un bon modèle |
|---|---|---|
| Global.1 | Noms identiques ou presque | Au sein d'une classe, deux entités ne partagent pas le même nom. Les noms sont comparés dans toutes les langues, sans tenir compte de la casse, des espaces, de la ponctuation ni de la largeur des caractères (« ABS制御 » équivaut à « ABS制御 ») ; les lettres accentuées comptent (« Größe » et « Grüße » diffèrent). |
| Global.2 | Noms en minuscules | Chaque nom d'entité commence par une majuscule. |
| Global.4 | Numéros répétés dans une classe | Dans une classe, chaque numéro est unique. |
| Global.5 | Mots vagues dans les noms ou descriptions | Les noms et descriptions emploient des mots précis. |
| Global.6 | Entités sans relation | Chaque entité a une relation. |
| Global.7 | Valeurs dynamiques pointant vers des cibles manquantes | Les valeurs dynamiques, blocs de matrice, tableaux dynamiques (tableaux, décomptes et totaux) et renvois dans les descriptions pointent vers des entités, documents, classes, étiquettes, relations, figures et tableaux qui existent. |
| Global.8 | Vues UAF impossibles à afficher | Chaque vue UAF utilise une racine, une classe et une relation acceptées par son type de vue. |
| Global.9 | Relations que le schéma n'autorise pas | Chaque relation joint des classes que le schéma autorise pour cette relation. |
| Global.10 | Entités sans nom ni numéro | Chaque entité a un nom ou un numéro. |
| Global.11 | Valeurs hors des choix de leur attribut | Chaque valeur d'énumération ou de sélection multiple fait partie des choix de son attribut, choisie une seule fois. |
| Action.1 | Noms d'Action sans verbe initial | Chaque nom d'Action commence par un verbe. |
| Action.2 | Noms d'Action en minuscules | Chaque nom d'Action commence par une majuscule. |
| Action.3 | Actions sans nom | Chaque action a un nom. |
| Action.4 | Actions sans numéro | Chaque action a un numéro. |
| Action.5 | Actions sans description | Chaque action a une description. |
| Action.6 | Actions sans parent ni enfant | Chaque action a un parent ou un enfant. |
| Action.7 | Actions ayant un seul enfant | Aucune action n'a un seul enfant. |
| Action.9 | Actions de plus de 9 enfants | Aucune action n'a plus de 9 enfants. |
| Action.10 | Actions ayant plusieurs parents | Aucune action n'a plusieurs parents. |
| Action.11 | Actions qu'aucun actif n'exécute | Un actif exécute chaque action. |
| Action.12 | Actions qui ne produisent rien | Chaque action produit une entrée/sortie. |
| Action.13 | Actions qui ne consomment rien | Chaque action consomme une entrée/sortie. |
| Action.14 | Actions sans entrée ni sortie | Chaque action consomme ou produit une entrée/sortie. |
| Action.15 | Actions qui produisent sans rien consommer | Chaque action qui produit des sorties consomme aussi une entrée. |
| Action.16 | Actions qui consomment sans rien produire | Chaque action qui consomme des entrées produit aussi une sortie. |
| Action.17 | Actions dont une entrée est produite après son utilisation | Aucune action ne reçoit une entrée/sortie générée par une action ultérieure. |
| Action.18 | Actions non tracées vers une exigence | Chaque action est tracée vers une exigence. |
| Action.19 | Boucles qui ne peuvent jamais se terminer | Chaque boucle peut se terminer. Nomme la boucle et la branche OR à 0 % qui bloque son EXIT. |
| Asset.1 | Noms d'actif sans nom commun | Chaque nom d'actif est un nom ou un groupe nominal. |
| Asset.2 | Noms d'actifs en minuscules | Chaque nom d'actif commence par une majuscule. |
| Asset.3 | Actifs sans nom | Chaque actif a un nom. |
| Asset.4 | Actifs sans numéro | Chaque actif a un numéro. |
| Asset.5 | Actifs sans description | Chaque actif a une description. |
| Asset.6 | Actifs sans parent ni enfant | Chaque actif a un parent ou un enfant. |
| Asset.7 | Actifs avec un seul enfant | Aucun actif n'a un seul enfant. |
| Asset.9 | Actifs de plus de 9 enfants | Aucun actif n'a plus de 9 enfants. |
| Asset.10 | Actifs ayant plusieurs parents | Aucun actif n'a plusieurs parents. |
| Asset.11 | Actifs qui n'effectuent aucune action | Chaque actif effectue une action. |
| Asset.12 | Actifs non reliés par un conduit | Chaque actif est relié par un conduit. |
| Asset.13 | Actifs en échange sans conduit commun | Les actifs qui échangent une entrée/sortie sont reliés par un conduit. |
| Asset.14 | Actifs en interaction sans norme commune | Les actifs en interaction référencent la même norme. |
| Asset.15 | Actifs qui n'échangent rien | Chaque actif échange une entrée/sortie avec un autre actif. |
| Conduit.1 | Noms de conduits ne commençant pas par un nom | Chaque nom de conduit commence par un nom. |
| Conduit.2 | Conduits sans nom | Chaque conduit a un nom. |
| Conduit.3 | Conduits sans numéro | Chaque conduit a un numéro. |
| Conduit.4 | Conduits sans description | Chaque conduit a une description. |
| Conduit.5 | Conduits reliant plus de deux actifs | Aucun conduit ne relie plus de deux actifs. |
| Conduit.6 | Conduits reliant moins de deux actifs | Chaque conduit relie deux actifs. |
| Conduit.7 | Conduits sans norme commune avec leurs actifs | Un conduit et les actifs qu'il relie référencent la même norme. |
| Conduit.8 | Conduits qui ne transfèrent rien | Chaque conduit transfère une entrée/sortie. |
| Conduit.9 | Conduits non tracés vers une exigence | Chaque conduit est tracé vers une exigence. |
| IO.1 | Entrées/sorties sans nom | Chaque entrée/sortie a un nom. |
| IO.2 | Entrées/sorties sans numéro | Chaque entrée/sortie a un numéro. |
| IO.3 | Entrées/sorties sans description | Chaque entrée/sortie a une description. |
| IO.4 | Entrées/sorties ayant plusieurs parents | Aucune entrée/sortie n'a plus d'un parent. |
| IO.5 | Entrées/sorties qu'aucune action ne produit | Une action produit chaque entrée/sortie. |
| IO.6 | Entrées/sorties qu'aucune action ne consomme | Une action consomme chaque entrée/sortie. |
| IO.7 | Entrées/sorties qu'aucune action n'utilise | Chaque entrée/sortie est produite ou consommée par une action. |
| IO.8 | Entrées/sorties qu'une action produit et consomme à la fois | Aucune action ne consomme une entrée/sortie qu'elle produit. |
| IO.9 | Entrées/sorties sans norme commune avec leurs actifs | Une entrée/sortie et les actifs qui l'échangent référencent la même norme. |
| IO.10 | Entrées/sorties non tracées vers une exigence | Chaque entrée/sortie est tracée vers une exigence. |
| Requirement.1 | Exigences nommant des entités non reliées | Une exigence est reliée à chaque entité qu'elle nomme. |
| Requirement.2 | Exigences feuilles sans « shall » | Chaque exigence feuille emploie le mot « shall ». |
| Requirement.3 | Exigences sans nom | Chaque exigence a un nom. |
| Requirement.4 | Exigences sans numéro | Chaque exigence a un numéro. |
| Requirement.5 | Exigences sans description | Chaque exigence a une description. |
| Requirement.6 | Exigences sans parent ni enfant | Chaque exigence a un parent ou un enfant. |
| Requirement.7 | Exigences ayant plusieurs parents | Aucune exigence n'a plusieurs parents. |
| Requirement.8 | Exigences feuilles qu'aucune entité de conception ne satisfait | Chaque exigence feuille est reliée à une Action, un Asset, un Input/Output ou un Conduit. |
| Requirement.9 | Exigences satisfaites par plusieurs entrées/sorties | Aucune exigence n'est satisfaite par plus d'une entrée/sortie. |
| Requirement.10 | Exigences feuilles sans cas de test de vérification | Chaque exigence feuille est vérifiée par un Test Case. |
| Requirement.11 | Exigences hors des modèles EARS | Chaque exigence feuille contenant « shall » suit l'un des modèles EARS. Désactivée (Ignorer) tant que vous n'avez pas défini sa gravité. |
| Risk.1 | Risques de plus haut niveau sans atténuation | Chaque risque ouvert au niveau le plus élevé de la matrice des risques est atténué par quelque chose. |
| Risk.2 | Acceptations de danger antérieures à un changement de mesure de maîtrise | Aucune acceptation du risque résiduel d'un danger n'est antérieure à une modification de ses mesures de maîtrise ou de leur vérification. |
| TestCase.1 | Cas de test en échec sans problème lié | Chaque Test Case en échec est lié à un Issue. |
| Measure.1 | Mesures qui dépassent leur seuil | La valeur projetée (ou actuelle) de chaque Measure respecte son seuil. |
Remarques sur les règles :
- Les règles de rédaction des exigences citent le INCOSE Guide to Writing Requirements : mots vagues (R7, termes vagues ; R8, clauses échappatoires), « shall » (R1, énoncés structurés) et majuscules (R39, guide de style). Le contrôle complet de la rédaction est Qualité des exigences.
- Les tâches, cas de test, transitions d'état, ports et ressources sont ignorés par les règles Action et Asset ; les règles Global s'y appliquent toujours.
- Un élément décomposé compte comme exécuté, alimenté, productif ou tracé lorsque l'un de ses descendants l'est. Les éléments qui se décomposent mutuellement en boucle comptent ensemble.
- Global.9 signale chaque élément une seule fois, avec les autres extrémités de ses relations que le schéma n'autorise pas, et la relation et la classe dans la note, par exemple « Not allowed: decomposed by → Risk ». Une relation compte comme autorisée lorsque le schéma l'autorise dans l'un ou l'autre sens. De telles relations subsistent après le retrait d'une cible dans l'éditeur de schéma et peuvent arriver avec des importations.
- Global.10 et Global.11 viennent de LML 2.0 : une entité est identifiée par un nom ou un numéro (§2.1), et une valeur d'énumération ou de sélection multiple est choisie dans la liste de son attribut (§2.5.6, §2.5.12). Global.11 réunit dans sa note tous les problèmes d'un élément, par exemple
Status: "Pending" is not a choiceouVerification Method: "Test" chosen twice. Les deux s'exécutent par défaut là où le schéma contient les éléments intégrés LML 2.0 : le schéma par défaut, ou la copie propre d'un projet après Schéma → Ajouter les nouveaux éléments intégrés…. Dans un projet dont la copie du schéma est plus ancienne, elles démarrent sur Ignorer, de sorte qu'un modèle créé avec LML 1.x affiche les mêmes constats qu'avant ; réglez-les sur Avertissement ou Erreur dans Paramètres pour les exécuter. L'éditeur de schéma demande au moins deux valeurs lorsque vous créez ou modifiez une liste. - Les ports sont des points d'interface, pas des parties : ils ne comptent pas comme enfants, et un conduit sur un port compte pour l'actif qui le possède.
- Les cas d'utilisation (Actions portant l'étiquette Use Case) sont exemptés de la règle du verbe et des règles d'entrées/sorties.
- Requirement.11 contrôle la phrase qui contient « shall » par rapport aux six modèles EARS (Rédiger avec les modèles EARS) et nomme le premier point à corriger, par exemple « Event-driven: Put a comma after the \"When\" condition, before the system name. » La justification et les notes situées dans d'autres phrases ne sont pas contrôlées.
- Les projets SysML v2 exécutent 17 des règles, dans le vocabulaire SysML v2 : Global.1, .2, .4 à .8, Requirement.2 à .5, .8, .10 et .11, Risk.1, TestCase.1 et Measure.1. Les règles Action, Asset, Conduit et Input/Output ne s'appliquent pas ; les diagnostics de l'éditeur contrôlent les noms, les types et la structure du modèle. Les règles Requirement contrôlent les usages d'exigence : par exemple Requirement.8 s'intitule « Leaf requirements nothing satisfies » (une part ou une action qui la satisfait) et Requirement.10 « Leaf requirements with no verification case ». Global.1, .2 et .6 contrôlent les éléments à côté du modèle, comme les risques, les tâches et les documents.
Règles de ligne de produits
Dès qu'un projet a une Feature ou une Configuration, les contrôles du modèle exécutent aussi le jeu de règles intégré Ligne de produits (règles ProductLine.1 à ProductLine.11 et 13 à 17, classe Ligne de produits). Les features ou configurations manquantes dans Applies To (ProductLine.1), les configurations qui enfreignent une règle ou sont incomplètes (ProductLine.3) et les configurations Released dont des exigences n'y sont pas vérifiées (ProductLine.16) sont des erreurs ; les autres règles sont des avertissements. ProductLine.10 et 11 contrôlent l'exhaustivité de chaque configuration depuis Toutes les configurations. ProductLine.13 et 14 contrôlent les révisions d'un élément (supersedes) : deux en vigueur pour la même unité, et des unités sans aucune. Dans une vue de configuration, chaque règle contrôle cette configuration. Voir Lignes de produits et configurations.
Messages
| Message | Signification |
|---|---|
| « Aucun constat. Chaque contrôle applicable réussit. » | Rien à corriger. |
| « Aucun constat. N constats ignorés ; Afficher les ignorés les liste. » | Chaque constat restant a été ignoré. |
| « Aucun constat ne correspond au filtre. Effacez le filtre ou les facettes. » | Les facettes ou le filtre masquent tous les constats. |
| « Le schéma n'autorise aucune de ces relations pour la classe … » | La correction nécessite une relation que le schéma du projet n'autorise pas pour cette classe. Ajoutez-la dans l'éditeur de schéma, ou corrigez le constat autrement. |
| « Le motif n'est pas une expression régulière valide (…). Corrigez-le. » | L'éditeur de règles ou un fichier importé contient un motif illisible. |
| « L'id « … » est déjà utilisé dans ce jeu de règles. Choisissez-en un autre. » | Deux règles d'un même jeu doivent avoir des ID différents. |
| « La relation « … » ne figure pas dans le schéma de ce projet. » | Une règle nomme une relation que ce projet n'a pas ; elle ne signale rien tant que vous ne l'avez pas modifiée. |
| « L'expression ne nomme rien pour la classe « … ». » | Une expression ou un filtre nomme une classe, une étiquette, une relation ou un élément que le projet n'a pas. |
| « La version N n'est pas prise en charge. Cette version de Holarch lit la version 1. » | Le fichier de jeu de règles a été écrit par une version plus récente de Holarch. |
Limites
- La liste affiche jusqu'à 200 constats par groupe ; filtrez la liste pour voir le reste.
- Un jeu de règles contient jusqu'à 500 règles ; un fichier contient jusqu'à 50 jeux de règles et 2 Mo. Les motifs font jusqu'à 300 caractères et contrôlent les 20 000 premiers caractères d'une valeur.
- L'évolution depuis la dernière exécution est conservée par appareil et par navigateur, et non dans le projet.
- L'API publique et les outils MCP renvoient les mêmes constats avec les paramètres du projet ; ils ne stockent pas les résultats.