Capítulos do curso
Treinamento · Trilha 6. Migrar para o Holarch · Capítulo 6.1 de 5
6.1 Planejar uma migração 3:00
Decida para onde vai cada tipo de dado no modelo antes de importá-lo.
Mostra o Holarch 2.21.
O que você vai aprender
- Mapear cada tipo de dado de origem para uma classe, um rótulo, um atributo ou um relacionamento
- Conferir no esquema de um projeto os atributos e rótulos de que uma importação precisa
- Adicionar um atributo para um campo de origem que não tem lugar no esquema
- Encontrar a página Importar e exportar e dizer suas quatro etapas
Planeje uma mudança para o Holarch: o exemplo do Plant Inspection Drone e os arquivos que sua equipe traz, como os dados se mapeiam para classes, rótulos, atributos e relacionamentos da LML, onde o esquema do projeto mostra o que está disponível e o que toda importação faz.
Arquivos de projeto
- Projeto concluído (.holarch.json; Gerenciar projetos → Arquivos de projeto ▾ → Importar projeto (.json)…)
O vídeo é reproduzido a partir de holarch.app; veja a Política de Privacidade.
Prática
Faça isto você mesmo no Holarch, no projeto de demonstração CubeSat EO-1.
- Abra seu projeto de demonstração EO-1 (se não tiver um, crie-o: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)).
- Abra Ajustes → Esquema na barra lateral, clique em Requisito em Classes e liste os atributos que uma planilha de requisitos poderia preencher (por exemplo Priority, Owner, Verification Method).
- Abra a página Rótulos do esquema e encontre onde ficam tipos como Performance Requirement.
- Suponha que a planilha de acompanhamento de um fornecedor tenha uma coluna
Supplier Refsem lugar no esquema: em Requisito, clique em + Atributo, dê o nomeSupplier Ref, escolha um tipo de texto e clique em Adicionar atributo. - Abra Necessidades e requisitos → Importar e exportar e leia quais formatos a área de soltar aceita e o que o cartão Exportar oferece.
Você terminou quando Supplier Ref for o último na lista de atributos de Requirement e você souber dizer para onde iria cada coluna de uma planilha de acompanhamento típica.
Teste-se
- Por que decidir para onde vai cada tipo de dado antes de importar?
- Uma coluna não tem atributo correspondente. Quais são suas opções?
- Uma importação deu errado. Como desfazê-la?
- Quando usar Gerenciar projetos → Importar projeto (.json)… em vez da página Importar?
Mostrar as respostas
Por que decidir para onde vai cada tipo de dado antes de importar?
Dados que chegam nas classes, rótulos, atributos e relacionamentos certos funcionam imediatamente na rastreabilidade, nas checagens de qualidade e nos relatórios. Corrigi-los depois da importação significa editar muitos itens à mão.
Uma coluna não tem atributo correspondente. Quais são suas opções?
Adicione o atributo em Ajustes → Esquema antes da importação, ou mapeie a coluna para Novo atributo (adicionado ao esquema) na etapa Mapear.
Uma importação deu errado. Como desfazê-la?
Pressione ⌘Z / Ctrl+Z uma vez: uma importação feita pela página Importar é um único passo de desfazer.
Quando usar Gerenciar projetos → Importar projeto (.json)… em vez da página Importar?
Para restaurar um projeto inteiro como um projeto novo e separado. A página Importar mescla os itens de um arquivo no projeto que está aberto.
Saiba mais
Transcrição
Mostrar a transcrição (narração e o que aparece na tela)
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.