Holarch

Contrôle et revues

Demandes de modification

Proposez des modifications d'éléments approuvés ou figés dans une référence sous forme de demande de modification, faites-les examiner et approuver, puis appliquez-les en une seule étape avec un historique complet.

Utilisation →

Sur cette page
  1. Mode d'emploi
    1. Créer une demande de modification
    2. Préparer les modifications
    3. Soumettre, examiner et approuver
    4. Appliquer les modifications
  2. Travailler dans une demande de modification
    1. L'activer
    2. Entrer et quitter
    3. Ce qui fonctionne autrement
    4. Examiner les modifications
    5. Appliquer une demande dans laquelle vous avez travaillé
  3. Impact
  4. Statut
  5. Maîtrise de la configuration
    1. Approbations et approbateurs
  6. Enregistrements d'approbation
  7. Commentaires, notifications et journal

Une demande de modification propose un ensemble de modifications du modèle, explique pourquoi, et attend une approbation avant que quoi que ce soit ne change. Utilisez les demandes de modification pour la gestion de configuration : une fois les exigences approuvées ou une référence définie, les modifications passent par une demande que les approbateurs du projet examinent. Les demandes de modification se trouvent sous Contrôle et revues → Demandes de modification.

Mode d'emploi

Créer une demande de modification

  1. Ouvrez Contrôle et revues → Demandes de modification et cliquez sur + Nouvelle demande de modification dans l'en-tête de la page, ou cliquez sur Proposer une modification… dans l'en-tête de la vue de l'élément d'un élément sous gestion de configuration (cela ouvre la demande de modification ouverte de l'élément s'il en existe une).
  2. Donnez-lui un Titre et une Raison : pourquoi la modification est nécessaire et ce qu'elle doit permettre.
  3. Cliquez sur Créer, puis ajoutez les Éléments concernés avec Ajouter un élément…. Holarch liste les éléments qui leur sont tracés (exigences, tests, interfaces et autres éléments liés) ; cliquez sur + sur ceux qui changent aussi.

Préparer les modifications

  1. Cliquez sur Ajouter une modification ▾ et choisissez ce que vous proposez : Modifier un élément… (numéro, nom, description dans l'éditeur de texte enrichi, afin que sa mise en forme soit conservée, ou un attribut), Nouvel élément…, Supprimer un élément…, Ajouter une relation…, Retirer une relation…, Ajouter un lien vers un autre projet… ou Retirer un lien vers un autre projet…. Dans un projet SysML v2, Modifier le texte SysML… propose une modification du texte d'un package.
  2. Cliquez sur Préparer la modification. Chaque modification préparée est listée sous Modifications proposées, avec un diff mot à mot pour les modifications de description et de texte et sa liste Impact (voir Impact). Rien ne change encore dans le modèle.
  3. Retirez une modification préparée avec Retirer.

Soumettre, examiner et approuver

  1. Cliquez sur Soumettre à revue. Sur le service hébergé, les approbateurs reçoivent une notification et une entrée sous Mon travail → À décider, où Approuver… et Rejeter… ouvrent la demande avec sa boîte de dialogue de vote.
  2. Un approbateur ouvre la demande, vérifie les modifications proposées et leurs listes Impact, puis clique sur Approuver… ou Rejeter… (un rejet nécessite une raison). Lorsqu'une exigence modifiée fait partie d'une référence, la boîte de dialogue Approuver… liste aussi les éléments de vérification et les documents à réexaminer.
  3. La carte de revue affiche Approbations : N sur M. Une demande dont les changements d'état ont leurs propres approbateurs liste aussi chaque règle avec son décompte, par exemple ○ Chaque approbateur nommé (3) : 1 sur 3. Lorsque la demande a les approbations nécessaires, son statut devient Approuvée. Un seul rejet la rejette ; l'auteur peut alors modifier les modifications et la soumettre de nouveau.

Retirer clôt une demande qui n'est pas encore appliquée sans modifier le modèle ; son enregistrement reste dans le journal.

Appliquer les modifications

  1. Un éditeur ou un propriétaire ouvre la demande approuvée et clique sur Appliquer les modifications, puis confirme avec Appliquer les modifications.
  2. Toutes les modifications préparées sont appliquées ensemble, et une seule annulation défait le tout. L'historique de chaque élément modifié enregistre la modification « via CR-12 ».
  3. Les modifications dont les éléments ont été supprimés entre-temps sont ignorées et listées avec le résultat. Une publication de configuration préparée (Ajouter une modification ▾ → Publier une configuration…) est enregistrée avec les approbateurs de la demande, ou listée avec la raison pour laquelle elle n'a pas été publiée ; voir Publier via une demande de modification.
  4. La demande conserve la liste Impact de chaque modification telle qu'elle était juste avant l'application des modifications, comme trace de ce qui a été pris en compte. Son Historique affiche « impact enregistré » avec les décomptes, par exemple « 4 concernés, 9 à vérifier ». L'application n'attend jamais la liste d'impact : si des éléments d'autres projets sont encore en cours de lecture après quelques secondes, la demande est appliquée immédiatement et conserve la liste telle que calculée à ce moment, marquée « Impact non terminé lors de l'application » sur la demande, dans son historique et dans les exports.

Travailler dans une demande de modification

Au lieu de préparer chaque modification dans une boîte de dialogue, vous pouvez travailler dans une demande de modification en brouillon : modifiez le modèle comme d'habitude sur n'importe quelle page, et vos modifications vont dans la demande au lieu du modèle en vigueur. Le modèle en vigueur ne change que lorsque la demande est approuvée et appliquée.

L'activer

Le travail dans les demandes de modification est désactivé pour chaque projet jusqu'à ce qu'un propriétaire du projet l'active : ouvrez Paramètres sur la page Demandes de modification et cochez Travailler dans des demandes de modification : modifier dans un brouillon et appliquer après approbation. La désactivation est refusée tant qu'un brouillon contient encore des modifications faites dans celui-ci ; appliquez ou retirez d'abord ces demandes. Sur le service hébergé, le travail dans les demandes de modification fait partie de l'offre Team du propriétaire du projet, comme les règles d'approbation (voir la note sous Gestion de configuration) : une adresse e-mail académique vérifiée ou l'appartenance à une organisation de classe active l'inclut aussi, et les projets qui utilisaient les règles d'approbation avant la version 2.29.0 le conservent. Sur les autres offres, le paramètre est affiché désactivé. L'application de bureau n'a pas d'offres.

Entrer et quitter

Commencez à travailler dans une demande en brouillon depuis l'un de ces points :

  • Y travailler maintenant dans la boîte de dialogue Nouvelle demande de modification (coché par défaut).
  • Travailler dans cette demande de modification sur la page d'une demande en brouillon.
  • Proposer une modification ▾ → Travailler dans une demande de modification… dans la vue de l'élément d'un élément. La liste affiche les brouillons qui nomment l'élément, plus Nouvelle demande de modification….
  • Travailler dans une demande de modification dans le message affiché lorsque vous modifiez un élément sous gestion de configuration.
  • ⌘K / Ctrl+K → Travailler dans une demande de modification….
  • Continuer sous Mon travail → Demandes de modification sur lesquelles je travaille.

Pendant que vous travaillez dans une demande :

  • Un bandeau sous la barre supérieure indique, par exemple, Travail dans CR-12 Range upgrade. Les modifications vont dans cette demande de modification, pas dans le modèle en vigueur. 3 modifications. avec Examiner les modifications et Quitter.
  • L'état d'enregistrement indique, par exemple, Enregistré à 14:02 dans CR-12.
  • Les éléments modifiés par la demande portent un repère DM dans les tableaux et sur les diagrammes.

Pour essayer, ouvrez le projet de démonstration CubeSat EO-1 : CR-1 Shorten the planning cycle est un brouillon contenant des modifications. Ouvrez-le sous Demandes de modification et cliquez sur Travailler dans cette demande de modification. Dans la démo Hybrid Car, CR-2 Clarify the charge time contient une modification de la documentation d'une exigence.

Cliquez sur Quitter dans le bandeau (ou ⌘K / Ctrl+K → Quitter la demande de modification) pour revenir au modèle en vigueur. Le mode appartient à l'onglet du navigateur : un autre onglet peut afficher le modèle en vigueur en même temps, et un rechargement garde l'onglet dans la demande.

Ce qui fonctionne autrement

  • Annuler s'arrête au point où vous êtes entré dans la demande.
  • Les modifications du schéma, les références, le partage, Demander une approbation et Restaurer une version précédente sont refusés tant que vous n'avez pas quitté la demande.
  • Les éléments sous gestion de configuration peuvent être modifiés dans la demande ; c'est sa raison d'être.
  • Soumettre à revue suspend les modifications jusqu'à ce que la demande soit tranchée ou retirée. Une demande rejetée redevient un brouillon lorsque vous la modifiez.
  • Retirer déplace les modifications de la demande dans la Corbeille en une seule entrée, par exemple Modifications de CR-12 ; Restaurer les remet dans la demande.

Examiner les modifications

Une demande contenant des modifications a deux onglets sur sa page : Détails (la demande, les modifications préparées, la revue, les commentaires et l'historique) et Modifications, qui compare le modèle avant la demande avec le modèle tel que la demande le rendrait. Examiner les modifications dans le bandeau l'ouvre.

  • Des vignettes de décompte affichent les éléments ajoutés, supprimés et modifiés et les modifications de relations ; en dessous, chaque modification a sa propre ligne, le texte modifié étant affiché mot par mot.
  • Les résultats qualité, les marques de liens suspects et les autres enregistrements de revue sont masqués ; cliquez sur Afficher les données de revue pour les lister aussi.
  • Documents liste chaque document qui contient un élément modifié. Comparer les versions… affiche le document avant la demande et avec elle, chaque champ côte à côte avec les mots modifiés marqués ; une phrase déplacée au sein d'un champ est affichée en violet aux deux endroits, avec un lien entre eux.
  • Diagrammes liste chaque diagramme modifié avec ce qui a changé, par exemple Diagramme d'Asset 0 Drone Delivery System : 1 forme ajoutée (Charger), 1 déplacée. Afficher avant et après dessine les deux versions côte à côte.

Aperçu dans le modèle sur la page de la demande ouvre le modèle tel qu'il serait après l'application de la demande, en lecture seule. Le bandeau indique, par exemple, Aperçu de CR-12 (lecture seule). Chaque page affiche la modification en place, ce qui vous permet de vérifier une spécification générée, la RVTM ou une matrice. Les modifications sont refusées jusqu'à ce que vous cliquiez sur Quitter. Les relecteurs et les lecteurs peuvent aussi afficher l'aperçu.

Les votes couvrent les modifications faites dans la demande ainsi que ses modifications préparées : une modification faite après un vote annule ce vote, et les approbateurs décident de nouveau.

Appliquer une demande dans laquelle vous avez travaillé

Appliquer les modifications sur une demande approuvée compare d'abord ses modifications avec le modèle en vigueur tel qu'il est maintenant, car d'autres ont pu modifier les mêmes éléments entre-temps.

  • Aucun conflit : la confirmation indique, par exemple, Appliquer 14 modifications au modèle en vigueur ? Une seule annulation défait le tout. Après Appliquer les modifications, la notification indique CR-12 appliquée : 14 modifications. Les nouveaux éléments conservent leurs id, et l'historique de chaque élément modifié indique « via CR-12 » et nomme les auteurs de la demande.
  • Les modifications de champs différents d'un même élément fusionnent sans demander : si la demande a renommé un élément et que quelqu'un d'autre a modifié son numéro dans le modèle en vigueur, les deux modifications sont conservées.
  • Conflits : le même champ modifié des deux côtés, un élément supprimé d'un côté et modifié de l'autre, ou un lien de la demande vers un élément supprimé dans le modèle en vigueur. La page de la demande les compte, par exemple CR-12 a 2 conflits avec le modèle en vigueur., et Appliquer les modifications ouvre d'abord Résoudre les conflits — CR-12.

Dans Résoudre les conflits, chaque élément en conflit a une carte avec la version Modèle en vigueur (sur le service hébergé, avec l'auteur de la modification) et la version Demande de modification ; Afficher l'original ajoute la version d'avant les deux modifications. Les diagrammes sont dessinés côte à côte. Choisissez l'une des options suivantes :

  • Garder dynamique : l'élément reste tel que le modèle en vigueur l'a. Pour un lien vers un élément supprimé, le lien est laissé de côté.
  • Utiliser la demande de modification : la valeur de la demande pour chaque champ qu'elle a modifié ; les champs que seul le modèle en vigueur a modifiés gardent leur valeur en vigueur. Pour une suppression, le résultat de la demande : l'élément est supprimé, ou restauré avec les modifications de la demande. Pour un lien vers un élément supprimé, l'élément est restauré depuis la corbeille avec le lien.
  • Combiner : une ligne par champ modifié avec En direct et Demande de modification. Les champs modifiés d'un seul côté commencent de ce côté ; les champs modifiés des deux côtés commencent sur Demande de modification.

Appliquer les modifications reste désactivé tant que chaque conflit n'a pas de choix (« Choisissez une version pour chacun des 3 conflits. »). Seul un approbateur de la demande autorisé à modifier résout les conflits ; les autres voient, par exemple, CR-12 a 3 conflits avec le modèle en vigueur. Un approbateur les résout lors de l'application. L'Historique de la demande enregistre chaque choix (« Version en vigueur de R.4.2 conservée », « Modification en vigueur d'Ann sur R.4.3 remplacée »), et sur le service hébergé, la personne dont la modification en vigueur a été remplacée reçoit une notification.

Une seule action Annuler défait toute l'application : elle restaure le modèle en vigueur et remet la demande à l'état Approuvée avec ses modifications, prête à être appliquée de nouveau. Après l'application, l'onglet Modifications de la demande conserve la liste de ce qui a été appliqué. Une demande modifiée après son approbation ne peut pas être appliquée tant qu'elle n'a pas été soumise et approuvée de nouveau. Toute personne qui travaille dans la demande ou en affiche l'aperçu au moment de son application revient au modèle en vigueur. Dans un projet SysML v2, la confirmation liste les erreurs que la demande ajouterait au modèle, et Appliquer les modifications reste désactivé jusqu'à ce que vous choisissiez une autre version ou que la demande soit rejetée.

Impact

Chaque modification préparée a une liste Impact : les éléments qui lui sont tracés, trouvés avant que quiconque approuve ou applique la modification. Son en-tête affiche les décomptes, par exemple Impact 3 concernés · 7 à vérifier. Cliquez sur l'en-tête pour afficher ou masquer la liste. Une demande de plus de trois modifications commence avec les listes fermées.

La liste est regroupée en Exigences, Tests et vérification, Interfaces, Documents, Diagrammes, Éléments d'autres projets et Autres éléments. Chaque ligne est marquée :

MarqueSignification
ConcernéLa modification le touche : un élément à une relation de l'élément modifié, un document ou un diagramme qui affiche l'élément modifié, les deux extrémités d'une relation ajoutée ou retirée, et les éléments d'autres projets liés à l'élément modifié.
ContrôlerUne étape plus loin : les éléments tracés à un élément concerné, les documents et diagrammes qui les affichent, et les éléments d'autres projets à deux liens de distance.

Chaque ligne nomme sa classe et la façon dont elle est atteinte, par exemple « verified by 1.1 Pump pressure ». Un lien vers un autre projet dont l'élément a changé depuis le dernier examen du lien affiche Modifié. Cliquez sur une ligne pour ouvrir l'élément, le document ou le diagramme. Les éléments d'autres projets proviennent de la Traçabilité de l'élément, avec vos propres accès : les liens vers des projets que vous ne pouvez pas ouvrir sont seulement comptés.

Une liste affiche au plus 300 lignes et indique combien il en reste. Les liens vers d'autres projets sont lus pour les 12 premiers éléments modifiés.

Sous l'en-tête, une note indique sur quoi repose la liste : « L'impact est fondé sur les relations modélisées ; les dépendances non liées ou plus éloignées peuvent ne pas apparaître. Calculé sur la révision 1 204 à 14:02. » La révision est celle du projet au moment du calcul de la liste (sur le service hébergé, le même numéro pour chaque éditeur). Si le modèle change pendant votre lecture, la liste reste telle que calculée ; rouvrez la demande pour la recalculer. Une liste enregistrée conserve la révision sur laquelle elle a été calculée.

Lorsque la demande est appliquée, les listes sont enregistrées avec elle et affichées telles qu'elles étaient, de sorte que l'enregistrement indique toujours ce qui a été pris en compte après que des éléments ont été renommés ou supprimés. Exporter ▾ → Word (.docx) les inclut, et le journal Excel a une colonne Impact avec les décomptes.

La même liste apparaît à d'autres endroits où une modification attend une décision :

  • Aperçus IA et propositions des clients IA : voir IA.
  • Nouvelle publication… d'une bibliothèque : les projets et éléments qui utilisent les éléments de bibliothèque modifiés depuis la dernière publication ; voir Bibliothèques.
  • Approbation d'une exigence incluse dans une référence : les éléments de vérification et les documents qui devraient être réexaminés ; voir Exigences.

Statut

StatutSignification
BrouillonEn cours de rédaction ; l'auteur prépare les modifications.
SoumiseEn attente des approbateurs.
En cours de revueAu moins un approbateur a voté.
ApprouvéeApprobations suffisantes ; prête à être appliquée.
RejetéeUn approbateur l'a rejetée ; l'auteur peut la réviser et la soumettre de nouveau.
RetiréeClôturée sans modifier le modèle.
Mise en œuvreLes modifications ont été appliquées.

Maîtrise de la configuration

Note : sur le service hébergé, l'offre du propriétaire du projet est déterminante. La gestion de configuration (le premier paramètre) fait partie des offres Individual et Team ; les règles d'approbation ci-dessous (approbations requises, qui approuve, un comité de modification, auto-approbation) font partie de l'offre Team. Une adresse e-mail académique vérifiée ou l'appartenance à une organisation de classe active conserve les deux. Les projets et organisations qui les utilisaient avant la version 2.29.0 les conservent. Sans les règles d'approbation, les demandes de modification fonctionnent avec une seule règle : l'approbation d'un propriétaire du projet décide, et l'auteur peut approuver sa propre demande, ce qui vous permet d'approuver et d'appliquer vos propres modifications lorsque vous travaillez seul. Les paramètres enregistrés auparavant sont conservés mais pas appliqués, et Paramètres l'indique ; les éléments approuvés et inclus dans une référence peuvent alors être modifiés directement. Les enregistrements d'approbation, les votes et les statuts sont conservés. L'application de bureau n'a pas d'offres.

Paramètres dans l'en-tête de la page Demandes de modification ouvre Paramètres des demandes de modification. Les paramètres y sont regroupés sous Gestion de configuration (ce qui nécessite une demande de modification, et si les éditeurs travaillent dans des brouillons) et Approbation (nombre d'approbations, qui approuve, auto-approbation) ; chaque paramètre s'applique dès que vous le modifiez, et Terminé ferme la boîte de dialogue. La ligne au-dessus de la liste indique ce que font actuellement les paramètres, par exemple « Les éléments approuvés et inclus dans une référence peuvent être modifiés directement ; 1 approbation par les propriétaires du projet. », avec un lien Modifier dans Paramètres.

Dans Paramètres, un propriétaire du projet peut activer Les modifications d'éléments approuvés et inclus dans une référence nécessitent une demande de modification. Ensuite :

  • Les exigences approuvées (Status Approved) et les éléments de la dernière référence du projet ne peuvent plus être modifiés, supprimés ni liés directement. Holarch explique pourquoi et renvoie aux demandes de modification.
  • Leur S'applique à, leur Applicabilité et leur appartenance aux configurations (lignes de produits) en font aussi partie : changer les configurations ou les unités auxquelles un élément s'applique nécessite une demande de modification.
  • Les commentaires, les revues, les approbations d'exigences, les résultats qualité et les marques d'examen des liens restent ouverts.
  • Les demandes de modification approuvées appliquent leurs modifications à ces éléments.
  • L'API REST et MCP suivent la même règle : une modification directe de ces éléments par un script est refusée (409 change-control), et la proposition d'un client IA ne peut pas les inclure. Proposez plutôt la modification dans une demande de modification.
  • Sur le service hébergé, le serveur contrôle chaque modification qui lui parvient, y compris les modifications faites hors ligne. Une modification d'un élément approuvé ou inclus dans une référence faite avant que l'élément ne passe sous gestion (hors ligne, ou pendant que quelqu'un d'autre l'approuvait) n'est pas enregistrée : Holarch indique de quel élément il s'agissait, recharge le projet et conserve vos autres modifications. Proposez plutôt cette modification dans une demande de modification.

Note : sur le service hébergé, la gestion de configuration est imposée par le serveur pour tous les modes de modification (l'application, l'API REST et MCP) ; un éditeur ne peut pas la contourner avec un autre client. Seule l'application d'une demande de modification approuvée modifie ces éléments. Dans l'application de bureau et dans les projets du navigateur, c'est l'application qui l'impose, comme pour les verrous d'éléments.

Approbations et approbateurs

  • Approbations requises : 1, 2 ou 3.
  • Qui approuve : Propriétaires du projet, Propriétaires et éditeurs, ou Un comité de modification composé de membres nommés du projet (service hébergé ; sur l'application de bureau, vous approuvez vos propres demandes). Un comité de modification peut nommer des relecteurs : ils approuvent la demande, la rejettent et la commentent sans pouvoir modifier le modèle. Tout membre du projet qui peut commenter (relecteur ou plus) peut commenter une demande de modification.
  • Les auteurs peuvent approuver leurs propres demandes de modification : désactivé par défaut.

Seuls les propriétaires du projet modifient ces paramètres.

Les mêmes paramètres s'appliquent aux demandes créées par un workflow : un changement d'état marqué Approbation dans Schéma → Workflow ouvre Demander une approbation, qui crée et soumet une demande de modification contenant ce seul changement.

Une transition de workflow peut à la place nommer ses propres approbateurs, par exemple chaque membre d'un comité de revue, ou 2 ingénieurs nommés sur 4 (Choisir les approbateurs d'une transition). Une demande a alors besoin des approbations de chaque règle dont relèvent ses changements d'état ; les changements qu'aucune transition ne couvre utilisent ces paramètres. Dans l'application de bureau, les approbateurs sont des noms : vous approuvez sous le nom indiqué dans Préférences → Votre nom. Une demande qui ne contient que des changements d'état est appliquée avec sa dernière approbation lorsque cet approbateur est autorisé à modifier.

Sur le service hébergé, Holarch n'utilise que les paramètres enregistrés par un propriétaire du projet ; les paramètres modifiés par quelqu'un d'autre sont ignorés et les valeurs par défaut s'appliquent (les propriétaires approuvent, une approbation, pas leurs propres demandes).

Lorsque Holarch n'a aucune trace de la personne qui a soumis une demande de modification, par exemple dans un projet téléversé ou importé avec ses demandes, seul un propriétaire du projet peut l'approuver. Les paramètres sans trace de la personne qui les a enregistrés s'appliquent avec les propriétaires comme approbateurs et sans auto-approbation jusqu'à ce qu'un propriétaire les enregistre de nouveau.

Enregistrements d'approbation

Sur le service hébergé, approuver ou rejeter demande votre mot de passe (une fois toutes les 10 minutes) et enregistre qui a décidé, quand, la note et les modifications préparées exactes auxquelles le vote s'applique. Si les modifications préparées sont modifiées après un vote, ce vote ne compte plus et les approbateurs sont de nouveau sollicités. Avant l'application des modifications, le serveur vérifie que la demande est approuvée avec ses modifications actuelles. Chaque vote est aussi inscrit dans le journal d'audit (demande, décision et longueur de la note ; pas la note elle-même).

Note : un enregistrement d'approbation indique qui a approuvé quoi et quand. Ce n'est pas une signature électronique réglementée par la loi (comme celle prévue par le 21 CFR Part 11).

Commentaires, notifications et journal

  • Les Commentaires sur une demande de modification fonctionnent comme les commentaires sur les éléments.
  • Sur le service hébergé, des notifications sont envoyées aux approbateurs lorsqu'une demande est soumise, à l'auteur lorsqu'elle est approuvée ou rejetée, et à l'auteur et aux votants lorsqu'elle est appliquée ou retirée.
  • Chaque demande conserve un Historique de ce qui s'est passé, par qui et quand.
  • Exporter ▾ sur la page Demandes de modification (affiché dès qu'il existe une demande de modification) enregistre le journal des demandes de modification en Excel (.xlsx) ou Word (.docx), avec les modifications et l'historique de chaque demande.