Holarch
Capítulos do curso

Treinamento · Trilha 4. Documentos e entregáveis · Capítulo 4.4 de 5

4.4 Pacotes de revisão e linhas de base 2:35

Congele o que é revisado, veja o que mudou desde então e entregue aos revisores um único pacote.

Mostra o Holarch 2.41.

O que você vai aprender

  • Salvar uma linha de base do documento com registros de aprovação
  • Comparar uma linha de base com a versão atual e exportar as alterações
  • Solicitar a revisão de um documento com Solicitar revisão
  • Montar um pacote de revisão a partir de vários documentos e exportá-lo como um único arquivo Word

Prepare a Bike-Share Dock para a revisão de requisitos do sistema: coloque a especificação em uma linha de base com sua aprovação, altere um requisito e leia o relatório de mudanças em relação à linha de base, depois monte um pacote de revisão que reúne a especificação e o plano de gerenciamento de engenharia de sistemas.

Arquivos de projeto

  • Projeto inicial (.holarch.json; Gerenciar projetos → Arquivos de projeto ▾ → Importar projeto (.json)…)
  • Projeto concluído (.holarch.json; Gerenciar projetos → Arquivos de projeto ▾ → Importar projeto (.json)…)

O vídeo é reproduzido a partir de holarch.app; veja a Política de Privacidade.

Prática

Faça isto você mesmo no Holarch, 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.

Teste-se

  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?
Mostrar as respostas
  1. O que uma linha de base de documento contém, e ela pode mudar depois?

    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. Em que uma linha de base de documento difere de uma linha de base do projeto?

    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. Seu pacote deve exportar a SRS da linha de base, não as edições de hoje. Como?

    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 que acontece com uma revisão depois que você clica em Solicitar revisão?

    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.

Saiba mais

Transcrição

Mostrar a transcrição (narração e o que aparece na tela)

Introduction

Chapter four: review packages and baselines. Before a review, you freeze what is being reviewed, and you hand the reviewers one package.

You will baseline a document with its approval, see what changed since the baseline, and build a review package from several documents.

Baseline a document

Open the system requirements. In the version menu at the top of the document, choose Save Baseline.

On screen: Documents → the SRS → Version ▾ → Save Baseline….

Name it SRR Baseline, for the system requirements review. The approval is filled in with your name. Add the role, Lead Systems Engineer. Approval records are dated now and cannot be edited later. Click Create.

On screen: Name, approval role → Create.

The version menu now lists it. A baseline is a read-only snapshot of the document: its items, their attributes and their relationships.

On screen: Version ▾: the baseline.

What changed since

Now a change arrives: the footprint grows shorter. In the outline, open section 10, and change requirement 10.1 to two by eleven meters.

On screen: Outline → 10.1 → edit its description.

Open the version menu, and choose SRR Baseline. Holarch shows the document as it was, read-only, with its approval. Click Compare to Current.

On screen: Version ▾ → SRR Baseline → Compare to Current.

The change report lists every item that changed since the baseline, with the field and the change marked. Reviewers can see exactly what moved, and the report exports to Excel.

On screen: Baseline Change Report.

Build a review package

Now the review package. Open Plan and Deliver, then Review Packages, and click New Review Package. Name it SRR Review Package, and click Create.

On screen: Plan & Deliver → Review Packages → + New Review Package.

A review package is a document that holds other documents. In Write, choose Insert, then Document, and pick the system requirements.

On screen: Write ▾ → Insert → Document… → the SRS.

Insert the systems engineering management plan the same way. Each document keeps its own sections, below it.

On screen: Write ▾ → Insert → Document… → the SEMP.

The package has its own page setup, so it can carry a cover page of its own. From Deliver, choose a Word template, and the whole package becomes one file for the review board.

On screen: Deliver ▾ → Specification (Word).

Recap

Let's recap. You baselined a document with its approval, read what changed since the baseline, and built a review package from two documents.

Next, you present the model to the review board with slides that stay up to date.