Requisiti
Mappa del programma
Vedere come i propri progetti sono collegati tra loro, con il numero di collegamenti per ogni coppia di progetti, e seguire la catena di collegamenti di un elemento attraverso altri progetti.
In questa pagina
- Panoramica
- Concetti
- Come usarlo
- Vedere come si collegano i propri progetti
- Partire da un progetto
- Tracciare un elemento attraverso il programma
- Esempio pratico: la demo CubeSat EO-1 e un progetto payload
- Esempio pratico: la Hybrid Car e il suo pacco batteria
- Suggerimenti e buone pratiche
- Errori comuni
- Come si collega alle altre funzionalità
- La pagina Mappa del programma
- API e MCP
- Messaggi
- Limiti
- Correlati
Panoramica
Un programma che si estende su più progetti (un progetto di sistema, progetti di sottosistema, un progetto di test, librerie) è tenuto insieme da collegamenti ad altri progetti. Ogni collegamento è memorizzato nel progetto che lo crea, quindi nessun singolo progetto mostra il quadro completo. La Mappa del programma lo fa: disegna un riquadro per ogni progetto che si può aprire e una freccia per ogni coppia di progetti, con l'etichetta della relazione e il numero di collegamenti.
La pagina ha due viste:
- Progetti: ogni progetto che si può aprire e i collegamenti tra essi, come grafo o come tabella.
- Traccia elemento: un elemento al centro e gli elementi collegati a esso in altri progetti, anello dopo anello, fino a sei passi di distanza.
La Mappa del programma è aperta a tutti gli utenti che hanno eseguito l'accesso. I collegamenti stessi si creano con il piano Team; i collegamenti memorizzati in un progetto il cui proprietario ha un piano che non li include sono disegnati in grigio. I collegamenti tra i progetti demo Hybrid Car e Hybrid Car Battery Pack funzionano con ogni piano.
Concetti
Che cosa mostra la mappa
| Elemento | Significato |
|---|---|
| Riquadro | Un progetto che si può aprire: il suo nome, il tipo di progetto e il numero di elementi; il suo nome accessibile aggiunge i collegamenti che contiene e riceve |
| Freccia | Collegamenti memorizzati nel progetto alla coda che puntano a elementi del progetto alla punta |
| Etichetta della freccia | relazione · collegamenti · eliminati, per esempio traced from · 12 · 1 eliminato |
| Progetti che non si possono aprire (N collegamenti) | Un riquadro tratteggiato che conta ogni collegamento verso un progetto che non si può aprire |
| Riquadro del rilascio di libreria | Un rilascio di libreria leggibile, collegato dai propri progetti |
Le frecce di solito puntano verso l'alto: i progetti di sottosistema memorizzano collegamenti traced from e satisfies verso il progetto di sistema, e i progetti di test memorizzano collegamenti verifies. La mappa pone i progetti che contengono collegamenti sotto i progetti a cui puntano.
Chi vede cosa
La mappa è costruita solo dai progetti che si possono aprire: un progetto di cui si è membri con qualsiasi ruolo, non nel cestino, e di cui si soddisfa la regola di accesso in due passaggi dell'organizzazione.
- Un collegamento verso un progetto che non si può aprire viene contato in Progetti che non si possono aprire (N collegamenti). Quel riquadro non nomina mai il progetto o l'elemento, e ha lo stesso aspetto sia che il progetto esista, sia nel cestino o non sia mai esistito.
- I collegamenti memorizzati in un progetto che non si può aprire non vengono contati da nessuna parte, anche quando puntano ai propri progetti.
- Essere amministratore dell'organizzazione non aggiunge nulla: la mappa usa l'appartenenza ai progetti.
- Le esportazioni (CSV, SVG, PNG) contengono esattamente ciò che mostra la pagina.
Colori
| Colore | Significato |
|---|---|
| Freccia blu | Collegamenti tra progetti che si possono aprire |
| Freccia ambra | Alcune delle destinazioni sono eliminate (nel cestino o scomparse) |
| Freccia grigia | Collegamenti verso progetti che non si possono aprire, verso un rilascio di libreria, o memorizzati in un progetto il cui proprietario ha un piano che non include i collegamenti ad altri progetti |
Come usarlo
Vedere come si collegano i propri progetti
- Fare clic su Gestisci progetti, poi su Mappa del programma. La vista Progetti si apre con ogni progetto che contiene o riceve collegamenti.
- Leggere le frecce. Puntare su un riquadro per attenuare tutto ciò che non è collegato a esso.
- Fare clic su una freccia. L'ispettore elenca i suoi collegamenti, 100 alla volta: l'elemento che contiene ciascun collegamento, la relazione e l'elemento di destinazione. Fare clic su uno dei due elementi per aprirlo nel suo progetto, o su Mostra altro per i 100 successivi.
- Fare clic su Esporta CSV nell'ispettore per salvare i collegamenti di quella freccia, o su Esporta ▾ nella barra per salvare l'intera mappa come CSV, SVG o PNG.
Partire da un progetto
- Aprire il progetto, poi Verifica → Copertura del programma, e fare clic su Apri Mappa del programma.
- La mappa mostra solo quel progetto e i progetti collegati a esso, direttamente o tramite altri.
- Fare clic su Mostra tutti i progetti per vedere tutto ciò che si può aprire.
È anche possibile fare clic su un riquadro e scegliere Mostra solo progetti collegati.
Tracciare un elemento attraverso il programma
- Selezionare l'elemento. Nella sezione Tracciabilità dell'ispettore, aprire Altri progetti ⋯ e scegliere Mostra nella Mappa del programma. Dall'elenco dei collegamenti di una freccia, fare invece clic su Traccia questo elemento.
- La vista Traccia elemento mostra l'elemento al centro e gli elementi collegati a esso in anelli: il primo anello a un passo di distanza, il secondo a due passi. I collegamenti vengono seguiti in entrambe le direzioni.
- Scegliere Passi (da 1 a 6, predefinito 3) per andare più lontano o restare più vicini.
- Gli elementi sono colorati per progetto, con un riquadro tratteggiato attorno agli elementi di ogni progetto. Deselezionare Raggruppa per progetto per rimuovere i riquadri.
- Fare clic su un elemento per Apri elemento e Traccia da qui, che lo pone al centro.
Esempio pratico: la demo CubeSat EO-1 e un progetto payload
- Creare la demo CubeSat EO-1, poi un secondo progetto EO-1 Payload con il requisito PL.1 Imager resolution.
- In EO-1 Payload, selezionare PL.1. In Tracciabilità → Altri progetti, fare clic su +, scegliere traced from, il progetto CubeSat e il suo requisito di acquisizione immagini, e fare clic su Aggiungi collegamento.
- Creare un terzo progetto EO-1 Test Campaign con il caso di test TC.4 Resolution test, e collegarlo con verifies a PL.1 in EO-1 Payload.
- Aprire Gestisci progetti → Mappa del programma. La mappa mostra EO-1 Test Campaign in basso, EO-1 Payload sopra di esso e il progetto CubeSat in cima, con le frecce verifies · 1 e traced from · 1.
- Fare clic su PL.1 → Tracciabilità ⋯ → Mostra nella Mappa del programma: il caso di test e il requisito CubeSat si trovano a un passo di distanza, ai due lati.
Esempio pratico: la Hybrid Car e il suo pacco batteria
- In Gestisci progetti, fare clic su File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2).
- Poi creare File di progetto ▾ → Nuovo progetto demo → Hybrid Car Battery Pack (SysML v2). I requisiti del pacco del fornitore della batteria PackCapacity, PackMass e ChargeAcceptance sono collegati con traced from ai requisiti dell'auto VR-3, VR-6 e VR-5 nella demo Hybrid Car più recente, qualunque delle due si crei per prima; creando di nuovo la demo Hybrid Car i collegamenti passano a quella nuova. Questi collegamenti demo funzionano con ogni piano. Senza un progetto Hybrid Car la demo del pacco non ha collegamenti.
- Aprire Gestisci progetti → Mappa del programma. La mappa mostra i due progetti SysML v2 con la freccia traced from · 3.
Suggerimenti e buone pratiche
- Concordare le relazioni usate dai sottoprogetti (traced from o satisfies per i requisiti, verifies per i test) così le frecce si leggono allo stesso modo ovunque.
- Disattivare Raggruppa relazioni per vedere una freccia per relazione, per esempio per distinguere i collegamenti dei requisiti da quelli dei test tra gli stessi due progetti.
- Trascinare i riquadri per disporre la mappa. Le posizioni vengono conservate in questo browser per ogni ambito.
- Usare la vista Tabella per ordinare le coppie di progetti per numero di collegamenti o di destinazioni eliminate.
- Una freccia ambra indica collegamenti da riparare: aprire il suo elenco di collegamenti, poi correggere o rimuovere i collegamenti in Tracciabilità → Altri progetti dell'elemento.
Errori comuni
| Problema | Causa | Correzione |
|---|---|---|
| Manca un progetto | Non se ne è membri, è nel cestino, o non ha collegamenti | Chiedere l'accesso al proprietario; selezionare Mostra progetti non collegati per elencare i progetti senza collegamenti |
| Tutto finisce in Progetti che non si possono aprire | I collegamenti puntano a progetti di cui non si è membri | Chiedere l'accesso al proprietario di un progetto |
| Frecce grigie al centro della mappa | Il progetto che contiene i collegamenti ha un proprietario senza il piano Team | Il proprietario passa a un piano superiore in Impostazioni account → Piano e fatturazione |
| Un nuovo collegamento non compare ancora | La mappa sta ancora leggendo le modifiche recenti | Fare clic su Aggiorna dopo un minuto |
Come si collega alle altre funzionalità
- Collegamenti ad altri progetti: la mappa li legge; non aggiunge né modifica nulla. Creare i collegamenti in Tracciabilità → Altri progetti di un elemento (vedere Collegamenti ad altri progetti).
- Copertura del programma: la vista per elemento dei collegamenti verso un progetto, con le lacune (vedere Copertura del programma). Apri Mappa del programma lì avvia la mappa da quel progetto.
- Librerie: i collegamenti a un elemento di un rilascio di libreria compaiono come frecce verso il riquadro del rilascio (vedere Librerie).
- Diagramma Spider: la tracciabilità all'interno di un progetto, con riquadri tratteggiati per gli elementi collegati altrove. Traccia elemento usa la stessa disposizione ad anelli.
- API e MCP: la stessa mappa e la stessa traccia per gli strumenti (vedere API e MCP).
La pagina Mappa del programma
Barra
| Controllo | Che cosa fa |
|---|---|
| Progetti / Traccia elemento | Cambia la vista |
| Ambito | Tutti i miei progetti, un'organizzazione (quando se ne fa parte), o una cartella con le sue sottocartelle (quando si hanno cartelle; vedere Cartelle dei progetti) |
| Mostra tutti i progetti | Mostrato dopo aver aperto la mappa da un progetto; esce dall'insieme collegato di quel progetto |
| Mostra progetti non collegati | Mostra anche i progetti senza collegamenti |
| Raggruppa relazioni | Una freccia per coppia di progetti (le etichette elencano ogni relazione), o una freccia per relazione |
| Passi | Traccia elemento: da 1 a 6 passi di distanza |
| Raggruppa per progetto | Traccia elemento: riquadri tratteggiati attorno agli elementi di ogni progetto |
| Grafo / Tabella | Il diagramma o una tabella ordinabile; su uno schermo stretto si apre prima la tabella |
| Aggiorna | Rilegge i collegamenti |
| Esporta ▾ | Esporta CSV, Esporta SVG, Esporta PNG |
Grafo
- Fare clic su un riquadro per mostrare il suo progetto nell'ispettore: Apri progetto e Mostra solo progetti collegati. Fare doppio clic su un riquadro, o premere Shift+Enter su di esso, per aprire il progetto.
- Fare clic su una freccia per elencarne i collegamenti nell'ispettore.
- Trascinare i riquadri per spostarli; scorrere o pizzicare per lo zoom; trascinare lo sfondo per la panoramica.
- Premere Tab per raggiungere la mappa, poi i tasti freccia per spostarsi tra riquadri e frecce; Enter passa all'ispettore. Ogni riquadro e ogni freccia hanno un nome letto da uno screen reader, come “EO-1 Payload, progetto LML, 1 collegamento in uscita, 1 in entrata”.
Tabella
| Vista | Colonne |
|---|---|
| Progetti | Progetto di origine, Relazione, Progetto di destinazione, Collegamenti, Eliminato |
| Traccia elemento | Progetto, Numero, Nome, Classe, Passi dall'elemento, Stato |
Fare clic sull'intestazione di una colonna per ordinare.
Ispettore
| Selezione | Contenuto |
|---|---|
| Riquadro del progetto | Nome, tipo, numero di elementi, collegamenti in uscita e in entrata; Apri progetto, Mostra solo progetti collegati |
| Freccia | Progetto di origine e di destinazione, collegamenti per relazione, l'elenco dei collegamenti (100 alla volta, Mostra altro), Esporta CSV, Traccia questo elemento per riga |
| Elemento (Traccia elemento) | Numero e nome, classe, progetto, passi dall'elemento tracciato, stato; Apri elemento, Traccia da qui |
| Progetti che non si possono aprire | “Collegamenti a progetti che non si possono aprire. Chiedere l'accesso al proprietario di un progetto.” |
API e MCP
L'API REST e MCP danno le stesse risposte con l'accesso e l'elenco dei progetti del token stesso. I progetti di un'organizzazione che ha disattivato l'accesso all'API vengono esclusi, come i progetti che non si possono aprire.
| Chiamata | Restituisce |
|---|---|
GET /api/v1/program-map | Progetti, rilasci, frecce (from, to, relation, links, deleted, plan) e il conteggio nascosto; from, unlinked, org come nella pagina |
GET /api/v1/projects/<project>/items/<item>/trace | Traccia elemento: nodi con progetto, numero, nome, classe e passi, i collegamenti tra essi e il conteggio nascosto; steps 1–6 (predefinito 3) |
MCP program_map | Lo stesso di GET /program-map |
MCP trace_chain | Lo stesso della chiamata di traccia; gli elementi in progetti con marcature per dati regolamentati rispondono withheld |
Vedere API e MCP.
Messaggi
| Messaggio | Significato |
|---|---|
| Nessun collegamento tra i propri progetti. Aggiungerne uno dalla sezione Tracciabilità di un elemento. | Nessuno dei propri progetti contiene o riceve un collegamento visibile |
| Questo progetto non ha collegamenti ad altri progetti. Aggiungerne uno dalla sezione Tracciabilità di un elemento. | La mappa è stata aperta da un progetto senza collegamenti |
| Questo elemento non ha collegamenti ad altri progetti. Aggiungerne uno dalla sua sezione Tracciabilità. | L'elemento tracciato non ha collegamenti |
| Alcuni progetti sono ancora in fase di lettura. Aggiornare tra un minuto. | Le modifiche recenti nei progetti grandi sono ancora in fase di lettura; la mappa mostra ciò che è pronto |
| Vengono mostrati i primi 500 elementi. Ridurre i passi. | Traccia elemento ha raggiunto il limite |
| N collegamenti da progetti il cui proprietario ha un piano che non include i collegamenti ad altri progetti non vengono seguiti. | Traccia elemento ha saltato i collegamenti memorizzati con un piano che non li include |
| Impossibile leggere la mappa del programma. Ricaricare la pagina. | La richiesta non è riuscita |
Limiti
| Limite | Valore |
|---|---|
| Passi di Traccia elemento | Da 1 a 6 |
| Elementi in una Traccia elemento | 500 |
| Collegamenti elencati per pagina nell'elenco di una freccia | 100 |
| Collegamenti per progetto | 20.000 (vedere Collegamenti ad altri progetti) |