Especificando o Produto

Nesta parte do tutorial, veremos um dos principais fluxos de usuário que podem ajudar você a começar a usar o Requirements Portal:

• Coletar e escrever requisitos

• Decompor requisitos

• Revisar e melhorar requisitos

• Aprovar e liberar especificações

Criando um Novo Projeto

1. Na página Home do Requirements Portal (acessada ao abrir o Requirements Portal pelo menu de nove pontos no canto superior direito da interface do Workspace baseada em navegador – ), clique no botão  acima da lista de projetos de requisitos.

   

2. A janela Create Requirements Project será aberta, onde você poderá especificar os detalhes do projeto:

   • Project Name – insira um nome de projeto adequado (e exclusivo) (por exemplo, Valifan).

   • Description – insira uma descrição opcional para o projeto (por exemplo, Amazing Valifan project).

   • Electronics Project – deixe este campo em branco. 

   Depois de especificar os detalhes do projeto, clique no botão .

   

3. O projeto de requisitos aparecerá na lista da página Home. Clique no nome dele para abri-lo em uma nova guia do navegador.

   

Definindo Requisitos das Partes Interessadas

A maior parte do projeto e desenvolvimento de sistemas segue o ciclo V. O primeiro processo em um ciclo V é entender as necessidades do negócio e identificar as necessidades das partes interessadas. Essas necessidades das partes interessadas são então convertidas em requisitos das partes interessadas, que podem ser criados diretamente, importados por CSV/XLSX ou até mesmo criados por meio do ValiAssistant com IA. Nesta parte do tutorial, vamos nos concentrar no método de importação.

1. Baixe o seguinte arquivo CSV que contém os requisitos das partes interessadas:

   Valifan_stakeholder_Requirements.csv

2. Se ainda não estiver lá, navegue até o Módulo de Requisitos clicando na entrada Requirements na árvore do projeto à esquerda.

3. Clique no botão  na página que será aberta e selecione Import Requirements no menu exibido.

   

4. Na janela Document Importer que será aberta, arraste e solte o arquivo CSV baixado na área Drop your file here ou clique no link upload from your computer para enviar o CSV, para que o assistente de importação possa ler e importar o arquivo.

   

5. A entrada do arquivo enviado aparecerá na janela. Ative a opção Classic Import (Non-AI) no canto inferior esquerdo da janela e então clique no botão  para prosseguir.

   

6. Na próxima etapa, selecione + Add specification na lista suspensa no canto superior esquerdo e insira o nome de uma nova especificação (por exemplo,Stakeholder_requirements) na qual os requisitos serão importados. Certifique-se de que as colunas de dados do arquivo CSV estejam corretamente mapeadas para as colunas no Requirements Portal. Se necessário, use as listas suspensas nos cabeçalhos das colunas.

   

7. Certifique-se de que a opção Parametrize values esteja ativada e de que todos os requisitos estejam selecionados para importação (todas as caixas de seleção na coluna mais à esquerda da tabela estejam ativadas) e então clique em  para prosseguir.

   

8. A próxima página do assistente notificará você sobre a importação bem-sucedida. Feche a janela para prosseguir.

   

9. Uma nova especificação foi criada, e todos os requisitos foram importados para ela. Os valores e unidades detectados foram transformados de texto simples em valis (parâmetros), que são destacados nos requisitos.

   

Adicionando Requisitos de Sistema

Em um fluxo típico de engenharia de sistemas, os requisitos de sistema são criados a partir dos requisitos das partes interessadas. A maioria dos projetos técnicos deve atender a requisitos rigorosos, como requisitos de massa, consumo de energia e custo. O Requirements Portal fornece uma visão abrangente de quão bem um projeto atende a todos esses requisitos.

Agora, criaremos manualmente alguns requisitos de sistema.

1. Clique com o botão direito na entrada Requirements na árvore do projeto à esquerda e selecione Create Specification no menu exibido. Na janela Create new specification, insira Fan_Specs no campo Name e clique em .

   

2. Clique na entrada da especificação recém-criada na árvore do projeto. Dentro dessa especificação, clique em  o botão  e selecione Create Requirement no menu exibido.

   

3. A janela Create Requirement será aberta. Nessa janela:

   1. No campo Identifier, insira um identificador exclusivo, por exemplo, R-Fan-001.

   2. No campo Text, insira The Mass of the fan shall not exceed 300g.

   3. Clique no botão  e certifique-se de que a especificação correta esteja selecionada (Fan_Specs) no campo Specification.

   4. Certifique-se de que a opção Parametrize values esteja ativada.

      Quando essa opção está ativada, os valores numéricos dentro do requisito são verificados e convertidos diretamente em valis por meio do recurso de parametrização.

   5. Clique no botão .

   

4. Da mesma forma, adicione outro requisito com o identificador R-Fan-002 e o texto de requisito The Mass of the propeller shall not exceed 50g, mas desta vez desative a opção Parametrize values (um vali será criado manualmente a partir de um valor dentro desse requisito mais tarde).

   

5. Os requisitos adicionados serão listados quando a especificação Fan_Specs estiver selecionada. Observe que, enquanto R-Fan-001 possui um vali, R-Fan-002 ainda não possui um vali.

   

Criando Valis de Requisito em um Requisito

Agora, criaremos manualmente um novo vali dentro do campo de texto do requisito.

1. Clique duas vezes na célula da coluna Text do requisito R-Fan-002 e exclua o texto 50g.

   

2. Digite $ para exibir um pop-up com uma lista de valis/objetos dentro do projeto. No canto superior direito do pop-up, clique no botão  para criar um vali.

   

3. Na janela Create new que será aberta. Na guia Vali da janela, insira os seguintes dados para o novo vali:

   1. Name: Req_Mass_Propeller

   2. Formula and unit: 50g

   3. Display unit: g

      O campo Display unit é opcional. Se for deixado vazio, ele obterá a unidade do campo Formula and unit .

   

4. Clique no botão  para criar um novo vali e inseri-lo no campo Text do requisito e então pressione Enter ou clique em algum lugar da tabela fora da célula para concluir a edição.

5. Agora, o texto 50g aparece de forma diferente do texto comum, o que indica um vali. Esse vali agora pode ser usado em diferentes partes do projeto (por exemplo, relatórios, Módulo Blocks, verificação etc.).

   

Decompondo Requisitos com Relações de Pai e Filho

1. Clique no controle Columns à direita da tabela e certifique-se de que as entradas das colunas Parents e Children estejam marcadas para que sejam exibidas na tabela.

   

   Clique novamente no controle Columns para ocultar a lista.

2. Clique duas vezes na célula da coluna Parent do requisito R-Fan-002 e selecione o requisito R-Fan-001 no pop-up para vincular ambos os requisitos. Observe que R-Fan-002 será adicionado automaticamente à coluna Children de R-Fan-001.

   

   

    

3. Clique na guia Connections na parte superior da tabela de requisitos para abrir um grafo de conexões que mostra a relação pai-filho da especificação selecionada.

   As caixas azuis ao redor dos requisitos indicam a especificação em que eles estão.

   

Gerando Requisitos Usando o Engineering Assistant

Para acelerar seu processo de gerenciamento de requisitos, você pode gerar requisitos/decompor requisitos usando o Engineering Assistant. Nós o usaremos para criar dois requisitos de segurança para o projeto do tutorial.

1. Clique no botão  no canto superior direito para abrir o painel Engineering Assistant.

   

    

2. No painel Engineering Assistant, você pode descrever seu produto, sistema, subsistema e fornecer o máximo de informações possível para que a IA possa propor os melhores requisitos para sua descrição. Como estamos interessados em requisitos de segurança, solicite dois requisitos de segurança para nosso ventilador inserindo um prompt no campo Ask anything na parte inferior do painel:

   Create 2 safety requirements for designing a fan. Apply the INCOSE guide to writing requirements.

   Clique em  ou pressione Enter para prosseguir.

   

3. Os requisitos sugeridos serão apresentados na região de grade da tabela da especificação. Clique no botão  no painel Engineering Assistant para criar novos requisitos conforme sugerido.

   

   

    

4. Os requisitos gerados podem ser alterados a qualquer momento após a criação. Se necessário, altere os identificadores dos requisitos gerados para R-Fan-003 e R-Fan-004 clicando duas vezes nas células deles na coluna Identifier, inserindo o texto e pressionando Enter ou clicando em algum lugar da tabela fora da célula para concluir a edição.

Atualizando, Gerenciando e Revisando Requisitos

Ao longo do processo de desenvolvimento, é comum que os requisitos evoluam e sejam atualizados com base em vários fatores, como contribuições das partes interessadas e restrições de projeto. No Requirements Portal, você pode atualizar requisitos diretamente clicando duas vezes nos campos das colunas ou dentro da seção de detalhes do requisito, e todas as alterações são registradas no histórico para fácil referência.

1. Entre no modo de edição do texto do requisito R-Fan-003 ou R-Fan-004 clicando duas vezes em sua célula na coluna Text. Altere o texto para The fan shall include a protective guard with openings no larger than inches to prevent accidental contact with moving parts. e pressione Enter ou clique em algum lugar da tabela fora da célula para concluir a edição.

   

   

   

    

2. Clique no identificador do requisito alterado para abrir sua visualização detalhada, de onde você pode ajustar campos adicionais, assinar, definir proprietários, adicionar uma justificativa, criar pais/filhos etc.

   

3. A rastreabilidade é um conceito fundamental do Requirements Portal, e todas as alterações são rastreadas no histórico dos requisitos e de outros objetos. Clique em History para abrir uma visualização que fornece informações sobre versões, quem fez uma alteração e quando, além de campos e ações.

   

Validando Requisitos

Nos estágios iniciais do ciclo de vida do produto, é crucial validar os requisitos antes de avançar com o processo de projeto. O Requirements Portal fornece uma maneira conveniente de gerenciar estados de requisitos usando a coluna State. Por padrão, estados como Draft, In Review e Final estão incluídos, mas você pode adicionar estados adicionais com base em necessidades específicas.

Nesta parte do tutorial, você atribuirá o estado Draft aos requisitos recém-adicionados, garantindo um fluxo de trabalho estruturado e organizado.

1. Na especificação Fan_Spec, clique no controle Columns à direita da tabela e certifique-se de que a entrada da coluna State esteja marcada para que ela seja exibida na tabela.

   

2. Marque a caixa à esquerda do cabeçalho da coluna Identifier para selecionar todos os requisitos da especificação.

   

3. Clique duas vezes em uma célula de qualquer requisito na coluna State (se necessário, role a tabela para a direita para ver a coluna) para abrir uma lista suspensa com as opções disponíveis para o estado. Selecione Draft na lista suspensa e confirme a atualização. Todos os requisitos ficarão com o estado Draft.