Holarch

Treinamento · Trilha 1. Primeiros passos

Trilha 1. Primeiros passos: folha de exercícios

Para todos que estão começando no Holarch. 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
Nada: comece aqui com uma conta gratuita.
Plano
Gratuito
Projeto
O capítulo 1.1 percorre o demo CubeSat EO-1; os outros capítulos montam uma Bike-Share Dock a partir de um arquivo inicial.

1.1 O espaço de trabalho do Holarch

Assistir ao capítulo 1.1 (5:34)

Prática

No projeto de demonstração CubeSat EO-1:

  1. Crie o demo EO-1: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada).
  2. Em Início, leia os cartões Requer atenção, depois clique em Verificação na barra lateral e abra a Central de testes pela página de visão geral.
  3. Clique em Banco de dados na parte inferior da barra lateral, clique em + Filtro e escolha a classe Caso de teste. Selecione TC-04 Pointing Accuracy Test e leia sua Rastreabilidade no inspetor: qual requisito ele verifica.
  4. Clique duas vezes na linha de TC-04 para abri-lo na Visão do item, depois pressione ⌘K / Ctrl+K, digite battery e pressione Enter em 1.3.2 Battery Pack. Alterne entre as duas abas do editor.
  5. Clique no indicador Requer atenção na barra superior e abra a entrada Testes reprovados. Nessa página, clique em ? na barra superior e leia o painel de Ajuda.
  6. Para um passo a passo checado, execute o tutorial 1 Getting Around (Ajuda → Tutoriais).

Você terminou quando TC-04 e 1.3.2 Battery Pack estiverem abertos em suas próprias abas do editor e você souber dizer qual requisito TC-04 verifica.

Perguntas

  1. Você altera a descrição de um requisito no Banco de dados. A especificação de requisitos do sistema ainda mostra o texto antigo?
  2. Quando você usaria ⌘K / Ctrl+K em vez da barra lateral?
  3. Por que não há um botão Salvar?

1.2 Seu primeiro projeto

Assistir ao capítulo 1.2 (5:43)

Prática

No projeto de demonstração CubeSat EO-1:

  1. Abra seu projeto de demonstração EO-1 (ou crie-o: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)).
  2. Clique em Banco de dados na parte inferior da barra lateral e depois em + Novo item. Escolha a classe Statement, dê o nome Field Boundary Overlays, o número N4, descreva a necessidade (os agrônomos querem os limites dos talhões desenhados em cada mapa de vegetação) e clique em Criar.
  3. Crie um segundo Statement, Rideshare Mass Limit, número C1, declarando que a espaçonave não deve exceder o limite de massa do dispensador. No inspetor, clique em + Rótulo e escolha Restrição.
  4. Crie um Requisito Field Boundary Layer, número 6.6, escrito como uma declaração com shall, e confira que seu Status é Rascunho. Depois crie uma Ação Overlay Field Boundaries, número F12.
  5. Clique duas vezes na descrição de N4 na tabela, altere uma palavra e pressione Enter. Pressione ⌘Z / Ctrl+Z para desfazer e ⇧⌘Z / Ctrl+Shift+Z para refazer.
  6. Clique em + Filtro e escolha a classe Statement para ver as necessidades e as restrições juntas.

Você terminou quando o filtro Statement listar de N1 a N4 e C1, C1 tiver o rótulo Restrição e 6.6 Field Boundary Layer mostrar o status Rascunho.

Perguntas

  1. Por que a classe importa quando você cria um item?
  2. Um stakeholder diz que os operadores devem poder planejar passagens de casa. Isso é um Statement ou um Requirement?
  3. Para que serve um rótulo, se a classe já diz o que um item é?

1.3 Atributos e relacionamentos

Assistir ao capítulo 1.3 (3:29)

Prática

No projeto de demonstração CubeSat EO-1:

  1. Abra seu projeto de demonstração EO-1 (ou crie-o: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)).
  2. No Banco de dados, selecione 2.5 Safe Mode Recovery e digite uma Justificativa no inspetor (por que a espaçonave deve sair do modo de segurança por conta própria).
  3. Selecione F10 Enter Safe Mode. Em Rastreabilidade, encontre satisfies (marque Mostrar todas as relações se não estiver listado), clique em + → Vincular existente…, marque 2.5 Safe Mode Recovery e clique em Vincular selecionados. Selecione 2.5 e encontre o mesmo vínculo em satisfied by.
  4. Selecione 1.4 C&DH, marque Mostrar todas as relações e relacione-o com performs a OPS.9 Hold Data Onboard, o único passo de operações que nenhuma parte executa ainda.
  5. Selecione 2.2 Mission Operations Center. Em decomposed by, clique em + → Novo Asset… e crie Image Processing Server.
  6. Clique duas vezes em F10 Enter Safe Mode para abrir a Visão do item e depois clique nos nomes relacionados: de F10 para 1.4 C&DH, e de lá para 1 EO-1 Spacecraft.

Você terminou quando a Visão do item de 2.5 Safe Mode Recovery listar F10 em satisfied by, e OPS.9 listar 1.4 C&DH em performed by.

Perguntas

  1. Você adiciona um vínculo a partir de F10 com satisfies. Por que 2.5 agora mostra satisfied by sem nenhum passo extra?
  2. Por que o seletor de Vincular existente… não oferece todos os itens do projeto?
  3. O que relacionar um ativo com performs a uma ação registra em termos de engenharia de sistemas?

1.4 Seu primeiro diagrama

Assistir ao capítulo 1.4 (4:00)

Prática

No projeto de demonstração CubeSat EO-1:

  1. Abra seu projeto de demonstração EO-1 (ou crie-o: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)).
  2. Clique em Diagramas na parte inferior da barra lateral e depois em + Novo diagrama. Escolha Diagrama de Asset, digite EPS em Diagrama de, escolha 1.3 EPS e clique em Criar. Ative Actions executadas para ver qual função cada parte executa.
  3. Escolha + Asset ▾ → Novo Asset filho… e crie Battery Heater. Clique em ⋯ (Mais ações) na barra de ferramentas do diagrama e depois em + Conduit: de Battery Pack para Battery Heater, com o nome Heater Power Line. Depois escolha Organizar ▾ → Organizar layout.
  4. Abra o Banco de dados e encontre Battery Heater e Heater Power Line como novas linhas.
  5. De volta à aba do diagrama, mude o tipo para Diagrama de hierarquia com o seletor de tipo.
  6. Crie um Diagrama Spider de 3.2 Battery Capacity e mantenha o nível em 2.

Você terminou quando o diagrama spider de 3.2 mostrar o Battery Pack que o atende e o TC-07 Battery Capacity Test que o verifica.

Perguntas

  1. Você não exclui nada, mas renomeia uma parte em um diagrama. Onde mais o novo nome aparece?
  2. Por que um novo Diagrama de Asset de 1.3 EPS já mostra três partes?
  3. Quando um Diagrama Spider é mais útil que um Diagrama de Asset?

1.5 Documentos

Assistir ao capítulo 1.5 (2:46)

Prática

No projeto de demonstração CubeSat EO-1:

  1. Abra seu projeto de demonstração EO-1 (ou crie-o: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)).
  2. Abra Necessidades e requisitos → Documentos e clique em + Novo documento. Dê a ele o nome EO-1 Ground Station Specification, escolha o modelo Especificação de requisitos e clique em Criar.
  3. Selecione a seção 4.1 Primary Functions, clique em + Filho, dê ao requisito o nome Track the Spacecraft e escreva sua declaração com shall na descrição do inspetor.
  4. Em Adição rápida, na parte inferior, escolha Sob 10 Design Constraints, digite The ground station antenna shall have a diameter of no more than 3.7 m. e pressione Enter. Adicione uma segunda restrição da mesma forma.
  5. Abra o Banco de dados e digite in:"EO-1 Ground Station Specification" class:Requirement na caixa de busca para listar os novos requisitos.
  6. De volta ao documento, escolha Entregar ▾ → Especificação (Word) e abra o arquivo.

Você terminou quando o arquivo Word mostrar seus três requisitos sob as respectivas seções numeradas.

Perguntas

  1. Qual é a diferença entre um requisito digitado em um documento do Holarch e um digitado em um processador de texto?
  2. Como a Adição rápida escolhe o nome do novo requisito?
  3. Quando você marcaria Incluir orientações de redação?

1.6 Encontrar o que procura

Assistir ao capítulo 1.6 (2:37)

Prática

No projeto de demonstração CubeSat EO-1:

  1. Abra seu projeto de demonstração EO-1 (ou crie-o: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)).
  2. No Banco de dados, digite downlink na caixa de busca e leia de quais classes vêm os resultados. Limpe a busca.
  3. Clique em + Filtro, escolha a classe Requisito, depois Status em Atributos do requisito, = é, In Review, e clique em Adicionar filtro.
  4. No painel Visões, clique em Salvar visão…, dê o nome Awaiting decision, marque Compartilhar com o projeto e clique em Salvar.
  5. Pressione ⌘K / Ctrl+K e digite TC-09 para abrir o Safe Mode Entry Test; pressione ⌘K / Ctrl+K de novo, digite rvtm e abra a página RVTM; depois digite new test e pressione Escape sem criar nada.
  6. Abra 3.1 Orbit Average Power na Visão do item e clique em Histórico…. Leia quais campos mudaram e quem os alterou.

Você terminou quando Awaiting decision aparecer no painel Visões com a marca de compartilhada e listar apenas requisitos In Review.

Perguntas

  1. Um colega pergunta toda semana quais requisitos ainda estão em revisão. Qual é a forma mais rápida de dar essa lista a ele?
  2. O que o filtro Sem relacionamentos encontra, e por que ele é útil?
  3. Quem pode ver uma visão salva sem Compartilhar com o projeto?

1.7 Compartilhamento e papéis

Assistir ao capítulo 1.7 (2:24)

Prática

No projeto de demonstração CubeSat EO-1:

  1. Abra seu projeto de demonstração EO-1 (ou crie-o: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)). Você também precisa de um segundo endereço de e-mail que consiga ler.
  2. Clique em Compartilhar à direita da barra superior. Em Convidar pessoas, digite o segundo endereço, escolha Revisor e clique em Convidar. Confira que ele aparece em Convites pendentes e feche a caixa de diálogo.
  3. Selecione 6.4 Operator Interface na SRS. Na seção Discussão do inspetor, escreva uma pergunta sobre qual valor mensurável o requisito deve declarar e clique em Adicionar comentário.
  4. No grupo Fluxo de trabalho do inspetor, defina Responsável como você mesmo e um Prazo na próxima semana. Abra Planejar → Meu trabalho e encontre o requisito em Atribuído a mim.
  5. Aceite o convite a partir do segundo endereço em uma janela privada do navegador. Como revisor, abra 6.4 e confirme que você pode responder ao comentário, mas não editar o texto.

Você terminou quando 6.4 Operator Interface estiver no seu Meu trabalho com o prazo, e a resposta do revisor aparecer na Discussão dele.

Perguntas

  1. Um stakeholder precisa aprovar requisitos, mas não deve alterá-los. Qual papel você dá a ele?
  2. Por que você pode adicionar revisores e leitores sem atingir o limite de colaboradores de um plano?
  3. Para onde deve ir uma pergunta sobre um requisito: um e-mail ou a Discussão do item?

1.8 Exportação, importação e versões

Assistir ao capítulo 1.8 (2:31)

Prática

No projeto de demonstração CubeSat EO-1:

  1. Abra seu projeto de demonstração EO-1 (ou crie-o: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)).
  2. No Banco de dados, clique duas vezes na descrição de 6.3 Telemetry Archive, torne-a mais precisa e pressione Enter. Continue trabalhando por um ou dois minutos para que uma nova versão automática seja salva.
  3. Abra Controle e revisões → Linhas de base e versões e clique em Restaurar uma versão anterior… no cabeçalho da página. Selecione uma versão de antes da sua edição, leia a mudança que ela lista para 6.3 e clique em Cancelar.
  4. Em Gerenciar projetos, abra o menu ⋯ da linha do projeto, escolha Exportar este projeto… e clique em Exportar JSON.
  5. Escolha Arquivos de projeto ▾ → Importar projeto (.json)… e escolha o arquivo. Abra o novo projeto e confira que a SRS e seus diagramas estão lá.
  6. No Banco de dados da cópia, filtre pela classe Caso de teste, clique em Exportar…, escolha Tabela (Excel) e clique em Exportar. Exclua a cópia quando terminar: ela conta como um dos seus projetos.

Você terminou quando tiver o arquivo JSON do projeto, um arquivo Excel dos casos de teste e tiver visto a mudança em 6.3 na prévia da restauração.

Perguntas

  1. Qual é a diferença entre uma versão automática e uma linha de base?
  2. Você restaura uma versão por engano. É possível voltar ao ponto em que estava?
  3. Importar um arquivo de projeto sobrescreve o projeto de onde ele veio?

Gabarito

1.1 O espaço de trabalho do Holarch

  1. Não. Existe uma única cópia de cada item; o documento, o Banco de dados, os diagramas e o inspetor mostram todos o mesmo item, então a edição aparece em todos os lugares.
  2. Quando você sabe o nome ou o número do que procura. ⌘K / Ctrl+K encontra itens, páginas, documentos, diagramas e comandos pelo nome; a barra lateral serve para navegar por etapa do ciclo de vida.
  3. O Holarch salva cada mudança assim que você a faz e mostra o status do salvamento na barra superior. Cada mudança é um passo de desfazer, então ⌘Z / Ctrl+Z a reverte.

1.2 Seu primeiro projeto

  1. A classe decide quais atributos e relacionamentos o item pode ter. O Holarch só oferece vínculos que fazem sentido para ele: um ativo pode executar uma ação, um risco não.
  2. Um Statement: é uma necessidade nas palavras do stakeholder. Os requisitos que a formalizam vêm depois e são rastreados até ela.
  3. Um rótulo separa itens de uma classe em tipos, como um Statement com o rótulo Restrição, para que você possa filtrar e gerar relatórios por tipo sem uma nova classe.

1.3 Atributos e relacionamentos

  1. Cada relacionamento tem um nome em cada sentido. É um único vínculo, lido como satisfies a partir da função e como satisfied by a partir do requisito.
  2. Ele lista apenas itens das classes que a relação permite para este item, então você não consegue criar um vínculo que o esquema não define.
  3. A alocação de uma função à parte física que a executa.

1.4 Seu primeiro diagrama

  1. Em todos os lugares onde o item aparece: o Banco de dados, os documentos, outros diagramas e o inspetor. Um diagrama é uma visão do modelo, não um desenho separado.
  2. O diagrama lê os relacionamentos decomposed by que já existem no modelo, então as partes são desenhadas sem nenhum posicionamento manual.
  3. Quando você quer a rastreabilidade em torno de um item através de vários tipos de relacionamento: a necessidade, a função, a parte e o teste, por exemplo para avaliar o impacto de uma mudança.

1.5 Documentos

  1. No Holarch, cada requisito do documento é um item do modelo: você pode rastreá-lo, checar sua qualidade, desenhá-lo em diagramas e encontrá-lo no Banco de dados.
  2. Ela dá nome ao requisito a partir das palavras depois de shall e o numera depois dos irmãos dele na seção escolhida.
  3. Quando os autores são novos no tipo de documento: cada seção recebe então uma breve nota sobre o que deve conter, que você apaga enquanto escreve.

1.6 Encontrar o que procura

  1. Salve a consulta como uma visão com Compartilhar com o projeto. Todos no projeto a recebem no painel Visões, e ela sempre reflete o modelo atual.
  2. Itens sem nenhum vínculo, como necessidades até as quais nada é rastreado ou requisitos que nada atende. São as pontas soltas do modelo.
  3. Só você, neste navegador. Ela fica guardada no navegador e é oferecida em todos os projetos que você abrir nele.

1.7 Compartilhamento e papéis

  1. Revisor. Os revisores leem, comentam e aprovam, rejeitam ou reabrem requisitos, mas não podem editar o modelo.
  2. Só proprietários e editores contam para o limite; revisores e leitores não.
  3. A Discussão do item. O comentário fica junto do requisito, uma menção notifica a pessoa, e ele aguarda no Meu trabalho dela.

1.8 Exportação, importação e versões

  1. As versões automáticas são salvas cerca de uma vez por minuto enquanto você edita e mantidas apenas pelos dias do plano do proprietário. Uma linha de base é um snapshot com nome que você cria em um marco, e ela é mantida.
  2. Sim. O estado anterior à restauração é salvo primeiro como uma versão, e a restauração é um único passo de desfazer.
  3. Não. A importação se torna um novo projeto com uma nova identidade, e você é o proprietário dele.

Publicado por Holarch