Epsilon3

Diese Integration besteht aus zwei Skripten, die eine Verbindung zu den APIs von Requirements & Systems Portal und Epsilon3 herstellen. Sie sind für die Ausführung im Scripting Module von Requirements & Systems Portal vorgesehen, können aber auch für die Nutzung in der Desktop-Umgebung eines Benutzers angepasst werden.

Inhaltsverzeichnis

Überblick

Diese Integration ermöglicht die Synchronisierung von Master Procedures aus Epsilon3 mit Requirements & Systems Portal und automatisiert den Verifizierungsprozess innerhalb von Requirements & Systems Portal mithilfe dieser Verfahren.

Integrationsdateien

Die Integration besteht aus zwei zentralen Python-Skripten, die aus diesem Repository auf Github heruntergeladen werden können:

1. fetch_master_procedures.py

2. create_check_run.py

Verwendung

fetch_master_procedures.py

Dieses Skript meldet sich bei Epsilon3 an und ruft die Master Procedures ab. Anschließend erstellt es diese Verfahren in Requirements & Systems Portal als symbolische Dateien im Format [P] {Procedure Code} - {Procedure Title}.

Schritte:

1. Führen Sie fetch_master_procedures.py aus, um sich bei Epsilon3 anzumelden und Master Procedures abzurufen.

2. Die Verfahren werden in Requirements & Systems Portal als symbolische Dateien im Format [P] {Procedure Code} - {Procedure Title} neu erstellt.

3. Fügen Sie diese Verfahrensdateien als Close-out-Referenz für eine Verifizierungsmethode „Epsilon3 Test“ hinzu, die auf eine Anforderung in Requirements & Systems Portal angewendet wird.

create_check_run.py

Dieses Skript prüft jede Verifizierungsmethode „Epsilon3 Test“ auf eine Verfahrensdatei. Wenn eine gefunden wird, erstellt es in Epsilon3 einen Run für dieses Verfahren, erzeugt eine Run-Datei im Format [R] {Procedure Code} - {Procedure Title}_{Date and Time Stamp} und ersetzt die Verfahrensdatei als Close-out-Referenz durch die entsprechende Run-Datei.

Schritte:

1. Lösen Sie create_check_run.py aus.

2. Das Skript prüft jede Verifizierungsmethode „Epsilon3 Test“ und erstellt in Epsilon3 einen entsprechenden Run.

3. Wenn die Close-out-Referenz bereits eine Run-Datei ist, prüft das Skript den aktuellen Zustand und Status in Epsilon3 und aktualisiert den Verifizierungsstatus in Requirements & Systems Portal.

Einrichtung der Integration

Diese Skripte sind für die Ausführung in bestimmten Projekten vorgesehen und sollten einmal pro Requirements & Systems Portal-Projekt eingerichtet werden.

Voraussetzungen:

1. Erstellen Sie in Requirements & Systems Portal eine benutzerdefinierte Verifizierungsmethode „Epsilon3 Test“ mit „Upload“ als Close-out-Referenz.

2. Erstellen Sie Benutzerschlüssel in Requirements & Systems Portal:

   • EPSILON3_API_KEY: In Epsilon3 generierter Schlüssel.

   • EPSILON3_TEAM_KEY: Schlüssel im URL-Pfad der Epsilon3-Bereitstellung nach dem Teil „team/“.

Schritte:

1. Klonen Sie dieses Repository.

2. Erstellen Sie die Benutzerschlüssel wie oben beschrieben.

3. Bearbeiten Sie die Skripte so, dass sie auf die korrekten Basis-URLs der Bereitstellungen von Requirements & Systems Portal und Epsilon3 verweisen.

Anpassung

Benutzer werden dazu ermutigt, eigene Branches dieses Repositorys zu erstellen und die Skripte anzupassen, damit sie besser zu ihren Workflows in Requirements & Systems Portal und Epsilon3 passen.

Einschränkungen

• Diese Skripte funktionieren derzeit nur mit den ursprünglichen Requirements Verification Methods von Requirements & Systems Portal.

• Sie sind noch nicht mit dem neuen Workflow des Verification & Validations Module kompatibel.

Support

Für weitere Unterstützung wenden Sie sich bitte an den Epsilon3-Helpdesk oder kontaktieren Sie den Altium Support über die Altium Support-Seite.