Holarch

Primeiros passos

Tutoriais

Ouvir esta página 19 min

Onze tutoriais guiados sobre um pequeno modelo de Estação Meteorológica, do primeiro requisito a uma especificação entregue, com um painel de etapas que confere seu trabalho à medida que você avança.

Como usá-lo →

Nesta página
  1. Como usá-lo
    1. Iniciar um tutorial
    2. Seguir as etapas
    3. Assistir ao vídeo
    4. Retomar, reiniciar ou concluir
  2. Tutorial 1: Getting Around
  3. Tutorial 2: Write Good Requirements
  4. Tutorial 3: Trace Requirements
  5. Tutorial 4: Functional Analysis
  6. Tutorial 5: From a Spreadsheet to Requirement Diagrams
  7. Tutorial 6: Physical Architecture and Allocation
  8. Tutorial 7: Interfaces
  9. Tutorial 8: Simulate the Functional Flow
  10. Tutorial 9: Verify the Requirements
  11. Tutorial 10: Baseline, Change, Impact
  12. Tutorial 11: Produce the Deliverable
  13. Projetos de tutorial e limites do plano
  14. Relacionado

O Holarch tem onze tutoriais guiados. Cada um cria um pequeno projeto inicial e abre um painel de etapas ao lado da página. O painel confere o modelo enquanto você trabalha e marca cada etapa quando ela é concluída. Esta página lista todas as etapas como texto, para que você também possa acompanhar por aqui.

Todos os tutoriais usam o mesmo sistema pequeno: WS-1 Weather Station, uma estação movida a energia solar que mede o tempo, registra as leituras e as envia a um servidor. Cada tutorial tem seu próprio projeto inicial, então você pode fazê-los em qualquer ordem. Os tutoriais 6 a 11 levam o modelo adiante: cada projeto inicial contém a Estação Meteorológica como os tutoriais anteriores a deixaram.

TutorialTempoVocê aprende a
Orientação10 minusar a barra lateral, o Banco de dados, o inspetor, a pesquisa (⌘K / Ctrl+K) e a Ajuda
Escrever bons requisitos15 mincriar um documento de requisitos, adicionar requisitos, executar a checagem de qualidade e corrigir a redação sinalizada
Rastrear requisitos12 minvincular requisitos a funções e componentes na Matriz de rastreabilidade e encontrar uma lacuna
Análise funcional15 minderivar funções de requisitos, decompor uma função e gerar um FFBD
De uma planilha a diagramas de requisitos20 minimportar requisitos do Excel, colocá-los em linha de base, corrigir o que a checagem de qualidade sinaliza, desenhar e exportar diagramas Spider e de árvore, adicionar requisitos e aplicar rótulos a eles
Arquitetura física e alocação15 minconstruir a hierarquia de assets, alocar funções a componentes e checar o resultado com a Hierarquia de alocação
Interfaces15 minconectar subsistemas com conduits, nomear o que flui, adicionar portas, ler o registro de interfaces e exportar um ICD
Simular o fluxo funcional15 mindar durações às funções, simular o fluxo, encontrar o caminho mais longo e checar um requisito de tempo
Verificar os requisitos15 minescolher métodos de verificação, criar casos de teste, registrar resultados, ler a RVTM e fechar as lacunas
Linha de base, mudança, impacto20 minaprovar e colocar requisitos em linha de base, alterar um por meio de uma solicitação de mudança, marcar os vínculos alterados como revisados e aprová-lo novamente
Produzir o entregável12 mincriar uma especificação a partir de um modelo, inserir matrizes vivas, colocá-la em linha de base e exportá-la para Word

Como usá-lo

Iniciar um tutorial

Inicie um tutorial a partir de qualquer um destes lugares:

  • Ajuda → Tutoriais na barra lateral.
  • Gerenciar projetos → Arquivos de projeto ▾ → Iniciar um tutorial…, ou Iniciar um tutorial quando você ainda não tem projetos.
  • Pesquisa (⌘K / Ctrl+K): digite tutorial e escolha Iniciar um tutorial… ou um tutorial pelo nome.

Na página Tutoriais, clique em Iniciar no cartão de um tutorial. Você vê o novo projeto, chamado Tutorial: <name> (Weather Station), com o painel de etapas à direita.

Seguir as etapas

  1. Leia a etapa atual no painel. É a primeira etapa sem marca.
  2. Clique em Mostrar para destacar o controle de que a etapa precisa. O destaque esmaece após alguns segundos e nunca bloqueia a página.
  3. Clique em Ir até lá quando a etapa for feita em outra página.
  4. Faça a etapa na janela normal do Holarch. A etapa fica verde assim que o modelo a cumpre. A próxima etapa abre.
  5. Clique em Saiba mais para ver o tópico da Ajuda ou a seção de Docs correspondente.

O painel fica encaixado em todas as páginas do projeto de tutorial. Clique em › no cabeçalho para recolhê-lo em uma faixa estreita e clique na faixa para trazê-lo de volta.

Assistir ao vídeo

Um tutorial com vídeo mostra a imagem dele com ▶ no cartão na página Tutoriais e ▶ no cabeçalho do painel. Clique em qualquer um para reproduzir o vídeo em uma caixa de diálogo. Ele é reproduzido a partir de holarch.app com as legendas desativadas; ative-as com o controle de legendas do player. Quando o vídeo tem narração no idioma da sua interface, ele é reproduzido nesse idioma (a imagem continua a mesma); Áudio abaixo do vídeo troca para outro idioma, mantendo o ponto em que você está. O controle de legendas lista todos os idiomas em que o vídeo tem legendas. Um vídeo sem narração no seu idioma é reproduzido em inglês. Nada é carregado antes do clique; consulte a Política de Privacidade. Na versão para desktop, o vídeo abre em holarch.app em uma nova aba. Todo tutorial tem um vídeo e funciona sem ele.

Ajuda → Vídeos lista os vídeos dos tutoriais, os tours (visões gerais curtas de grupos de recursos no projeto de demonstração CubeSat EO-1), Building a CubeSat in Holarch, uma série que constrói o modelo CubeSat EO-1 passo a passo, do conceito da missão à verificação, e Systems Engineering with Holarch, uma série que segue os processos técnicos da ISO/IEC/IEEE 15288 na WS-1 Weather Station, e os destaques de recursos, clipes curtos de um recurso cada; os mesmos vídeos estão na página Vídeos, e cada destaque também é reproduzido na página Recursos dele. Todo vídeo é reproduzido a partir de holarch.app, com legendas (na versão para desktop, ele abre lá em uma nova aba). Os tópicos da Ajuda com um tour correspondente mostram ▶ Assistir ao tour, os tópicos com um destaque mostram ▶ Assistir: e o nome do clipe, e um projeto novo ou quase vazio mostra Novo no Holarch? ▶ Assistir ao tour de 4 minutos em Início até você fechá-lo com ×.

Retomar, reiniciar ou concluir

  • Retomar: abra o projeto de tutorial novamente ou clique em Retomar na página Tutoriais. O progresso é salvo no projeto, então ele também é retomado em outro navegador.
  • Reiniciar: clique em Reiniciar… no painel ou no cartão. O Holarch exclui o projeto de tutorial e cria um novo.
  • Marcar como concluído: clique em Marcar como concluído no painel quando as etapas estiverem feitas. O cartão na página Tutoriais mostra Concluído. O projeto permanece; exclua-o em Gerenciar projetos quando não precisar mais dele.
  • Fechar: × no cabeçalho do painel oculta o painel neste projeto. Clique em Retomar na página Tutoriais, ou execute Mostrar painel do tutorial em ⌘K / Ctrl+K, para mostrá-lo novamente.

Cada cartão na página Tutoriais mostra Não iniciado, Em andamento (com as etapas feitas) ou Concluído e tem um link para Passos como texto nesta página. O cartão de um tutorial concluído tem Abrir no lugar de Retomar.

Tutorial 1: Getting Around

Aprenda as partes da janela do Holarch em um modelo pronto da Estação Meteorológica. O projeto inicial tem um documento de requisitos, quatro funções e quatro componentes.

  1. Abra o banco de dados do modelo. Clique em Banco de dados na parte inferior da barra lateral. Todos os itens do projeto são listados em uma tabela.
  2. Use o inspetor. Clique na linha Sensor Suite. No inspetor à direita, altere Nome no primeiro grupo (Definição) para Sensor Package. O novo nome é salvo na hora. Todas as páginas o mostram.
  3. Pesquise com ⌘K / Ctrl+K. Pressione ⌘K / Ctrl+K (ou clique em Pesquisar na barra superior). Digite Data Logger e pressione Enter. O item abre em sua própria página.
  4. Crie um item a partir da pesquisa. Pressione ⌘K / Ctrl+K, digite new req e escolha Novo requisito…. Digite o nome Measure Wind Speed e a descrição The station shall measure the wind speed to within 0.5 m/s. Clique em Criar.
  5. Abra um grupo do ciclo de vida. Clique em Comportamento na barra lateral. A página de visão geral mostra as páginas do grupo e números ao vivo.
  6. Abra o documento de requisitos. Na barra lateral, abra Necessidades e requisitos → Documentos e clique em Weather Station Requirements.
  7. Abra a Ajuda da página. Clique em ? na barra superior ou pressione ? fora de um campo de texto. A Ajuda abre o tópico da página em que você está, ao lado da página.

Tutorial 2: Write Good Requirements

Escreva requisitos, cheque-os em relação às regras de redação de requisitos e corrija o que a checagem sinaliza. O projeto inicial tem os componentes da Estação Meteorológica, mas ainda nenhum requisito.

  1. Crie um documento de requisitos. Abra Necessidades e requisitos → Documentos e clique em + Novo documento. Digite o nome Weather Station Requirements, mantenha Em branco e clique em Criar.
  2. Adicione quatro requisitos. Em Adição rápida, abaixo do documento, digite cada linha e pressione Enter:
    • The station shall measure air temperature and report humidity quickly.
    • The station shall store measurements as needed.
    • The station should be easy to install.
    • The station shall transmit the weather report to the server at intervals of 10 minutes.
  3. Execute a checagem de qualidade. Abra Necessidades e requisitos → Qualidade. Defina o escopo como Document: Weather Station Requirements e clique em Checar qualidade. Cada requisito recebe uma pontuação. A coluna Sugestões diz o que corrigir.
  4. Divida o requisito combinado. O primeiro requisito declara duas ações (medir e informar), então falha em Singular. Abra o documento, selecione o primeiro requisito e altere sua Descrição no inspetor para The station shall measure the air temperature to within 0.5 °C. Depois adicione The station shall measure the relative humidity to within 3 %. com Adição rápida.
  5. Substitua a redação vaga. Altere a descrição do segundo requisito para The station shall store the measurements of the last 30 days. Altere a do terceiro para The installer shall mount the station on the mast in 30 minutes. A etapa fica verde quando nenhum requisito do documento falha em Unambiguous.
  6. Cheque novamente. Na página Qualidade, clique em Checar qualidade de novo. Agora todo requisito tem pontuação de 67% ou mais. Correct e Feasible exigem o julgamento de um revisor, e Verifiable exige um teste, então 67% é o máximo que um requisito pode alcançar antes de ser revisado e verificado.

Tutorial 3: Trace Requirements

Vincule requisitos às funções e aos componentes que os satisfazem, leia a matriz e encontre o que falta. O projeto inicial tem seis requisitos, quatro funções e quatro componentes. Cinco requisitos já estão vinculados a funções.

  1. Abra a Matriz de rastreabilidade. Clique em Ir até lá na etapa ou abra Verificação → Matriz de rastreabilidade. Clique no chip Linhas, defina Linhas de como Todas as entidades de uma classe e Classe como Requirement, e clique em Concluído. Faça o mesmo com o chip Colunas para Action. Cada marca é um relacionamento entre um requisito (linha) e uma função (coluna).
  2. Encontre e feche a lacuna. Marque Somente lacunas. Sobra uma linha: Report Battery Level; nenhuma função o satisfaz. Clique na célula em que ela encontra F4 Manage Power e escolha satisfied by se o Holarch perguntar. A linha sai da lista de lacunas. Desmarque Somente lacunas.
  3. Vincule um requisito a um componente. Defina a classe do chip Colunas como Asset. Clique na célula em que Store Measurements encontra Data Logger e escolha satisfied by.
  4. Aloque funções a componentes. Defina a classe do chip Linhas como Action e mantenha as colunas em Asset. Vincule cada função ao componente que a executa, com performed by:
    • F1 Measure Weather → Sensor Suite
    • F2 Log Measurements → Data Logger
    • F3 Report Weather → Radio Link
    • F4 Manage Power → Power Subsystem
  5. Leia o rastreamento na página do item. Pressione ⌘K / Ctrl+K, digite Report Battery Level e pressione Enter. A seção Rastreamento mostra que F4 Manage Power o satisfaz.
  6. Siga o rastreamento até o componente. Clique em F4 Manage Power na seção Rastreamento e depois em Power Subsystem abaixo de performed by. Você seguiu a cadeia requisito → função → componente.

Tutorial 4: Functional Analysis

Derive funções dos requisitos, decomponha uma delas e desenhe o diagrama de blocos de fluxo funcional (FFBD). O projeto inicial tem um documento de requisitos com quatro requisitos funcionais e dois requisitos de desempenho, e ainda nenhuma função.

  1. Abra a Análise funcional. Abra Comportamento → Análise funcional. Defina o escopo como Weather Station Requirements.
  2. Extraia as funções. Na aba Funções, clique em Extrair por regras…. Revise a pré-visualização e clique em Aplicar. O Holarch cria uma função de nível superior com uma função por requisito funcional (F1–F4) e vincula cada requisito à sua função com satisfied by.
  3. Renomeie a função de nível superior. Clique no nome da função de nível superior ao lado de Função de nível superior:. Altere seu Nome para Operate Weather Station.
  4. Decomponha uma função. Abra F1 Measure Weather (pesquise com ⌘K / Ctrl+K). Na seção Rastreamento, clique no + ao lado de decomposed by (marque Mostrar todas as relações se ele não estiver listado), escolha Nova Action… e crie a Action Read Sensors. Faça o mesmo para Check Readings. F1 agora tem duas subfunções.
  5. Organize o fluxo. Volte para Análise funcional e abra a aba Fluxo e FFBD. Clique em Editar como texto…, digite AND(LOOP(F1 -> F2 -> F3) | F4) e aplique. Medir, registrar e informar agora se repetem em um laço, enquanto o gerenciamento de energia é executado em paralelo.
  6. Abra o FFBD. Clique em Abrir FFBD. O diagrama mostra o laço (LP) e o ramo paralelo (AND).
  7. Mude o layout. Na barra de ferramentas do FFBD, defina a orientação como De cima para baixo.
  8. Abra o FFBD da subfunção. Clique duas vezes em F1 Measure Weather no FFBD. O FFBD dela abre com Read Sensors e Check Readings.

Tutorial 5: From a Spreadsheet to Requirement Diagrams

Traga requisitos de uma planilha para o Holarch, cheque-os e melhore-os, e desenhe os diagramas que mostram sua estrutura. O projeto de tutorial começa vazio.

  1. Obtenha a planilha. Clique em Baixar planilha na etapa ou baixe weather-station-requirements.xlsx (versão CSV). Para fazer a sua no Excel ou em qualquer aplicativo de planilhas, coloque estas colunas na primeira linha:
    • Número: o número de estrutura, como 1, 1.1, 1.2.
    • Nome: um nome curto.
    • Descrição: o enunciado do requisito, como The weather station shall ….
    • Classe: Statement para um título de grupo (1 Sensing), Requirement para as linhas abaixo dele (1.1, 1.2). O Holarch lê arquivos do Excel diretamente; não é preciso salvar como CSV. O arquivo de exemplo tem quatro requisitos fracos de propósito.
  2. Importe-a. Abra Necessidades e requisitos → Importar e exportar e solte o arquivo na página. Clique em Continuar duas vezes para chegar a Revisão e depois clique em Importar N itens. O Holarch associa as colunas pelos nomes e aninha cada requisito em seu Statement pelo número. O documento de requisitos abre.
  3. Crie uma linha de base. No documento, clique em Versão ▾ no bloco de título e escolha Salvar linha de base…. Dê o nome Baseline 1 e clique em Criar. A linha de base guarda esta primeira versão, para que você possa comparar mudanças posteriores com ela.
  4. Execute a checagem de qualidade. Abra Necessidades e requisitos → Qualidade, defina o escopo como o documento e clique em Checar qualidade. Clique em Exportar ▾ → Excel (.xlsx) para guardar o relatório. Leia os níveis: as checagens automáticas chegam no máximo a 78%. 67% ou mais significa que o requisito passa em todas as regras de redação. Abaixo de 67%: reescreva-o.
  5. Corrija os requisitos sinalizados. Selecione no documento cada requisito abaixo de 67% e altere sua Descrição no inspetor. Execute a checagem de novo até que cada um chegue a 67%. Correct e Feasible exigem sua própria revisão: depois de checar, clique no ✘ deles para marcar Sim, o que eleva a pontuação para 89–100%. Por exemplo:
    • 1.2: The weather station shall measure the wind speed to the nearest 0.1 m/s.
    • 1.3: The rain gauge shall record each 0.2 mm of rainfall.
    • 2.3: The display shall show the latest readings.
    • 3.2: The weather station shall send the low-battery alert at 20 % charge.
  6. Crie e exporte o diagrama Spider. Abra Diagramas na barra lateral. Os cartões marcados como Visão derivada são diagramas que o Holarch oferece para cada entidade de nível superior com filhos (consulte Diagramas); abrir um o salva. Crie o Spider você mesmo, como faria para qualquer entidade: clique em + Novo diagrama e escolha Diagrama Spider. Em Raiz, digite Weather Station, escolha o documento Weather Station Requirements e clique em Criar.
    • O Spider segue os relacionamentos marcados na seção Gráfico do inspetor (Relacionamentos… na barra de ferramentas leva até ela), aqui source of (do documento para seus Statements) e decomposed by (de cada Statement para seus requisitos).
    • Nível define quantos passos a partir da raiz ele percorre. Mudanças em qualquer um dos dois valem na hora.
    • Clique em Exportar… na barra de ferramentas do diagrama e escolha Diagrama (PNG) ou Diagrama (SVG).
  7. Abra e exporte o diagrama de árvore. Os diagramas também abrem a partir do documento. Abra Weather Station Requirements; se um item estiver selecionado, pressione Esc para que a árvore comece no documento. Clique em Exibir ▾ na barra de ferramentas do documento e escolha Abrir em ▸ Árvore. A árvore mostra cada Statement com seus requisitos abaixo. Clique em Exportar… e escolha um formato.
  8. Adicione um requisito no Banco de dados. Abra Banco de dados e clique em + Novo item. Escolha Requirement, dê o nome Maximum Wind Speed, o número 1.2.1 e a descrição The weather station shall report wind speeds up to 150 km/h. Na seção Rastreamento do inspetor, clique em + ao lado de decomposes, escolha Vincular existente…, marque 1.2 e clique em Vincular selecionados. Abra o documento: o novo requisito fica abaixo de 1.2.
  9. Aplique rótulos aos requisitos. Abra Necessidades e requisitos → Requisitos. Marque de 1.1 a 3.2 e clique em Rótulo ▾ → Functional Requirement. As linhas continuam marcadas: clique em × no fim da barra de seleção (ou pressione Esc) para desmarcá-las, depois marque 1.2.1 e escolha Rótulo ▾ → Performance Requirement. Um clique aplica o rótulo a todos os requisitos marcados.
  10. Mova-se entre vistas e projetos. Abra o documento em Necessidades e requisitos → Documentos e depois o Banco de dados: ambos mostram os mesmos itens. Abra Gerenciar projetos, abra outro projeto e depois volte a este pelo nome do projeto na barra superior.

Tutorial 6: Physical Architecture and Allocation

Construa o lado físico da Estação Meteorológica e diga qual componente executa cada função. O projeto inicial tem os requisitos, as funções F0–F4 (F1 decomposta em Read Sensors e Check Readings) e o fluxo do tutorial 4, e o sistema WS-1 Weather Station ainda sem partes.

  1. Abra o Diagrama de Asset. Abra Arquitetura → Diagramas de Asset e clique em + Novo diagrama. Escolha Diagrama de Asset, escolha WS-1 Weather Station em Raiz e clique em Criar. O sistema está sozinho no diagrama.
  2. Adicione os subsistemas. Arraste Asset da paleta para o diagrama, digite o nome de um subsistema e clique em OK. Cada um se torna parte de WS-1 (decomposed by). Organizar ▾ → Arrumar layout os alinha:
    • Sensor Suite
    • Data Logger
    • Power Subsystem
    • Radio Link
  3. Decomponha um subsistema. Arraste Asset da paleta para dentro da caixa Sensor Suite, dê o nome Temperature Sensor e clique em OK. Faça o mesmo para Humidity Sensor. Um asset solto dentro de uma caixa se torna filho dela.
  4. Aloque as funções. Clique em Ir até lá na etapa para abrir a Matriz de rastreabilidade com funções como linhas, assets como colunas e performed by como relacionamento. Clique na célula em que cada função encontra quem a executa:
    • F0 Operate Weather Station → WS-1 Weather Station
    • F1 Measure Weather → Sensor Suite
    • F2 Log Measurements → Data Logger
    • F3 Report Weather → Radio Link
    • F4 Manage Power → Power Subsystem
  5. Aloque as subfunções. Na mesma matriz, vincule F1.1 Read Sensors a Temperature Sensor e F1.2 Check Readings a Data Logger. Check Readings é executada no registrador, então a função de medição agora abrange dois subsistemas.
  6. Abra o Diagrama de hierarquia. Abra Diagramas, clique em + Novo diagrama e escolha Diagrama de hierarquia. Em Raiz, escolha WS-1 Weather Station e clique em Criar.
  7. Aplique a Hierarquia de alocação. Clique em Configurar na barra de ferramentas do diagrama. Em Opções, clique na predefinição Hierarquia de alocação (consulte Predefinição Hierarquia de alocação). Cada subsistema lista os números das funções que executa, com seus componentes abaixo.
  8. Cheque a alocação. Leia o diagrama: todo número de função aparece abaixo de um subsistema, e F1.2 fica abaixo de Data Logger, enquanto sua mãe F1 fica abaixo de Sensor Suite. Uma função dividida entre subsistemas significa que dados passam entre eles; essa é a interface do tutorial 7. Abra Verificação → Checagens do modelo e confirme que nenhuma regra informa Ações que nenhum ativo executa.

Tutorial 7: Interfaces

Conecte os subsistemas, diga o que flui entre eles e produza o documento de controle de interfaces (ICD). O projeto inicial tem a hierarquia de assets e a alocação do tutorial 6, e nenhuma conexão.

  1. Abra o Diagrama de Asset. Abra Arquitetura → Diagramas de Asset e clique em + Novo diagrama. Escolha Diagrama de Asset, escolha WS-1 Weather Station em Raiz e clique em Criar.
  2. Desenhe um conduit. Clique em ⋯ (Mais ações) na barra de ferramentas do diagrama e depois em + Conduit. Defina Asset de origem como Sensor Suite, Asset de destino como Data Logger e Nome como Sensor Bus, e clique em Criar. Você também pode arrastar do ponto verde de uma caixa até outra caixa.
  3. Conecte os outros subsistemas. Adicione mais dois conduits da mesma forma:
    • Data Logger → Radio Link: Serial Link
    • Power Subsystem → Data Logger: Power Harness
  4. Diga o que flui. Clique na linha Sensor Bus. No painel dela, clique em + Transfere I/O…, depois em Criar novo…, e crie o Input/Output Sensor Readings. Faça o mesmo em Serial Link com Weather Report.
  5. Acorde a interface. Com Sensor Bus selecionado, abra seus atributos no inspetor. Defina Interface Status como Agreed e Latency como 1 Segundos.
  6. Adicione portas. Abra Arquitetura → Diagramas de blocos e clique em + Novo diagrama. Escolha Diagrama de blocos interno, escolha WS-1 Weather Station em Raiz e clique em Criar. Na paleta, digite Sensor Out em Adicionar ou encontrar… e arraste "Sensor Out" como porta para Sensor Suite. Depois digite Sensor In e arraste "Sensor In" como porta para Data Logger.
  7. Leia o registro de interfaces. Abra Interfaces → Registro de interfaces. Cada conduit é uma linha com suas extremidades, o que ele transfere e seu status. Clique no cartão Agreed para listar apenas as interfaces acordadas.
  8. Exporte o ICD. Abra Interfaces → ICDs e clique em + Novo diagrama. Escolha Diagrama de controle de interfaces, escolha Sensor Bus em Raiz e clique em Criar. Clique em Exportar documento ICD para salvar o documento de controle de interfaces para Word.

Tutorial 8: Simulate the Functional Flow

Dê durações às funções, execute o fluxo do tutorial 4 e descubra o que define o tempo total. O projeto inicial tem o fluxo AND(LOOP(F1 -> F2 -> F3) | F4) do tutorial 4 e a alocação do tutorial 6.

  1. Abra o Diagrama de Action. Abra Comportamento → Diagramas de Action e clique em F0 Operate Weather Station. Um laço de F1 → F2 → F3 é executado ao lado de F4 em um ramo paralelo.
  2. Dê uma duração a cada função. Selecione cada função e defina Duração nos atributos dela no inspetor. F1 Measure Weather é decomposta, então seu tempo é o tempo das subfunções: defina o delas (clique duas vezes em F1 para abrir o diagrama dela).
    • F1.1 Read Sensors: 15 Segundos
    • F1.2 Check Readings: 5 Segundos
    • F2 Log Measurements: 5 Segundos
    • F3 Report Weather: 2 Minutos
    • F4 Manage Power: 10 Minutos
  3. Defina a contagem do laço. Selecione a caixa LOOP. No painel dela, mantenha Repetir enquanto em Iterações e defina a contagem como 3.
  4. Execute a simulação. Clique em ▶ Simular ▾ → Eventos discretos. Na página Simulador, clique em ⏩ Executar até o fim. O resumo mostra Tempo total: 10 min. O Holarch salva a execução em Resultados salvos ▾.
  5. Encontre o caminho mais longo. Leia a Linha do tempo. Os dois ramos começam juntos, e o ciclo termina quando o mais lento termina: o laço leva 7,25 min (três passagens de 2 min 25 s), Manage Power leva 10 min. Manage Power está no caminho mais longo, então define o tempo total. Altere sua Duração para 5 Minutos.
  6. Execute de novo. Execute até o fim novamente. O tempo total cai para os 7,25 min do laço. O laço agora é o caminho mais longo, e encurtar ainda mais Manage Power não muda nada.
  7. Cheque um requisito de tempo. Defina a Duração de F3 Report Weather como =triang.dist(1, 4, 2) Minutos, para que cada relatório leve entre 1 e 4 minutos. No Simulador, mude para Monte Carlo e clique em ▶ Executar Monte Carlo. Clique em Verificar em relação ao requisito…, escolha Tempo total, ≤ 10 Minutos e o requisito Transmit Weather Report, depois Registrar resultado… e Aplicar. O Holarch registra o resultado em um caso de teste que verifica o requisito (consulte Simulação).

Tutorial 9: Verify the Requirements

Planeje como cada requisito é verificado, registre os resultados e feche as lacunas que a RVTM mostra. O projeto inicial tem os requisitos, com métodos e casos de teste apenas para os requisitos 1 a 3.

  1. Abra a Central de testes. Abra Verificação → Central de testes. Cobertura de verificação lista cada requisito com seu método e seus casos de teste.
  2. Escolha os métodos de verificação. Em Cobertura de verificação, clique nas letras dos métodos (Análise, Demonstração, Inspeção, Teste) para os requisitos que não têm um:
    • 4 Transmit Weather Report: T
    • 5 Operate on Solar Power: A
    • 6 Report Battery Level: I
  3. Leia a RVTM. Abra Verificação → RVTM. Os cartões contam os requisitos por status: dois Aprovados, um Não executado, três Somente planejado (um método, mas nenhum teste). Sem teste em Verificado por marca cada lacuna.
  4. Feche as lacunas. De volta à Central de testes, clique em + Caso de teste nas linhas dos requisitos 4, 5 e 6. Cada novo caso de teste verifica seu requisito e começa como Não executado.
  5. Registre os resultados. Defina o Status de cada caso de teste: clique no status na linha dele e escolha um valor. Os testes dos requisitos 3, 5 e 6 passam: escolha Aprovados. O primeiro relatório do requisito 4 chegou após 12 minutos, então o teste dele é reprovado: escolha Reprovado.
  6. Corrija e teste novamente. O temporizador de relatórios do rádio foi corrigido. Execute novamente o teste reprovado e defina-o como Aprovados. A RVTM agora mostra todos os requisitos como Aprovados.
  7. Exporte a RVTM. Na página RVTM, clique em Exportar ▾ → Excel (.xlsx).

Tutorial 10: Baseline, Change, Impact

Coloque os requisitos sob controle, altere um da forma controlada e trate do que a mudança afeta. O projeto inicial tem o modelo verificado do tutorial 9, com conduits e casos de teste.

  1. Aprove os requisitos. Abra Weather Station Requirements. Selecione cada requisito e clique em Aprovar na caixa Aprovação do inspetor. Uma mudança posterior no texto devolve um requisito aprovado para revisão.
  2. Configure o controle de mudanças. Abra Controle e revisões → Solicitações de mudança. Em Ajustes, marque Os autores podem aprovar suas próprias solicitações de mudança: você trabalha sozinho em um projeto de tutorial. Em uma equipe, outro proprietário ou um comitê de mudanças aprova, e Alterações em itens aprovados e em linha de base exigem uma solicitação de mudança normalmente também fica ativado.
  3. Coloque o projeto em linha de base. Abra Controle e revisões → Linhas de base e versões. Clique em + Salvar linha de base… no cabeçalho da página, digite SRR e clique em Salvar linha de base. A linha de base guarda o modelo inteiro como ele está na System Requirements Review.
  4. Solicite uma mudança. O cliente quer um relatório a cada 5 minutos. Em Solicitações de mudança, clique em Nova solicitação de mudança, digite o título Report every 5 minutes e o motivo Customer asks for faster reports. e clique em Criar.
  5. Prepare a mudança e seu impacto. Clique em Adicionar mudança ▾ → Alterar um item…, escolha 4 Transmit Weather Report e altere sua descrição para The station shall transmit the weather report to the server at intervals of 5 minutes. Clique em Preparar alteração. Em Itens afetados, a lista de impacto sugere os itens rastreados até ele; clique em + ao lado de F3 Report Weather e do caso de teste dele. Clique em Enviar para revisão.
  6. Aprove e aplique. Clique em Aprovar… e confirme (no serviço hospedado, o Holarch pede sua senha antes). Depois clique em Aplicar mudanças. O Holarch aplica a mudança preparada e marca a solicitação como Implementada; um único Desfazer reverte tudo.
  7. Encontre os vínculos a revisar. Abra Necessidades e requisitos → Vínculos a revisar. O novo texto marca os vínculos do requisito 4 para revisão: o que o satisfaz e o verifica pode não servir mais. O requisito 4 voltou a Em revisão.
  8. Revise-os e marque-os como revisados. Clique em Diff para ver o que mudou. F3 ainda satisfaz o requisito, e o teste dele precisa de uma nova execução. Clique em Marcar todos como revisados…, digite o comentário F3 checked; test re-run planned. e clique em Marcar como revisado.
  9. Aprove-o novamente. Abra o requisito 4 e clique em Aprovar de novo. Ele está na linha de base SRR, então uma caixa de diálogo lista os itens rastreados até ele; clique em Aprovar ali. Abra Linhas de base e versões e clique em Comparar em SRR para ver a mudança desde a linha de base.

Tutorial 11: Produce the Deliverable

Transforme o modelo em uma especificação que se mantém atualizada, depois congele-a e exporte-a. O projeto inicial tem o modelo verificado; um caso de teste (requisito 5) ainda não foi executado.

  1. Crie a especificação. Abra Necessidades e requisitos → Documentos e clique em + Novo documento. Dê o nome WS-1 System Specification, escolha o modelo Requirements Specification e clique em Criar. O modelo fornece as seções e orientações de redação.
  2. Insira uma RVTM viva. Selecione a seção 11 Verification Approach. Clique em Escrever ▾ → Inserir ▸ Matriz…, escolha Matriz de rastreabilidade de verificação de requisitos (RVTM), defina o escopo como Weather Station Requirements e clique em Inserir. Clique em ✓ (Salvar) na barra de ferramentas do editor para salvar a seção.
  3. Insira a matriz de alocação. Selecione a seção 3 System Overview e insira a Matriz de alocação (funções para componentes) da mesma forma. Ela mostra a alocação do tutorial 6.
  4. Veja-a atualizar. Abra Verificação → Central de testes e defina Verify Operate on Solar Power como Aprovados. Volte à especificação. O requisito 5 na RVTM agora diz Aprovados: as matrizes acompanham o modelo.
  5. Coloque o documento em linha de base. Na especificação, clique em Versão ▾ no bloco de título e escolha Salvar linha de base…. Dê o nome Issue 1 e clique em Criar.
  6. Exporte para Word. Clique em Entregar ▾ e escolha Especificação (Word). O arquivo Word tem as seções, as matrizes como tabelas e o bloco de título. Entregar ▾ → Imprimir ou PDF… gera um PDF da mesma forma.

Projetos de tutorial e limites do plano

  • Os projetos de tutorial não contam para os 5 projetos ativos do plano Free.
  • Cada projeto de tutorial comporta até 300 itens.
  • Você pode ter um projeto de tutorial por tutorial. Reiniciar… o substitui.
  • Os projetos de tutorial são pessoais: não é possível adicionar editores nem transferi-los. Você pode convidar leitores. Por exemplo, um aluno pode compartilhar um projeto de tutorial com um instrutor como leitor.
  • Os anexos de um projeto de tutorial contam para seu armazenamento como qualquer outro arquivo.