Requisiti
Collegamenti ad altri progetti
Tracciare un elemento verso un requisito, una funzione o un test in un altro progetto; ogni persona vede l'elemento collegato solo se può aprirne il progetto.
Panoramica
Un collegamento a un altro progetto è una relazione di tracciabilità da un elemento di questo progetto a un elemento di un progetto diverso, come un requisito di sottosistema traced from un requisito della specifica di sistema, o una procedura di test che verifies un requisito gestito da un altro team.
Il collegamento fa parte di questo progetto. Memorizza solo gli id dei due elementi e la relazione. Numero, nome, classe e stato dell'elemento collegato vengono letti dal suo progetto ogni volta che lo si guarda, con il proprio accesso:
- Quando si può aprire l'altro progetto, si vede l'elemento e si può raggiungerlo con un clic.
- Quando non si può, compare Elemento in un progetto non accessibile. Il nome non arriva mai all'utente, né nell'app, né nelle esportazioni, né tramite l'API o gli strumenti di IA.
I collegamenti ad altri progetti fanno parte del piano Team. Decide il piano del proprietario del progetto. Con gli altri piani i collegamenti esistenti restano visibili e possono essere rimossi, ma non se ne possono aggiungere di nuovi. I collegamenti tra i progetti demo Hybrid Car e Hybrid Car Battery Pack funzionano con ogni piano.
Concetti
Che cosa contiene un collegamento
| Parte | Significato |
|---|---|
| Origine | Un elemento di questo progetto |
| Relazione | Una relazione dello schema di questo progetto, come traced from, satisfies o verified by |
| Obiettivo | L'id di un progetto e l'id di un elemento al suo interno |
La relazione viene controllata rispetto alla classe dell'origine. La classe della destinazione non viene controllata quando si crea il collegamento, perché il collegamento non legge mai il contenuto dell'altro progetto. Quando la classe della destinazione non si adatta alla relazione, la sezione Tracciabilità mostra ⚠ con “Questa relazione di solito non punta a …”.
Chi vede cosa
Ogni persona vede ogni elemento collegato con il ruolo che ha nel suo progetto:
| Il proprio accesso all'altro progetto | Cosa si vede |
|---|---|
| Qualsiasi ruolo (Owner, Editor, Reviewer, Viewer) | Numero, nome, progetto e un link che apre l'elemento |
| Nessuno, o il progetto non esiste più | Elemento in un progetto non accessibile |
Un progetto che non esiste e un progetto che non si può aprire hanno lo stesso aspetto, quindi un collegamento non rivela mai che un progetto esiste.
Stati dei collegamenti
| Mostrato | Significato | Che cosa fare |
|---|---|---|
| Numero e nome | L'elemento esiste e si può aprire il suo progetto | Nulla |
| Eliminato in <progetto> | L'elemento è nel cestino del suo progetto | Chiedere a qualcuno che può modificare quel progetto di ripristinarlo, o rimuovere il collegamento |
| Eliminato | L'elemento non esiste più | Rimuovere il collegamento (Rimuovi collegamenti interrotti) |
| Elemento in un progetto non accessibile | Non si ha accesso al progetto, o non esiste più | Chiedere l'accesso al proprietario del progetto se necessario |
| Caricamento… | L'elemento è in fase di lettura | Attendere un momento |
I nomi vengono letti quando una pagina mostra il collegamento, di nuovo quando si torna alla scheda dopo un minuto, e ogni cinque minuti. Un elemento rinominato mostra il suo nuovo nome senza alcuna modifica a questo progetto.
Destinazioni modificate
Una riga mostra Modificato quando l'elemento collegato è stato modificato nel suo progetto dopo la creazione o l'ultima revisione del collegamento. Puntarvi sopra per la data. Verificare che il collegamento sia ancora valido, poi:
- Fare clic su ✓ nella riga per segnare quel collegamento come rivisto.
- Fare clic su ⋯ accanto ad Altri progetti, poi su Segna tutti come rivisti (n), per ogni collegamento segnalato dell'elemento.
- Oppure aprire Esigenze e requisiti → Collegamenti da rivedere: la scheda Modificati in altri progetti elenca ogni collegamento segnalato del progetto, con ✓ per riga e Segna tutti come rivisti.
Segnare come rivisto compare nella cronologia dell'elemento e in Attività, e un solo annullamento lo revoca. Revisori e lettori vedono le segnalazioni ma non possono cancellarle. I collegamenti ai rilasci di libreria non vengono segnalati (un rilascio non cambia).
Come usarlo
Quando e perché
Usare i collegamenti ad altri progetti quando un unico modello sarebbe troppo grande o è gestito da team diversi: una specifica di sistema e le sue specifiche di sottosistema, i requisiti condivisi di una linea di prodotti e ogni prodotto, o i requisiti di un cliente e il proprio progetto. Tenere i collegamenti nel progetto di livello inferiore, rivolti verso l'alto: ogni sottosistema traccia i propri requisiti dai requisiti di sistema.
Usare le relazioni ordinarie all'interno di un progetto. Collega esistente… nella sezione Tracciabilità mette in relazione elementi dello stesso progetto; un collegamento a un altro progetto serve per elementi che si trovano altrove.
Aggiungere un collegamento
- Selezionare l'elemento, per esempio un requisito di sottosistema.
- Nell'ispettore, aprire la sezione Tracciabilità. In Altri progetti, fare clic su + (Aggiungi collegamento a un altro progetto…).
- Scegliere la Relazione, come traced from.
- Scegliere il Progetto. I suoi elementi sono elencati per numero.
- Per una libreria, scegliere la Versione: Attuale (copia di lavoro) o un rilascio come Release 1.1. Un collegamento a un rilascio mostra la sua etichetta invece di attuale, e il suo nome non apre una pagina.
- Digitare in Cerca per trovare un elemento per numero o nome. Scegliere una Classe per elencare solo quella classe.
- Fare clic sull'elemento, poi su Aggiungi collegamento. Il messaggio dice “Collegamento aggiunto.” e l'elemento compare in Altri progetti.
Un solo annullamento rimuove il collegamento. Aggiungere di nuovo lo stesso collegamento mantiene quello esistente.
Aprire l'elemento collegato
Fare clic sul nome dell'elemento collegato. Il suo progetto si apre su quell'elemento.
Rimuovere i collegamenti
- Fare clic su × nella riga del collegamento per rimuovere un collegamento.
- Quando i collegamenti puntano a elementi eliminati, fare clic su ⋯ accanto ad Altri progetti, poi su Rimuovi collegamenti interrotti (n).
Rimuovere un collegamento modifica solo questo progetto. L'altro progetto non viene mai modificato da un collegamento.
Esempio pratico: un sottosistema payload e la demo CubeSat EO-1
- Creare un progetto chiamato EO-1 Payload con un requisito PL.1 Detector pixel pitch shall be at most 5.5 µm.
- Selezionare PL.1, aprire Tracciabilità → Altri progetti → +.
- Scegliere traced from, il progetto CubeSat EO-1, cercare ground sample, e fare clic su 1.2 Ground Sample Distance. Fare clic su Aggiungi collegamento.
- La riga riporta traced from 1.2 Ground Sample Distance CubeSat EO-1 · attuale. Un collega che può aprire solo EO-1 Payload vede Elemento in un progetto non accessibile nella stessa riga.
Suggerimenti e buone pratiche
- Collegare dal livello inferiore al livello superiore, così il progetto di sistema non deve cambiare quando si aggiunge un sottosistema.
- Condividere il progetto di livello superiore come Viewer con le persone che lavorano su quello di livello inferiore, così vedono i nomi.
- Eseguire Rimuovi collegamenti interrotti dopo la riorganizzazione di un progetto di livello superiore.
Errori comuni
| Problema | Causa | Correzione |
|---|---|---|
| “Questo elemento è in questo progetto. Usare invece Collega esistente….” | La destinazione è nello stesso progetto | Usare Collega esistente… nel gruppo della relazione |
| Nessun + in Altri progetti | Si può solo visualizzare il progetto, o l'elemento è bloccato | Chiedere il ruolo Editor, o sbloccare l'elemento |
| “I collegamenti a elementi di altri progetti fanno parte del piano Team.” | Il proprietario del progetto non ha il piano Team | Passare a un piano superiore in Impostazioni account → Piano e fatturazione |
| Il selettore dice “Questo progetto non può essere letto. Scegliere un altro progetto.” | Si è perso l'accesso a quel progetto | Chiedere l'accesso al suo proprietario |
Come si collega alle altre funzionalità
- Matrice di tracciabilità: i collegamenti dalle righe tramite le relazioni scelte sono elencati sotto la griglia in Altri progetti; Esporta… li aggiunge (vedere Tracciabilità).
- Diagramma Spider: gli elementi collegati compaiono come riquadri tratteggiati attorno al loro elemento; disattivarli con Opzioni → Altri progetti.
- Mappa del programma: Gestisci progetti → Mappa del programma mostra come si collegano tutti i propri progetti, e Altri progetti ⋯ → Mostra nella Mappa del programma traccia questo elemento attraverso gli altri progetti (vedere Mappa del programma).
- Copertura del programma: il progetto a cui si punta elenca questi collegamenti in Verifica → Copertura del programma, per elemento e progetto (vedere Copertura del programma).
- Cronologia e Attività: l'aggiunta e la rimozione di un collegamento vengono registrate sull'elemento.
- Cestino: eliminare un elemento sposta con esso i suoi collegamenti nel cestino; ripristinare l'elemento li ripristina.
- Richieste di modifica: Aggiungi modifica ▾ → Aggiungi un collegamento a un altro progetto… e Rimuovi un collegamento a un altro progetto… preparano i collegamenti; vengono aggiunti o rimossi quando la richiesta viene applicata.
- Librerie: collegarsi a un elemento di un rilascio di libreria con la scelta Versione (vedere Librerie).
Esportazioni e report
Le esportazioni nominano gli elementi collegati con l'accesso della persona che esporta. Tutto ciò che quella persona non può leggere viene scritto come “Elemento in un altro progetto”.
| Esportazione | Che cosa succede ai collegamenti ad altri progetti |
|---|---|
| JSON del progetto (esportazione dal Database) | Conservati come memorizzati: solo id. Importando il file vengono mantenuti |
| ReqIF (Database e Documenti) | Un attributo External links su ogni elemento collegato: relazione, id del progetto e id dell'elemento, più numero e nome quando si possono leggere |
| XMI | Esclusi; il report di esportazione li conta come “Collegamento a un altro progetto” |
| Matrice di tracciabilità (Excel) | Un foglio Other projects separato |
| Matrice di tracciabilità (CSV) | Una colonna Other projects |
| Report Requirements Traceability Matrix (RTM) | Una colonna Other Projects |
API e MCP
L'API e MCP restituiscono i collegamenti come id. Per leggere i nomi, chiamare l'operazione resolve; usa l'accesso e l'elenco dei progetti del token stesso. La Mappa del programma e la Traccia dell'elemento sono disponibili come GET /api/v1/program-map, GET /api/v1/projects/<project>/items/<item>/trace e gli strumenti MCP program_map e trace_chain. Vedere API e MCP.
Le funzionalità di IA nell'app ricevono i collegamenti solo come id.
Messaggi
| Messaggio | Significato |
|---|---|
| Collegamento aggiunto. | Il collegamento è stato salvato |
| Questo elemento è in questo progetto. Usare invece Collega esistente…. | L'elemento scelto è nello stesso progetto |
| Scegliere un elemento, poi aggiungere il collegamento. | Si è fatto clic su Aggiungi collegamento senza scegliere un elemento |
| Nessun altro progetto a cui collegarsi. Creare o aprire prima un altro progetto. | Si ha solo questo progetto |
| I collegamenti a elementi di altri progetti fanno parte del piano Team. | Il proprietario del progetto non ha il piano Team |
| Un progetto contiene al massimo 20.000 collegamenti ad altri progetti. Rimuoverne prima alcuni. | Il progetto ha raggiunto il limite |
Limiti
| Limite | Valore |
|---|---|
| Collegamenti per progetto | 20,000 |
| Elementi letti per richiesta | 500 |
| Elementi elencati nel selettore | 100 per ricerca (restringere la ricerca per vederne altri) |
Un collegamento punta alla versione corrente dell'altro progetto, o alla copia di un elemento in un rilascio di libreria (vedere Librerie).