Epsilon3

Esta integração consiste em dois scripts que se ligam às APIs do Requirements & Systems Portal e do Epsilon3. Foram concebidos para serem executados a partir do Módulo de Scripting do Requirements & Systems Portal, mas também podem ser adaptados para utilização no ambiente de desktop de um utilizador.

Índice

Visão geral

Esta integração facilita a sincronização de Procedimentos Mestre do Epsilon3 para o Requirements & Systems Portal e automatiza o processo de verificação no Requirements & Systems Portal utilizando esses procedimentos.

Ficheiros de integração

A integração consiste em dois scripts Python principais que podem ser transferidos a partir deste repositório no Github:

1. fetch_master_procedures.py

2. create_check_run.py

Utilização

fetch_master_procedures.py

Este script inicia sessão no Epsilon3 e obtém os Procedimentos Mestre. Em seguida, recria estes procedimentos como ficheiros simbólicos no Requirements & Systems Portal com o formato [P] {Procedure Code} - {Procedure Title}.

Passos:

1. Execute fetch_master_procedures.py para iniciar sessão no Epsilon3 e obter os Procedimentos Mestre.

2. Os procedimentos serão recriados no Requirements & Systems Portal como ficheiros simbólicos com o formato [P] {Procedure Code} - {Procedure Title}.

3. Adicione estes ficheiros de procedimento como referência de fecho para um Método de Verificação "Epsilon3 Test" aplicado a um requisito do Requirements & Systems Portal.

create_check_run.py

Este script verifica cada método de verificação "Epsilon3 Test" relativamente a um ficheiro de procedimento. Se for encontrado, cria uma execução para esse procedimento no Epsilon3, cria um ficheiro de execução com o formato [R] {Procedure Code} - {Procedure Title}_{Date and Time Stamp} e substitui o ficheiro de procedimento pelo ficheiro de execução correspondente como referência de fecho.

Passos:

1. Acione create_check_run.py.

2. O script irá verificar cada método de verificação "Epsilon3 Test" e criar uma execução correspondente no Epsilon3.

3. Se a referência de fecho já for um ficheiro de execução, o script verifica o estado e o estatuto atuais no Epsilon3 e atualiza o estado da verificação no Requirements & Systems Portal.

Configuração da integração

Estes scripts destinam-se a ser executados em projetos específicos e devem ser configurados uma vez por projeto do Requirements & Systems Portal.

Pré-requisitos:

1. Crie um Método de Verificação personalizado "Epsilon3 Test" no Requirements & Systems Portal com "Upload" como referência de fecho.

2. Crie segredos de utilizador no Requirements & Systems Portal:

   • EPSILON3_API_KEY: Chave gerada no Epsilon3.

   • EPSILON3_TEAM_KEY: Chave no URL da implementação do Epsilon3 a seguir à parte "team/" do URL.

Passos:

1. Clone este repositório.

2. Crie os segredos de utilizador conforme descrito acima.

3. Edite os scripts para apontarem para os URLs base corretos do Requirements & Systems Portal e da implementação do Epsilon3.

Personalização

Os utilizadores são incentivados a criar os seus próprios branches deste repositório e a personalizar os scripts para melhor se adequarem aos seus fluxos de trabalho do Requirements & Systems Portal e do Epsilon3.

Limitações

• Atualmente, estes scripts funcionam apenas com os Métodos de Verificação de Requisitos originais do Requirements & Systems Portal.

• Ainda não são compatíveis com o novo fluxo de trabalho do módulo Verification & Validations.

Suporte

Para obter assistência adicional, consulte o helpdesk do Epsilon3 ou contacte o Suporte da Altium na Página de Suporte da Altium.