Holarch

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.

Come usarlo →

In questa pagina
  1. Panoramica
  2. Concetti
    1. Che cosa contiene un collegamento
    2. Chi vede cosa
    3. Stati dei collegamenti
    4. Destinazioni modificate
  3. Come usarlo
    1. Quando e perché
    2. Aggiungere un collegamento
    3. Aprire l'elemento collegato
    4. Rimuovere i collegamenti
    5. Esempio pratico: un sottosistema payload e la demo CubeSat EO-1
    6. Suggerimenti e buone pratiche
    7. Errori comuni
    8. Come si collega alle altre funzionalità
  4. Esportazioni e report
  5. API e MCP
  6. Messaggi
  7. Limiti
  8. Correlati

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

ParteSignificato
OrigineUn elemento di questo progetto
RelazioneUna relazione dello schema di questo progetto, come traced from, satisfies o verified by
ObiettivoL'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 progettoCosa 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.

MostratoSignificatoChe cosa fare
Numero e nomeL'elemento esiste e si può aprire il suo progettoNulla
Eliminato in <progetto>L'elemento è nel cestino del suo progettoChiedere a qualcuno che può modificare quel progetto di ripristinarlo, o rimuovere il collegamento
EliminatoL'elemento non esiste piùRimuovere il collegamento (Rimuovi collegamenti interrotti)
Elemento in un progetto non accessibileNon si ha accesso al progetto, o non esiste piùChiedere l'accesso al proprietario del progetto se necessario
Caricamento…L'elemento è in fase di letturaAttendere 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.

  1. Selezionare l'elemento, per esempio un requisito di sottosistema.
  2. Nell'ispettore, aprire la sezione Tracciabilità. In Altri progetti, fare clic su + (Aggiungi collegamento a un altro progetto…).
  3. Scegliere la Relazione, come traced from.
  4. Scegliere il Progetto. I suoi elementi sono elencati per numero.
  5. 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.
  6. Digitare in Cerca per trovare un elemento per numero o nome. Scegliere una Classe per elencare solo quella classe.
  7. 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.

  • 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

  1. Creare un progetto chiamato EO-1 Payload con un requisito PL.1 Detector pixel pitch shall be at most 5.5 µm.
  2. Selezionare PL.1, aprire Tracciabilità → Altri progetti → +.
  3. 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.
  4. 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

ProblemaCausaCorrezione
“Questo elemento è in questo progetto. Usare invece Collega esistente….”La destinazione è nello stesso progettoUsare Collega esistente… nel gruppo della relazione
Nessun + in Altri progettiSi può solo visualizzare il progetto, o l'elemento è bloccatoChiedere 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 TeamPassare 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 progettoChiedere 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”.

EsportazioneChe 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
XMIEsclusi; 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

MessaggioSignificato
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

LimiteValore
Collegamenti per progetto20,000
Elementi letti per richiesta500
Elementi elencati nel selettore100 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).