Importar requisitos

Você pode carregar rápida e facilmente seus dados de requisitos existentes no Requirements Portal usando o Import Wizard disponível no Requirements Module.

AI Assisted Requirements Importer

A engenharia de requisitos frequentemente começa com a elaboração de requisitos das partes interessadas em documentos como PDFs e planilhas do Excel, nos quais os dados não são bem estruturados. Extrair dados de requisitos manualmente desses documentos não estruturados pode exigir muito trabalho e estar sujeito a erros e, para agilizar o processo de captura de requisitos no Requirements Portal, você pode aproveitar recursos de IA para importar requisitos de arquivos PDF, Excel, Word e CSV não estruturados.

A funcionalidade de AI-assisted Importer está atualmente em Beta.

Os seguintes campos podem ser importados para requisitos usando o AI-assisted Importer:

  • Identificador

  • Texto

  • Métodos

  • Blocos Aplicáveis

  • Título

  • Justificativa

  • Pais

  • Filhos

  • Tipo

  • Estado

  • Conformidade

  • Comentário de conformidade

  • Responsável

  • Tags

  • Caminho para a Seção

Acessando o Importador

O AI Assisted Importer é habilitado por padrão. Se necessário, ele pode ser desabilitado por um administrador do Workspace usando a opção External Provider na página Settings – ValiAssistant (acessada clicando no ícone  no canto superior direito, selecionando Settings no menu exibido e, em seguida, selecionando ValiAssistant na lista no painel esquerdo) – .

Quando a opção External Provider estiver desabilitada, somente o importador legado poderá ser acessado e usado. Para saber mais sobre o importador legado, consulte a seção Legacy Importer abaixo.

O AI Assisted Importer pode ser acessado a partir do Requirements Module () clicando no botão  no canto superior esquerdo da página e selecionando Create Requirement no menu exibido. Como alternativa, quando a especificação atualmente em exibição não tiver requisitos, o importador poderá ser acessado clicando no botão Import na página.

Fluxo de Importação

Depois que o importador é acessado, a janela Document Import é exibida. Para continuar com o AI Assisted Importer, clique no botão .

Nesta janela, se desejar, você pode optar por usar o importador legado clicando no link open the legacy importer here. O modo de usar o importador legado é descrito abaixo nesta página.

Na próxima etapa, você pode carregar um arquivo de um tipo compatível (*.pdf, *.docx, *.xlsx ou .*csv). Para fazer isso, arraste e solte o arquivo na região correspondente da janela ou clique no controle select from your computer para procurar e selecionar o arquivo no disco rígido.

O tamanho máximo do arquivo para upload é 100 MB.

Embora o arquivo carregado possa ser não estruturado, você pode usar o link Excel template para baixar um arquivo *.xlsx que pode ser usado para capturar requisitos de forma estruturada. Você também pode usar este link para baixar o arquivo.

Assim que o arquivo for carregado com sucesso, sua entrada será mostrada na janela. Você pode removê-lo da janela clicando no ícone . Como alternativa, arraste e solte outro arquivo na janela para substituir o arquivo existente.

Clique no botão  para prosseguir. O importador processará o arquivo carregado. Quando o processo for concluído, os dados extraídos serão apresentados como uma tabela de requisitos sugeridos. Você pode selecionar os requisitos que deseja importar habilitando as caixas de seleção à esquerda das linhas correspondentes.

Por padrão, os requisitos extraídos serão importados para a especificação que estava sendo visualizada quando o Importer foi acessado. Você pode selecionar a especificação desejada escolhendo-a na lista suspensa na parte superior da janela do Importer ou criar uma nova especificação selecionando a entrada As new (creates new specification) na lista suspensa e definindo o nome da nova especificação usando o campo Specification name exibido na janela.

Clique no botão  para prosseguir. Quando a importação for concluída, uma janela de confirmação será exibida.

Se o importador detectar problemas nos requisitos importados, isso será indicado na janela (). Clique no link para baixar um relatório detalhando os motivos dos problemas detectados. 

Clique no botão  para retornar à etapa de upload de arquivo do importador ou clique em  para sair do importador.

Importador Legado

Ao acessar o Importer (saiba mais), você pode optar por continuar com a ferramenta de importação legada para carregar dados de requisitos estruturados. Além disso, o importador legado só está disponível quando a opção External Provider estiver desabilitada nas configurações do Requirements Portal por um administrador.

O processo guia você por três etapas principais: Specification, Upload e Review. Ao concluir uma importação de especificação, é apresentado um resumo, bem como a possibilidade de executar ações adicionais, como Validar ou importar outros arquivos. Essas etapas e ações são descritas nas seções abaixo.

Especificação

Nesta etapa do Import Wizard, você pode definir a especificação de importação de destino:

  • Use a região Select a specification no lado esquerdo da janela Import Requirements para selecionar uma especificação existente e, opcionalmente, sua seção.

  • Use a região Create a specification no lado direito da janela Import Requirements para criar uma nova especificação (e também definir a abreviação e o bloco ao qual será alocada) sem sair do assistente de importação.

Clique na região desejada para usar o método preferido.

 
  • Se o Import Wizard for iniciado no contexto de uma Specification ou de uma Section, isso aparecerá como pré-selecionado para o destino da importação.

  • Caso não haja especificações existentes, uma deverá ser criada.

  • Na definição do nome da nova Specification, as regras de definição de nome devem ser atendidas – somente caracteres alfanuméricos e o caractere especial _ (sublinhado) são permitidos.

Upload

Nesta etapa do Import Wizard, você pode carregar um arquivo de um tipo compatível. Para fazer isso, arraste e solte o arquivo no lado direito da janela Import Requirements ou clique no controle Drop file para procurar e selecionar o arquivo no disco rígido. Assim que o arquivo for carregado com sucesso, uma notificação será mostrada na janela.

 
  • Somente arquivos do Excel (.xls, .xlsx) e Comma Separated Values (.csv) são compatíveis. Arquivos Excel Macro (.xlsm) não são compatíveis.

  • Caso um arquivo não compatível seja carregado, uma mensagem de erro notificará você sobre isso.

  • Quando um arquivo é carregado, você pode continuar o processo de importação ou carregar um novo arquivo (substituindo o anterior).

Revisão

Nesta etapa do Import Wizard, você pode revisar os resultados da importação de dados do arquivo carregado, configurar opções do arquivo e mapear dados do arquivo para campos de requisito.

A região Destination da janela Import Requirements fornece uma indicação visual de onde os dados serão importados (em termos da especificação ou seção).

A região File options fornece as seguintes opções:

  • Update requirements – quando habilitada, quaisquer requisitos existentes na especificação de destino serão sobrescritos pela substituição dos dados (os dados do arquivo substituem os dados na especificação).

    • Se a opção estiver desabilitada e você estiver importando requisitos cujo Identificador já exista na especificação selecionada como destino, o Requirements Portal adicionará o sufixo _import aos identificadores dos requisitos importados para diferenciá-los.

    • Se a opção estiver desabilitada e você estiver importando requisitos cujos Identificadores já existam no projeto atual, mas não na especificação selecionada como destino, o Requirements Portal adicionará um ícone de aviso aos identificadores para alertar sobre um identificador duplicado no mesmo projeto.

    • Se a opção estiver habilitada, valores em branco no arquivo importado são compatíveis, ou seja, se um valor no arquivo estiver em branco, o valor será removido do requisito. Isso também se aplica a campos de seleção múltipla, como Tags.

  • Use header row – você pode decidir usar a linha de cabeçalho do arquivo carregado ou usar uma linha de cabeçalho de referência geral fornecida pelo Requirements Portal (ou seja, cabeçalhos de coluna como A, B, C etc.).

    O Requirements Portal considera a linha de Cabeçalho como a primeira linha de qualquer arquivo carregado.

  • Sheet – no caso de um arquivo com várias planilhas, você pode selecionar de qual planilha deseja importar.

  • Starting row – você pode selecionar a partir de qual linha do arquivo importado os dados devem começar a ser coletados para serem inseridos no Requirements Portal.

Na tabela na parte inferior da janela Import Requirements, você vê uma visualização prévia do arquivo carregado e mapeia suas colunas para campos no Requirements Portal. Isso permite definir como os dados do arquivo corresponderão a campos específicos no Requirements Portal, selecionando o campo apropriado na lista suspensa Map To para cada coluna. Se o arquivo contiver cabeçalhos idênticos aos campos padrão no Requirements Portal, esses campos serão mapeados automaticamente. No entanto, você pode substituir ou ajustar esse mapeamento automático, se necessário.

  • Os seguintes campos podem ser selecionados para o mapeamento:

    • Identificador

    • Texto

    • Título

    • Justificativa

    • Pais

    • Filhos

    • Caminho para a Seção

    • Tipo

    • Estado

    • Tags

    • Conformidade

    • Comentário de conformidade

    • Métodos de V&V

    • Aplicabilidade

    • Blocos aplicáveis

    • Proprietário

    • Tags

    • Colunas personalizadas

  • Filhos, Métodos de V&V, Aplicabilidade, Blocos aplicáveis e Tags podem ser importados com mais de um valor para cada requisito. Para isso, cada valor deve ser separado por vírgula.

  • Se um método de verificação, bloco aplicável, tipo de requisito, estado, conformidade ou tag que está sendo importado não existir atualmente no Requirements Portal, ele será criado automaticamente durante a importação e adicionado ao requisito.

  • Para Aplicabilidade, tipos de bloco compostos podem ser referenciados com um /, por exemplo, block_A/block_B.

  • Para colunas personalizadas, os seguintes tipos estão disponíveis: Select, Multiselect, Texto, Data, Número.

  • Pelo menos a coluna Identificador deve ser selecionada. Caso contrário, uma mensagem de aviso será exibida até que essa condição seja atendida ().

  • Os seguintes campos diferenciam maiúsculas de minúsculas:

    • Tipo

    • Estado

    • Conformidade

    • Tags

    Por exemplo, se a tag TBD já existe no Requirements Portal e a tag tbd está sendo importada, uma nova tag tbd será criada e importada com o requisito.

Relatório de execução

Quando o processo de importação terminar e a importação for concluída com sucesso, uma mensagem de sucesso e as alterações realizadas serão exibidas. Se a importação falhar, uma mensagem de falha será exibida. Um exemplo de importação bem-sucedida é mostrado abaixo.

Se houver quaisquer erros leves, eles também serão exibidos (). Os possíveis erros leves são:

  • A relação não pode ser estabelecida → O identificador de Pai ou Filho não existe no projeto

  • A relação não pode ser estabelecida → O identificador de Pai ou Filho está duplicado no projeto

  • A Declaração de Conformidade do Requisito não existe no projeto

  • O Tipo de Requisito não existe no projeto

  • O Estado do Requisito não existe no projeto

  • A tag não existe no projeto

  • A Condição de Aplicabilidade não existe

Independentemente de a importação ter sido bem-sucedida ou não, você pode reimportar ou realizar uma nova importação clicando em Import new file (sucesso) ou Try again (falha), o que levará você de volta à etapa 1 (Specification).

Após uma importação bem-sucedida, você também pode iniciar o processo Valify clicando no controle Check now na parte superior da janela. Esse processo fará a varredura do texto dos requisitos importados em busca de possíveis parâmetros quantificáveis para serem convertidos em Valis dentro do requisito.

Para mais informações, consulte a página Valify Requirements.

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Conteúdo