Holarch

Treinamento · Trilha 4. Documentos e entregáveis

Trilha 4. Documentos e entregáveis: folha de exercícios

Para engenheiros e líderes. 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
Capítulo 1.5 Documentos; as trilhas 2 e 3 tornam as matrizes mais úteis.
Plano
Gratuito
Projeto
A Bike-Share Dock: cada capítulo tem seu arquivo inicial.

4.1 Modelos de documento

Assistir ao capítulo 4.1 (2:54)

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 Interface Control Document.
  3. Em Modelos para, escolha Documento de controle de interfaces, marque Incluir orientações de redação, escolha o cartão Documento de controle de interfaces (ICD) e clique em Criar.
  4. Selecione a seção 2.3 Interface Owners and Change Authority e leia suas orientações. Clique na descrição, substitua as orientações pelos responsáveis pelas interfaces do EO-1 (por exemplo, o Payload Lead e o Comms Lead) e pressione ⌘ / Ctrl↵ para salvar.
  5. Selecione a seção 3.2 Interface Matrix e leia a matriz de interfaces ao vivo que o modelo colocou ali.
  6. Para um passo a passo checado, execute o tutorial 11 Produce the Deliverable (Ajuda → Tutoriais).

Você terminou quando o novo ICD mostrar seu próprio texto em 2.3 no lugar das orientações, e 3.2 mostrar uma matriz dos componentes do EO-1.

Perguntas

  1. O que decide quais modelos Novo documento oferece primeiro?
  2. Qual é a diferença entre um modelo com e sem orientações de redação?
  3. Por que importa que cada seção seja um item do modelo?

4.2 Matrizes ao vivo em documentos

Assistir ao capítulo 4.2 (2:48)

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 → EO-1 System Requirements Specification e clique na descrição da seção 2 Attitude Determination and Control para editá-la.
  3. Na barra de ferramentas de rich text, abra + e escolha Matriz…. Escolha Matriz de alocação de requisitos, mantenha o escopo neste documento, clique em Inserir e pressione ⌘ / Ctrl↵ para salvar.
  4. Leia a legenda e as linhas sombreadas. 2.5 Safe Mode Recovery é uma lacuna: nada o atende.
  5. Selecione 2.5 e, na sua seção Rastreabilidade, vincule F10 Enter Safe Mode em satisfied by. Volte à seção 2 e leia a matriz de novo.

Você terminou quando a linha 2.5 da matriz de alocação listar F10 Enter Safe Mode e não estiver mais sombreada.

Perguntas

  1. Em que uma matriz ao vivo difere de uma tabela que você digita?
  2. Por que você fecha uma lacuna no modelo, e não na matriz?
  3. Quais escopos uma matriz pode cobrir?

4.3 Saída em Word e Excel

Assistir ao capítulo 4.3 (2:10)

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 EO-1 System Requirements Specification e escolha Entregar ▾ → Configurar página…. Em Marcação, escolha Marcação própria e defina um cabeçalho e um rodapé como EO-1 Program Internal.
  3. Marque Página de capa com Versão 2.0 e Preparado por EO-1 Systems Team, marque Números de página e clique em Aplicar.
  4. Escolha Entregar ▾ → Cópia para revisão (Word) e abra o arquivo: páginas em paisagem com as colunas de atributos sob cada item, e a marcação em todas as páginas.
  5. Escolha Entregar ▾ → Matriz de rastreabilidade…. Escolha a RVTM, defina Modelo como SRR Baseline e Exportar como como Matriz (Excel), leia a contagem de linhas e de lacunas e clique em Exportar.

Você terminou quando tiver um arquivo Word com a página de capa, a marcação e os números de página, e uma RVTM em Excel da SRR Baseline com suas lacunas sombreadas.

Perguntas

  1. Qual marcação um documento usa?
  2. Qual é a diferença entre um modelo do Word e um modelo de documento?
  3. De onde vêm as tabelas Revision History e Approvals de uma exportação para o Word?
  4. Por que exportar uma matriz a partir de uma linha de base em vez do modelo atual?

4.4 Pacotes de revisão e linhas de base

Assistir ao capítulo 4.4 (2:35)

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). Esta tarefa também usa o EO-1 Interface Control Document do capítulo Modelos de documento; crie-o primeiro se você pulou esse capítulo.
  2. Abra EO-1 System Requirements Specification, clique em Solicitar revisão ao lado do tipo de documento, deixe todos desmarcados e clique em Solicitar revisão. A faixa sob o título mostra a revisão.
  3. Clique em Versão ▾ → Salvar linha de base…, dê a ela o nome PDR Baseline, preencha seu papel, clique em + Adicionar aprovador para um segundo aprovador e clique em Criar.
  4. Mude 2.4 Target Slew para 45 segundos. Depois escolha Versão ▾ → Comparar versões… com De PDR Baseline e Para Versão atual, e clique em Alterações (Excel).
  5. Abra Controle e revisões → Revisões, clique em + Novo pacote de revisão e dê a ele o nome PDR review package. Escolha Escrever ▾ → Inserir ▸ Documento… duas vezes para adicionar a SRS e o ICD.
  6. Escolha Entregar ▾ → Configuração do entregável… e defina Exportar cada parte a partir de como PDR Baseline para a parte da SRS; depois escolha Entregar ▾ → Especificação (Word).

Você terminou quando o relatório de alterações listar a edição de 2.4 e o arquivo Word do pacote tiver a Parte A e a Parte B, com a parte da SRS a partir da PDR Baseline.

Perguntas

  1. O que uma linha de base de documento contém, e ela pode mudar depois?
  2. Em que uma linha de base de documento difere de uma linha de base do projeto?
  3. Seu pacote deve exportar a SRS da linha de base, não as edições de hoje. Como?
  4. O que acontece com uma revisão depois que você clica em Solicitar revisão?

4.5 Apresentações a partir do modelo

Assistir ao capítulo 4.5 (1:59)

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 Planejar → Apresentações e clique em + Nova apresentação. Dê a ela o nome EO-1 PDR Briefing, defina Começar a partir de como Um esboço de documento com EO-1 System Requirements Specification e clique em Criar.
  3. Dê um clique duplo no título do primeiro slide, digite EO-1 Preliminary Design Review e pressione Esc.
  4. Clique em + Novo slide ▾, escolha Em branco, depois Imagem ▾ → Imagem de… e escolha o FFBD de F0 Perform EO-1 Mission.
  5. Clique em ▶ Apresentar ▾ → Apresentar do slide atual, avance com → e termine com Esc. Depois clique em Exportar… e escolha Apresentação (PowerPoint).

Você terminou quando a apresentação tiver um slide de título, um slide por seção da SRS e uma imagem ao vivo do FFBD, e você tiver o arquivo do PowerPoint.

Perguntas

  1. O que mantém uma imagem em um slide atualizada?
  2. Quando você começaria uma apresentação a partir de um esboço de documento?
  3. Para quais formatos uma apresentação pode ser exportada?

Gabarito

4.1 Modelos de documento

  1. O tipo de documento escolhido em Modelos para. Os modelos de outros tipos continuam listados em Outros modelos; o documento recebe o tipo do modelo que você escolher.
  2. Ambos dão as mesmas seções numeradas e tabelas iniciais. Com orientações, cada seção também começa com um breve guia do que deve conter, que você substitui enquanto escreve.
  3. Uma seção é um Statement, então você pode vinculá-la, comentá-la e colocá-la em uma linha de base como um requisito, e o documento continua sendo uma visão do modelo.

4.2 Matrizes ao vivo em documentos

  1. O bloco guarda apenas qual matriz e qual escopo mostrar. O Holarch reconstrói as linhas a partir do modelo toda vez que o documento é exibido ou exportado, então ela nunca fica desatualizada.
  2. Uma matriz ao vivo não pode ser editada célula por célula. A lacuna é um vínculo ou atributo que falta no modelo, e corrigi-la ali atualiza todas as matrizes e visões que a mostram.
  3. Os itens de um documento, todas as partes de uma compilação ou o projeto inteiro. As matrizes de interfaces e N² também podem cobrir os filhos de um Asset ou de uma Action.

4.3 Saída em Word e Excel

  1. A mais próxima: a marcação do próprio documento; senão, a do projeto; senão, a da organização. Sem marcação, ele fica sem marcação.
  2. Um modelo de documento preenche o conteúdo: seções e tabelas iniciais. Um modelo do Word dá forma ao arquivo Word: sumário, numeração de legendas, tamanho da página e tabelas da parte pré-textual.
  3. Das linhas de base do documento e de seus registros de aprovação, quando o modelo do Word os inclui, como faz o Especificação.
  4. Um comitê de revisão anota o que foi acordado. Escolher uma linha de base em Modelo exporta a matriz como ela era naquela linha de base, não como é hoje.

4.4 Pacotes de revisão e linhas de base

  1. Um instantâneo somente leitura do documento: seus itens, os atributos e relacionamentos deles e os itens a um relacionamento de distância. Você pode renomeá-la e adicionar aprovações, mas os registros de aprovação existentes não podem ser editados.
  2. Uma linha de base de documento contém um único documento e é salva pelo seu Versão ▾. Uma linha de base do projeto contém todos os itens do projeto e é salva com + Salvar linha de base… em Controle e revisões → Linhas de base e versões.
  3. No pacote, defina Exportar cada parte a partir de como essa linha de base em Configuração do entregável…. Uma parte fixada mostra 📌 e o nome da linha de base, e exporta o conteúdo da linha de base.
  4. O documento fica In Review. Os revisores do projeto, ou as pessoas que você indicou, o recebem em Documentos a revisar, em Meu trabalho, e o aprovam ou rejeitam ali ou na faixa sob o título.

4.5 Apresentações a partir do modelo

  1. Uma imagem feita com Imagem de… mostra uma visão do modelo, não uma cópia. Quando o diagrama, o documento ou o gráfico muda, o slide mostra a mudança.
  2. Quando a apresentação segue um documento: você obtém um slide de título mais um slide por seção de nível superior com o texto da seção, pronto para enxugar.
  3. PowerPoint, Word e uma página web para a apresentação inteira, e PNG ou SVG para o slide atual.

Publicado por Holarch