Capitoli del corso
Formazione · Percorso 6. Migrare a Holarch · Capitolo 6.1 di 5
6.1 Pianificare una migrazione 3:00
Decidere dove va nel modello ogni tipo di dato prima di importarlo.
Mostra Holarch 2.21.
Che cosa si impara
- Mappare ogni tipo di dato di origine su una classe, un’etichetta, un attributo o una relazione
- Controllare nello schema di un progetto gli attributi e le etichette di cui un’importazione ha bisogno
- Aggiungere un attributo per un campo di origine che non ha collocazione nello schema
- Trovare la pagina Importazione ed esportazione e indicarne i quattro passaggi
Pianificare il passaggio a Holarch: il Plant Inspection Drone di esempio e i file che il suo team porta, come i dati si mappano su classi, etichette, attributi e relazioni LML, dove lo schema del progetto mostra che cosa è disponibile, e che cosa fa ogni importazione.
File di progetto
- Progetto completato (.holarch.json; Gestisci progetti → File di progetto ▾ → Importa progetto (.json)…)
Il video viene riprodotto da holarch.app; vedere l’Informativa sulla privacy.
Esercitazione
Provare in prima persona in Holarch, 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.
Verifica
- 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?
Mostra le risposte
Perché decidere dove va ogni tipo di dato prima dell’importazione?
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.
Una colonna non ha un attributo corrispondente. Quali sono le opzioni?
Aggiungere l’attributo in Impostazioni → Schema prima dell’importazione, oppure mappare la colonna su Nuovo attributo (aggiunto allo schema) nel passaggio Mappa.
Un’importazione è andata male. Come annullarla?
Premere una volta ⌘Z / Ctrl+Z: un’importazione dalla pagina di importazione è un unico passo di annullamento.
Quando si usa Gestisci progetti → Importa progetto (.json)… invece della pagina di importazione?
Per ripristinare un intero progetto come progetto nuovo e separato. La pagina di importazione unisce gli elementi di un file nel progetto aperto.
Per saperne di più
Trascrizione
Mostra la trascrizione (narrazione e contenuto dello schermo)
Introduction
Welcome to Migrating to Holarch. Most teams arrive with their data in other places: requirements in spreadsheets and Word documents, specifications from suppliers, and models in other tools. This track shows how each one comes in, and what to check afterwards.
This first chapter is about planning. A little thought about where each kind of data belongs saves a lot of clean-up later.
The example
Our example is the Plant Inspection Drone, a drone system that inspects tanks and pipe racks inside a process plant. Its team brings four files.
On screen: The example card.
Map your data
Before importing, decide where each kind of data goes. Rows of a requirements list become Requirements. Section headings become Statements that hold them. Parts and systems become Assets, and functions become Actions.
On screen: Mapping card: classes.
Types such as functional or performance become labels. Fields such as status or rationale become attributes. And links such as satisfies, verified by or refines become relationships, so they can be traced later.
On screen: Mapping card: labels, attributes, relationships.
Check the schema
Create the project first. In Manage Projects, click New Project, name it Plant Inspection Drone, and click Create Project.
On screen: + New Project → Plant Inspection Drone → Create Project.
The project's schema lists every class with its attributes and labels. Open Settings at the bottom of the rail, then Schema.
On screen: Settings → Schema.
Select Requirement. Its attributes include the status, with the values Draft, In Review, Approved and Rejected. The usual kinds of requirement, such as Functional and Performance, are under Labels. If your data has a field with no home here, an owner can add an attribute or a label before the import.
On screen: Schema → Requirement → its attributes; then Labels.
One import page
All imports start on one page: Needs and Requirements, then Import and Export. Drop any file here: Word, Holarch project files, Excel and CSV, plain text, UML and SysML models, or ReqIF. Holarch detects the format from the file.
On screen: Needs & Requirements → Import and Export: the drop zone.
Each import takes four steps: File, Map, Review and Import. It gives the items new identities in your project, and the whole import is a single undo step, so you can try it and take it back. Content from files is cleaned of anything unsafe on the way in.
On screen: The Import steps.
Recap
Let's recap. You met the Plant Inspection Drone and its files, mapped their data to classes, labels, attributes and relationships, checked the schema, and found the Import and Export page.
Next, the requirements tracker comes in from Excel.