Trilha 6. Migrar para o Holarch: folha de exercícios
Para equipes que vêm de outras ferramentas. Uma tarefa prática e algumas perguntas por capítulo, para fazer depois de cada vídeo. Imprima esta página pelo navegador ou trabalhe na tela. O gabarito começa em uma nova página no final.
Antes de começar
- Faça antes
- Trilha 1. Primeiros passos, capítulos 1.1 a 1.3.
- Plano
- Gratuito
- Projeto
- Seus próprios arquivos de requisitos, ou arquivos que você exporta do demo EO-1 para praticar.
6.1 Planejar uma migração
Assistir ao capítulo 6.1 (3:00)
Prática
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.
Perguntas
- 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?
6.2 Requisitos a partir de Excel e CSV
Assistir ao capítulo 6.2 (2:32)
Prática
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)). No Banco de dados, busque
class:Requirement, clique em Exportar…, escolha Tabela (CSV), marque Status e Prioridade (mantenha Rótulos marcado) e clique em Exportar. - Abra o arquivo em um aplicativo de planilhas. Mantenha o cabeçalho e as linhas das seções 1 e 2 e depois adicione duas linhas no topo:
1,Mission Imaging, ClassStatement, e2,Attitude Determination and Control, ClassStatement. Salve-o como .xlsx ou .csv. - Em Gerenciar projetos, clique em + Novo projeto, dê o nome
EO-1 Import Practicee clique em Criar projeto. - Abra Necessidades e requisitos → Importar e exportar, solte o arquivo, clique em Continuar e confira o Campo do Holarch de cada coluna (defina como Ignorar qualquer coluna que você não queira).
- Clique em Continuar, mantenha Criar um documento a partir destes N itens marcado e clique em Importar N itens.
- No novo documento, confira que 1.6.1 e 1.6.2 ficam sob 1.6 e selecione 1.5 para ver seus rótulos e seu status.
Você terminou quando o novo documento mostrar as seções 1 e 2 com seus requisitos aninhados pelo número, com rótulos e status intactos.
Perguntas
- Como o Holarch reconstrói a hierarquia das linhas de uma planilha?
- Algumas linhas chegaram com a classe errada. Por quê?
- Você quer atualizar os responsáveis de 50 requisitos existentes a partir de uma planilha, sem criar cópias. Como?
6.3 Requisitos a partir de Word e ReqIF
Assistir ao capítulo 6.3 (2:22)
Prática
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 Documentos → EO-1 System Requirements Specification e clique em Entregar ▾ → Especificação (Word).
- No mesmo documento, clique em Entregar ▾ → Requisitos (ReqIF)… e clique em Exportar.
- Em Gerenciar projetos, clique em + Novo projeto, dê o nome
EO-1 Import Practicee clique em Criar projeto. Abra Necessidades e requisitos → Importar e exportar, solte o .docx, clique em Continuar duas vezes e importe-o. - Compare o novo documento com a SRS: observe quais títulos viraram Statements e quais frases com shall viraram Requirements, e como foram nomeados.
- Importe o arquivo .reqif no mesmo projeto, depois abra o documento que ele cria e selecione 1.6 Revisit Time para conferir seus filhos e rótulos.
Você terminou quando o projeto tiver dois documentos, um do Word e um do ReqIF, e você souber dizer qual manteve os nomes e números originais.
Perguntas
- O que a importação do Word lê como seção, e o que lê como requisito?
- Um fornecedor pode enviar Word ou ReqIF. Por que pedir ReqIF?
- Uma relação do ReqIF tem um nome que o Holarch não conhece. O que acontece?
6.4 Modelos de outras ferramentas
Assistir ao capítulo 6.4 (2:44)
Prática
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 Necessidades e requisitos → Importar e exportar, clique em Exportar UML/SysML (XMI)… no cartão Exportar, mantenha Formato em OMG XMI 2.5.1 (.xmi) e clique em Exportar. Esse arquivo faz as vezes de uma exportação de uma ferramenta SysML como Cameo ou Enterprise Architect.
- Em Gerenciar projetos, clique em + Novo projeto, dê o nome
EO-1 Import Practicee clique em Criar projeto. Abra Necessidades e requisitos → Importar e exportar, solte o arquivo .xmi, confira que Formato mostra UML/SysML (.xmi, .uml, .mdzip), clique em Continuar duas vezes, leia Revisão e clique em Importar N itens. - No Banco de dados, busque
class:Asset, selecione Payload Camera e confira em Rastreabilidade que ela faz parte de EO-1 Spacecraft e quais ações executa. - Abra Diagramas, clique em + Novo diagrama, escolha Diagrama de Asset, escolha EO-1 Spacecraft em Diagrama de e clique em Criar.
- Ative Actions executadas para listar as funções de cada subsistema.
Você terminou quando o diagrama de ativos do novo projeto mostrar os subsistemas da espaçonave com as ações que eles executam.
Perguntas
- Quais arquivos de uma ferramenta SysML v1 o Holarch consegue importar, e como obtê-los?
- Por que é possível reconstruir diagramas rapidamente depois de uma importação?
- Você importa uma exportação posterior do mesmo modelo. Por que você não obtém cópias?
6.5 Organizar após a importação
Assistir ao capítulo 6.5 (2:40)
Prática
No projeto de demonstração CubeSat EO-1:
- Abra seu projeto
EO-1 Import Practicedos capítulos anteriores (ou importe um CSV dos requisitos do EO-1 como no capítulo 2). - Abra Necessidades e requisitos → Qualidade, escolha um dos documentos importados na barra de escopo e clique em Checar qualidade.
- Se você importou os mesmos requisitos duas vezes (Word e ReqIF), marque a linha de uma duplicata no Banco de dados e exclua-a com Excluir item… na barra de ações em massa. Reescreva 2.5 Safe Mode Recovery para que seja mensurável e cheque a qualidade de novo.
- Abra Verificação → Checagens do modelo e abra a regra Requirement.8, Requisitos folha que nenhuma entidade de projeto atende.
- Se você também importou os ativos (capítulo 4), selecione 2.1 Pointing Accuracy e, em Rastreabilidade, adicione satisfied by com + → Vincular existente… para ADCS. Execute as Checagens do modelo de novo.
Você terminou quando 2.5 tiver uma pontuação maior que antes e Requirement.8 não listar mais 2.1.
Perguntas
- O que a checagem de qualidade examina, e o que as Checagens do modelo examinam?
- Por que a pontuação de qualidade automática nunca passa de 78%?
- Por que conectar requisitos e partes logo depois de uma migração?
Gabarito
6.1 Planejar uma migração
- 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.
- Adicione o atributo em Ajustes → Esquema antes da importação, ou mapeie a coluna para Novo atributo (adicionado ao esquema) na etapa Mapear.
- Pressione ⌘Z / Ctrl+Z uma vez: uma importação feita pela página Importar é um único passo de desfazer.
- 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.
6.2 Requisitos a partir de Excel e CSV
- A partir de uma coluna ID da linha pai ou Número do pai, se mapeada; caso contrário, a partir do número de estrutura: 1.2 fica sob 1. Se o pai não existir, é usado o ancestral existente mais próximo.
- Uma coluna Class com nomes que o esquema não conhece recorre à Classe para linhas sem classe, com um aviso. Use os nomes de classe do editor de esquema.
- Exporte-os com a coluna ID, edite o arquivo e importe-o com a coluna ID mapeada para ID global e Associar entidades existentes por definido como ID global. A Revisão então os lista em Itens atualizados.
6.3 Requisitos a partir de Word e ReqIF
- Parágrafos nos estilos de título do Word viram Statements (seções). Um parágrafo com shall, must, will ou should vira um Requirement, nomeado a partir das primeiras palavras depois do verbo. Títulos digitados como texto simples em negrito são lidos como texto comum.
- O ReqIF traz o identificador, a hierarquia, os atributos e as relações de cada requisito. Quando o fornecedor envia um arquivo mais novo, importá-lo atualiza os mesmos itens em vez de adicionar cópias.
- Ela entra como traced to. Se o esquema não permitir traced to entre as duas classes, a relação é ignorada com um aviso.
6.4 Modelos de outras ferramentas
- XMI 2.x com o perfil SysML 1.x do Cameo/MagicDraw, Enterprise Architect, Rhapsody ou Papyrus (exporte-o da ferramenta), um projeto .mdzip do Cameo ou MagicDraw diretamente e um arquivo .uml do Papyrus. Requisitos isolados também podem vir como ReqIF, e tabelas como Excel ou CSV.
- Os layouts de diagrama de outra ferramenta não são importados, mas os relacionamentos sim. O Holarch desenha diagramas de ativos, de hierarquia e outros a partir desses relacionamentos.
- Cada item importado mantém seu id XMI, e Associar entidades existentes por usa ID XMI por padrão para arquivos XMI, então a importação posterior atualiza esses itens. Relacionamentos já existentes não são adicionados duas vezes.
6.5 Organizar após a importação
- A checagem de qualidade pontua a redação de cada requisito em relação às qualidades de um bom requisito. As Checagens do modelo examinam o modelo inteiro em busca de lacunas, como requisitos que nada atende, itens isolados ou ações que ninguém executa.
- Correto e Viável exigem o julgamento de uma pessoa, então a checagem nunca os marca como atendidos. Você os marca depois de revisar o requisito.
- Eles chegam de arquivos diferentes, sem vínculos entre si. Cada vínculo satisfied by alimenta a rastreabilidade, a cobertura e as checagens do modelo a partir de então.
Publicado por Holarch