Holarch

Modèle

Schéma et extensions

Adaptez le schéma LML d'un projet avec des classes, attributs, choix, relations, étiquettes et flux de statuts personnalisés, et voyez comment chaque modification affecte les données existantes.

Utilisation →

Sur cette page
  1. Vue d'ensemble
  2. Concepts
    1. Le schéma du projet
    2. Cours
    3. Attributs
    4. Relations et cibles
    5. Étiquettes
    6. Workflows
  3. Mode d'emploi
    1. Quand et pourquoi
    2. Ajouter un attribut à une classe
    3. Ajouter des choix à un attribut existant
    4. Créer une sous-classe
    5. Ajouter une étiquette
    6. Autoriser une nouvelle relation
    7. Définir un workflow de statut
    8. Ajouter ou modifier les états d'un workflow
    9. Choisir les approbateurs d'une transition
    10. Demander une approbation pour un changement d'état
    11. Partager un schéma entre projets
    12. Exemple détaillé : CubeSat EO-1
    13. Conseils et bonnes pratiques
    14. Erreurs courantes
    15. Liens avec les autres fonctions
  4. L'éditeur de schéma
    1. En-tête de page
    2. Barre latérale
    3. Usage
    4. Page de classe
    5. Boîte de dialogue Modifier la classe
    6. Boîte de dialogue d'attribut
    7. Page Relations
    8. Page Étiquettes
    9. Page Workflow
  5. Effet des modifications du schéma sur les données existantes
  6. Extensions intégrées
  7. Raccourcis clavier
  8. Options et paramètres
  9. Messages
  10. Limites
  11. Voir aussi

Vue d'ensemble

Le schéma définit ce que le modèle d'un projet peut contenir :

  • les classes d'entités,
  • les attributs de chaque classe,
  • les relations qui peuvent relier les classes,
  • les étiquettes qui marquent les entités,
  • des workflows facultatifs : les états d'un attribut de statut par classe, la façon dont ils peuvent changer, et les changements qui nécessitent une approbation.

Chaque projet part du schéma par défaut du Lifecycle Modeling Language (LML). L'éditeur de schéma le modifie pour un seul projet. La première modification crée la copie propre au projet, de sorte que les autres projets ne sont pas affectés. Chaque modification du schéma peut être défaite par une seule annulation.

Holarch ajoute aussi des extensions intégrées à chaque projet, comme Priority et Owner sur les exigences et Handling Strategy sur les risques. Voir Extensions intégrées.

Pour le travail quotidien sur les entités, les attributs et les relations, voir Modèle et base de données.

Concepts

Le schéma du projet

  • Schéma par défaut : les classes, relations, attributs et étiquettes LML fournis avec Holarch. Les rubriques d'aide de l'application Classes LML (schéma), Relations LML (schéma) et Étiquettes (schéma) les listent en direct pour le projet ouvert.
  • Schéma du projet : une copie stockée dans le projet. Elle est créée à la première modification. Elle accompagne le projet dans les exports et parvient à chaque membre qui l'ouvre.
  • Extensions intégrées : les ajouts dont les fonctions de Holarch ont besoin. Ils sont appliqués par nom à chaque ouverture d'un projet. La plupart des projets ont donc déjà leur propre copie, et la page Utilisation indique « Ce projet utilise son propre schéma modifié. »

Cours

Une classe est un genre d'entité, comme Requirement ou Asset. Elle a un Nom, une Description, un Parent et une Couleur, ainsi que deux indicateurs (Abstraite et Masqué).

  • Parent : une sous-classe hérite des attributs et des cibles de relation de son parent. Elle apparaît dans chaque requête, filtre et diagramme qui couvre le parent. Par exemple, une sous-classe personnalisée d'Action reçoit les diagrammes d'action. Une sous-classe personnalisée de Requirement reçoit les contrôles de qualité et les commandes d'approbation.
  • Abstraite : la classe regroupe des sous-classes et ne peut pas être créée directement.
  • Masqué : la classe n'est pas proposée lorsque vous créez des entités ou changez leur classe. Elle et ses sous-classes sont exclues du filtre de classe de la base de données. Les entités existantes restent.
  • Couleur : la couleur du badge et de la pastille de la classe. Sans couleur, une classe personnalisée prend la couleur de son ancêtre intégré le plus proche. Le badge affiche les deux premières lettres du nom.

Attributs

Un attribut est un champ que possède chaque entité d'une classe, comme Priority sur les exigences. Un attribut peut aussi appartenir à une relation.

Un attribut a un Nom, un Type et une place dans l'ordre de la classe. Il peut avoir des Valeurs autorisées, une Valeur par défaut et une Description. La description s'affiche lorsque vous pointez sur le libellé de l'attribut.

Les types, regroupés comme les liste la boîte de dialogue d'attribut (l'id de type stocké figure entre parenthèses ; les exports, les imports et l'API l'utilisent) :

GroupeTypeContenu
TexteTexte court (TEXT), Texte long (BIG_TEXT), Texte enrichi (HTML)Une ligne ; plusieurs lignes ; texte mis en forme
ChiffresNombre (NUMBER), Pourcentage (PERCENT), Durée (DURATION)Un nombre ou une distribution ; de 0 à 100 ; un nombre ou une distribution avec une unité de temps
Date et heureDate et heure (DATETIME)Date et heure
ChoixUn parmi une liste (ENUMERATION), Plusieurs parmi une liste (MULTISELECT), Oui ou non (BOOLEAN)Une valeur ; plusieurs valeurs ; Oui ou Non
LiensAdresse web (URI), Fichier (FILE)Un lien ; un fichier téléversé
SpécialEmplacement (GEOPOINT), Équation (EQUATION), Calculé (COMPUTABLE), Personne ou équipe (USER_TEAM), Multiplicité (MULTIPLICITY), Contrôle qualité (QUALITY)Latitude et longitude ; texte LaTeX ; une valeur calculée à partir des attributs d'autres entités ; un nom de personne ou d'équipe ; n, n..m, n..* ou * ; un critère Oui/Non défini par le contrôle de qualité

Les éditeurs de chaque type sont décrits dans Types d'attributs et éditeurs.

Les attributs hérités des classes parentes sont listés en premier, puis les propres attributs de la classe, dans l'ordre défini sur la page de chaque classe (faites glisser une ligne, ou utilisez ↑ / ↓). Un nouvel attribut se place en dernier.

Un attribut masqué conserve ses valeurs. Il disparaît des éditeurs, des filtres, des colonnes, des recherches et des rapports jusqu'à ce qu'il soit de nouveau affiché.

Relations et cibles

  • Une relation est toujours une paire : un nom et un nom inverse, comme satisfies / satisfied by. En créer une crée les deux.
  • Une cible autorise une relation d'une classe vers une autre, par exemple Requirement verified by Test Case. Une cible vers une classe autorise aussi ses sous-classes. Les sous-classes héritent des cibles de leur parent.
  • Les relations peuvent porter des attributs, par exemple Multiplicity sur decomposed by. Un attribut ajouté à une relation s'applique aussi à son inverse.
  • Une relation masquée est affichée grisée dans l'éditeur de schéma et exclue de la liste de référence de l'Aide. Elle reste utilisable.

Étiquettes

Une étiquette est une marque que vous placez sur des entités, comme Stakeholder Need. Elle n'ajoute aucun champ et ne change rien à la structure.

Une étiquette a un Nom, une Description et la ou les Classe(s) auxquelles elle s'applique. Elle peut avoir une étiquette Parent, si bien que les étiquettes peuvent s'imbriquer.

  • Sans classe sélectionnée, l'étiquette s'applique à toutes les classes.
  • Une étiquette pour une classe s'applique aussi à ses sous-classes.
  • Une étiquette masquée reste sur les entités qui la portent mais n'est plus proposée.

Workflows

Un workflow contrôle la façon dont un attribut ENUMERATION d'une classe peut changer, généralement Status. Il comporte :

  • États : les valeurs qu'utilise la classe, dans l'ordre. Vous pouvez ajouter, renommer, réordonner et retirer des états personnalisés. Les états intégrés, comme l'état Approved d'une exigence, peuvent seulement être retirés du service. Une sous-classe dont l'attribut est hérité (par exemple une Software Requirement sous Requirement) conserve ses propres états.
  • Transitions (De → Vers) : les changements autorisés. Sans transitions, chaque état peut suivre n'importe quel autre.
  • Approbation sur une transition : le changement nécessite une demande de modification approuvée. Par défaut, les approbateurs définis dans Demandes de modification → Paramètres décident. Une transition peut désigner ses propres approbateurs à la place : propriétaires, éditeurs ou personnes nommées, et combien d'entre eux doivent approuver (jusqu'à 5, ou chaque personne nommée).
  • Verrouiller l'élément après cette transition (dans le menu ⋯ de la transition) : l'élément est verrouillé après le changement.

Les éditeurs de l'attribut ne proposent alors que la valeur actuelle et les états suivants autorisés. Un état qui nécessite une approbation affiche (nécessite une approbation).

Mode d'emploi

Quand et pourquoi

Adaptez le schéma au début d'un projet : lorsque vous mettez en place la méthode de modélisation, et avant d'importer des données. Raisons typiques :

  • Adopter une méthode ou une norme : ajoutez les attributs qu'exige votre processus, par exemple un TRL sur les actifs ou un Safety Integrity Level sur les exigences. Ajoutez les étiquettes qu'attendent vos modèles de documents.
  • Spécialiser des classes : ajoutez des sous-classes telles que Hazard sous Risk ou Payload Instrument sous Asset. Les requêtes, les filtres et les rapports peuvent alors les distinguer, et elles conservent toutes les relations LML.
  • Autoriser une relation dont la méthode a besoin : ajoutez une cible, ou une nouvelle paire de relations.
  • Imposer un processus de revue : ajoutez un workflow pour que le Status d'une exigence passe de Draft → In Review → Approved. L'éditeur ne la laisse alors jamais sauter une étape. Marquez In Review → Approved comme Approbation afin que le passage soit soumis aux approbateurs du projet.
  • Réutiliser entre projets : exportez le schéma d'un projet et importez-le dans le suivant.

Le schéma répond à la question « Que peut exprimer ce modèle ? ». Modifiez-le de manière réfléchie. Les requêtes, les colonnes enregistrées, les rapports et les imports font référence aux classes, attributs et relations par leur nom.

Ajouter un attribut à une classe

  1. Dans le rail de navigation, cliquez sur Paramètres → Schéma (avec les outils en bas).
  2. Dans la barre latérale, sous Classes, cliquez sur la classe, par exemple Asset.
  3. Dans la carte Attributs, cliquez sur + Attribut.
  4. Saisissez le Nom.
  5. Choisissez le Type, par exemple Un parmi une liste sous Choix.
  6. Pour Un parmi une liste ou Plusieurs parmi une liste : tapez les choix dans Valeurs autorisées, un par ligne.
  7. Facultatif : définissez une Valeur par défaut. Les nouvelles entités de la classe commencent avec elle.
  8. Facultatif : saisissez une Description.
  9. Cliquez sur Ajouter un attribut.

    Le message « Attribut enregistré » s'affiche. L'attribut est le dernier de la liste de la classe et apparaît pour cette classe et ses sous-classes : dans l'inspecteur, la Vue de l'élément, les colonnes et filtres de la base de données, les recherches, les rapports et les correspondances d'import.

  10. Pour le déplacer, faites glisser sa ligne dans le tableau Attributs, ou utilisez ↑ et ↓ sur la ligne. Chaque déplacement peut être défait par une seule annulation.

Ajouter des choix à un attribut existant

  1. Ouvrez la classe qui définit l'attribut. La colonne Défini sur l'indique. Un attribut hérité se modifie sur la classe qui le définit.
  2. Cliquez sur ✎ (Modifier l'attribut) sur la ligne.
  3. Ajoutez le nouveau choix sur sa propre ligne dans Valeurs autorisées.
  4. Cliquez sur Enregistrer.

Pour Un parmi une liste, le carré placé avant chaque choix (sous la liste) définit la couleur de la valeur. Les tableaux Kanban dont les colonnes sont les valeurs de cet attribut l'utilisent comme couleur de colonne.

Pour retirer un choix, supprimez sa ligne dans la même boîte de dialogue. Les entités qui ont déjà cette valeur la conservent, mais l'éditeur ne la propose plus. Avant de retirer un choix, trouvez ces entités avec une requête d'attribut (par exemple Requirement:"Priority=Urgent") et donnez-leur un choix actuel.

Créer une sous-classe

  1. Ouvrez la classe parente.
  2. Cliquez sur + Sous-classe.

    (Ou cliquez sur + Classe dans la barre latérale et choisissez le Parent.)

  3. Saisissez le Nom et la Description.
  4. Définissez Abstraite, Masqué et Couleur si nécessaire.
  5. Cliquez sur Créer la classe.

    La nouvelle classe s'affiche. Elle possède déjà tous les attributs et cibles hérités.

Pour déplacer des entités existantes dans la nouvelle classe, sélectionnez-les dans la base de données et utilisez Changer de classe…. Voir Changer de classe.

Ajouter une étiquette

  1. Cliquez sur + Étiquette dans la barre latérale, ou sur + Nouvelle étiquette dans la page Étiquettes.
  2. Saisissez le Nom et la Description.
  3. Si l'étiquette relève d'une autre étiquette, choisissez celle-ci comme Parent.
  4. Sélectionnez la ou les Classe(s) auxquelles elle s'applique. Un clic avec ⌘ / Ctrl/Ctrl en sélectionne plusieurs. Si aucune n'est sélectionnée, l'étiquette s'applique à toutes les classes.
  5. Cliquez sur Créer l'étiquette.

Pour appliquer l'étiquette, utilisez + Étiquette dans l'inspecteur ou la Vue de l'élément, ou Label ▾ dans la barre d'actions groupées de la base de données.

Autoriser une nouvelle relation

Une relation entre deux classes n'est autorisée que si une cible la permet. Ajoutez une cible pour l'autoriser.

  1. Ouvrez la classe source.
  2. Dans Relations, cliquez sur + Relation.
  3. Choisissez la Relation.
  4. Choisissez l'Autre classe.
  5. Laissez Ajouter aussi la relation inverse à l'autre classe coché. Le lien peut alors être créé depuis l'une ou l'autre extrémité.
  6. Cliquez sur Ajouter une relation.

Si l'autre classe n'a pas l'inverse, la colonne Retour à cette classe affiche + sur <class> : cliquez dessus pour y ajouter l'inverse.

Si la relation dont vous avez besoin n'existe pas, créez-la d'abord :

  1. Cliquez sur Nouveau type de relation… dans la boîte de dialogue (ou sur + Relation dans la barre latérale).
  2. Saisissez le Nom et le Nom inverse, ainsi que leurs descriptions.
  3. Cliquez sur Créer la relation.
  4. Choisissez la nouvelle relation à l'étape 3 ci-dessus.

Définir un workflow de statut

  1. Cliquez sur Workflow dans la barre latérale.
  2. Dans Ajouter une classe…, choisissez la classe.

    Une carte s'affiche pour la classe. Le workflow surveille le premier attribut d'énumération de la classe.

  3. Si nécessaire, choisissez un autre attribut dans la liste surveille. Le changer efface les transitions.
  4. Cliquez sur + Ajouter une transition.
  5. Définissez le Nom, le De et le Vers de la transition. De vaut (Initial — aucune valeur) ou un état.
  6. Cochez Approbation si le changement nécessite une demande de modification approuvée. Pour verrouiller l'élément après le changement, ouvrez le menu ⋯ de la ligne (ou faites un clic droit sur la ligne) et choisissez Verrouiller l'élément après cette transition ; la ligne indique alors Verrouille l'élément.
  7. Répétez les étapes 4 à 6 pour chaque étape autorisée.

Pour choisir qui approuve une transition, voir Choisir les approbateurs d'une transition.

Les éditeurs de l'attribut ne proposent désormais que les états suivants autorisés, marqués ⇢ workflow.

Ajouter ou modifier les états d'un workflow

  1. Dans la page Workflow, trouvez la carte de la classe. La colonne Éléments compte les éléments dans chaque état ; un élément sans valeur est compté sous la valeur par défaut de l'attribut (un cas de test sans statut compte comme Not Run, comme l'affiche le Centre de test).
  2. Pour ajouter un état, tapez son nom dans Nouvel état et cliquez sur + Ajouter un état.

    L'état est ajouté à la classe et aux choix de l'attribut.

  3. Pour ordonner les états, cliquez sur ↑ ou ↓. Les sélecteurs et les colonnes des tableaux Kanban suivent cet ordre.
  4. Pour renommer un état personnalisé, cliquez sur Renommer… et saisissez le nouveau nom.

    Les éléments dans cet état, les transitions et la couleur de la valeur reçoivent le nouveau nom. Une seule annulation défait le tout.

  5. Pour retirer un état, cliquez sur Retirer… (personnalisé) ou Rendre obsolète… (intégré).
    • Un état qu'aucun élément ne porte est retiré.
    • Lorsque des éléments le portent, choisissez Déplacer et supprimer avec l'état vers lequel les déplacer, ou Conserver comme retiré. Un état retiré reste sur ses éléments, affiche (retiré) et n'est plus proposé. Ses transitions sortantes restent, afin que les éléments puissent le quitter. Restaurer le propose de nouveau.

Aucune modification sur cette page n'efface une valeur.

Choisir les approbateurs d'une transition

  1. Dans la page Workflow, cochez Approbation sur la transition.

    Un bouton apparaît à côté : Paramètres des demandes de modification ▾.

  2. Cliquez sur le bouton.

    Approbateurs de la transition s'ouvre.

  3. Dans Qui approuve, choisissez une option :
    • Comme défini dans Demandes de modification → Paramètres : les approbateurs du projet décident (par défaut).
    • Propriétaires ou Propriétaires et éditeurs.
    • Personnes désignées : cochez les membres du projet qui approuvent. Dans l'application de bureau, tapez leurs noms, séparés par des virgules, tels que chaque personne l'a saisi dans Préférences → Votre nom.
  4. Dans Approbations nécessaires, choisissez combien doivent approuver : de 1 à 5, ou Chaque personne désignée.
  5. Cliquez sur Enregistrer.

    Le bouton affiche la règle, par exemple Les 3 désignées ▾. Une seule annulation défait la modification.

Une demande qui contient plusieurs changements d'état doit satisfaire toutes les règles qui s'appliquent. Un seul rejet par une personne habilitée à approuver la rejette. Sur le service hébergé, les approbateurs désignés ne comptent que si c'est un propriétaire du projet qui a défini le workflow en dernier ; sinon, la transition nécessite le même nombre d'approbations de propriétaires.

Demander une approbation pour un changement d'état

  1. Dans l'inspecteur ou la Vue de l'élément, choisissez un état marqué (nécessite une approbation). Pour une exigence, vous pouvez aussi cliquer sur sa transition dans le bandeau de revue (elle se termine par …).

    Demander une approbation s'ouvre.

  2. Saisissez éventuellement un Motif, puis cliquez sur Soumettre la demande.

    Une demande de modification contenant le changement d'état est créée et soumise. La boîte de dialogue nomme ses approbateurs : ceux de la transition, ou ceux définis dans Demandes de modification → Paramètres. L'élément conserve son état.

    Tant que la demande est ouverte, le bandeau de revue de l'exigence l'affiche avec son décompte, par exemple CR-4 : 1 approbation sur 3.

  3. Les approbateurs l'approuvent.

    Avec la dernière approbation, l'élément passe au nouvel état, si cet approbateur peut modifier le projet. Sinon, un éditeur ouvre la demande et clique sur Appliquer les modifications. L'historique de l'élément affiche via CR-n, et l'enregistrement d'approbation d'une exigence nomme chaque approbateur et la demande.

Les changements directs vers un tel état sont refusés avec « … nécessite une approbation. Choisissez “X” sur l'élément pour la demander. » : Attributs… groupés, cellules de grille, déplacements sur les tableaux Kanban et modifications de l'IA. Choisir de nouveau l'état alors qu'une demande est ouverte ouvre cette demande.

Partager un schéma entre projets

  1. Dans le projet source, ouvrez Paramètres → Schéma dans le rail.
  2. Cliquez sur Exporter le schéma.

    Un fichier JSON est téléchargé.

  3. Dans le projet cible, ouvrez Paramètres → Schéma dans le rail.
  4. Cliquez sur Plus ▾ → Importer un schéma… et choisissez le fichier.
  5. Choisissez le Mode :
    • Fusionner (ajouter les classes, attributs, relations et étiquettes qui manquent à ce projet, associés par nom), ou
    • Remplacer le schéma de ce projet.
  6. Cliquez sur Importer.

Exemple détaillé : CubeSat EO-1

Cet exemple ajoute un niveau de maturité technologique (TRL) aux actifs, spécialise une classe et ajoute un workflow de revue. Créez la démo avec Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration, puis ouvrez Paramètres → Schéma dans le rail.

Examiner le modèle.

  1. Lisez la page Utilisation.

    Le tableau Classes liste les classes les plus utilisées en premier, avec leurs éléments, attributs et relations. Pas encore utilisé liste les classes, étiquettes et relations que la démo n'utilise pas.

Ajouter un TRL aux actifs.

  1. Cliquez sur Asset, puis sur + Attribut.
  2. Saisissez le nom TRL et choisissez le type Un parmi une liste.
  3. Tapez les choix 1 à 9 dans Valeurs autorisées, un par ligne.
  4. Saisissez la description Technology readiness level.
  5. Cliquez sur Ajouter un attribut.

    Le renseigner.

  6. Ouvrez Architecture → Assets.
  7. Sélectionnez 1.2.1 Reaction Wheel Assembly et définissez TRL sur 7 dans l'inspecteur.
  8. Définissez de la même façon 1.2.2 Star Tracker sur 6 et 1.1 Payload Camera sur 5.

    L'interroger.

  9. Dans le champ de recherche, tapez Asset:"TRL>=6" et appuyez sur Enter.

    La requête devient une puce de filtre dans la barre de requête. Le tableau liste les roues de réaction et le viseur d'étoiles. Les valeurs de choix qui sont des nombres se comparent comme des nombres.

Spécialiser une classe.

  1. De retour dans l'éditeur de schéma, ouvrez Asset et cliquez sur + Sous-classe.
  2. Nommez-la Payload Instrument et cliquez sur Créer la classe.
  3. Dans la base de données, cochez 1.1 Payload Camera et cliquez sur Changer de classe….
  4. Choisissez Payload Instrument comme Nouvelle classe.

    La boîte de dialogue indique « 1 élément deviendra Payload Instrument. » et ne liste rien à supprimer : la sous-classe hérite de tous les attributs et cibles d'Asset.

  5. Cliquez sur Changer de classe.

    La caméra conserve son TRL, ses liens performs et sa place dans la décomposition.

Ajouter un workflow de revue.

  1. Ouvrez Workflow et choisissez Requirement dans Ajouter une classe….
  2. Vérifiez qu'il surveille Status.
  3. Ajoutez ces transitions : Initial → Draft, Draft → In Review, In Review → Approved, In Review → Rejected, Rejected → Draft.
  4. Ouvrez 2.4 Target Slew. Son Status est Draft.

    Sa liste Status ne propose plus que Brouillon et In Review.

Annuler ou conserver.

  1. Appuyez sur ⌘Z / Ctrl+Z une fois par modification pour annuler l'expérience. Ou conservez les modifications et cliquez sur Exporter le schéma pour les réutiliser dans le prochain projet CubeSat.

Conseils et bonnes pratiques

  • Préférez les sous-classes et les étiquettes aux nouvelles classes de premier niveau. Une sous-classe conserve toutes les relations, tous les diagrammes et tous les contrôles LML de son parent. Une étiquette ne change absolument rien à la structure.
  • Masquez au lieu de supprimer. Masquer une classe, un attribut ou une étiquette préserve les données existantes et peut être annulé.
  • Configurez le schéma avant d'importer. La correspondance d'import propose les attributs existants. Les colonnes associées à Nouvel attribut sont créées automatiquement, avec un type deviné. Voir Import et export.
  • Conservez les ajouts intégrés. Masquez une extension intégrée dont vous n'avez pas besoin. Ne la renommez pas et ne la supprimez pas : une extension manquante est rajoutée, avec une valeur vide, à la prochaine ouverture du projet.
  • Documentez chaque élément personnalisé dans sa Description. Elle apparaît comme infobulle dans les éditeurs et dans les tableaux de schéma de l'Aide.
  • Les tests d'attribut « inférieur à » correspondent aussi aux entités sans valeur. Par exemple, Asset:"TRL<6" inclut les actifs sans TRL. Combinez un tel test avec un test positif, ou utilisez >= sur le complément.

Erreurs courantes

  • Changer le type d'un attribut efface ses valeurs. Holarch avertit « N entités ont une valeur “X”. Changer le type de A en B efface ces valeurs. » Si vous avez besoin des anciennes valeurs, exportez d'abord un rapport CSV. Une seule annulation défait à la fois le changement de type et l'effacement des valeurs ; dans les projets comptant plus de 5 000 valeurs de ce type, la carte de progression s'affiche pendant l'effacement.
  • Supprimer une relation supprime ses liens. La confirmation les compte. L'annulation les restaure.
  • Retirer une cible laisse des liens que le schéma n'autorise plus. Les liens existants restent ; les contrôles du modèle les listent sous la règle Global.9 (Relations que le schéma n'autorise pas). Retirez-les ou changez leur relation avant ou après avoir retiré la cible ; la confirmation les compte.
  • Une classe ne peut pas être supprimée tant qu'elle a des entités. Changez d'abord leur classe ou supprimez-les, ou masquez la classe.
  • Les transitions simples ne font que guider les éditeurs. Les Attributs… groupés, les imports et les modifications de l'IA peuvent toujours définir n'importe quel état qui ne nécessite pas d'approbation. Marquez une transition Approbation lorsqu'un changement ne doit pas contourner la revue.
  • Il n'est pas possible de renommer un état intégré. Les approbations, le contrôle de configuration et la vérification en dépendent. Ajoutez plutôt un nouvel état, ou rendez obsolète l'état intégré.

Liens avec les autres fonctions

  • La base de données, l'inspecteur et la Vue de l'élément affichent et modifient les attributs. Ils proposent les relations que le schéma autorise. Les requêtes font référence aux classes, attributs, étiquettes et relations par leur nom. Voir Modèle et base de données.
  • Diagrammes : les types de diagrammes qu'une entité peut avoir dépendent de sa classe et des classes situées au-dessus. Les sous-classes personnalisées en héritent.
  • Les fonctions des Exigences (qualité, approbations, TBD/TBR, liens à revoir) reposent sur des attributs intégrés tels que Status, TBD/TBR et les critères de qualité. Voir Exigences.
  • La Matrice de traçabilité et les Contrôles du modèle utilisent les cibles de relation pour déterminer ce qui est autorisé et ce qui manque. Voir Traçabilité.
  • L'import et l'export associent les attributs par nom et transportent le schéma dans les fichiers JSON de projet, .holarch et ReqIF. Voir Import et export.

L'éditeur de schéma

L'éditeur de schéma est l'endroit où vous effectuez toutes les modifications du schéma. Ouvrez-le depuis Paramètres → Schéma dans le rail de navigation (avec les outils en bas). L'adresse schema?class=<id> ouvre directement une classe (un ancien numéro de classe intégrée fonctionne toujours).

L'éditeur comporte un en-tête de page, une barre latérale et une zone principale. La zone principale affiche la page Utilisation, une classe, ou la page Relations, Étiquettes ou Workflow.

CommandeCe qu'il fait
Exporter le schémaTélécharge le schéma du projet au format JSON (<Project_name>_schema.json).
Plus ▾ → Importer un schéma…Importe un fichier JSON de schéma (ou un JSON de projet contenant un schéma) avec Fusionner ou Remplacer.
Ajouter les nouveaux éléments intégrés…Affiché lorsque le projet a son propre schéma. Liste les classes, relations, attributs et étiquettes que possède le schéma par défaut et qui manquent à cette copie (associés par nom), comme les ajouts de LML 2.0, ainsi que les valeurs et relations autorisées LML 2.0 des éléments existants (Decision Status Open et Closed ; Logical decomposed by Logical ; Connection transfers Input/Output), et les ajoute ; une seule annulation défait le tout. Les classes, attributs, choix et données existants restent inchangés ; les nouvelles valeurs se placent après les valeurs existantes.
Plus ▾ → Rétablir la valeur par défaut…Proposé lorsque le projet a son propre schéma. Le remplace par le schéma LML par défaut après confirmation.
  • Rechercher des classes, attributs, relations, étiquettes… filtre l'arbre des classes. La zone principale affiche les Classes, Attributs, Relations trouvées et Étiquettes trouvées correspondantes, ou « Aucune classe, aucun attribut, aucune relation ni étiquette ne correspond. Essayez un autre terme de recherche. »
  • Utilisation.
  • + Classe, + Étiquette, + Relation.
  • Classes : l'arbre des classes avec des pastilles de couleur, les marques « (abstraite) » et « (masqué) », et le nombre d'entités (sous-classes comprises).
  • Autres : Relations (avec le nombre), Étiquettes (avec le nombre) et Workflow.

Usage

Utilisation s'ouvre en premier. Sa ligne d'état indique « Le schéma LML par défaut. La première modification crée une copie pour ce projet. » ou « Ce projet utilise son propre schéma modifié. »

  • Classes : un tableau des classes non masquées, les plus utilisées en premier : Classe (cliquez pour l'ouvrir), Éléments (avec ses sous-classes), Attributs (les siens), Relations (autorisées, héritées comprises) et Dernière modification (la dernière fois que l'un de ses éléments a changé).
  • Pas encore utilisé : trois listes dépliables, les Classes, Étiquettes et Relations que rien n'utilise dans le projet, chacune avec un nombre. Masquer sur une ligne masque cette classe, cette étiquette ou cette paire de relations (une seule annulation défait le tout) ; les éléments masqués restent dans le schéma et sont réaffichés depuis leur page ou leur boîte de dialogue.

Page de classe

Cliquez sur une classe dans la barre latérale pour ouvrir sa page. De haut en bas :

  • Fil d'Ariane des classes parentes. Cliquez sur l'une d'elles pour l'ouvrir.
  • En-tête : icône et nom de la classe, puces Abstraite et Masqué, ✎ Modifier la classe, + Sous-classe et Supprimer. N éléments dans le projet › ouvre la base de données filtrée sur la classe.
  • Carte Description : la description, les puces Id N, Attributs N (avec « (k hérités) » lorsque certains viennent des parents), Relations N et Entités N, et les Sous-classes.
  • Carte Attributs : + Attribut et un tableau avec ces colonnes :
    • Les commandes d'ordre des attributs propres à la classe : faites glisser la ligne, ou utilisez ↑ / ↓ (une seule annulation défait chaque déplacement).
    • Nom, Type (le nom du type ; pointez dessus pour voir l'id stocké).
    • Détails : choix et valeur par défaut.
    • Défini sur : « cette classe » ou la classe ancêtre.
    • Description.
    • Actions, pour les attributs définis sur cette classe : ✎ (Modifier l'attribut), ⊘ / 👁 (Masquer l'attribut / Afficher l'attribut) et × (Retirer l'attribut).
  • Carte Relations : + Relation et un tableau avec les deux sens : Relation, Autres classes, Retour à cette classe (le nom inverse, et + sur <class> pour une autre classe à laquelle manque l'inverse) et Description. Dans Autres classes, × retire une relation définie sur cette classe. Les relations héritées affichent « (hérité de X) ».
  • Carte Étiquettes : les étiquettes disponibles sur la classe. * marque les étiquettes disponibles sur toutes les classes.

Boîte de dialogue Modifier la classe

Intitulée Créer une nouvelle classe ou Modifier la classe — X. Champs : Nom, Description, Parent ((aucun — niveau supérieur) ou une classe), Masqué, Abstraite et Couleur. Cliquez sur Créer la classe ou Enregistrer la classe.

Une classe intégrée qui a des entités ne peut pas changer de parent : « Des entités utilisent cette classe intégrée, son parent est donc fixe. »

Boîte de dialogue d'attribut

Intitulée Nouvel attribut ou Modifier l'attribut — X. Pour un attribut de relation, le titre ajoute « (relation “…”) ». Cliquez sur Ajouter un attribut ou Enregistrer.

  • Nom et Type (regroupés : Texte, Nombres, Date et heure, Choix, Liens, Spécial). Il n'y a pas de champ d'ordre : un nouvel attribut se place en dernier.
  • Valeurs autorisées (une par ligne) : pour Un parmi une liste et Plusieurs parmi une liste uniquement. Les lignes vides et les valeurs répétées sont supprimées. Une liste nécessite au moins deux valeurs : « Une énumération nécessite au moins deux choix. Ajoutez un autre choix. » (« Une sélection multiple … » pour Plusieurs parmi une liste). Un attribut qui n'a déjà qu'une seule valeur s'enregistre toujours tant que sa liste n'est pas modifiée. Pour Un parmi une liste, un carré de couleur par valeur suit la liste.
  • Valeur par défaut : pas pour FILE, COMPUTABLE, QUALITY, HTML et USER_TEAM.
  • Description.

Page Relations

Cliquez sur Relations dans la barre latérale pour voir toutes les paires de relations. La page comporte + Relation et un tableau avec ces colonnes :

  • Relation et Inverse.
  • Source → Cible : chaque paire de classes autorisée.
  • Attributs : ✎ par attribut, et + Attribut.
  • Utilisé : le nombre de liens.
  • Description.
  • ✎ (Modifier la relation) et × (Supprimer la relation).

La boîte de dialogue de relation est intitulée Nouvelle relation ou Modifier la relation — X. Elle comporte Nom, Nom inverse, Description, Description inverse, Masqué et Couleur (ou Couleur par défaut). Les diagrammes en araignée tracent la relation dans cette couleur ; un diagramme peut toujours choisir sa propre couleur par lien. La colonne Relation affiche la couleur sous forme de pastille. En modification, elle liste aussi les attributs de la relation, avec + Ajouter un attribut. Cliquez sur Créer la relation ou Enregistrer.

Page Étiquettes

Cliquez sur Étiquettes dans la barre latérale pour voir toutes les étiquettes. La page comporte Ajouter les étiquettes DoDAF et Ajouter les étiquettes UAF (les étiquettes de cadre qui manquent à ce projet ; elles sont aussi ajoutées au premier produit DoDAF ou à la première vue UAF), + Nouvelle étiquette et un tableau en ordre arborescent avec ces colonnes :

  • Étiquette.
  • S'applique à : puces de classe ou « Toutes les classes ».
  • Entités : le nombre.
  • Description.
  • Actions : ✎ (Modifier l'étiquette), ⊖ (Retirer cette étiquette de toutes les entités, affiché lorsqu'elle est utilisée) et × (Supprimer l'étiquette). Une seule annulation remet une étiquette sur toutes les entités dont elle a été retirée ; au-delà de 5 000 entités, la carte de progression s'affiche.

La boîte de dialogue d'étiquette est intitulée Créer une nouvelle étiquette ou Modifier l'étiquette — X. Elle comporte Nom, Description, Parent ((aucun) ou une étiquette), Classes (aucune sélectionnée : toutes les classes) et Masqué. Cliquez sur Créer l'étiquette ou Enregistrer l'étiquette.

Page Workflow

Cliquez sur Workflow dans la barre latérale. La page indique « Définissez les changements de valeur qu'autorise un attribut d'énumération (tel que Status). »

La page indique « Définissez les états d'une classe et les changements entre eux qui sont autorisés ou qui nécessitent une approbation. »

Ajouter une classe… liste les classes qui ont un attribut d'énumération et pas encore de workflow. Il surveille Status lorsque la classe en possède un. Chaque classe à workflow a une carte comportant :

  • La puce de la classe, surveille et l'attribut surveillé. Le changer demande une confirmation lorsque le workflow a des transitions.
  • Retirer : retire le workflow de la classe. Les valeurs des éléments restent.
  • États : un tableau avec État (marqué intégré ou (retiré)), Éléments (le nombre) et ↑, ↓, Renommer…, Retirer… ou Rendre obsolète…, ou Restaurer. Nouvel état et + Ajouter un état en dessous. Une sous-classe ayant un attribut hérité indique « États propres de X ; Y est hérité. »
  • Transitions : + Ajouter une transition ajoute « Nouvelle transition » de (Initial — aucune valeur) vers le premier état. Un tableau : Nom, De, Vers, Approbation et un menu ⋯ avec Verrouiller l'élément après cette transition et Supprimer la transition (également par un clic droit sur la ligne, ou ⇧F10 / Shift+F10 sur celle-ci). Nom, De et Vers se lisent comme du texte ; cliquez sur l'un d'eux (ou appuyez sur Enter ou F2) pour le modifier. Sans transitions, la carte indique « Aucune transition : chaque état peut suivre n'importe quel autre. »

Sur le service hébergé, seuls les propriétaires du projet modifient les workflows ; les autres voient la page en lecture seule avec « Seuls les propriétaires du projet modifient les workflows. »

Effet des modifications du schéma sur les données existantes

Consultez ce tableau avant de modifier un élément du schéma qui contient déjà des données.

ModificationEffet sur les entités et les liens
Renommer une classe, un attribut, une relation ou une étiquetteLes données sont conservées, car tout est stocké par id. Les requêtes enregistrées, le texte de recherche et les titres de colonnes qui utilisent l'ancien nom ne correspondent plus. Mettez-les à jour.
Changer le parent d'une classeDans les éditeurs, la classe reçoit les attributs et cibles du nouveau parent et perd ceux de l'ancien. Les valeurs stockées restent. Non autorisé pour une classe intégrée qui a des entités.
Marquer une classe comme abstraite ou masquéeLes entités existantes restent. La classe n'est plus proposée pour les nouvelles entités ni dans Changer de classe.
Supprimer une classeAutorisé seulement lorsque la classe n'a ni sous-classes ni entités. Ses propres attributs et cibles sont retirés. Les étiquettes la retirent de leur liste de classes.
Ajouter un attributLes entités existantes n'ont pas de valeur. Les nouvelles entités reçoivent la Valeur par défaut.
Changer le type d'un attributToutes les valeurs de cet attribut sont effacées, après confirmation.
Retirer un choixLes entités conservent l'ancienne valeur. L'éditeur ne la propose plus.
Masquer un attributLes valeurs sont conservées mais ne sont ni affichées, ni recherchées, ni exportées tant que l'attribut n'est pas réaffiché.
Retirer un attributSa valeur est effacée sur chaque entité et chaque lien, après confirmation.
Ajouter une cibleLa relation devient disponible entre ces classes (et leurs sous-classes).
Retirer une cibleLes liens existants restent, bien que le schéma ne les autorise plus. La règle Global.9 des contrôles du modèle les liste.
Supprimer une relationLa paire de relations, ses cibles et tous les liens qui l'utilisent sont supprimés.
Supprimer une étiquetteElle est retirée de toutes les entités. Ses étiquettes enfants remontent sous son parent.
Importer un schéma (Fusionner)Ajoute les classes, relations, cibles, attributs et étiquettes qui manquent par nom. Rien d'existant n'est modifié ni retiré.
Ajouter les nouveaux éléments intégrésAjoute les classes, relations, attributs et étiquettes du schéma par défaut qui manquent par nom, avec leurs id par défaut. Des cibles sont ajoutées pour les classes et relations ajoutées, ainsi que les cibles LML 2.0 entre classes existantes ; les valeurs LML 2.0 de Decision Status sont ajoutées à la fin. Rien d'existant n'est modifié ni retiré.
Importer un schéma (Remplacer) ou Rétablir la valeur par défautLe schéma est remplacé. Les données des entités restent, mais les valeurs des attributs qui n'existent plus ne sont pas affichées. Les extensions intégrées sont rajoutées à la prochaine ouverture du projet.

Chaque modification peut être défaite par une seule annulation, et ⌘Z / Ctrl+Z restaure le schéma ainsi que toutes les données qu'il a supprimées.

Extensions intégrées

Holarch ajoute ces éléments à chaque projet à son ouverture, car ses fonctions en ont besoin.

  • Ils sont associés par nom, sans tenir compte de la casse.
  • Ils ne sont ajoutés que s'ils manquent, et ne sont jamais renommés ni retirés.
  • Vos modifications de ces éléments sont conservées.
ClasseAttributs ajoutés
ExigencePriority et Criticality (High, Medium, Low), Owner, Source, TBD/TBR (None, TBD, TBR), TBD Owner, TBD Due Date, Verification Method (sélection multiple : Analysis, Demonstration, Inspection, Test), Verification Level (Component, Subsystem, System), Success Criteria
RiskOwner, Handling Strategy (Accept, Avoid, Transfer, Mitigate, Watch), Residual Probability, Residual Consequence, Need-by Date, Trigger, Closure Rationale ; Status reçoit les choix Mitigating et Watch
Test CaseTested By, Test Date, Configuration, Test Article, Test Evidence (fichier)
TâcheBoard Column (énumération), ajouté lorsqu'un tableau Kanban ayant ses propres noms de colonnes est créé ou converti. Ses valeurs sont les noms des colonnes.
Input/OutputData Rate, Data Rate Units, Protocol/Format, Message/Data Definition
ConduitConnector/Pins, Medium, Owner, Interface Status (Draft, Proposed, Agreed, Baselined), TBD/TBR (None, TBD, TBR)
PortConjugated
MesureWeight, Improvement Direction (N/A, Positive, Negative), Scoring Method (Direct 1-10, Direct 1-5, Linear, Thresholds), Score Thresholds, Current Estimate
DécisionStatus (Open, In Analysis, Decided, Deferred, Superseded), Decision Date, Decided By
CaractéristiqueUnits
AssetQuantity

Étiquettes ajoutées : Stakeholder Need et Interface Requirement (Requirement), Interface Block (Asset, sous Block), Trade Study et Whiteboard (Artifact), Criteria et TPM (Measure).

Cibles de relation ajoutées : Decision alternative Asset, Action, Artifact, Resource, Statement et Requirement, avec l'inverse alternative of.

Les pages de cadres (DoDAF et UAF) créent les étiquettes qu'utilisent leurs produits la première fois que vous ajoutez un tel produit.

Raccourcis clavier

ToucheOùAction
EnterChamp Valeurs autorisées de la boîte de dialogue d'attributCommencer le choix suivant (un par ligne)
⌘ / Ctrl/Ctrl+clicListe Classe(s) de la boîte de dialogue d'étiquetteSélectionner plusieurs classes
⌘ / Ctrl+Z / ⌘ / Ctrl+Shift+ZPartoutAnnuler / rétablir une modification du schéma

Options et paramètres

  • Le schéma du projet est stocké dans le projet et partagé avec chaque membre qui peut l'ouvrir.
  • Les membres ayant le rôle de lecteur ne peuvent pas le modifier (« Lecture seule : demandez un accès en modification à un propriétaire. »).
  • Les fichiers d'Exporter le schéma utilisent le format holarch-schema et contiennent les classes, relations, attributs, étiquettes et workflows.

Messages

MessageSignification et correction
« Saisissez un nom de classe. »Le nom de classe est vide.
« Ce nom de classe est trop long ; raccourcissez-le. »Les noms de classes et d'étiquettes sont limités à 100 caractères.
« Les noms de classes ne peuvent pas contenir : " ( ) < ou >. Les recherches donnent un sens à ces caractères. »Retirez ces caractères. Les autres lettres, chiffres, espaces et signes de ponctuation sont autorisés. Les noms de classes existants restent valides.
« Une autre classe utilise déjà ce nom. Choisissez-en un autre. »Les noms de classes sont uniques (sans tenir compte de la casse).
« “X” est un mot-clé de recherche (comme dans x:…). Choisissez un autre nom de classe. »Les clés de recherche (class, label, name, number, description, is, relationship, in, under, diagram, id, order) ainsi que AND, OR et NOT ne peuvent pas nommer une classe, car une recherche lirait la classe comme cette clé.
« Ce parent ferait de cette classe son propre ancêtre. »Choisissez un parent hors du sous-arbre de la classe.
« Cette classe a des sous-classes. Supprimez-les ou déplacez-les d'abord vers un autre parent. »Une classe ayant des sous-classes ne peut pas être supprimée.
« “X” (ou une sous-classe) a N entités. Changez d'abord leur classe ou supprimez-les, ou masquez la classe. »Une classe ayant des entités ne peut pas être supprimée.
« Saisissez un nom d'attribut. »Le nom d'attribut est vide.
« Le nom d'attribut contient des caractères non autorisés. »Utilisez des lettres, des chiffres, des espaces et _ - $ ( ) . , /.
« Name, Number et Description sont intégrés ; choisissez un autre nom d'attribut. »Ce sont des champs d'entité, pas des attributs.
« Un attribut portant ce nom existe déjà ici. »La classe, un parent ou une sous-classe le possède déjà.
« Ajoutez au moins un choix. »ENUMERATION et MULTISELECT nécessitent des choix.
« Saisissez un nom d'étiquette. » / « Le nom d'étiquette contient des caractères non autorisés. » / « Une autre étiquette utilise déjà ce nom. » / « Une étiquette ne peut pas se contenir elle-même. Choisissez un autre parent. »Contrôles de la boîte de dialogue d'étiquette. Les étiquettes peuvent aussi utiliser & et '.
« Saisissez un nom de relation et un nom inverse. » / « Le nom de la relation et le nom inverse doivent être différents. » / « Une relation nommée “X” existe déjà. »Contrôles de la boîte de dialogue de relation.
« Pas un fichier JSON. » / « Ce fichier n'est pas un schéma : il lui faut des classes, des relations, des attributs et des étiquettes. »Importer un schéma… nécessite un fichier JSON de schéma ou de projet.
« Schéma fusionné : N élément(s) ajouté(s) » / « Schéma remplacé »Import terminé.
« Aucune classe à workflow. Choisissez une classe avec Ajouter une classe… pour définir ses transitions de statut. »Aucun workflow n'est encore défini.

Avant une modification destructive, une confirmation en indique la conséquence :

ConfirmationTexte
Retirer l'attribut« N entités ont une valeur qui sera effacée. »
Changer le type et effacer les valeurs« N entités ont une valeur “X”. Changer le type de A en B efface ces valeurs. »
Supprimer la classe« Supprimer la classe “X” avec ses attributs et ses cibles ? »
Retirer la cible (× dans Autres classes)« N lien(s) existant(s) restent, bien que le schéma ne les autorise plus. »
Supprimer la relation« N lien(s) qui l'utilisent sont aussi supprimés. »
Supprimer l'étiquette« Elle est retirée de N entités. »
Retirer l'étiquette des éléments« Retirer “X” de N entités ? »
Réinitialiser le schéma« Les classes, attributs, relations et étiquettes personnalisés sont retirés du schéma (les données des entités restent ; l'annulation est possible). »

Limites

  • Noms de classes et d'étiquettes : 100 caractères.
  • Noms des attributs créés par les imports : 80 caractères.
  • Un seul attribut surveillé par classe.
  • Les transitions simples sont appliquées par les éditeurs d'attributs, les cellules de grille et le tableau Kanban. Les transitions avec approbation refusent aussi les changements directs et groupés. Les nouveaux éléments peuvent être créés dans n'importe quel état.
  • Verrouiller s'applique aux éléments LML. Les éléments SysML v2 ne sont pas verrouillés.
  • Noms d'états : 100 caractères.
  • Fusionner n'ajoute pas de nouveaux choix à un attribut qui existe déjà ; ajoutez-les dans la boîte de dialogue d'attribut.
  • Ajouter les nouveaux éléments intégrés… n'apparaît qu'après avoir rouvert la page, une fois le schéma devenu personnalisé.