Exigences
Liens vers d'autres projets
Tracez un élément vers une exigence, une fonction ou un test d'un autre projet ; chaque personne ne voit l'élément lié que si elle peut ouvrir son projet.
Sur cette page
Vue d'ensemble
Un lien vers un autre projet est une relation de trace d'un élément de ce projet vers un élément d'un autre projet, comme une exigence de sous-système traced from une exigence de la spécification système, ou une procédure de test qui verifies une exigence gérée par une autre équipe.
Le lien fait partie de ce projet. Il ne stocke que les identifiants des deux éléments et la relation. Le numéro, le nom, la classe et le statut de l'élément lié sont lus dans son propre projet à chaque consultation, avec vos propres droits d'accès :
- Lorsque vous pouvez ouvrir l'autre projet, vous voyez l'élément et pouvez cliquer pour y accéder.
- Lorsque vous ne le pouvez pas, vous voyez Élément d'un projet que vous ne pouvez pas ouvrir. Le nom ne vous parvient jamais, ni dans l'application, ni dans les exports, ni par l'API, ni par les outils d'IA.
Les liens vers d'autres projets font partie de l'offre Team. C'est l'offre du propriétaire du projet qui décide. Avec les autres offres, les liens existants restent visibles et peuvent être retirés, mais aucun nouveau lien ne peut être ajouté. Les liens entre les projets de démonstration Hybrid Car et Hybrid Car Battery Pack fonctionnent avec toutes les offres.
Concepts
Ce que contient un lien
| Partie | Signification |
|---|---|
| Source | Un élément de ce projet |
| Relation | Une relation du schéma de ce projet, comme traced from, satisfies ou verified by |
| Objectif | L'identifiant d'un projet et l'identifiant d'un élément de celui-ci |
La relation est contrôlée par rapport à la classe de la source. La classe de la cible n'est pas contrôlée lors de la création du lien, car le lien ne lit jamais le contenu de l'autre projet. Lorsque la classe de la cible ne convient pas à la relation, la section Trace affiche ⚠ avec « Cette relation ne pointe généralement pas vers … ».
Qui voit quoi
Chaque personne voit chaque élément lié avec le rôle qu'elle a dans son projet :
| Votre accès à l'autre projet | Ce que vous voyez |
|---|---|
| N'importe quel rôle (propriétaire, éditeur, réviseur, lecteur) | Numéro, nom, projet et un lien qui ouvre l'élément |
| Aucun, ou le projet n'existe plus | Élément d'un projet que vous ne pouvez pas ouvrir |
Un projet qui n'existe pas et un projet que vous ne pouvez pas ouvrir s'affichent de la même façon : un lien ne révèle donc jamais qu'un projet existe.
États des liens
| Affiché | Signification | Que faire |
|---|---|---|
| Numéro et nom | L'élément existe et vous pouvez ouvrir son projet | Rien |
| Supprimé dans <project> | L'élément est dans la corbeille de son projet | Demandez à une personne qui peut modifier ce projet de le restaurer, ou retirez le lien |
| Supprimé | L'élément n'existe plus | Retirez le lien (Retirer les liens rompus) |
| Élément d'un projet que vous ne pouvez pas ouvrir | Vous n'avez pas accès au projet, ou il n'existe plus | Demandez l'accès au propriétaire du projet si vous en avez besoin |
| Chargement… | L'élément est en cours de lecture | Patientez un instant |
Les noms sont lus lorsqu'une page affiche le lien, de nouveau lorsque vous revenez sur l'onglet au bout d'une minute, et toutes les cinq minutes. Un élément renommé affiche son nouveau nom sans aucune modification de ce projet.
Cibles modifiées
Une ligne affiche Modifié lorsque l'élément lié a été modifié dans son projet après la création du lien ou sa dernière revue. Pointez dessus pour voir la date. Vérifiez que le lien est toujours valable, puis :
- Cliquez sur ✓ sur la ligne pour marquer ce lien comme revu.
- Cliquez sur ⋯ à côté de Autres projets, puis sur Tout marquer comme revu (n), pour tous les liens signalés de l'élément.
- Ou ouvrez Besoins et exigences → Liens à revoir : la carte Modifiés dans d'autres projets liste tous les liens signalés du projet, avec ✓ sur chaque ligne et Tout marquer comme revu.
Marquer comme revu apparaît dans l'historique de l'élément et dans Activité, et une seule annulation le défait. Les réviseurs et les lecteurs voient les signalements mais ne peuvent pas les effacer. Les liens vers des publications de bibliothèque ne sont pas signalés (une publication ne change pas).
Mode d'emploi
Quand et pourquoi
Utilisez des liens vers d'autres projets lorsqu'un modèle unique serait trop grand ou appartient à des équipes différentes : une spécification système et ses spécifications de sous-systèmes, les exigences communes d'une ligne de produits et chaque produit, ou les exigences d'un client et votre conception. Gardez les liens dans le projet de niveau inférieur, pointant vers le haut : chaque sous-système trace ses exigences from (depuis) les exigences système.
Utilisez des relations ordinaires à l'intérieur d'un même projet. Lier un existant… dans la section Trace relie des éléments du même projet ; un lien vers un autre projet est destiné aux éléments qui se trouvent ailleurs.
Ajouter un lien
- Sélectionnez l'élément, par exemple une exigence de sous-système.
- Dans l'inspecteur, ouvrez la section Trace. Sous Autres projets, cliquez sur + (Ajouter un lien vers un autre projet…).
- Choisissez la Relation, par exemple traced from.
- Choisissez le Projet. Ses éléments sont listés par numéro.
- Pour une bibliothèque, choisissez la Version : Actuelle (copie de travail) ou une publication comme Release 1.1. Un lien vers une publication affiche son libellé au lieu de actuel, et son nom n'ouvre pas de page.
- Saisissez du texte dans Rechercher pour trouver un élément par numéro ou par nom. Choisissez une Classe pour ne lister que cette classe.
- Cliquez sur l'élément, puis sur Ajouter un lien. Le message indique « Lien ajouté. » et l'élément apparaît sous Autres projets.
Une seule annulation retire le lien. Ajouter à nouveau le même lien conserve le lien existant.
Ouvrir l'élément lié
Cliquez sur le nom de l'élément lié. Son projet s'ouvre sur cet élément.
Retirer des liens
- Cliquez sur × sur la ligne du lien pour retirer un lien.
- Lorsque des liens pointent vers des éléments supprimés, cliquez sur ⋯ à côté de Autres projets, puis sur Retirer les liens rompus (n).
Retirer un lien ne modifie que ce projet. L'autre projet n'est jamais modifié par un lien.
Exemple complet : un sous-système charge utile et la démo CubeSat EO-1
- Créez un projet nommé EO-1 Payload avec une exigence PL.1 Detector pixel pitch shall be at most 5.5 µm.
- Sélectionnez PL.1, ouvrez Trace → Autres projets → +.
- Choisissez traced from, le projet CubeSat EO-1, recherchez ground sample et cliquez sur 1.2 Ground Sample Distance. Cliquez sur Ajouter un lien.
- La ligne indique traced from 1.2 Ground Sample Distance CubeSat EO-1 · actuel. Un collègue qui ne peut ouvrir que EO-1 Payload voit Élément d'un projet que vous ne pouvez pas ouvrir sur la même ligne.
Conseils et bonnes pratiques
- Liez du niveau inférieur vers le niveau supérieur, afin que le projet système n'ait pas à changer lorsqu'un sous-système est ajouté.
- Partagez le projet de niveau supérieur en tant que lecteur avec les personnes qui travaillent sur celui de niveau inférieur, afin qu'elles voient les noms.
- Lancez Retirer les liens rompus après la réorganisation d'un projet de niveau supérieur.
Erreurs courantes
| Problème | Cause | Correction |
|---|---|---|
| « Cet élément se trouve dans ce projet. Utilisez plutôt Lier un existant… » | La cible est dans le même projet | Utilisez Lier un existant… dans le groupe de la relation |
| Pas de + sous Autres projets | Vous ne pouvez que consulter le projet, ou l'élément est verrouillé | Demandez le rôle d'éditeur, ou déverrouillez l'élément |
| « Les liens vers des éléments d'autres projets font partie de l'offre Team. » | Le propriétaire du projet n'a pas l'offre Team | Changez d'offre dans Paramètres du compte → Offre et facturation |
| Le sélecteur indique « Ce projet ne peut pas être lu. Choisissez un autre projet. » | Vous avez perdu l'accès à ce projet | Demandez l'accès à son propriétaire |
Liens avec les autres fonctions
- Matrice de traçabilité : les liens des lignes selon les relations choisies sont listés sous la grille, dans Autres projets ; Exporter… les ajoute (voir Traçabilité).
- Diagramme en araignée : les éléments liés apparaissent comme des cadres en pointillés autour de leur élément ; masquez-les avec Options → Autres projets.
- Carte de programme : Gérer les projets → Carte de programme montre comment tous vos projets sont liés, et Autres projets ⋯ → Afficher dans la carte de programme trace cet élément à travers d'autres projets (voir Carte de programme).
- Couverture du programme : le projet vers lequel vous établissez le lien liste ces liens dans Vérification → Couverture du programme, par élément et par projet (voir Couverture du programme).
- Historique et activité : l'ajout et le retrait d'un lien sont enregistrés sur l'élément.
- Corbeille : supprimer un élément déplace ses liens dans la corbeille avec lui ; restaurer l'élément les restaure.
- Demandes de modification : Ajouter une modification ▾ → Ajouter un lien vers un autre projet… et Retirer un lien vers un autre projet… préparent des liens ; ils sont ajoutés ou retirés lorsque la demande est appliquée.
- Bibliothèques : liez un élément d'une publication de bibliothèque avec le choix Version (voir Bibliothèques).
Exports et rapports
Les exports nomment les éléments liés avec les droits d'accès de la personne qui exporte. Tout ce que cette personne ne peut pas lire est écrit « Élément d'un autre projet ».
| Export | Ce que deviennent les liens vers d'autres projets |
|---|---|
| JSON du projet (export de la base de données) | Conservés tels qu'ils sont stockés : identifiants uniquement. L'import du fichier les conserve |
| ReqIF (base de données et documents) | Un attribut External links sur chaque élément lié : relation, identifiant du projet et identifiant de l'élément, plus le numéro et le nom lorsque vous pouvez les lire |
| XMI | Omis ; le rapport d'export les compte comme « Lien vers un autre projet » |
| Matrice de traçabilité (Excel) | Une feuille Autres projets séparée |
| Matrice de traçabilité (CSV) | Une colonne Autres projets |
| Rapport de matrice de traçabilité des exigences (RTM) | Une colonne Other Projects |
API et MCP
L'API et MCP renvoient les liens sous forme d'identifiants. Pour lire les noms, appelez l'opération de résolution ; elle utilise les droits d'accès et la liste de projets du jeton lui-même. La carte de programme et la traçabilité de l'élément sont disponibles via GET /api/v1/program-map, GET /api/v1/projects/<project>/items/<item>/trace et les outils MCP program_map et trace_chain. Voir API et MCP.
Les fonctions d'IA de l'application ne reçoivent les liens que sous forme d'identifiants.
Messages
| Message | Signification |
|---|---|
| Lien ajouté. | Le lien a été enregistré |
| Cet élément se trouve dans ce projet. Utilisez plutôt Lier un existant… | L'élément choisi est dans le même projet |
| Choisissez un élément, puis ajoutez le lien. | Ajouter un lien a été cliqué sans choisir d'élément |
| Aucun autre projet à lier. Créez ou ouvrez d'abord un autre projet. | Vous n'avez que ce projet |
| Les liens vers des éléments d'autres projets font partie de l'offre Team. | Le propriétaire du projet n'a pas l'offre Team |
| Un projet contient au plus 20 000 liens vers d'autres projets. Retirez-en d'abord quelques-uns. | Le projet a atteint la limite |
Limites
| Limite | Valeur |
|---|---|
| Liens par projet | 20,000 |
| Éléments lus par requête | 500 |
| Éléments listés dans le sélecteur | 100 par recherche (affinez la recherche pour voir les autres) |
Un lien pointe vers la version actuelle de l'autre projet, ou vers la copie d'un élément dans une publication de bibliothèque (voir Bibliothèques).