Percorso 6. Migrare a Holarch: scheda di esercizi
Per i team che arrivano da altri strumenti. Un’esercitazione e alcune domande per ogni capitolo, da svolgere dopo ogni video. Stampare questa pagina dal browser, oppure lavorare a schermo. Le soluzioni iniziano su una nuova pagina alla fine.
Prima di iniziare
- Da seguire prima
- Percorso 1. Primi passi, capitoli da 1.1 a 1.3.
- Piano
- Free
- Progetto
- I propri file di requisiti, oppure file esportati dalla demo EO-1 per esercitarsi.
6.1 Pianificare una migrazione
Guarda il capitolo 6.1 (3:00)
Esercitazione
Sul progetto demo CubeSat EO-1:
- Aprire il proprio progetto demo EO-1 (se non lo si ha, crearlo: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata)).
- Aprire Impostazioni → Schema nella barra laterale, fare clic su Requisito in Classi ed elencare gli attributi che un foglio di calcolo di requisiti potrebbe compilare (ad esempio Priorità, Proprietario, Metodo di verifica).
- Aprire la pagina Etichette dello schema e trovare dove sono conservati tipi come Performance Requirement.
- Si supponga che il tracker di un fornitore abbia una colonna
Supplier Refsenza una collocazione: su Requisito, fare clic su + Attributo, chiamarloSupplier Ref, scegliere un tipo testo e fare clic su Aggiungi attributo. - Aprire Esigenze e requisiti → Importazione ed esportazione e leggere quali formati accetta l’area di rilascio e che cosa offre la scheda Esporta.
L’esercizio è completato quando Supplier Ref è l’ultimo nell’elenco degli attributi di Requirement e si sa dire dove andrebbe ogni colonna di un tracker tipico.
Domande
- Perché decidere dove va ogni tipo di dato prima dell’importazione?
- Una colonna non ha un attributo corrispondente. Quali sono le opzioni?
- Un’importazione è andata male. Come annullarla?
- Quando si usa Gestisci progetti → Importa progetto (.json)… invece della pagina di importazione?
6.2 Requisiti da Excel e CSV
Guarda il capitolo 6.2 (2:32)
Esercitazione
Sul progetto demo CubeSat EO-1:
- Aprire il proprio progetto demo EO-1 (se non lo si ha, crearlo: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata)). Nel Database, cercare
class:Requirement, fare clic su Esporta…, scegliere Tabella (CSV), spuntare Stato e Priorità (lasciare spuntato Etichette) e fare clic su Esporta. - Aprire il file in un’applicazione per fogli di calcolo. Mantenere l’intestazione e le righe delle sezioni 1 e 2, poi aggiungere due righe in cima:
1,Mission Imaging, ClassStatement, e2,Attitude Determination and Control, ClassStatement. Salvarlo come .xlsx o .csv. - In Gestisci progetti, fare clic su + Nuovo progetto, chiamarlo
EO-1 Import Practicee fare clic su Crea progetto. - Aprire Esigenze e requisiti → Importazione ed esportazione, rilasciare il file, fare clic su Continua e controllare il Campo di Holarch di ogni colonna (impostare su Salta le colonne indesiderate).
- Fare clic su Continua, lasciare spuntato Crea un documento da questi N elementi e fare clic su Importa N elementi.
- Nel nuovo documento, verificare che 1.6.1 e 1.6.2 si trovino sotto 1.6, e selezionare 1.5 per vederne le etichette e lo stato.
L’esercizio è completato quando il nuovo documento mostra le sezioni 1 e 2 con i requisiti annidati per numero, con etichette e stati intatti.
Domande
- Come ricostruisce Holarch la gerarchia delle righe di un foglio di calcolo?
- Alcune righe sono arrivate con la classe sbagliata. Perché?
- Si vogliono aggiornare da un foglio di calcolo i proprietari di 50 requisiti esistenti, non crearne copie. Come?
6.3 Requisiti da Word e ReqIF
Guarda il capitolo 6.3 (2:22)
Esercitazione
Sul progetto demo CubeSat EO-1:
- Aprire il proprio progetto demo EO-1 (se non lo si ha, crearlo: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata)). Aprire Documenti → EO-1 System Requirements Specification e fare clic su Consegna ▾ → Specifica (Word).
- Nello stesso documento, fare clic su Consegna ▾ → Requisiti (ReqIF)… e fare clic su Esporta.
- In Gestisci progetti, fare clic su + Nuovo progetto, chiamarlo
EO-1 Import Practicee fare clic su Crea progetto. Aprire Esigenze e requisiti → Importazione ed esportazione, rilasciare il .docx, fare clic due volte su Continua e importarlo. - Confrontare il nuovo documento con l’SRS: notare quali titoli sono diventati Statement e quali frasi con shall sono diventate Requirement, e come sono stati denominati.
- Importare il file .reqif nello stesso progetto, poi aprire il documento che crea e selezionare 1.6 Revisit Time per controllarne i figli e le etichette.
L’esercizio è completato quando il progetto contiene due documenti, uno da Word e uno da ReqIF, e si sa dire quale ha conservato i nomi e i numeri originali.
Domande
- Che cosa legge l’importazione Word come sezione, e che cosa come requisito?
- Un fornitore può inviare Word o ReqIF. Perché chiedere ReqIF?
- Una relazione ReqIF ha un nome che Holarch non conosce. Che cosa succede?
6.4 Modelli da altri strumenti
Guarda il capitolo 6.4 (2:44)
Esercitazione
Sul progetto demo CubeSat EO-1:
- Aprire il proprio progetto demo EO-1 (se non lo si ha, crearlo: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata)). Aprire Esigenze e requisiti → Importazione ed esportazione, fare clic su Esporta UML/SysML (XMI)… nella scheda Esporta, lasciare Formato su OMG XMI 2.5.1 (.xmi) e fare clic su Esporta. Questo file fa le veci di un’esportazione da uno strumento SysML come Cameo o Enterprise Architect.
- In Gestisci progetti, fare clic su + Nuovo progetto, chiamarlo
EO-1 Import Practicee fare clic su Crea progetto. Aprire Esigenze e requisiti → Importazione ed esportazione, rilasciare il file .xmi, verificare che Formato mostri UML/SysML (.xmi, .uml, .mdzip), fare clic due volte su Continua, leggere Revisione e fare clic su Importa N elementi. - Nel Database, cercare
class:Asset, selezionare Payload Camera e verificare in Traccia che fa parte di EO-1 Spacecraft e quali azioni esegue. - Aprire Diagrammi, fare clic su + Nuovo diagramma, scegliere Diagramma di Asset, scegliere EO-1 Spacecraft in Diagramma di e fare clic su Crea.
- Attivare Action eseguite per elencare le funzioni di ogni sottosistema.
L’esercizio è completato quando il diagramma di Asset del nuovo progetto mostra i sottosistemi del veicolo spaziale con le azioni che eseguono.
Domande
- Quali file di uno strumento SysML v1 può importare Holarch, e come si ottengono?
- Perché si possono ricostruire rapidamente i diagrammi dopo un’importazione?
- Si importa un’esportazione successiva dello stesso modello. Perché non si ottengono copie?
6.5 Riordinare dopo l’importazione
Guarda il capitolo 6.5 (2:40)
Esercitazione
Sul progetto demo CubeSat EO-1:
- Aprire il progetto
EO-1 Import Practicedei capitoli precedenti (oppure importare un CSV dei requisiti di EO-1 come nel capitolo 2). - Aprire Esigenze e requisiti → Qualità, scegliere uno dei documenti importati nella barra dell’ambito e fare clic su Controlla la qualità.
- Se si sono importati gli stessi requisiti due volte (Word e ReqIF), spuntare la riga di un duplicato nel Database ed eliminarlo con Elimina elemento… nella barra delle azioni multiple. Riscrivere 2.5 Safe Mode Recovery in modo che sia misurabile, poi controllare di nuovo la qualità.
- Aprire Verifica → Controlli del modello e aprire la regola Requirement.8, Requisiti foglia che nessuna entità di progetto soddisfa.
- Se si sono importati anche gli asset (capitolo 4), selezionare 2.1 Pointing Accuracy e in Traccia aggiungere satisfied by con + → Collega esistente… verso ADCS. Eseguire di nuovo i Controlli del modello.
L’esercizio è completato quando 2.5 ottiene un punteggio più alto di prima e Requirement.8 non elenca più 2.1.
Domande
- Che cosa esamina il controllo di qualità, e che cosa esaminano i Controlli del modello?
- Perché il punteggio di qualità automatico non supera mai il 78%?
- Perché collegare requisiti e parti subito dopo una migrazione?
Soluzioni
6.1 Pianificare una migrazione
- I dati che finiscono nelle classi, etichette, attributi e relazioni giusti funzionano subito nella tracciabilità, nei controlli di qualità e nei report. Correggerli dopo l’importazione significa modificare molti elementi a mano.
- Aggiungere l’attributo in Impostazioni → Schema prima dell’importazione, oppure mappare la colonna su Nuovo attributo (aggiunto allo schema) nel passaggio Mappa.
- Premere una volta ⌘Z / Ctrl+Z: un’importazione dalla pagina di importazione è un unico passo di annullamento.
- Per ripristinare un intero progetto come progetto nuovo e separato. La pagina di importazione unisce gli elementi di un file nel progetto aperto.
6.2 Requisiti da Excel e CSV
- Da una colonna ID della riga padre o Numero padre se mappata, altrimenti dal numero di struttura: 1.2 va sotto 1. Se il padre manca, si usa l’antenato esistente più vicino.
- Una colonna Classe con nomi che lo schema non conosce ricade sulla Classe per le righe senza classe, con un avviso. Usare i nomi delle classi dell’editor dello schema.
- Esportarli con la colonna ID, modificare il file e importarlo con la colonna ID mappata su ID globale e Abbina le entità esistenti per impostato su ID globale. Revisione li elenca allora in Elementi aggiornati.
6.3 Requisiti da Word e ReqIF
- I paragrafi con stili di titolo di Word diventano Statement (sezioni). Un paragrafo con shall, must, will o should diventa un Requirement, denominato con le prime parole dopo il verbo. I titoli scritti come semplice testo in grassetto vengono letti come testo normale.
- ReqIF trasporta l’identificativo, la gerarchia, gli attributi e le relazioni di ogni requisito. Quando il fornitore invia un file più recente, importarlo aggiorna gli stessi elementi invece di aggiungere copie.
- Arriva come traced to. Se lo schema non consente traced to tra le due classi, la relazione viene saltata con un avviso.
6.4 Modelli da altri strumenti
- XMI 2.x con il profilo SysML 1.x da Cameo/MagicDraw, Enterprise Architect, Rhapsody o Papyrus (esportato dallo strumento), un progetto Cameo o MagicDraw .mdzip direttamente e un file Papyrus .uml. I soli requisiti possono arrivare anche come ReqIF, e le tabelle come Excel o CSV.
- I layout dei diagrammi di un altro strumento non vengono importati, ma le relazioni sì. Holarch disegna diagrammi di Asset, di gerarchia e altri a partire da quelle relazioni.
- Ogni elemento importato conserva il proprio id XMI, e per i file XMI Abbina le entità esistenti per è impostato di default su ID XMI, quindi l’importazione successiva aggiorna quegli elementi. Le relazioni già presenti non vengono aggiunte due volte.
6.5 Riordinare dopo l’importazione
- Il controllo di qualità valuta la formulazione di ogni requisito rispetto alle qualità di un buon requisito. I Controlli del modello esaminano l’intero modello alla ricerca di lacune come requisiti che nulla soddisfa, elementi isolati o azioni che nessuno esegue.
- Corretto e Fattibile richiedono il giudizio di una persona, quindi il controllo non li segna mai come soddisfatti. Li si segna dopo aver esaminato il requisito.
- Arrivano da file diversi senza collegamenti tra loro. Ogni collegamento satisfied by alimenta da quel momento la tracciabilità, la copertura e i controlli del modello.
Pubblicato da Holarch