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.
In questa pagina
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
- 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.
- 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.
- 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.
- Salvare la correzione. Il rilievo scompare e i conteggi si aggiornano.
- Quando un rilievo è voluto (per esempio un'azione riutilizzata sotto due elementi padre), fare clic su Ignora.
Concentrarsi su un'area
- Nei facet a sinistra, spuntare Errori in Gravità per vedere solo gli errori.
- 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.
- Digitare in Filtra rilievi per cercare il nome di un elemento o il titolo di una regola.
- Fare clic su Cancella facet per mostrare di nuovo tutto.
Rivedere insieme i rilievi di un elemento
- Scegliere Raggruppa per entità accanto al filtro.
- 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
- Aprire il progetto demo CubeSat EO-1 e andare in Verifica → Controlli del modello.
- 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).
- 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.
- Scegliere Raggruppa per entità per vedere insieme tutti i rilievi rimasti di un requisito.
Scrivere una propria regola
- 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.
- Sotto il set, fare clic su + Aggiungi regola. L'editor delle regole si apre con l'ID R1.
- Digitare un Nome che indichi che cosa trova la regola, per esempio “Requisiti senza un caso di test che li verifica”.
- In Si applica a, scegliere Requirement.
- In Segnala un elemento quando, scegliere Manca una relazione, quindi scegliere verified by in Relazione.
- Impostare Gravità su Errore e scrivere il Messaggio, per esempio “Collegare il caso di test che verifica il requisito.”
- Leggere l'anteprima sotto i campi, per esempio “Al momento segnala 3 elementi: SYS-2 Top Speed, …”. Fare clic su Salva.
- 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à
- Nella demo CubeSat EO-1, aprire Set di regole…, fare clic su + Nuovo set di regole e chiamarlo “Budget di massa”.
- Fare clic su + Aggiungi regola. Chiamarla “Assiemi oltre la loro allocazione di massa” e scegliere Asset in Si applica a.
- 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.
- Impostare Gravità su Errore e fare clic su Salva, quindi su Chiudi.
- 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
- In Set di regole…, fare clic su Esporta accanto al set. Viene scaricato un file con un nome come
program-rules.holarch-rules.json. - 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.
- 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.
- 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
Intestazione della pagina
| Controllo | Che 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. |
| Impostazioni | Imposta la gravità di ogni regola e i figli per livello (vedere Impostazioni). |
| ↻ Esegui controlli | Esegue 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
| Facet | Valori |
|---|---|
| Gravità | Errori, Avvisi |
| Classe | La classe di ogni elemento con un rilievo |
| Regola | Ogni regola con un rilievo, per numero e titolo |
| Etichetta | Ogni etichetta su un elemento con un rilievo |
| Ignorato | Mostra 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
| Correzione | Usato da | Che cosa fa |
|---|---|---|
| Modifica un campo | Nome, numero o descrizione mancanti; controlli su verbi e sostantivi | Apre il campo con il valore corrente. |
| Maiuscola iniziale | Nomi in minuscolo | Propone il nome con la prima lettera maiuscola. |
| Aggiungi relazioni | Padre, esecutore, input, output, condotti, norme e tracciamenti mancanti | Elenca gli elementi che lo schema consente per la relazione; spuntarli e fare clic su Aggiungi relazioni. |
| Unisci | Nomi simili, figli unici | Mantiene un elemento, sposta su di esso ogni relazione degli altri, combina le descrizioni ed elimina gli altri (un solo annullamento revoca tutto). |
| Elimina correlati | Azioni con un input prodotto dopo l'uso | Elimina gli input/output che vengono consumati prima di esistere. |
| Aggiungi traced to | Requisiti che nominano entità non correlate | Aggiunge traced to dal requisito a ogni elemento che il suo testo nomina. |
| Crea Issue | Casi di test falliti senza issue collegata | Crea una Issue collegata al caso di test e ai requisiti che verifica. |
| Apertura | Elenchi di figli lunghi, scambi, norme, soglie, relazioni non consentite dallo schema | Apre l'elemento o il suo diagramma. |
| Apri vista UAF | Viste UAF che non possono essere mostrate | Elenca 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
| Controllo | Che cosa fa |
|---|---|
| + Nuovo set di regole | Chiede 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 set | Attiva o disattiva il set. Un set disattivato non viene eseguito. |
| Rinomina… | Rinomina il set. |
| Esportazione | Scarica il set come file JSON di set di regole. |
| Elimina | Elimina il set e le sue regole dopo una conferma. Annulla li ripristina. |
| + Aggiungi regola, Modifica, Elimina | Aggiungere 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
| Campo | Che cosa imposta |
|---|---|
| Nome | Il titolo dei rilievi della regola: che cosa trova la regola. |
| ID | Breve e univoco nel set, per esempio R1 o SYS-NUM; fino a 40 lettere, cifre, punti, trattini e trattini bassi. |
| Si applica a | Qualsiasi 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 a | Facoltativo: un filtro nel linguaggio di filtro del Database che restringe prima gli elementi, per esempio is:leaf. |
| Segnala un elemento quando | La condizione, sotto. |
| Gravità | Errore o Avviso. |
| Messaggio | La 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.
| Condizione | Campi | Segnala un elemento quando |
|---|---|---|
| Un attributo è vuoto | Attributo | L'attributo non ha valore. |
| Un attributo corrisponde a un modello | Attributo, Modello, Ignora maiuscole/minuscole | Il testo dell'attributo contiene una corrispondenza del modello, un'espressione regolare. |
| Un attributo non corrisponde a un modello | Attributo, Modello, Ignora maiuscole/minuscole | Il testo dell'attributo non ha corrispondenze, per esempio ^SYS-\d+$ per i numeri che devono iniziare con SYS-. |
| Manca una relazione | Relazione, Di elementi di | L'elemento non ha un collegamento di quella relazione (verso elementi di quella classe). |
| È presente una relazione | Relazione, Di elementi di | L'elemento ha un collegamento di quel tipo. |
| Gli elementi correlati sono almeno N | Relazione, Di elementi di, N | L'elemento ha N o più elementi correlati, per esempio più di 9 figli. |
| Gli elementi correlati sono al massimo N | Relazione, Di elementi di, N | L'elemento ha N o meno elementi correlati. |
| Un valore è fuori da un intervallo | Attributo, 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 intervallo | Attributo, Minimo, Massimo, Unità | Il numero dell'attributo è nell'intervallo, limiti inclusi. |
| Un totale di valori correlati confrontato con un valore | Funzione, Relazione, Di elementi di, Valore di ogni elemento correlato, Confronto, Confronta con | Il 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 corrisponde | Espressione | L'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:
| Espressione | Report |
|---|---|
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
| Regola | Heading | Un buon modello |
|---|---|---|
| Global.1 | Nomi uguali o quasi uguali | All'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.2 | Nomi in minuscolo | Ogni nome di entità inizia con la maiuscola. |
| Global.4 | Numeri ripetuti in una classe | All'interno di una classe, ogni numero è univoco. |
| Global.5 | Parole vaghe in nomi o descrizioni | Nomi e descrizioni usano parole precise. |
| Global.6 | Entità senza relazioni | Ogni entità ha una relazione. |
| Global.7 | Valori dinamici che puntano a destinazioni mancanti | Valori 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.8 | Viste UAF che non possono essere mostrate | Ogni vista UAF usa una radice, una classe e una relazione accettate dal suo tipo di vista. |
| Global.9 | Relazioni non consentite dallo schema | Ogni relazione unisce classi che lo schema consente per quella relazione. |
| Global.10 | Entità senza nome né numero | Ogni entità ha un nome o un numero. |
| Global.11 | Valori fuori dalle scelte del loro attributo | Ogni valore di enumerazione e di selezione multipla è una delle scelte del suo attributo, scelta una sola volta. |
| Action.1 | Nomi di azioni senza verbo iniziale | Ogni nome di Action inizia con un verbo. |
| Action.2 | Nomi di azioni in minuscolo | Ogni nome di Action inizia con la maiuscola. |
| Action.3 | Azioni senza nome | Ogni azione ha un nome. |
| Action.4 | Azioni senza numero | Ogni azione ha un numero. |
| Action.5 | Azioni senza descrizione | Ogni azione ha una descrizione. |
| Action.6 | Azioni senza padre né figlio | Ogni azione ha un padre o un figlio. |
| Action.7 | Azioni con un solo figlio | Nessuna azione ha un solo figlio. |
| Action.9 | Azioni con più di 9 figli | Nessuna azione ha più di 9 figli. |
| Action.10 | Azioni con più padri | Nessuna azione ha più padri. |
| Action.11 | Azioni che nessun asset esegue | Qualche asset esegue ogni azione. |
| Action.12 | Azioni che non producono nulla | Ogni azione produce un input/output. |
| Action.13 | Azioni che non consumano nulla | Ogni azione consuma un input/output. |
| Action.14 | Azioni senza input né output | Ogni azione consuma o produce un input/output. |
| Action.15 | Azioni che producono ma non consumano nulla | Ogni azione che produce output consuma anche un input. |
| Action.16 | Azioni che consumano ma non producono nulla | Ogni azione che consuma input produce anche un output. |
| Action.17 | Azioni con un input prodotto dopo l'uso | Nessuna azione riceve un input/output generato da un'azione successiva. |
| Action.18 | Azioni non tracciate a un requisito | Ogni azione è tracciata a un requisito. |
| Action.19 | Cicli che non possono mai terminare | Ogni ciclo può terminare. Indica il ciclo e il ramo OR allo 0 % che ne blocca l'EXIT. |
| Asset.1 | Nomi di asset senza sostantivo | Ogni nome di asset è un sostantivo o un sintagma nominale. |
| Asset.2 | Nomi di asset in minuscolo | Ogni nome di asset inizia con la maiuscola. |
| Asset.3 | Asset senza nome | Ogni asset ha un nome. |
| Asset.4 | Asset senza numero | Ogni asset ha un numero. |
| Asset.5 | Asset senza descrizione | Ogni asset ha una descrizione. |
| Asset.6 | Asset senza padre né figlio | Ogni asset ha un padre o un figlio. |
| Asset.7 | Asset con un solo figlio | Nessun asset ha un solo figlio. |
| Asset.9 | Asset con più di 9 figli | Nessun asset ha più di 9 figli. |
| Asset.10 | Asset con più padri | Nessun asset ha più padri. |
| Asset.11 | Asset che non eseguono alcuna azione | Ogni asset esegue qualche azione. |
| Asset.12 | Asset non collegati da un condotto | Ogni asset è collegato da un condotto. |
| Asset.13 | Asset che si scambiano dati senza un condotto in comune | Gli asset che si scambiano un input/output sono collegati da un condotto. |
| Asset.14 | Asset che interagiscono senza una norma in comune | Gli asset che interagiscono fanno riferimento alla stessa norma. |
| Asset.15 | Asset che non scambiano nulla | Ogni asset scambia un input/output con un altro asset. |
| Conduit.1 | Nomi di condotti senza sostantivo iniziale | Ogni nome di condotto inizia con un sostantivo. |
| Conduit.2 | Condotti senza nome | Ogni condotto ha un nome. |
| Conduit.3 | Condotti senza numero | Ogni condotto ha un numero. |
| Conduit.4 | Condotti senza descrizione | Ogni condotto ha una descrizione. |
| Conduit.5 | Condotti con più di due asset | Nessun condotto collega più di due asset. |
| Conduit.6 | Condotti con meno di due asset | Ogni condotto collega due asset. |
| Conduit.7 | Condotti senza una norma in comune con i propri asset | Un condotto e gli asset che collega fanno riferimento alla stessa norma. |
| Conduit.8 | Condotti che non trasferiscono nulla | Ogni condotto trasferisce qualche input/output. |
| Conduit.9 | Condotti non tracciati a un requisito | Ogni condotto è tracciato a un requisito. |
| IO.1 | Input/output senza nome | Ogni input/output ha un nome. |
| IO.2 | Input/output senza numero | Ogni input/output ha un numero. |
| IO.3 | Input/output senza descrizione | Ogni input/output ha una descrizione. |
| IO.4 | Input/output con più padri | Nessun input/output ha più di un padre. |
| IO.5 | Input/output che nessuna azione produce | Qualche azione produce ogni input/output. |
| IO.6 | Input/output che nessuna azione consuma | Qualche azione consuma ogni input/output. |
| IO.7 | Input/output che nessuna azione usa | Ogni input/output è prodotto o consumato da un'azione. |
| IO.8 | Input/output che un'azione produce e consuma | Nessuna azione consuma un input/output che produce. |
| IO.9 | Input/output senza una norma in comune con i propri asset | Un input/output e gli asset che lo scambiano fanno riferimento alla stessa norma. |
| IO.10 | Input/output non tracciati a un requisito | Ogni input/output è tracciato a un requisito. |
| Requirement.1 | Requisiti che nominano entità non correlate | Un requisito è correlato a ogni entità che nomina. |
| Requirement.2 | Requisiti foglia senza “shall” | Ogni requisito foglia usa la parola “shall”. |
| Requirement.3 | Requisiti senza nome | Ogni requisito ha un nome. |
| Requirement.4 | Requisiti senza numero | Ogni requisito ha un numero. |
| Requirement.5 | Requisiti senza descrizione | Ogni requisito ha una descrizione. |
| Requirement.6 | Requisiti senza padre né figli | Ogni requisito ha un padre o un figlio. |
| Requirement.7 | Requisiti con più padri | Nessun requisito ha più padri. |
| Requirement.8 | Requisiti foglia che nessuna entità di progetto soddisfa | Ogni requisito foglia è correlato a un Action, Asset, Input/Output o Conduit. |
| Requirement.9 | Requisiti soddisfatti da più input/output | Nessun requisito è soddisfatto da più di un input/output. |
| Requirement.10 | Requisiti foglia senza caso di test di verifica | Ogni requisito foglia è verificato da un Test Case. |
| Requirement.11 | Requisiti fuori dai modelli EARS | Ogni requisito foglia con “shall” segue uno dei modelli EARS. Disattivato (Ignora) finché non se ne imposta la gravità. |
| Risk.1 | Rischi di livello massimo senza mitigazione | Ogni rischio aperto al livello più alto della matrice dei rischi è mitigato da qualcosa. |
| Risk.2 | Accettazioni di pericoli precedenti a una modifica dei controlli | Nessuna accettazione del rischio residuo di un pericolo è anteriore a una modifica dei suoi controlli o della loro verifica. |
| TestCase.1 | Casi di test falliti senza issue collegata | Ogni Test Case fallito è collegato a una Issue. |
| Measure.1 | Measure che superano la soglia | Il 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 choiceoVerification 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
| Messaggio | Significato |
|---|---|
| “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.