Epsilon3

Questa integrazione è composta da due script che si connettono alle API di Requirements & Systems Portal ed Epsilon3. Sono progettati per essere eseguiti dal modulo di scripting di Requirements & Systems Portal, ma possono anche essere adattati per l'uso dall'ambiente desktop di un utente.

Indice dei contenuti

Panoramica

Questa integrazione facilita la sincronizzazione delle Master Procedure da Epsilon3 a Requirements & Systems Portal e automatizza il processo di verifica all'interno di Requirements & Systems Portal utilizzando tali procedure.

File di integrazione

L'integrazione è composta da due script Python principali che possono essere scaricati da questo repository su Github:

1. fetch_master_procedures.py

2. create_check_run.py

Utilizzo

fetch_master_procedures.py

Questo script accede a Epsilon3 e recupera le Master Procedure. Quindi ricrea queste procedure come file simbolici in Requirements & Systems Portal con il formato [P] {Procedure Code} - {Procedure Title}.

Passaggi:

1. Eseguire fetch_master_procedures.py per accedere a Epsilon3 e recuperare le Master Procedure.

2. Le procedure verranno ricreate in Requirements & Systems Portal come file simbolici con il formato [P] {Procedure Code} - {Procedure Title}.

3. Aggiungere questi file di procedura come riferimento di chiusura per un metodo di verifica "Epsilon3 Test" applicato a un requisito di Requirements & Systems Portal.

create_check_run.py

Questo script controlla ogni metodo di verifica "Epsilon3 Test" per un file di procedura. Se trovato, crea un'esecuzione per quella procedura in Epsilon3, crea un file di esecuzione con il formato [R] {Procedure Code} - {Procedure Title}_{Date and Time Stamp} e sostituisce il file di procedura con il file di esecuzione corrispondente come riferimento di chiusura.

Passaggi:

1. Attivare create_check_run.py.

2. Lo script controllerà ogni metodo di verifica "Epsilon3 Test" e creerà un'esecuzione corrispondente in Epsilon3.

3. Se il riferimento di chiusura è già un file di esecuzione, lo script verifica lo stato e lo status correnti in Epsilon3 e aggiorna lo stato della verifica in Requirements & Systems Portal.

Configurazione dell'integrazione

Questi script sono destinati all'esecuzione su progetti specifici e devono essere configurati una volta per ogni progetto di Requirements & Systems Portal.

Prerequisiti:

1. Creare un metodo di verifica personalizzato "Epsilon3 Test" in Requirements & Systems Portal  con "Upload" come riferimento di chiusura.

2. Creare i segreti utente in Requirements & Systems Portal:

   • EPSILON3_API_KEY: Chiave generata in Epsilon3.

   • EPSILON3_TEAM_KEY: Chiave nell'URL della distribuzione Epsilon3 dopo la parte "team/" dell'URL.

Passaggi:

1. Clonare questo repository.

2. Creare i segreti utente come descritto sopra.

3. Modificare gli script in modo che puntino agli URL di base corretti della distribuzione di Requirements & Systems Portal ed Epsilon3.

Personalizzazione

Gli utenti sono incoraggiati a creare i propri branch di questo repository e a personalizzare gli script per adattarli meglio ai propri flussi di lavoro di Requirements & Systems Portal ed Epsilon3.

Limitazioni

• Questi script attualmente funzionano solo con i metodi di verifica dei requisiti originali di Requirements & Systems Portal.

• Non sono ancora compatibili con il nuovo flusso di lavoro del modulo Verification & Validations.

Supporto

Per ulteriore assistenza, fare riferimento all'helpdesk di Epsilon3 oppure contattare il supporto Altium alla pagina di supporto Altium.