Capítulos do curso
Treinamento · Trilha 6. Migrar para o Holarch · Capítulo 6.3 de 5
6.3 Requisitos a partir de Word e ReqIF 2:22
Importe uma especificação do Word como documento e o arquivo ReqIF de um fornecedor com sua hierarquia e seus vínculos.
Mostra o Holarch 2.21.
O que você vai aprender
- Explicar quais partes de um arquivo Word viram seções e quais viram requisitos
- Importar uma especificação do Word como documento de requisitos numerado
- Importar um arquivo ReqIF com sua hierarquia, atributos e relações
- Conferir uma relação importada na seção Rastreabilidade
Importe do Word a especificação da carga útil do Plant Inspection Drone, onde os títulos viram seções e as frases com shall viram requisitos, e do ReqIF os requisitos do fornecedor da bateria, com sua hierarquia, seus atributos e um relacionamento refines.
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.
- 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).
- No mesmo documento, clique em Entregar ▾ → Requisitos (ReqIF)… e clique em Exportar.
- Em Gerenciar projetos, clique em + Novo projeto, dê o nome
EO-1 Import Practicee clique em Criar projeto. Abra Necessidades e requisitos → Importar e exportar, solte o .docx, clique em Continuar duas vezes e importe-o. - Compare o novo documento com a SRS: observe quais títulos viraram Statements e quais frases com shall viraram Requirements, e como foram nomeados.
- 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.
Teste-se
- O que a importação do Word lê como seção, e o que lê como requisito?
- Um fornecedor pode enviar Word ou ReqIF. Por que pedir ReqIF?
- Uma relação do ReqIF tem um nome que o Holarch não conhece. O que acontece?
Mostrar as respostas
O que a importação do Word lê como seção, e o que lê como requisito?
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.
Um fornecedor pode enviar Word ou ReqIF. Por que pedir ReqIF?
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.
Uma relação do ReqIF tem um nome que o Holarch não conhece. O que acontece?
Ela entra como traced to. Se o esquema não permitir traced to entre as duas classes, a relação é ignorada com um aviso.
Saiba mais
Transcrição
Mostrar a transcrição (narração e o que aparece na tela)
Introduction
Chapter three: requirements from Word and ReqIF. Many specifications live in Word, and many suppliers exchange requirements as ReqIF files. Both come in through the same Import and Export page.
We import the payload specification and the battery supplier's requirements into the Plant Inspection Drone project.
Word
The Word file uses heading styles for its sections, and plain sentences with shall for its requirements. That is what the Word import reads. Heading styles or Word's list numbering matter: headings typed as ordinary bold text are read as ordinary text.
On screen: Card: what Holarch reads in Word.
Open Import and Export, and drop the file. Holarch detects Word from the file and analyzes it.
On screen: Import and Export → drop the .docx → Word detected.
Click Continue. The numbering pattern stays automatic, which uses numbered headings and shall sentences. Click Continue for the review: Holarch creates a requirements document with the name of the file, and lists the sections and the requirements under them.
On screen: Continue → Map: numbering → Continue → Review.
Click Import. The document opens, numbered from the Word headings, with each shall sentence as a requirement you can now trace and check.
On screen: Import → the document.
ReqIF
Now the supplier's file. ReqIF is the standard exchange format between requirements tools. Open Import and Export again, and drop the file.
On screen: Import and Export → drop the .reqif → ReqIF detected.
Click Continue. Each requirement in the file is a row. Its ReqIF identifier and its parent rebuild the hierarchy, its type becomes the class, and its attributes map by name: the chapter name to the number, the name, and the text to the description.
On screen: Continue → Map.
Click Continue, check the review, and click Import.
On screen: Continue → Review → Import.
Check the result
The supplier's relations come in as relationships. Select Charge Time, and open Trace: it refines Pack Capacity, just as the file says.
On screen: Select B.4 Charge Time → Trace.
Recap
Let's recap. You imported a Word specification, where headings became sections and shall sentences requirements, and a supplier's ReqIF file, with its hierarchy, attributes and relations.
Next, a whole model from another tool.