Modello
Schema ed estensioni
Adattare lo schema LML di un progetto con classi, attributi, scelte, relazioni, etichette e flussi di stato personalizzati, e vedere come ogni modifica influisce sui dati esistenti.
In questa pagina
- Panoramica
- Concetti
- Come usarlo
- Quando e perché
- Aggiungere un attributo a una classe
- Aggiungere scelte a un attributo esistente
- Creare una sottoclasse
- Aggiungere un'etichetta
- Consentire una nuova relazione
- Definire un flusso di lavoro di stato
- Aggiungere o modificare gli stati di un flusso di lavoro
- Scegliere gli approvatori di una transizione
- Richiedere l'approvazione per un cambio di stato
- Condividere uno schema tra progetti
- Esempio guidato: CubeSat EO-1
- Suggerimenti e buone pratiche
- Errori comuni
- Come si collega alle altre funzionalità
- L'Editor dello schema
- Come le modifiche allo schema influiscono sui dati esistenti
- Estensioni predefinite
- Scorciatoie da tastiera
- Opzioni e impostazioni
- Messaggi
- Limiti
- Correlati
Panoramica
Lo schema definisce cosa può contenere il modello di un progetto:
- le classi delle entità,
- gli attributi di ogni classe,
- le relazioni che possono collegare le classi,
- le etichette che contrassegnano le entità,
- flussi di lavoro facoltativi: gli stati di un attributo di stato per classe, come possono cambiare e quali cambi richiedono approvazione.
Ogni progetto parte dallo schema predefinito del Lifecycle Modeling Language (LML). L'Editor dello schema lo modifica per un solo progetto. La prima modifica crea la copia propria del progetto, quindi gli altri progetti non vengono interessati. Ogni modifica allo schema si può annullare con un solo annullamento.
Holarch aggiunge anche estensioni predefinite a ogni progetto, come Priorità e Owner sui requisiti e Handling Strategy sui rischi. Vedere Estensioni predefinite.
Per lavorare ogni giorno con entità, attributi e relazioni, vedere Modello e Database.
Concetti
Lo schema del progetto
- Schema predefinito: le classi, le relazioni, gli attributi e le etichette LML forniti con Holarch. Gli argomenti della Guida nell'app Classi LML (schema), Relazioni LML (schema) ed Etichette (schema) li elencano aggiornati per il progetto aperto.
- Schema del progetto: una copia memorizzata all'interno del progetto. Viene creata alla prima modifica. Viaggia con il progetto nelle esportazioni e raggiunge ogni membro che lo apre.
- Estensioni predefinite: aggiunte richieste dalle funzionalità di Holarch. Vengono applicate per nome a ogni apertura di un progetto. Per questo la maggior parte dei progetti ha già una propria copia, e la pagina Utilizzo riporta “Questo progetto usa un proprio schema modificato.”
Corsi
Una classe è un tipo di entità, come Requirement o Asset. Ha un Nome, una Descrizione, un Padre e un Colore, e due indicatori (Astratta e Nascosta).
- Padre: una sottoclasse eredita gli attributi e le destinazioni delle relazioni del padre. Compare in ogni query, filtro e diagramma che copre il padre. Per esempio, una sottoclasse personalizzata di Action riceve i diagrammi di azione. Una sottoclasse personalizzata di Requirement riceve i controlli di qualità e i controlli di approvazione.
- Astratta: la classe raggruppa sottoclassi e non si può creare direttamente.
- Nascosta: la classe non viene proposta quando si creano entità o se ne cambia la classe. Essa e le sue sottoclassi vengono escluse dal filtro di classe del Database. Le entità esistenti restano.
- Colore: il colore del badge e del campione della classe. Senza colore, una classe personalizzata prende il colore del suo antenato predefinito più vicino. Il badge mostra le prime due lettere del nome.
Attributi
Un attributo è un campo che ogni entità di una classe ha, come Priorità sui requisiti. Un attributo può anche appartenere a una relazione.
Un attributo ha un Nome, un Tipo e una posizione nell'ordine della classe. Può avere Valori consentiti, un Valore predefinito e una Descrizione. La descrizione compare quando si punta sull'etichetta dell'attributo.
Tipi, raggruppati come li elenca la finestra di dialogo dell'attributo (l'id del tipo memorizzato è tra parentesi; esportazioni, importazioni e l'API lo usano):
| Gruppo | Tipo | Contiene |
|---|---|---|
| Testo | Testo breve (TEXT), Testo lungo (BIG_TEXT), Testo formattato (HTML) | Una riga; più righe; testo formattato |
| Numeri | Numero (NUMBER), Percentuale (PERCENT), Durata (DURATION) | Un numero o una distribuzione; da 0 a 100; un numero o una distribuzione con un'unità di tempo |
| Data e ora | Data e ora (DATETIME) | Data e ora |
| Scelte | Uno da un elenco (ENUMERATION), Più da un elenco (MULTISELECT), Sì o no (BOOLEAN) | Un valore; più valori; Sì o No |
| Link | Indirizzo web (URI), File (FILE) | Un link; un file caricato |
| Speciali | Posizione (GEOPOINT), Equazione (EQUATION), Calcolato (COMPUTABLE), Persona o team (USER_TEAM), Molteplicità (MULTIPLICITY), Controllo di qualità (QUALITY) | Latitudine e longitudine; testo LaTeX; un valore calcolato da attributi di altre entità; il nome di una persona o di un team; n, n..m, n..* o *; un criterio Sì/No impostato dal controllo di qualità |
Gli editor per ogni tipo sono descritti in Tipi di attributo ed editor.
Gli attributi ereditati dalle classi genitore sono elencati per primi, poi gli attributi propri della classe, nell'ordine impostato nella pagina di ogni classe (trascinare una riga, o ↑ / ↓). Un nuovo attributo va in fondo.
Un attributo nascosto conserva i suoi valori. Scompare da editor, filtri, colonne, ricerche e report finché non viene mostrato di nuovo.
Relazioni e destinazioni
- Una relazione è sempre una coppia: un nome e un nome inverso, come satisfies / satisfied by. Crearne una crea entrambi.
- Una destinazione consente una relazione da una classe a un'altra, per esempio Requirement verified by Test Case. Una destinazione verso una classe consente anche le sue sottoclassi. Le sottoclassi ereditano le destinazioni del padre.
- Le relazioni possono avere attributi, per esempio Molteplicità su decomposed by. Un attributo aggiunto a una relazione si applica anche alla sua inversa.
- Una relazione nascosta compare attenuata nell'Editor dello schema ed è esclusa dall'elenco di riferimento della Guida. Resta utilizzabile.
Etichette
Un'etichetta è un tag che si applica alle entità, come Stakeholder Need. Non aggiunge campi e non cambia nulla di strutturale.
Un'etichetta ha un Nome, una Descrizione e le Classi a cui si applica. Può avere un'etichetta Padre, così le etichette possono essere annidate.
- Senza classi selezionate, l'etichetta si applica a ogni classe.
- Un'etichetta per una classe si applica anche alle sue sottoclassi.
- Un'etichetta nascosta resta sulle entità che la hanno ma non viene più proposta.
Flussi di lavoro
Un flusso di lavoro controlla come può cambiare un attributo ENUMERATION di una classe, tipicamente Stato. Comprende:
- Stati: i valori usati dalla classe, in ordine. È possibile aggiungere, rinominare, riordinare e rimuovere stati personalizzati. Gli stati predefiniti, come Approved di un requisito, si possono solo ritirare. Una sottoclasse il cui attributo è ereditato (per esempio un Software Requirement sotto Requirement) mantiene i propri stati.
- Transizioni (Da → A): i cambi consentiti. Senza transizioni ogni stato può seguire ogni altro.
- Approvazione su una transizione: il cambio richiede una richiesta di modifica approvata. Per impostazione predefinita decidono gli approvatori impostati in Richieste di modifica → Impostazioni. Una transizione può invece indicare i propri approvatori: proprietari, editor o persone specifiche, e quanti di loro devono approvare (fino a 5, o ogni persona indicata).
- Blocca l'elemento dopo questa transizione (nel menu ⋯ della transizione): l'elemento viene bloccato dopo il cambio.
Gli editor dell'attributo offrono allora solo il valore attuale e gli stati successivi consentiti. Uno stato che richiede approvazione riporta (richiede approvazione).
Come usarlo
Quando e perché
Adattare lo schema all'inizio di un progetto: quando si imposta il metodo di modellazione e prima di importare dati. Motivi tipici:
- Adottare un metodo o uno standard: aggiungere gli attributi richiesti dal proprio processo, per esempio un TRL sugli asset o un Safety Integrity Level sui requisiti. Aggiungere le etichette che i propri modelli di documento si aspettano.
- Specializzare le classi: aggiungere sottoclassi come Hazard sotto Risk o Payload Instrument sotto Asset. Query, filtri e report possono così distinguerle, e mantengono ogni relazione LML.
- Consentire una relazione richiesta dal metodo: aggiungere una destinazione o una nuova coppia di relazioni.
- Imporre un processo di revisione: aggiungere un flusso di lavoro in modo che lo Stato di un requisito passi da Draft → In Review → Approved. L'editor non gli consente mai di saltare un passaggio. Contrassegnare In Review → Approved come Approvazione affinché il passaggio passi dagli approvatori del progetto.
- Riutilizzare tra progetti: esportare lo schema da un progetto e importarlo nel successivo.
Lo schema risponde alla domanda “Che cosa può dire questo modello?”. Modificarlo con attenzione. Query, colonne salvate, report e importazioni fanno riferimento a classi, attributi e relazioni per nome.
Aggiungere un attributo a una classe
- Nella barra di navigazione, fare clic su Impostazioni → Schema (con gli strumenti in fondo).
- Nella barra laterale, in Classi, fare clic sulla classe, per esempio Asset.
- Nella scheda Attributi, fare clic su + Attributo.
- Inserire il Nome.
- Scegliere il Tipo, per esempio Uno da un elenco in Scelte.
- Per Uno da un elenco o Più da un elenco: digitare le scelte in Valori consentiti, una per riga.
- Facoltativo: impostare un Valore predefinito. Le nuove entità della classe partono con esso.
- Facoltativo: inserire una Descrizione.
- Fare clic su Aggiungi attributo.
Compare il messaggio “Attributo salvato”. L'attributo è l'ultimo nell'elenco della classe e compare per quella classe e le sue sottoclassi: nell'ispettore, nella Vista elemento, nelle colonne e nei filtri del Database, nelle ricerche, nei report e nelle mappature di importazione.
- Per spostarlo, trascinarne la riga nella tabella Attributi, oppure usare ↑ e ↓ sulla riga. Ogni spostamento si può annullare con un solo annullamento.
Aggiungere scelte a un attributo esistente
- Aprire la classe che definisce l'attributo. La colonna Definito su la indica. Un attributo ereditato si modifica nella classe che lo definisce.
- Fare clic su ✎ (Modifica attributo) sulla riga.
- Aggiungere la nuova scelta su una riga a sé in Valori consentiti.
- Fare clic su Salva.
Per Uno da un elenco, il quadratino prima di ogni scelta (sotto l'elenco) imposta il colore del valore. Le bacheche Kanban le cui colonne sono i valori di quell'attributo lo usano come colore della colonna.
Per rimuovere una scelta, eliminarne la riga nello stesso dialogo. Le entità che hanno già quel valore lo mantengono, ma l'editor non lo propone più. Prima di rimuovere una scelta, trovare quelle entità con una query sugli attributi (per esempio Requirement:"Priority=Urgent") e assegnare loro una scelta attuale.
Creare una sottoclasse
- Aprire la classe padre.
- Fare clic su + Sottoclasse.
(Oppure fare clic su + Classe nella barra laterale e scegliere il Padre.)
- Inserire Nome e Descrizione.
- Impostare Astratta, Nascosta e Colore se necessario.
- Fare clic su Crea classe.
Viene mostrata la nuova classe. Ha già tutti gli attributi e le destinazioni ereditati.
Per spostare entità esistenti nella nuova classe, selezionarle nel Database e usare Cambia classe…. Vedere Cambia classe.
Aggiungere un'etichetta
- Fare clic su + Etichetta nella barra laterale, oppure su + Nuova etichetta nella pagina Etichette.
- Inserire Nome e Descrizione.
- Se l'etichetta appartiene a un'altra etichetta, scegliere quella come Padre.
- Selezionare le Classi a cui si applica. ⌘ / Ctrl/Ctrl+clic ne seleziona più d'una. Se non ne è selezionata nessuna, l'etichetta si applica a tutte le classi.
- Fare clic su Crea etichetta.
Per applicare l'etichetta, usare + Etichetta nell'ispettore o nella Vista elemento, oppure Etichetta ▾ nella barra delle azioni multiple del Database.
Consentire una nuova relazione
Una relazione tra due classi è consentita solo quando una destinazione lo permette. Aggiungere una destinazione per consentirla.
- Aprire la classe di origine.
- In Relazioni, fare clic su + Relazione.
- Scegliere la Relazione.
- Scegliere l'Altra classe.
- Lasciare selezionato Aggiungi la relazione inversa anche all'altra classe. Il collegamento si può così creare da entrambe le estremità.
- Fare clic su Aggiungi relazione.
Se all'altra classe manca l'inversa, la colonna Torna a questa classe mostra + su <classe>: fare clic per aggiungervi l'inversa.
Se la relazione necessaria non esiste, crearla prima:
- Fare clic su Nuovo tipo di relazione… nel dialogo (o su + Relazione nella barra laterale).
- Inserire Nome e Nome inverso, e le relative descrizioni.
- Fare clic su Crea relazione.
- Scegliere la nuova relazione al passaggio 3 sopra.
Definire un flusso di lavoro di stato
- Fare clic su Workflow nella barra laterale.
- In Aggiungi una classe…, scegliere la classe.
Viene mostrata una scheda per la classe. Il workflow osserva il primo attributo di enumerazione della classe.
- Se necessario, scegliere un attributo diverso nell'elenco osserva. Cambiandolo, le transizioni vengono cancellate.
- Fare clic su + Aggiungi transizione.
- Impostare Nome, Da e A della transizione. Da è (Iniziale — nessun valore) o uno stato.
- Selezionare Approvazione se la modifica richiede una richiesta di modifica approvata. Per bloccare l'elemento dopo la modifica, aprire il menu ⋯ della riga (o fare clic destro sulla riga) e scegliere Blocca l'elemento dopo questa transizione; la riga indica allora Blocca l'elemento.
- Ripetere i passaggi da 4 a 6 per ogni passaggio consentito.
Per scegliere chi approva una transizione, vedere Scegliere gli approvatori di una transizione.
Gli editor dell'attributo propongono ora solo gli stati successivi consentiti, contrassegnati con ⇢ flusso di lavoro.
Aggiungere o modificare gli stati di un flusso di lavoro
- Nella pagina Workflow, trovare la scheda della classe. La colonna Elementi conta gli elementi in ogni stato; un elemento senza valore viene contato sotto il valore predefinito dell'attributo (un caso di test senza stato conta come Not Run, come lo mostra il Centro test).
- Per aggiungere uno stato, digitarne il nome in Nuovo stato e fare clic su + Aggiungi stato.
Lo stato viene aggiunto alla classe e alle scelte dell'attributo.
- Per ordinare gli stati, fare clic su ↑ o ↓. I selettori e le colonne delle bacheche seguono quest'ordine.
- Per rinominare uno stato personalizzato, fare clic su Rinomina… e inserire il nuovo nome.
Gli elementi in quello stato, le transizioni e il colore del valore assumono il nuovo nome. Un solo annullamento revoca tutto.
- Per rimuovere uno stato, fare clic su Rimuovi… (personalizzato) o Ritira… (integrato).
- Uno stato che nessun elemento ha viene rimosso.
- Quando degli elementi lo hanno, scegliere Sposta e rimuovi con lo stato in cui spostarli, oppure Mantieni come ritirato. Uno stato ritirato resta sui suoi elementi, mostra (ritirato) e non viene più proposto. Le sue transizioni in uscita restano, così gli elementi possono lasciarlo. Ripristina lo propone di nuovo.
Nessuna modifica in questa pagina cancella un valore.
Scegliere gli approvatori di una transizione
- Nella pagina Workflow, selezionare Approvazione sulla transizione.
Accanto compare un pulsante: Impostazioni delle richieste di modifica ▾.
- Fare clic sul pulsante.
Si apre Approvatori della transizione.
- In Chi approva, scegliere una delle opzioni:
- Come impostato in Richieste di modifica → Impostazioni: decidono gli approvatori del progetto (il valore predefinito).
- Proprietari o Proprietari ed editor.
- Persone designate: selezionare i membri del progetto che approvano. Nell'app desktop, digitarne i nomi, separati da virgole, come ciascuno lo inserisce in Preferenze → Il tuo nome.
- In Approvazioni necessarie, scegliere quanti devono approvare: da 1 a 5, oppure Ogni persona designata.
- Fare clic su Salva.
Il pulsante mostra la regola, per esempio Tutte e 3 le persone designate ▾. Un solo annullamento revoca la modifica.
Una richiesta che contiene più cambi di stato richiede tutte le regole applicabili. Un solo rifiuto da parte di chi può approvare la respinge. Nel servizio ospitato, gli approvatori designati contano solo se l'ultimo a impostare il workflow è stato un proprietario del progetto; altrimenti la transizione richiede lo stesso numero di approvazioni dei proprietari.
Richiedere l'approvazione per un cambio di stato
- Nell'ispettore o nella Vista elemento, scegliere uno stato contrassegnato con (richiede approvazione). Per un requisito si può anche fare clic sulla sua transizione nella striscia di revisione (termina con …).
Si apre Richiedi approvazione.
- Facoltativamente inserire un Motivo, poi fare clic su Invia richiesta.
Viene creata e inviata una richiesta di modifica con il cambio di stato. Il dialogo indica gli approvatori: quelli della transizione, o quelli impostati in Richieste di modifica → Impostazioni. L'elemento mantiene il suo stato.
Finché la richiesta è aperta, la striscia di revisione del requisito la mostra con il conteggio, per esempio CR-4: 1 di 3 approvazioni.
- Gli approvatori la approvano.
Con l'ultima approvazione l'elemento passa al nuovo stato, se quell'approvatore può modificare il progetto. Altrimenti un editor apre la richiesta e fa clic su Applica modifiche. La cronologia dell'elemento mostra via CR-n e il registro di approvazione di un requisito indica ogni approvatore e la richiesta.
Le modifiche dirette verso uno stato di questo tipo vengono rifiutate con “… richiede approvazione. Scegliere “X” nell'elemento per richiederla.”: Attributi… in blocco, celle della griglia, spostamenti sulle bacheche e modifiche dell'IA. Scegliere di nuovo lo stato mentre una richiesta è aperta apre quella richiesta.
Condividere uno schema tra progetti
- Nel progetto di origine, aprire Impostazioni → Schema nella barra di navigazione.
- Fare clic su Esporta schema.
Viene scaricato un file JSON.
- Nel progetto di destinazione, aprire Impostazioni → Schema nella barra di navigazione.
- Fare clic su Altro ▾ → Importa schema… e scegliere il file.
- Scegliere la Modalità:
- Unisci (aggiungi le classi, gli attributi, le relazioni e le etichette che mancano a questo progetto, abbinati per nome), oppure
- Sostituisci lo schema di questo progetto.
- Fare clic su Importa.
Esempio guidato: CubeSat EO-1
Questo esempio aggiunge un livello di maturità tecnologica (TRL) agli asset, specializza una classe e aggiunge un workflow di revisione. Creare la demo con Gestisci progetti → File di progetto ▾ → Nuovo progetto demo, poi aprire Impostazioni → Schema nella barra di navigazione.
Esaminare il modello.
- Leggere la pagina Utilizzo.
La tabella Classi elenca per prime le classi più usate, con i loro elementi, attributi e relazioni. Non ancora usato elenca le classi, le etichette e le relazioni che la demo non usa.
Aggiungere un TRL agli asset.
- Fare clic su Asset, poi su + Attributo.
- Inserire il nome
TRLe scegliere il tipo Uno da un elenco. - Digitare le scelte da
1a9in Valori consentiti, una per riga. - Inserire la descrizione
Technology readiness level. - Fare clic su Aggiungi attributo.
Compilarlo.
- Aprire Architettura → Asset.
- Selezionare 1.2.1 Reaction Wheel Assembly e impostare TRL a
7nell'ispettore. - Impostare allo stesso modo 1.2.2 Star Tracker a
6e 1.1 Payload Camera a5.Interrogarlo.
- Nella casella di ricerca, digitare
Asset:"TRL>=6"e premere Enter.La query diventa un chip di filtro nella barra delle query. La tabella elenca le ruote di reazione e lo star tracker. I valori di scelta che sono numeri vengono confrontati come numeri.
Specializzare una classe.
- Tornati nell'Editor dello schema, aprire Asset e fare clic su + Sottoclasse.
- Chiamarla
Payload Instrumente fare clic su Crea classe. - Nel Database, selezionare 1.1 Payload Camera e fare clic su Cambia classe….
- Scegliere Payload Instrument come Nuova classe.
Il dialogo indica “1 elemento diventerà Payload Instrument.” e non elenca nulla da rimuovere: la sottoclasse eredita ogni attributo e destinazione di Asset.
- Fare clic su Cambia classe.
La fotocamera mantiene il suo TRL, i suoi collegamenti performs e il suo posto nella scomposizione.
Aggiungere un workflow di revisione.
- Aprire Workflow e scegliere Requirement in Aggiungi una classe….
- Verificare che osservi Status.
- Aggiungere queste transizioni: Initial → Draft, Draft → In Review, In Review → Approved, In Review → Rejected, Rejected → Draft.
- Aprire 2.4 Target Slew. Il suo Status è Draft.
Il suo elenco Status propone ora solo Draft e In Review.
Annullare o mantenere.
- Premere ⌘Z / Ctrl+Z una volta per ogni modifica per annullare l'esperimento. Oppure mantenere le modifiche e fare clic su Esporta schema per riutilizzarle nel prossimo progetto CubeSat.
Suggerimenti e buone pratiche
- Preferire sottoclassi ed etichette a nuove classi di primo livello. Una sottoclasse mantiene ogni relazione LML, diagramma e controllo della classe padre. Un'etichetta non cambia nulla nella struttura.
- Nascondere invece di eliminare. Nascondere una classe, un attributo o un'etichetta lascia intatti i dati esistenti e si può annullare.
- Impostare lo schema prima di importare. La mappatura dell'importazione propone gli attributi esistenti. Le colonne mappate su Nuovo attributo vengono create automaticamente, con un tipo dedotto. Vedere Importazione ed esportazione.
- Mantenere le aggiunte integrate. Nascondere un'estensione integrata che non serve. Non rinominarla né eliminarla: una mancante viene aggiunta di nuovo, con valore vuoto, alla successiva apertura del progetto.
- Documentare ogni elemento personalizzato nella sua Descrizione. Compare come suggerimento negli editor e nelle tabelle dello schema della Guida.
- I test di attributo «minore di» trovano anche le entità senza valore. Per esempio,
Asset:"TRL<6"include gli asset senza TRL. Combinare un test di questo tipo con un test positivo, oppure usare>=sul complemento.
Errori comuni
- Cambiare il tipo di un attributo ne cancella i valori. Holarch avvisa “N entità hanno un valore “X”. Cambiare il tipo da A a B cancella quei valori.” Se servono i valori precedenti, esportare prima un report CSV. Un solo annullamento revoca sia il cambio di tipo sia la cancellazione dei valori; nei progetti con più di 5.000 valori di questo tipo, durante la cancellazione compare la scheda di avanzamento.
- Eliminare una relazione ne elimina i collegamenti. La conferma li conta. Annulla li ripristina.
- Rimuovere una destinazione lascia relazioni che lo schema non consente più. I collegamenti esistenti restano; Controlli del modello li elenca sotto la regola Global.9 (relazioni che lo schema non consente). Rimuoverli o cambiarne la relazione prima o dopo aver rimosso la destinazione; la conferma li conta.
- Una classe non si può eliminare finché ha entità. Cambiarne prima la classe o eliminarle, oppure nascondere la classe.
- Le transizioni semplici guidano solo gli editor. Attributi… in blocco, le importazioni e le modifiche dell'IA possono comunque impostare qualsiasi stato che non richieda approvazione. Contrassegnare una transizione con Approvazione quando una modifica non deve aggirare la revisione.
- Non è possibile rinominare uno stato integrato. Approvazioni, controllo della configurazione e verifica si basano su di essi. Aggiungere invece un nuovo stato, oppure ritirare quello integrato.
Come si collega alle altre funzionalità
- Database, ispettore e Vista elemento mostrano e modificano gli attributi. Propongono le relazioni consentite dallo schema. Le query fanno riferimento a classi, attributi, etichette e relazioni per nome. Vedere Modello e Database.
- Diagrammi: i tipi di diagramma che un'entità può avere dipendono dalla sua classe e dalle classi superiori. Le sottoclassi personalizzate li ereditano.
- Le funzioni dei Requisiti (qualità, approvazioni, TBD/TBR, collegamenti da rivedere) si basano su attributi integrati come Status, TBD/TBR e i criteri di qualità. Vedere Requisiti.
- Matrice di tracciabilità e Controlli del modello usano le destinazioni delle relazioni per decidere cosa è consentito e cosa manca. Vedere Tracciabilità.
- Importazione ed esportazione si abbinano agli attributi per nome e trasportano lo schema nei file JSON di progetto,
.holarche ReqIF. Vedere Importazione ed esportazione.
L'Editor dello schema
L'Editor dello schema è il punto in cui si effettua ogni modifica dello schema. Si apre da Impostazioni → Schema nella barra di navigazione (con gli strumenti in basso). L'indirizzo schema?class=<id> apre direttamente una classe (funziona anche un numero di classe integrata precedente).
L'editor ha un'intestazione di pagina, una barra laterale e un'area principale. L'area principale mostra la pagina Utilizzo, una classe, oppure la pagina Relazioni, Etichette o Workflow.
Intestazione della pagina
| Controllo | Che cosa fa |
|---|---|
| Esporta schema | Scarica lo schema del progetto come JSON (<Project_name>_schema.json). |
| Altro ▾ → Importa schema… | Importa un file JSON di schema (anche un JSON di progetto che contiene uno schema) con Unisci o Sostituisci. |
| Aggiungi nuovi elementi integrati… | Mostrato quando il progetto ha un proprio schema. Elenca le classi, le relazioni, gli attributi e le etichette che lo schema predefinito ha e che mancano a questa copia (abbinati per nome), come le aggiunte di LML 2.0, e i valori e le relazioni consentite di LML 2.0 per quelli esistenti (Decision Status Open e Closed; Logical decomposed by Logical; Connection transfers Input/Output), e li aggiunge; un solo annullamento revoca tutto. Classi, attributi, scelte e dati esistenti restano invariati; i nuovi valori vanno dopo quelli esistenti. |
| Altro ▾ → Ripristina predefinito… | Proposto quando il progetto ha un proprio schema. Lo sostituisce con lo schema LML predefinito dopo la conferma. |
Barra laterale
- Cerca classi, attributi, relazioni, etichette… filtra l'albero delle classi. L'area principale mostra le Classi, gli Attributi, le Relazioni trovate e le Etichette trovate corrispondenti, oppure “Nessuna classe, attributo, relazione o etichetta corrisponde. Provare un altro termine di ricerca.”
- Utilizzo.
- + Classe, + Etichetta, + Relazione.
- Classi: l'albero delle classi con campioni di colore, i contrassegni “(astratta)” e “(nascosto)” e il numero di entità (sottoclassi incluse).
- Altro: Relazioni (con il conteggio), Etichette (con il conteggio) e Workflow.
Uso
Utilizzo si apre per prima. La sua riga di stato indica “Lo schema LML predefinito. La prima modifica crea una copia per questo progetto.” oppure “Questo progetto usa un proprio schema modificato.”
- Classi: una tabella delle classi non nascoste, le più usate per prime: Classe (fare clic per aprirla), Elementi (con le sue sottoclassi), Attributi (i propri), Relazioni (consentite, ereditate incluse) e Ultima modifica (l'ultima volta che è cambiato uno dei suoi elementi).
- Non ancora usato: tre elenchi apribili, Classi, Etichette e Relazioni che nulla nel progetto usa, ciascuno con un conteggio. Nascondi su una riga nasconde quella classe, etichetta o coppia di relazioni (un solo annullamento revoca tutto); gli elementi nascosti restano nello schema e vengono mostrati di nuovo nella loro pagina o nel loro dialogo.
Pagina della classe
Fare clic su una classe nella barra laterale per aprirne la pagina. Dall'alto in basso:
- Percorso delle classi padre. Fare clic su una per aprirla.
- Intestazione: icona e nome della classe, chip Astratta e Nascosta, ✎ Modifica classe, + Sottoclasse ed Elimina. N entità nel progetto › apre il Database filtrato sulla classe.
- Scheda Descrizione: la descrizione, i chip Id N, Attributi N (con “(k ereditati)” quando alcuni provengono dalle classi padre), Relazioni N ed Entità N, e le Sottoclassi.
- Scheda Attributi: + Attributo e una tabella con queste colonne:
- I controlli di ordinamento degli attributi propri della classe: trascinare la riga, oppure ↑ / ↓ (un solo annullamento revoca ogni spostamento).
- Nome, Tipo (il nome del tipo; puntarvi sopra per l'id memorizzato).
- Dettagli: scelte e valore predefinito.
- Definito su: “questa classe” o la classe antenata.
- Descrizione.
- Azioni, per gli attributi definiti in questa classe: ✎ (Modifica attributo), ⊘ / 👁 (Nascondi attributo / Mostra attributo) e × (Rimuovi attributo).
- Scheda Relazioni: + Relazione e una tabella con entrambe le direzioni: Relazione, Altre classi, Torna a questa classe (il nome inverso, e + su <classe> per un'altra classe a cui manca l'inversa) e Descrizione. In Altre classi, × rimuove una relazione definita in questa classe. Quelle ereditate mostrano “(ereditato da X)”.
- Scheda Etichette: le etichette disponibili per la classe.
*contrassegna le etichette disponibili per tutte le classi.
Finestra di dialogo Modifica classe
Intitolato Crea nuova classe o Modifica classe — X. Campi: Nome, Descrizione, Padre ((nessuna — livello superiore) o una classe), Nascosta, Astratta e Colore. Fare clic su Crea classe o Salva classe.
Una classe integrata che ha entità non può cambiare la classe padre: “Degli elementi usano questa classe integrata, quindi la sua classe padre è fissa.”
Finestra di dialogo dell'attributo
Intitolato Nuovo attributo o Modifica attributo — X. Per un attributo di relazione, il titolo aggiunge “(relazione “…”)”. Fare clic su Aggiungi attributo o Salva.
- Nome e Tipo (raggruppati: Testo, Numeri, Data e ora, Scelte, Collegamenti, Speciali). Non c'è un campo di ordinamento: un nuovo attributo va in fondo.
- Valori consentiti (uno per riga): solo per Uno da un elenco e Più da un elenco. Le righe vuote e i valori ripetuti vengono eliminati. Un elenco richiede almeno due valori: “Un'enumerazione richiede almeno due scelte. Aggiungere un'altra scelta.” (“Una selezione multipla …” per Più da un elenco). Un attributo che ha già un solo valore si salva comunque finché il suo elenco resta invariato. Per Uno da un elenco, dopo l'elenco segue un quadratino di colore per ogni valore.
- Valore predefinito: non per FILE, COMPUTABLE, QUALITY, HTML e USER_TEAM.
- Descrizione.
Pagina Relazioni
Fare clic su Relazioni nella barra laterale per vedere tutte le coppie di relazioni. La pagina ha + Relazione e una tabella con queste colonne:
- Relazione e Inversa.
- Origine → Destinazione: ogni coppia di classi consentita.
- Attributi: ✎ per ogni attributo, e + Attributo.
- Usato: il numero di relazioni.
- Descrizione.
- ✎ (Modifica relazione) e × (Elimina relazione).
Il dialogo della relazione è intitolato Nuova relazione o Modifica relazione — X. Contiene Nome, Nome inverso, Descrizione, Descrizione inversa, Nascosta e Colore (o Colore predefinito). I diagrammi Spider disegnano la relazione in questo colore; un diagramma può comunque scegliere un proprio colore per ogni relazione. La colonna Relazione mostra il colore come campione. In modifica elenca anche gli attributi della relazione, con + Aggiungi attributo. Fare clic su Crea relazione o Salva.
Pagina Etichette
Fare clic su Etichette nella barra laterale per vedere tutte le etichette. La pagina ha Aggiungi etichette DoDAF e Aggiungi etichette UAF (le etichette del framework che mancano a questo progetto; vengono aggiunte anche al primo prodotto DoDAF o alla prima vista UAF), + Nuova etichetta e una tabella in ordine ad albero con queste colonne:
- Etichetta.
- Si applica a: chip delle classi o “Tutte le classi”.
- Entità: il conteggio.
- Descrizione.
- Azioni: ✎ (Modifica etichetta), ⊖ (Rimuovi questa etichetta da tutte le entità, mostrato quando è in uso) e × (Elimina etichetta). Un solo annullamento rimette un'etichetta su tutte le entità da cui era stata tolta; con più di 5.000 entità compare la scheda di avanzamento.
Il dialogo dell'etichetta è intitolato Crea nuova etichetta o Modifica etichetta — X. Contiene Nome, Descrizione, Padre ((nessuno) o un'etichetta), Classi (nessuna selezionata: tutte le classi) e Nascosta. Fare clic su Crea etichetta o Salva etichetta.
Pagina Flusso di lavoro
Fare clic su Workflow nella barra laterale. La pagina indica “Impostare quali cambi di valore consente un attributo di enumerazione (come Status).”
La pagina indica “Impostare gli stati di una classe e quali passaggi tra di essi sono consentiti o richiedono approvazione.”
Aggiungi una classe… elenca le classi che hanno un attributo di enumerazione e nessun workflow. Osserva Status quando la classe lo ha. Ogni classe con workflow ha una scheda con:
- Il chip della classe, osserva e l'attributo osservato. Cambiarlo chiede conferma quando il workflow ha transizioni.
- Rimuovi: rimuove il workflow della classe. I valori degli elementi restano.
- Stati: una tabella di Stato (contrassegnato integrato o (ritirato)), Elementi (il conteggio) e ↑, ↓, Rinomina…, Rimuovi… o Ritira…, oppure Ripristina. Sotto, Nuovo stato e + Aggiungi stato. Una sottoclasse con un attributo ereditato indica “Stati propri di X; Y è ereditato.”
- Transizioni: + Aggiungi transizione aggiunge “Nuova transizione” da (Iniziale — nessun valore) al primo stato. Una tabella: Nome, Da, A, Approvazione e un menu ⋯ con Blocca l'elemento dopo questa transizione ed Elimina transizione (anche con clic destro sulla riga, o ⇧F10 / Shift+F10 su di essa). Nome, Da e A appaiono come testo; fare clic su uno di essi (o premere Enter o F2) per modificarlo. Senza transizioni la scheda indica “Nessuna transizione: ogni stato può seguire qualsiasi altro.”
Nel servizio ospitato, solo i proprietari del progetto modificano i workflow; gli altri vedono la pagina in sola lettura con “Solo i proprietari del progetto modificano i workflow.”
Come le modifiche allo schema influiscono sui dati esistenti
Consultare questa tabella prima di modificare un elemento dello schema che ha già dati.
| Modifica | Effetto su entità e relazioni |
|---|---|
| Rinominare una classe, un attributo, una relazione o un'etichetta | I dati vengono mantenuti, perché tutto è memorizzato per id. Le query salvate, il testo di ricerca e i titoli di colonna che usano il vecchio nome smettono di corrispondere. Aggiornarli. |
| Cambiare la classe padre di una classe | Negli editor, la classe acquisisce gli attributi e le destinazioni della nuova classe padre e perde quelli della precedente. I valori memorizzati restano. Non consentito per una classe integrata che ha entità. |
| Contrassegnare una classe come astratta o nascosta | Le entità esistenti restano. La classe non viene più proposta per nuove entità o per Cambia classe. |
| Eliminare una classe | Consentito solo quando la classe non ha sottoclassi né entità. I suoi attributi e destinazioni vengono rimossi. Le etichette la tolgono dal loro elenco di classi. |
| Aggiungere un attributo | Le entità esistenti non hanno valore. Le nuove entità ricevono il Valore predefinito. |
| Cambiare il tipo di un attributo | Ogni valore di quell'attributo viene cancellato, dopo la conferma. |
| Rimuovere una scelta | Le entità mantengono il vecchio valore. L'editor non lo propone più. |
| Nascondere un attributo | I valori vengono mantenuti ma non mostrati, cercati né esportati finché l'attributo non viene mostrato di nuovo. |
| Rimuovere un attributo | Il suo valore viene cancellato su ogni entità e relazione, dopo la conferma. |
| Aggiungere una destinazione | La relazione diventa disponibile tra quelle classi (e le loro sottoclassi). |
| Rimuovere una destinazione | Le relazioni esistenti restano, anche se lo schema non le consente più. La regola Global.9 dei Controlli del modello le elenca. |
| Eliminare una relazione | Vengono rimossi la coppia di relazioni, le sue destinazioni e ogni relazione che la usa. |
| Eliminare un'etichetta | Viene rimossa da ogni entità. Le sue etichette figlie passano all'etichetta padre. |
| Importa schema (Unisci) | Aggiunge classi, relazioni, destinazioni, attributi ed etichette mancanti per nome. Nulla di esistente viene modificato o rimosso. |
| Aggiungi nuovi elementi integrati | Aggiunge le classi, le relazioni, gli attributi e le etichette dello schema predefinito che mancano per nome, con i loro id predefiniti. Vengono aggiunte le destinazioni per le classi e le relazioni aggiunte, più le destinazioni LML 2.0 tra classi esistenti; i valori di Decision Status di LML 2.0 vengono accodati. Nulla di esistente viene modificato o rimosso. |
| Importa schema (Sostituisci) o Ripristina predefinito | Lo schema viene sostituito. I dati delle entità restano, ma i valori degli attributi che non esistono più non vengono mostrati. Le estensioni integrate vengono aggiunte di nuovo alla successiva apertura del progetto. |
Ogni modifica si può annullare con un solo annullamento, e ⌘Z / Ctrl+Z ripristina lo schema insieme agli eventuali dati che ha rimosso.
Estensioni predefinite
Holarch aggiunge questi elementi a ogni progetto all'apertura, perché le sue funzioni ne hanno bisogno.
- Vengono abbinati per nome, senza distinguere maiuscole e minuscole.
- Vengono aggiunti solo se mancano, e non vengono mai rinominati né rimossi.
- Le modifiche apportate a essi vengono mantenute.
| Classe | Attributi aggiunti |
|---|---|
| Requisito | Priority e Criticality (High, Medium, Low), Owner, Source, TBD/TBR (None, TBD, TBR), TBD Owner, TBD Due Date, Verification Method (selezione multipla: Analysis, Demonstration, Inspection, Test), Verification Level (Component, Subsystem, System), Success Criteria |
| Risk | Owner, Handling Strategy (Accept, Avoid, Transfer, Mitigate, Watch), Residual Probability, Residual Consequence, Need-by Date, Trigger, Closure Rationale; Status acquisisce le scelte Mitigating e Watch |
| Test Case | Tested By, Test Date, Configuration, Test Article, Test Evidence (file) |
| Compito | Board Column (enumerazione), aggiunto quando si crea o si converte una bacheca Kanban con nomi di colonna propri. I suoi valori sono i nomi delle colonne. |
| Input/Output | Data Rate, Data Rate Units, Protocol/Format, Message/Data Definition |
| Conduit | Connector/Pins, Medium, Owner, Interface Status (Draft, Proposed, Agreed, Baselined), TBD/TBR (None, TBD, TBR) |
| Port | Conjugated |
| Misura | Weight, Improvement Direction (N/A, Positive, Negative), Scoring Method (Direct 1-10, Direct 1-5, Linear, Thresholds), Score Thresholds, Current Estimate |
| Decisione | Status (Open, In Analysis, Decided, Deferred, Superseded), Decision Date, Decided By |
| Caratteristica | Units |
| Asset | Quantity |
Etichette aggiunte: Stakeholder Need e Interface Requirement (Requirement), Interface Block (Asset, sotto Block), Trade Study e Whiteboard (Artifact), Criteria e TPM (Measure).
Destinazioni di relazione aggiunte: Decision alternative Asset, Action, Artifact, Resource, Statement e Requirement, con l'inversa alternative of.
Le pagine dei framework (DoDAF e UAF) creano le etichette usate dai loro prodotti la prima volta che si aggiunge un prodotto di quel tipo.
Scorciatoie da tastiera
| Tasto | Dove | Azione |
|---|---|---|
| Enter | Campo Valori consentiti nel dialogo dell'attributo | Iniziare la scelta successiva (una per riga) |
| ⌘ / Ctrl/Ctrl+clic | Elenco Classi nel dialogo dell'etichetta | Selezionare più classi |
| ⌘ / Ctrl+Z / ⌘ / Ctrl+Shift+Z | Ovunque | Annullare / ripetere una modifica dello schema |
Opzioni e impostazioni
- Lo schema del progetto è memorizzato nel progetto e condiviso con ogni membro che può aprirlo.
- I membri con il ruolo di lettore non possono modificarlo (“Sola visualizzazione: chiedere a un proprietario l'accesso in modifica.”).
- I file di Esporta schema usano il formato
holarch-schemae contengono le classi, le relazioni, gli attributi, le etichette e il workflow.
Messaggi
| Messaggio | Significato e soluzione |
|---|---|
| “Inserire un nome di classe.” | Il nome della classe è vuoto. |
| “Il nome della classe è troppo lungo; abbreviarlo.” | I nomi di classi ed etichette sono limitati a 100 caratteri. |
| “I nomi delle classi non possono contenere : " ( ) < o >. Nelle ricerche questi caratteri hanno un significato.” | Rimuovere quei caratteri. Altre lettere, cifre, spazi e segni di punteggiatura sono consentiti. I nomi di classe esistenti restano validi. |
| “Un'altra classe usa già questo nome. Sceglierne uno diverso.” | I nomi delle classi sono univoci (senza distinzione tra maiuscole e minuscole). |
| ““X” è una parola chiave di ricerca (come in x:…). Scegliere un altro nome di classe.” | Le chiavi di ricerca (class, label, name, number, description, is, relationship, in, under, diagram, id, order) e AND, OR, NOT non possono dare il nome a una classe, perché una ricerca leggerebbe la classe come quella chiave. |
| “Con quella classe padre questa classe diventerebbe antenata di se stessa.” | Scegliere una classe padre al di fuori del sottoalbero della classe. |
| “Questa classe ha sottoclassi. Eliminarle o spostarle prima sotto un'altra classe padre.” | Una classe con sottoclassi non si può eliminare. |
| ““X” (o una sottoclasse) ha N entità. Cambiarne prima la classe o eliminarle, oppure nascondere la classe.” | Una classe con entità non si può eliminare. |
| “Inserire un nome di attributo.” | Il nome dell'attributo è vuoto. |
| “Il nome dell'attributo contiene caratteri non consentiti.” | Usare lettere, cifre, spazi e _ - $ ( ) . , /. |
| “Name, Number e Description sono integrati; scegliere un altro nome di attributo.” | Sono campi dell'entità, non attributi. |
| “Qui esiste già un attributo con questo nome.” | La classe, una classe padre o una sottoclasse lo ha già. |
| “Aggiungere almeno una scelta.” | ENUMERATION e MULTISELECT richiedono delle scelte. |
| “Inserire un nome di etichetta.” / “Il nome dell'etichetta contiene caratteri non consentiti.” / “Un'altra etichetta usa già questo nome.” / “Un'etichetta non può stare dentro se stessa. Scegliere un'altra etichetta padre.” | Controlli del dialogo dell'etichetta. Le etichette possono usare anche & e '. |
| “Inserire un nome di relazione e un nome inverso.” / “Il nome della relazione e il nome inverso devono essere diversi.” / “Esiste già una relazione chiamata “X”.” | Controlli del dialogo della relazione. |
| “Non è un file JSON.” / “Questo file non è uno schema: richiede classi, relazioni, attributi ed etichette.” | Importa schema… richiede un file JSON di schema o di progetto. |
| “Schema unito: N elementi aggiunti” / “Schema sostituito” | Importazione completata. |
| “Nessuna classe di workflow. Scegliere una classe con Aggiungi una classe… per definirne le transizioni di stato.” | Non è ancora definito alcun workflow. |
Prima di una modifica distruttiva, una conferma indica la conseguenza:
| Conferma | Testo |
|---|---|
| Rimuovi attributo | “N entità hanno un valore che verrà cancellato.” |
| Cambia tipo e cancella valori | “N entità hanno un valore “X”. Cambiare il tipo da A a B cancella quei valori.” |
| Elimina classe | “Eliminare la classe “X” con i suoi attributi e le sue destinazioni?” |
| Rimuovi destinazione (× in Altre classi) | “N relazioni esistenti restano, anche se lo schema non le consente più.” |
| Elimina relazione | “Vengono rimosse anche N relazioni che la usano.” |
| Elimina etichetta | “Viene rimossa da N entità.” |
| Rimuovi etichetta dagli elementi | “Rimuovere “X” da N entità?” |
| Ripristina schema | “Classi, attributi, relazioni ed etichette personalizzati vengono rimossi dallo schema (i dati delle entità restano; è possibile annullare).” |
Limiti
- Nomi di classi ed etichette: 100 caratteri.
- Nomi degli attributi creati dalle importazioni: 80 caratteri.
- Un attributo osservato per classe.
- Le transizioni semplici vengono applicate dagli editor degli attributi, dalle celle della griglia e dalla bacheca Kanban. Le transizioni con approvazione rifiutano anche le modifiche dirette e in blocco. I nuovi elementi si possono creare in qualsiasi stato.
- Blocca si applica agli elementi LML. Gli elementi SysML v2 non vengono bloccati.
- Nomi degli stati: 100 caratteri.
- Unisci non aggiunge nuove scelte a un attributo già esistente; aggiungerle nel dialogo dell'attributo.
- Aggiungi nuovi elementi integrati… compare solo dopo aver riaperto la pagina, una volta che lo schema è diventato personalizzato.
Correlati
- Modello e Database: entità, editor degli attributi, query e modifiche in blocco.
- Requisiti: gli attributi dei requisiti, i controlli di qualità e le approvazioni.
- Tracciabilità: come le relazioni alimentano la matrice e i controlli di copertura.
- Importazione ed esportazione: mappatura degli attributi e schema nei file di scambio.
- Guida: Schema, Nozioni di base su LML.