Holarch

Treinamento · Trilha 6. Migrar para o Holarch

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:

  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)).
  2. 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).
  3. Abra a página Rótulos do esquema e encontre onde ficam tipos como Performance Requirement.
  4. Suponha que a planilha de acompanhamento de um fornecedor tenha uma coluna Supplier Ref sem lugar no esquema: em Requisito, clique em + Atributo, dê o nome Supplier Ref, escolha um tipo de texto e clique em Adicionar atributo.
  5. 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

  1. Por que decidir para onde vai cada tipo de dado antes de importar?
  2. Uma coluna não tem atributo correspondente. Quais são suas opções?
  3. Uma importação deu errado. Como desfazê-la?
  4. 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:

  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.
  2. 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, Class Statement, e 2, Attitude Determination and Control, Class Statement. Salve-o como .xlsx ou .csv.
  3. Em Gerenciar projetos, clique em + Novo projeto, dê o nome EO-1 Import Practice e clique em Criar projeto.
  4. 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).
  5. Clique em Continuar, mantenha Criar um documento a partir destes N itens marcado e clique em Importar N itens.
  6. 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

  1. Como o Holarch reconstrói a hierarquia das linhas de uma planilha?
  2. Algumas linhas chegaram com a classe errada. Por quê?
  3. 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:

  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).
  2. No mesmo documento, clique em Entregar ▾ → Requisitos (ReqIF)… e clique em Exportar.
  3. Em Gerenciar projetos, clique em + Novo projeto, dê o nome EO-1 Import Practice e clique em Criar projeto. Abra Necessidades e requisitos → Importar e exportar, solte o .docx, clique em Continuar duas vezes e importe-o.
  4. Compare o novo documento com a SRS: observe quais títulos viraram Statements e quais frases com shall viraram Requirements, e como foram nomeados.
  5. 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

  1. O que a importação do Word lê como seção, e o que lê como requisito?
  2. Um fornecedor pode enviar Word ou ReqIF. Por que pedir ReqIF?
  3. 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:

  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.
  2. Em Gerenciar projetos, clique em + Novo projeto, dê o nome EO-1 Import Practice e 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.
  3. 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.
  4. Abra Diagramas, clique em + Novo diagrama, escolha Diagrama de Asset, escolha EO-1 Spacecraft em Diagrama de e clique em Criar.
  5. 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

  1. Quais arquivos de uma ferramenta SysML v1 o Holarch consegue importar, e como obtê-los?
  2. Por que é possível reconstruir diagramas rapidamente depois de uma importação?
  3. 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:

  1. Abra seu projeto EO-1 Import Practice dos capítulos anteriores (ou importe um CSV dos requisitos do EO-1 como no capítulo 2).
  2. Abra Necessidades e requisitos → Qualidade, escolha um dos documentos importados na barra de escopo e clique em Checar qualidade.
  3. 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.
  4. Abra Verificação → Checagens do modelo e abra a regra Requirement.8, Requisitos folha que nenhuma entidade de projeto atende.
  5. 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

  1. O que a checagem de qualidade examina, e o que as Checagens do modelo examinam?
  2. Por que a pontuação de qualidade automática nunca passa de 78%?
  3. Por que conectar requisitos e partes logo depois de uma migração?

Gabarito

6.1 Planejar uma migração

  1. 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.
  2. Adicione o atributo em Ajustes → Esquema antes da importação, ou mapeie a coluna para Novo atributo (adicionado ao esquema) na etapa Mapear.
  3. Pressione ⌘Z / Ctrl+Z uma vez: uma importação feita pela página Importar é um único passo de desfazer.
  4. 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

  1. 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.
  2. 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.
  3. 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

  1. 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.
  2. 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.
  3. 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

  1. 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.
  2. 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.
  3. 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

  1. 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.
  2. 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.
  3. 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