Holarch

Verifica

Controlli del modello

Eseguire 75 controlli basati su regole e i propri set di regole sull'intero modello, restringere i rilievi per gravità, classe, regola ed etichetta, correggerli sul posto, ignorare quelli voluti e impostare quanto è rigida ogni regola.

Come usarlo →

In questa pagina
  1. Panoramica
  2. Concetti
  3. Come usarlo
    1. Esaminare i rilievi
    2. Concentrarsi su un'area
    3. Rivedere insieme i rilievi di un elemento
    4. Esempio pratico: la demo CubeSat EO-1
    5. Scrivere una propria regola
    6. Controllare un budget di massa con le unità
    7. Condividere regole con un altro progetto
    8. Suggerimenti
  4. La pagina
    1. Intestazione della pagina
    2. Riga di intestazione
    3. Barra degli strumenti
    4. Facet
    5. Rilievi
    6. Correzioni
  5. Impostazioni
  6. Set di regole
    1. Il dialogo Set di regole
    2. L'editor delle regole
    3. Regole con espressione
    4. File dei set di regole
  7. Regole
    1. Regole della linea di prodotti
  8. Messaggi
  9. Limiti
  10. Correlati

Panoramica

Verifica → Controlli del modello esegue un catalogo di regole su ogni elemento del progetto ed elenca ciò che trova ciascuna regola. Le regole cercano le lacune che rendono un modello difficile da considerare affidabile o da rivedere: nomi e numeri mancanti, elementi isolati, azioni che nessuno esegue, interfacce che non trasportano nulla, requisiti non allocati o non verificati, rischi senza un piano di trattamento e misure che non raggiungono la loro soglia.

I controlli vengono eseguiti di nuovo ogni volta che il modello cambia, quindi la pagina, la scheda Controlli del modello nella Home e il badge su Verifica concordano sempre.

Concetti

  • Regola: un controllo con un numero (per esempio Requirement.10), un titolo che indica che cosa trova, una descrizione di come si presenta un buon modello e una correzione. Le regole sono raggruppate per la classe che controllano: Global (ogni elemento), Action, Asset, Conduit, Input/Output, Requirement, Risk, Test Case e Measure.
  • Rilievo: un elemento che viola una regola. Un rilievo può indicare elementi correlati, per esempio i duplicati di un nome o i figli di un elemento padre.
  • Gravità: ogni regola segnala come Errore o Avviso, oppure è impostata su Ignora e non viene eseguita. Il valore predefinito è Avviso, tranne per le regole LML 2.0 Global.10 e Global.11 in un progetto la cui copia dello schema è anteriore a LML 2.0 (vedere Regole).
  • Rilievo ignorato: un rilievo accettato per un elemento. Non conta più, e Mostra ignorati lo elenca con Ripristina.
  • Controllo applicabile: una regola eseguita su almeno un elemento della sua classe. La riga di intestazione conta quanti controlli applicabili non hanno rilievi.
  • Set di regole: un gruppo con nome di regole proprie, memorizzato nel progetto e attivato o disattivato nel suo insieme. Le sue regole vengono eseguite con i controlli integrati e i loro rilievi usano lo stesso elenco, Correggi e Ignora. Vedere Set di regole.

Come usarlo

Eseguire i controlli prima di ogni revisione, dopo un'importazione di grandi dimensioni e ogni volta che la Home mostra errori dei controlli del modello. Rispondono a una sola domanda: che cosa, nel modello, richiede attenzione prima che qualcun altro lo legga?

Esaminare i rilievi

  1. Aprire Verifica → Controlli del modello. La riga di intestazione mostra, per esempio, “84% dei controlli applicabili superati”, seguito dal numero di errori e avvisi e dalla variazione rispetto all'ultima esecuzione.
  2. L'elenco è raggruppato per regola, prima gli errori. Fare clic sul titolo di una regola per aprirla; la sua descrizione spiega perché la regola è importante.
  3. Per ogni rilievo, fare clic su Correggi. Il dialogo di correzione mostra l'elemento, la regola e la correzione suggerita: un campo da compilare, relazioni da aggiungere, duplicati da unire o un pulsante che apre l'elemento o il suo diagramma.
  4. Salvare la correzione. Il rilievo scompare e i conteggi si aggiornano.
  5. Quando un rilievo è voluto (per esempio un'azione riutilizzata sotto due elementi padre), fare clic su Ignora.

Concentrarsi su un'area

  1. Nei facet a sinistra, spuntare Errori in Gravità per vedere solo gli errori.
  2. Spuntare una classe in Classe (la classe dell'elemento con il rilievo), una regola in Regola o un'etichetta in Etichetta. Le spunte in un facet si combinano con OR; i facet si combinano con AND. Ogni valore mostra quanti rilievi ha.
  3. Digitare in Filtra rilievi per cercare il nome di un elemento o il titolo di una regola.
  4. Fare clic su Cancella facet per mostrare di nuovo tutto.

Rivedere insieme i rilievi di un elemento

  1. Scegliere Raggruppa per entità accanto al filtro.
  2. Ogni elemento è elencato una volta con tutti i suoi rilievi, in ordine di numero. Un elemento con un errore mostra un badge Errore nel titolo.

Esempio pratico: la demo CubeSat EO-1

  1. Aprire il progetto demo CubeSat EO-1 e andare in Verifica → Controlli del modello.
  2. Spuntare Requirement in Classe. Le regole rimaste mostrano quali requisiti non hanno un elemento padre, un'allocazione (Requirement.8) o un caso di test che li verifica (Requirement.10).
  3. Aprire Requirement.10, fare clic su Correggi su un rilievo e collegare il caso di test che lo verifica. Il rilievo esce dall'elenco e la percentuale della riga di intestazione sale.
  4. Scegliere Raggruppa per entità per vedere insieme tutti i rilievi rimasti di un requisito.

Scrivere una propria regola

  1. Fare clic su Set di regole… nell'intestazione della pagina, quindi su + Nuovo set di regole. Dare un nome al set, per esempio “Regole del programma”, e fare clic su OK.
  2. Sotto il set, fare clic su + Aggiungi regola. L'editor delle regole si apre con l'ID R1.
  3. Digitare un Nome che indichi che cosa trova la regola, per esempio “Requisiti senza un caso di test che li verifica”.
  4. In Si applica a, scegliere Requirement.
  5. In Segnala un elemento quando, scegliere Manca una relazione, quindi scegliere verified by in Relazione.
  6. Impostare Gravità su Errore e scrivere il Messaggio, per esempio “Collegare il caso di test che verifica il requisito.”
  7. Leggere l'anteprima sotto i campi, per esempio “Al momento segnala 3 elementi: SYS-2 Top Speed, …”. Fare clic su Salva.
  8. Fare clic su Chiudi. I rilievi della regola compaiono nell'elenco sotto R1, prima gli errori. Fare clic su Correggi per collegare un caso di test; il rilievo esce dall'elenco.

Controllare un budget di massa con le unità

  1. Nella demo CubeSat EO-1, aprire Set di regole…, fare clic su + Nuovo set di regole e chiamarlo “Budget di massa”.
  2. Fare clic su + Aggiungi regola. Chiamarla “Assiemi oltre la loro allocazione di massa” e scegliere Asset in Si applica a.
  3. In Segnala un elemento quando, scegliere Un totale di valori correlati confrontato con un valore. Impostare Funzione su Totale, Relazione su decomposed by, Valore di ogni elemento correlato su Mass, Confronto su è maggiore di e Confronta con su Mass Allocation.
  4. Impostare Gravità su Errore e fare clic su Salva, quindi su Chiudi.
  5. Viene elencato un assieme le cui parti pesano più della sua allocazione, per esempio “Total Mass of “decomposed by” 2.34 kg is more than Mass Allocation 1.35 kg”. Le masse in grammi e in chilogrammi si sommano; una massa inserita in metri viene elencata come “Impossibile sommare massa e lunghezza: le dimensioni sono diverse (kg vs m).”

Condividere regole con un altro progetto

  1. In Set di regole…, fare clic su Esporta accanto al set. Viene scaricato un file con un nome come program-rules.holarch-rules.json.
  2. Nell'altro progetto, aprire Set di regole…, fare clic su Importa…, poi su Scegli file… (o incollare il testo del file) e fare clic su Importa.
  3. Per condividere tramite una libreria, tenere i set di regole nel progetto della libreria e pubblicare un rilascio. In un progetto che usa la libreria, fare clic su Da libreria…, spuntare i set e fare clic su Copia.
  4. Quando la libreria pubblica un rilascio più recente con il set, Set di regole… mostra “È disponibile una versione più recente” accanto alla copia. Fare clic su Aggiorna…, rivedere le modifiche, scegliere Mantieni la mia o Usa quella della libreria per ogni regola modificata in entrambi i punti e fare clic su Aggiorna. Le altre modifiche fatte alla copia vengono mantenute.

Suggerimenti

  • Impostare su Errore in Impostazioni le regole che il team considera bloccanti, in modo che la Home le elenchi come problemi.
  • Ignorare un rilievo solo quando è voluto, e spiegarne il motivo nella descrizione dell'elemento o in un commento. Mostra ignorati permette ai revisori di vedere che cosa è stato accettato.
  • Un lungo elenco di rilievi sui nomi dopo un'importazione di solito si corregge più rapidamente modificando i nomi nel Database.
  • Eseguire i controlli prima di salvare una baseline, in modo che la baseline non contenga lacune note.

La pagina

ControlloChe cosa fa
Esporta…Apre il dialogo Esporta con Findings (CSV): ogni rilievo non ignorato, con regola, gravità, titolo, id dell'elemento, numero, nome, classe, nota ed elementi correlati.
ImpostazioniImposta la gravità di ogni regola e i figli per livello (vedere Impostazioni).
↻ Esegui controlliEsegue di nuovo tutti i controlli e registra i conteggi come ultima esecuzione.

Riga di intestazione

  • “N% dei controlli applicabili superati”: rosso quando un rilievo è un errore, ambra quando ci sono solo avvisi, verde quando non c'è nulla da correggere.
  • Il numero di rilievi, errori e avvisi.
  • La variazione rispetto all'ultima esecuzione su questo dispositivo, per esempio “3 rilievi in meno rispetto all'ultima esecuzione.” L'ultima esecuzione viene registrata quando si apre o si lascia la pagina e quando si fa clic su ↻ Esegui controlli. La prima visita indica “Prima esecuzione su questo dispositivo.”

In un progetto di grandi dimensioni i controlli vengono eseguiti in background, così la pagina resta utilizzabile: la prima visita mostra “Esecuzione dei controlli del modello…”, le visite successive mostrano i rilievi precedenti finché i nuovi non sono pronti, e una scheda di avanzamento mostra un'esecuzione che dura più di un secondo.

Barra degli strumenti

  • Raggruppa per regola (predefinito) o Raggruppa per entità. La scelta viene ricordata su questo dispositivo.
  • Filtra rilievi: cerca nei nomi degli elementi, nei numeri e nei titoli delle regole.
  • Espandi tutto e Comprimi tutto aprono o chiudono tutti i gruppi.

Facet

FacetValori
GravitàErrori, Avvisi
ClasseLa classe di ogni elemento con un rilievo
RegolaOgni regola con un rilievo, per numero e titolo
EtichettaOgni etichetta su un elemento con un rilievo
IgnoratoMostra ignorati aggiunge all'elenco i rilievi ignorati, contrassegnati come Ignorato, con Ripristina

I conteggi seguono gli altri facet e il filtro, quindi mostrano che cosa resterebbe spuntando un valore.

Rilievi

Ogni rilievo mostra l'elemento (o, raggruppando per entità, la regola), la nota (per esempio “Parole vaghe: adequate, TBD” o “14 figli”), gli elementi correlati e i pulsanti Correggi e Ignora, oppure Ripristina per un rilievo ignorato. Un solo annullamento revoca un Ignora o un Ripristina.

Correzioni

CorrezioneUsato daChe cosa fa
Modifica un campoNome, numero o descrizione mancanti; controlli su verbi e sostantiviApre il campo con il valore corrente.
Maiuscola inizialeNomi in minuscoloPropone il nome con la prima lettera maiuscola.
Aggiungi relazioniPadre, esecutore, input, output, condotti, norme e tracciamenti mancantiElenca gli elementi che lo schema consente per la relazione; spuntarli e fare clic su Aggiungi relazioni.
UnisciNomi simili, figli uniciMantiene un elemento, sposta su di esso ogni relazione degli altri, combina le descrizioni ed elimina gli altri (un solo annullamento revoca tutto).
Elimina correlatiAzioni con un input prodotto dopo l'usoElimina gli input/output che vengono consumati prima di esistere.
Aggiungi traced toRequisiti che nominano entità non correlateAggiunge traced to dal requisito a ogni elemento che il suo testo nomina.
Crea IssueCasi di test falliti senza issue collegataCrea una Issue collegata al caso di test e ai requisiti che verifica.
AperturaElenchi di figli lunghi, scambi, norme, soglie, relazioni non consentite dallo schemaApre l'elemento o il suo diagramma.
Apri vista UAFViste UAF che non possono essere mostrateElenca le viste della radice con i loro problemi e apre la prima.

Impostazioni

  • Figli per livello: Action.9 e Asset.9 segnalano un padre con più figli di questo numero. Il valore predefinito è 9, dalla linea guida secondo cui le persone gestiscono circa 7 ± 2 elementi per livello. I valori consentiti vanno da 2 a 99; un altro valore mostra “I figli per livello devono essere un numero intero da 2 a 99.”
  • Gravità per regola: Errore, Avviso o Ignora. Una regola ignorata non viene eseguita.
  • Ripristina predefiniti riporta ogni regola al suo valore predefinito (Avviso; Requirement.11 Ignora; Global.10 e Global.11 Ignora in un progetto la cui copia dello schema è anteriore a LML 2.0) e i figli per livello a 9.

Le impostazioni sono memorizzate nel progetto, condivise con tutti i suoi membri e annullabili.

Set di regole

Set di regole… nell'intestazione della pagina apre il dialogo Set di regole. Le proprie regole vengono eseguite nei Controlli del modello insieme ai controlli integrati: i loro rilievi mostrano l'ID della regola (per esempio R1) e il nome, contano nella riga di intestazione, compaiono in Regola nei facet e usano Correggi, Ignora ed Esporta… come qualsiasi rilievo. I set di regole sono memorizzati nel progetto, condivisi con tutti i suoi membri, e ogni modifica è un unico passo di annullamento.

Il dialogo Set di regole

ControlloChe cosa fa
+ Nuovo set di regoleChiede un nome e aggiunge un set vuoto, attivato.
Importa…Aggiunge i set di regole di un file di set di regole: Scegli file… o incollarne il testo, quindi Importa. Ogni regola viene prima controllata; un file con un problema viene rifiutato e i problemi vengono elencati. Un nome già usato riceve “ (2)”.
Da libreria…Elenca i set di regole nei rilasci delle librerie usate da questo progetto; spuntarli e fare clic su Copia. La copia ricorda la sua libreria e il suo rilascio.
Aggiorna…Accanto a un set copiato quando la sua libreria ha pubblicato un rilascio più recente che contiene il set (“È disponibile una versione più recente”). Mostra in anteprima le regole aggiunte, modificate e rimosse nella libreria, le modifiche proprie che vengono mantenute e le regole modificate sia qui sia nella libreria; scegliere Mantieni la mia o Usa quella della libreria per ciascuna di esse, quindi fare clic su Aggiorna. Un solo annullamento revoca tutto.
Casella di controllo accanto a un setAttiva o disattiva il set. Un set disattivato non viene eseguito.
Rinomina…Rinomina il set.
EsportazioneScarica il set come file JSON di set di regole.
EliminaElimina il set e le sue regole dopo una conferma. Annulla li ripristina.
+ Aggiungi regola, Modifica, EliminaAggiungere una regola al set, modificarla o eliminarla.

Una regola che non può essere eseguita in questo progetto, per esempio una che nomina una classe o una relazione che lo schema non ha, mostra il problema in rosso sotto il suo nome e non segnala nulla.

L'editor delle regole

CampoChe cosa imposta
NomeIl titolo dei rilievi della regola: che cosa trova la regola.
IDBreve e univoco nel set, per esempio R1 o SYS-NUM; fino a 40 lettere, cifre, punti, trattini e trattini bassi.
Si applica aQualsiasi elemento, una classe (sottoclassi incluse: un Test Case è anche una Action) o, in un progetto SysML v2, un tipo di modello come Part o Requirement.
Solo elementi corrispondenti aFacoltativo: un filtro nel linguaggio di filtro del Database che restringe prima gli elementi, per esempio is:leaf.
Segnala un elemento quandoLa condizione, sotto.
GravitàErrore o Avviso.
MessaggioLa correzione da apportare, mostrata nel dialogo Correggi.

La riga sotto i campi indica quanti elementi la regola segnala in quel momento e nomina i primi cinque.

CondizioneCampiSegnala un elemento quando
Un attributo è vuotoAttributoL'attributo non ha valore.
Un attributo corrisponde a un modelloAttributo, Modello, Ignora maiuscole/minuscoleIl testo dell'attributo contiene una corrispondenza del modello, un'espressione regolare.
Un attributo non corrisponde a un modelloAttributo, Modello, Ignora maiuscole/minuscoleIl testo dell'attributo non ha corrispondenze, per esempio ^SYS-\d+$ per i numeri che devono iniziare con SYS-.
Manca una relazioneRelazione, Di elementi diL'elemento non ha un collegamento di quella relazione (verso elementi di quella classe).
È presente una relazioneRelazione, Di elementi diL'elemento ha un collegamento di quel tipo.
Gli elementi correlati sono almeno NRelazione, Di elementi di, NL'elemento ha N o più elementi correlati, per esempio più di 9 figli.
Gli elementi correlati sono al massimo NRelazione, Di elementi di, NL'elemento ha N o meno elementi correlati.
Un valore è fuori da un intervalloAttributo, Minimo, Massimo, UnitàIl numero dell'attributo è sotto il minimo o sopra il massimo. Lasciare vuoto un limite per un intervallo aperto.
Un valore è all'interno di un intervalloAttributo, Minimo, Massimo, UnitàIl numero dell'attributo è nell'intervallo, limiti inclusi.
Un totale di valori correlati confrontato con un valoreFunzione, Relazione, Di elementi di, Valore di ogni elemento correlato, Confronto, Confronta conIl Totale, il Minimo o il Massimo di un valore sugli elementi correlati (o il Numero di elementi) è maggiore, almeno uguale, minore, al massimo uguale, uguale o diverso rispetto a un attributo dell'elemento (per esempio Mass Allocation) o a un valore con la sua unità (12 kg). Gli elementi correlati senza il valore vengono saltati.
Un'espressione corrispondeEspressioneL'elemento corrisponde all'espressione.

Gli attributi si indicano come sull'elemento: Nome, Number e Descrizione (in un progetto SysML v2 Short Name e Documentazione) o qualsiasi attributo della classe. In un progetto SysML v2 si può indicare anche un attribute usage dell'elemento, come mass. Un elemento la cui classe non ha tale attributo viene saltato. I valori di un elemento LML includono anche le characteristic da cui è specified by (una characteristic Mass con Value 2.4 e Units kg si legge come 2.4 kg) e le sue allocazioni di budget (Mass Allocation, da Budget). Senza Unità, un intervallo legge il numero iniziale del valore (1,500 kg e 1500 [kg] si leggono come 1500) e salta i valori che non sono numeri. Con un'Unità come kg, i valori vengono prima convertiti (25000 g si legge come 25 kg), e un valore di un'altra grandezza, come 3 m, è un rilievo a sé: “Impossibile confrontare lunghezza e massa: le dimensioni sono diverse (m vs kg).” I totali e le espressioni convertono le unità nello stesso modo e segnalano una mancata corrispondenza nello stesso modo, mai come un confronto silenzioso.

Regole con espressione

Un'espressione si scrive nel linguaggio di filtro della barra dei filtri del Database, quindi un filtro che lì trova gli elementi problematici funziona come regola: ogni elemento corrispondente viene segnalato. Esempi:

EspressioneReport
class:Requirement is:leaf NOT relationship:"verified by"Requisiti foglia che nessun caso di test verifica.
class:Requirement Requirement:"Status=Draft"Requisiti ancora in Draft.
class:Action is:root NOT relationship:"performed by"Azioni di primo livello che nulla esegue.
class:Asset (name:%TBD% OR description:TBD)Asset con TBD nel nome o nella descrizione.
class:Asset value:"sum(decomposed by → Mass) > Mass Allocation"Assiemi le cui parti pesano più della loro allocazione, con qualsiasi combinazione di unità.

Aritmetica con unità: value:"Mass * 1.1 <= 12 kg" o value:"sum(decomposed by → Mass) > Mass Allocation" confronta valori dell'elemento e totali sui suoi elementi correlati (sum, min, max, count), con +, -, *, /, parentesi e unità dopo i numeri (12 kg, 9.81 [m/s^2]). Anche i confronti di attributi con un'unità, come Asset:"Mass>2 kg", vengono convertiti.

Termini: testo libero, name: (% corrisponde a qualsiasi testo), number: (* corrisponde a qualsiasi testo), description:, class:, label:, relationship:"…", status:, id:, under:"<number>", is:root, is:leaf, is:orphan, is:top, is:locked, is:diagram, confronti di attributi come Requirement:"Priority>=3" (=, ~ contiene, <, <=, >, >=; = senza valore significa vuoto), AND, OR, NOT e parentesi. Un termine che non nomina nulla nel progetto, come una classe sconosciuta, viene mostrato come problema.

File dei set di regole

Un file di set di regole è JSON con "format": "holarch-rule-set", "version": 1, un name, una description facoltativa e un elenco di rules, ciascuna con id, name, severity, message, un target facoltativo ({"class": "Requirement"}), un filtro where facoltativo e un check. Esportare un set per vederne la struttura esatta. Gli stessi file vengono eseguiti nei controlli del modello dell'API pubblica e dell'MCP. Funzionano anche nei progetti SysML v2: lì l'API e l'MCP eseguono solo i set di regole del progetto (le regole integrate vengono eseguite nell'app), e una regola sulle relazioni che Holarch ricava da connessioni e flussi (connected by, transfers, generates, receives) viene eseguita solo nell'app.

Regole

RegolaHeadingUn buon modello
Global.1Nomi uguali o quasi ugualiAll'interno di una classe, due entità non condividono lo stesso nome. I nomi vengono confrontati in qualsiasi lingua, ignorando maiuscole/minuscole, spaziatura, punteggiatura e larghezza dei caratteri (“ABS制御” equivale a “ABS制御”); le lettere accentate contano (“Größe” e “Grüße” sono diversi).
Global.2Nomi in minuscoloOgni nome di entità inizia con la maiuscola.
Global.4Numeri ripetuti in una classeAll'interno di una classe, ogni numero è univoco.
Global.5Parole vaghe in nomi o descrizioniNomi e descrizioni usano parole precise.
Global.6Entità senza relazioniOgni entità ha una relazione.
Global.7Valori dinamici che puntano a destinazioni mancantiValori dinamici, blocchi di matrice, tabelle dinamiche (tabelle, conteggi e totali) e riferimenti incrociati nelle descrizioni puntano a entità, documenti, classi, etichette, relazioni, figure e tabelle esistenti.
Global.8Viste UAF che non possono essere mostrateOgni vista UAF usa una radice, una classe e una relazione accettate dal suo tipo di vista.
Global.9Relazioni non consentite dallo schemaOgni relazione unisce classi che lo schema consente per quella relazione.
Global.10Entità senza nome né numeroOgni entità ha un nome o un numero.
Global.11Valori fuori dalle scelte del loro attributoOgni valore di enumerazione e di selezione multipla è una delle scelte del suo attributo, scelta una sola volta.
Action.1Nomi di azioni senza verbo inizialeOgni nome di Action inizia con un verbo.
Action.2Nomi di azioni in minuscoloOgni nome di Action inizia con la maiuscola.
Action.3Azioni senza nomeOgni azione ha un nome.
Action.4Azioni senza numeroOgni azione ha un numero.
Action.5Azioni senza descrizioneOgni azione ha una descrizione.
Action.6Azioni senza padre né figlioOgni azione ha un padre o un figlio.
Action.7Azioni con un solo figlioNessuna azione ha un solo figlio.
Action.9Azioni con più di 9 figliNessuna azione ha più di 9 figli.
Action.10Azioni con più padriNessuna azione ha più padri.
Action.11Azioni che nessun asset esegueQualche asset esegue ogni azione.
Action.12Azioni che non producono nullaOgni azione produce un input/output.
Action.13Azioni che non consumano nullaOgni azione consuma un input/output.
Action.14Azioni senza input né outputOgni azione consuma o produce un input/output.
Action.15Azioni che producono ma non consumano nullaOgni azione che produce output consuma anche un input.
Action.16Azioni che consumano ma non producono nullaOgni azione che consuma input produce anche un output.
Action.17Azioni con un input prodotto dopo l'usoNessuna azione riceve un input/output generato da un'azione successiva.
Action.18Azioni non tracciate a un requisitoOgni azione è tracciata a un requisito.
Action.19Cicli che non possono mai terminareOgni ciclo può terminare. Indica il ciclo e il ramo OR allo 0 % che ne blocca l'EXIT.
Asset.1Nomi di asset senza sostantivoOgni nome di asset è un sostantivo o un sintagma nominale.
Asset.2Nomi di asset in minuscoloOgni nome di asset inizia con la maiuscola.
Asset.3Asset senza nomeOgni asset ha un nome.
Asset.4Asset senza numeroOgni asset ha un numero.
Asset.5Asset senza descrizioneOgni asset ha una descrizione.
Asset.6Asset senza padre né figlioOgni asset ha un padre o un figlio.
Asset.7Asset con un solo figlioNessun asset ha un solo figlio.
Asset.9Asset con più di 9 figliNessun asset ha più di 9 figli.
Asset.10Asset con più padriNessun asset ha più padri.
Asset.11Asset che non eseguono alcuna azioneOgni asset esegue qualche azione.
Asset.12Asset non collegati da un condottoOgni asset è collegato da un condotto.
Asset.13Asset che si scambiano dati senza un condotto in comuneGli asset che si scambiano un input/output sono collegati da un condotto.
Asset.14Asset che interagiscono senza una norma in comuneGli asset che interagiscono fanno riferimento alla stessa norma.
Asset.15Asset che non scambiano nullaOgni asset scambia un input/output con un altro asset.
Conduit.1Nomi di condotti senza sostantivo inizialeOgni nome di condotto inizia con un sostantivo.
Conduit.2Condotti senza nomeOgni condotto ha un nome.
Conduit.3Condotti senza numeroOgni condotto ha un numero.
Conduit.4Condotti senza descrizioneOgni condotto ha una descrizione.
Conduit.5Condotti con più di due assetNessun condotto collega più di due asset.
Conduit.6Condotti con meno di due assetOgni condotto collega due asset.
Conduit.7Condotti senza una norma in comune con i propri assetUn condotto e gli asset che collega fanno riferimento alla stessa norma.
Conduit.8Condotti che non trasferiscono nullaOgni condotto trasferisce qualche input/output.
Conduit.9Condotti non tracciati a un requisitoOgni condotto è tracciato a un requisito.
IO.1Input/output senza nomeOgni input/output ha un nome.
IO.2Input/output senza numeroOgni input/output ha un numero.
IO.3Input/output senza descrizioneOgni input/output ha una descrizione.
IO.4Input/output con più padriNessun input/output ha più di un padre.
IO.5Input/output che nessuna azione produceQualche azione produce ogni input/output.
IO.6Input/output che nessuna azione consumaQualche azione consuma ogni input/output.
IO.7Input/output che nessuna azione usaOgni input/output è prodotto o consumato da un'azione.
IO.8Input/output che un'azione produce e consumaNessuna azione consuma un input/output che produce.
IO.9Input/output senza una norma in comune con i propri assetUn input/output e gli asset che lo scambiano fanno riferimento alla stessa norma.
IO.10Input/output non tracciati a un requisitoOgni input/output è tracciato a un requisito.
Requirement.1Requisiti che nominano entità non correlateUn requisito è correlato a ogni entità che nomina.
Requirement.2Requisiti foglia senza “shall”Ogni requisito foglia usa la parola “shall”.
Requirement.3Requisiti senza nomeOgni requisito ha un nome.
Requirement.4Requisiti senza numeroOgni requisito ha un numero.
Requirement.5Requisiti senza descrizioneOgni requisito ha una descrizione.
Requirement.6Requisiti senza padre né figliOgni requisito ha un padre o un figlio.
Requirement.7Requisiti con più padriNessun requisito ha più padri.
Requirement.8Requisiti foglia che nessuna entità di progetto soddisfaOgni requisito foglia è correlato a un Action, Asset, Input/Output o Conduit.
Requirement.9Requisiti soddisfatti da più input/outputNessun requisito è soddisfatto da più di un input/output.
Requirement.10Requisiti foglia senza caso di test di verificaOgni requisito foglia è verificato da un Test Case.
Requirement.11Requisiti fuori dai modelli EARSOgni requisito foglia con “shall” segue uno dei modelli EARS. Disattivato (Ignora) finché non se ne imposta la gravità.
Risk.1Rischi di livello massimo senza mitigazioneOgni rischio aperto al livello più alto della matrice dei rischi è mitigato da qualcosa.
Risk.2Accettazioni di pericoli precedenti a una modifica dei controlliNessuna accettazione del rischio residuo di un pericolo è anteriore a una modifica dei suoi controlli o della loro verifica.
TestCase.1Casi di test falliti senza issue collegataOgni Test Case fallito è collegato a una Issue.
Measure.1Measure che superano la sogliaIl valore previsto (o attuale) di ogni Measure rispetta la soglia.

Note sulle regole:

  • Le regole sulla scrittura dei requisiti citano la INCOSE Guide to Writing Requirements: parole vaghe (R7, termini vaghi; R8, clausole di salvaguardia), “shall” (R1, enunciati strutturati) e lettere maiuscole (R39, guida di stile). Il controllo completo della scrittura è Qualità dei requisiti.
  • Le regole Action e Asset saltano attività, casi di test, transizioni di stato, porte e risorse; le regole Global si applicano comunque a questi elementi.
  • Un elemento scomposto conta come eseguito, alimentato, produttivo o tracciato quando lo è uno qualsiasi dei suoi discendenti. Gli elementi che si scompongono a vicenda in un ciclo contano insieme.
  • Global.9 segnala ogni elemento una sola volta, con le altre estremità delle sue relazioni non consentite dallo schema e con la relazione e la classe nella nota, per esempio “Non consentita: decomposed by → Risk”. Una relazione conta come consentita quando lo schema la consente in una delle due direzioni. Queste relazioni restano dopo che una destinazione viene rimossa nell'Editor dello schema e possono arrivare con le importazioni.
  • Global.10 e Global.11 provengono da LML 2.0: un'entità è identificata da un nome o da un numero (§2.1), e un valore di enumerazione o di selezione multipla viene scelto dall'elenco del suo attributo (§2.5.6, §2.5.12). Global.11 mette nella nota tutti i problemi di un elemento, per esempio Status: "Pending" is not a choice o Verification Method: "Test" chosen twice. Entrambe vengono eseguite per impostazione predefinita dove lo schema ha gli elementi integrati di LML 2.0: lo schema predefinito, o la copia propria di un progetto dopo Schema → Aggiungi nuovi elementi integrati…. In un progetto con una copia dello schema più vecchia partono su Ignora, quindi un modello creato con LML 1.x mostra gli stessi rilievi di prima; impostarle su Avviso o Errore in Impostazioni per eseguirle. L'Editor dello schema chiede almeno due valori quando si crea o si modifica un elenco.
  • Le porte sono punti di interfaccia, non parti: non contano come figli, e un condotto su una porta conta per l'asset che la possiede.
  • I casi d'uso (Action con l'etichetta Use Case) sono esenti dalla regola sul verbo e dalle regole sugli input/output.
  • Requirement.11 controlla la frase che contiene “shall” rispetto ai sei modelli EARS (Scrivere con i modelli EARS) e indica la prima cosa da correggere, per esempio “Event-driven: Inserire una virgola dopo la condizione \"When\", prima del nome del sistema.” Le motivazioni e le note in altre frasi non vengono controllate.
  • I progetti SysML v2 eseguono 17 delle regole, con la terminologia SysML v2: Global.1, .2, da .4 a .8, Requirement da .2 a .5, .8, .10 e .11, Risk.1, TestCase.1 e Measure.1. Le regole Action, Asset, Conduit e Input/Output non si applicano; le diagnostiche dell'editor controllano nomi, tipi e struttura del modello. Le regole Requirement controllano i requirement usage: per esempio Requirement.8 diventa “Requisiti foglia che nulla soddisfa” (una parte o un'azione che lo soddisfa) e Requirement.10 “Requisiti foglia senza caso di verifica”. Global.1, .2 e .6 controllano gli elementi accanto al modello, come rischi, attività e documenti.

Regole della linea di prodotti

Quando un progetto ha una Feature o una Configuration, i Controlli del modello eseguono anche il set di regole integrato Linea di prodotti (regole da ProductLine.1 a ProductLine.11 e da 13 a 17, classe Linea di prodotti). Feature o configurazioni mancanti in Applies To (ProductLine.1), configurazioni che violano una regola o sono incomplete (ProductLine.3) e configurazioni Released con requisiti non verificati in esse (ProductLine.16) sono errori; le altre regole sono avvisi. ProductLine.10 e 11 controllano la completezza di ogni configurazione da Tutte le configurazioni. ProductLine.13 e 14 controllano le revisioni di un elemento (supersedes): due in vigore per la stessa unità, e unità senza nessuna. In una vista di configurazione ogni regola controlla quella configurazione. Vedere Linee di prodotti e configurazioni.

Messaggi

MessaggioSignificato
“Nessun rilievo. Tutti i controlli applicabili sono superati.”Nulla da correggere.
“Nessun rilievo. N rilievi ignorati; Mostra ignorati li elenca.”Tutti i rilievi rimasti sono stati ignorati.
“Nessun rilievo corrisponde al filtro. Cancellare il filtro o le faccette.”I facet o il filtro nascondono tutti i rilievi.
“Lo schema non consente nessuna di queste relazioni per la classe …”La correzione richiede una relazione che lo schema del progetto non consente per quella classe. Aggiungerla nell'Editor dello schema, oppure correggere il rilievo in un altro modo.
“Il modello non è un'espressione regolare valida (…). Correggerlo.”L'editor delle regole o un file importato contiene un modello che non si può leggere.
“L'id “…” è già usato in questo set di regole. Sceglierne un altro.”Due regole dello stesso set richiedono ID diversi.
“La relazione “…” non è nello schema di questo progetto.”Una regola nomina una relazione che questo progetto non ha; non segnala nulla finché non la si modifica.
“L'espressione non nomina nulla per la classe “…”.”Un'espressione o un filtro nomina una classe, un'etichetta, una relazione o un elemento che il progetto non ha.
“La versione N non è supportata. Questa versione di Holarch legge la versione 1.”Il file del set di regole è stato scritto da una versione più recente di Holarch.

Limiti

  • L'elenco mostra fino a 200 rilievi per gruppo; filtrare l'elenco per vedere il resto.
  • Un set di regole contiene fino a 500 regole; un file contiene fino a 50 set di regole e 2 MB. I modelli hanno fino a 300 caratteri e controllano i primi 20.000 caratteri di un valore.
  • La variazione rispetto all'ultima esecuzione viene conservata per dispositivo e browser, non nel progetto.
  • L'API pubblica e gli strumenti MCP restituiscono gli stessi rilievi con le impostazioni del progetto; non memorizzano i risultati.