Holarch

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.

Come usarlo →

In questa pagina
  1. Panoramica
  2. Concetti
    1. Che cosa mostra la mappa
    2. Chi vede cosa
    3. Colori
  3. Come usarlo
    1. Vedere come si collegano i propri progetti
    2. Partire da un progetto
    3. Tracciare un elemento attraverso il programma
    4. Esempio pratico: la demo CubeSat EO-1 e un progetto payload
    5. Esempio pratico: la Hybrid Car e il suo pacco batteria
    6. Suggerimenti e buone pratiche
    7. Errori comuni
    8. Come si collega alle altre funzionalità
  4. La pagina Mappa del programma
    1. Barra
    2. Grafo
    3. Tabella
    4. Ispettore
  5. API e MCP
  6. Messaggi
  7. Limiti
  8. 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

ElementoSignificato
RiquadroUn 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
FrecciaCollegamenti memorizzati nel progetto alla coda che puntano a elementi del progetto alla punta
Etichetta della frecciarelazione · 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 libreriaUn 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

ColoreSignificato
Freccia bluCollegamenti tra progetti che si possono aprire
Freccia ambraAlcune delle destinazioni sono eliminate (nel cestino o scomparse)
Freccia grigiaCollegamenti 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

  1. Fare clic su Gestisci progetti, poi su Mappa del programma. La vista Progetti si apre con ogni progetto che contiene o riceve collegamenti.
  2. Leggere le frecce. Puntare su un riquadro per attenuare tutto ciò che non è collegato a esso.
  3. 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.
  4. 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

  1. Aprire il progetto, poi Verifica → Copertura del programma, e fare clic su Apri Mappa del programma.
  2. La mappa mostra solo quel progetto e i progetti collegati a esso, direttamente o tramite altri.
  3. 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

  1. 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.
  2. 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.
  3. Scegliere Passi (da 1 a 6, predefinito 3) per andare più lontano o restare più vicini.
  4. Gli elementi sono colorati per progetto, con un riquadro tratteggiato attorno agli elementi di ogni progetto. Deselezionare Raggruppa per progetto per rimuovere i riquadri.
  5. 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

  1. Creare la demo CubeSat EO-1, poi un secondo progetto EO-1 Payload con il requisito PL.1 Imager resolution.
  2. 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.
  3. 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.
  4. 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.
  5. 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

  1. In Gestisci progetti, fare clic su File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2).
  2. 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.
  3. 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

ProblemaCausaCorrezione
Manca un progettoNon se ne è membri, è nel cestino, o non ha collegamentiChiedere l'accesso al proprietario; selezionare Mostra progetti non collegati per elencare i progetti senza collegamenti
Tutto finisce in Progetti che non si possono aprireI collegamenti puntano a progetti di cui non si è membriChiedere l'accesso al proprietario di un progetto
Frecce grigie al centro della mappaIl progetto che contiene i collegamenti ha un proprietario senza il piano TeamIl proprietario passa a un piano superiore in Impostazioni account → Piano e fatturazione
Un nuovo collegamento non compare ancoraLa mappa sta ancora leggendo le modifiche recentiFare 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

ControlloChe cosa fa
Progetti / Traccia elementoCambia la vista
AmbitoTutti 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 progettiMostrato dopo aver aperto la mappa da un progetto; esce dall'insieme collegato di quel progetto
Mostra progetti non collegatiMostra anche i progetti senza collegamenti
Raggruppa relazioniUna freccia per coppia di progetti (le etichette elencano ogni relazione), o una freccia per relazione
PassiTraccia elemento: da 1 a 6 passi di distanza
Raggruppa per progettoTraccia elemento: riquadri tratteggiati attorno agli elementi di ogni progetto
Grafo / TabellaIl diagramma o una tabella ordinabile; su uno schermo stretto si apre prima la tabella
AggiornaRilegge 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

VistaColonne
ProgettiProgetto di origine, Relazione, Progetto di destinazione, Collegamenti, Eliminato
Traccia elementoProgetto, Numero, Nome, Classe, Passi dall'elemento, Stato

Fare clic sull'intestazione di una colonna per ordinare.

Ispettore

SelezioneContenuto
Riquadro del progettoNome, tipo, numero di elementi, collegamenti in uscita e in entrata; Apri progetto, Mostra solo progetti collegati
FrecciaProgetto 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.

ChiamataRestituisce
GET /api/v1/program-mapProgetti, 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>/traceTraccia elemento: nodi con progetto, numero, nome, classe e passi, i collegamenti tra essi e il conteggio nascosto; steps 1–6 (predefinito 3)
MCP program_mapLo stesso di GET /program-map
MCP trace_chainLo stesso della chiamata di traccia; gli elementi in progetti con marcature per dati regolamentati rispondono withheld

Vedere API e MCP.

Messaggi

MessaggioSignificato
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

LimiteValore
Passi di Traccia elementoDa 1 a 6
Elementi in una Traccia elemento500
Collegamenti elencati per pagina nell'elenco di una freccia100
Collegamenti per progetto20.000 (vedere Collegamenti ad altri progetti)