Externe Bedingungen

Externe Bedingungen ermöglichen es, bestimmte Prüfungen oder Validierungen für Vorgänge in Visual Planning durch eine externe Schnittstelle auszuführen. Ähnlich wie bei den externen Filtern wird die Logik nicht direkt in Visual Planning, sondern über eine externe API-Schnittstelle ausgeführt. Dies ermöglicht eine flexible Prüfung von Vorgängen basierend auf externen Bedingungen.

URL für Externe Bedingungen

Um eine externe Bedingung zu überprüfen, wird eine GET-Anfrage mit einer URL wie die folgende gesendet:

GET /?UID=5CD2-5B9F-DB40-2F95-CAB0-8EA4-EF2A-5347&SRCPLANNING=Dokumentation_VP9&USERNAME=admin&ACCESSTOKEN=c86a83ce-5901-a0b4-8656-db8849a8a209 

Parameterbeschreibung

Die GET-Anfrage enthält mehrere Parameter, die zur Überprüfung und Authentifizierung der Bedingung notwendig sind:

• UID: Die eindeutige Identifikationsnummer (UID) des Vorgangs, der geprüft werden soll. Dieser Parameter ermöglicht es, die Prüfung auf einen spezifischen Vorgang anzuwenden.

• SRCPLANNING: Der Name der Planung, aus der die Bedingung aufgerufen wurde. Dieser Parameter gibt den Kontext der Anfrage an und stellt sicher, dass die Bedingung für die richtige Planung ausgeführt wird.

• USERNAME: Der Benutzername des Nutzers, der die Bedingung aufgerufen hat. Dieser Parameter kann genutzt werden, um benutzerspezifische Prüfungen zu initiieren oder Benutzeraktionen nachzuverfolgen.

• ACCESSTOKEN: Ein Token, der vermutlich zur Authentifizierung des Benutzers (USERNAME) dient. Aktuell ist jedoch nicht klar, wie oder wo dieser Token eingesetzt wird.

Erwartete Antwort im JSON-Format

Das Visual Planning erwartet eine Antwort im JSON-Format, die den Status der Bedingungsprüfung zurückgibt. Die Struktur der Antwort sollte wie folgt aussehen:

• status: Die Antwort sollte entweder "OK" oder "KO" lauten. "OK" zeigt an, dass die Bedingung erfüllt ist, während "KO" signalisiert, dass die Bedingung nicht erfüllt wurde.

Beispiel einer funktionierenden Anfrage und Antwort

Beispiel einer erfolgreichen Antwort, in der die Bedingung erfüllt ist:

{"status": "OK"}

Beispiel einer Antwort, in der die Bedingung nicht erfüllt ist:

{"status": "KO"}

Hinweise zur Implementierung

• Stored Procedures: Die Verwendung von Stored Procedures funktioniert für die externe Bedingungsprüfung nicht. Stattdessen muss die Logik zur Bedingungsüberprüfung vollständig innerhalb der externen API-Schnittstelle implementiert werden.

Zusammenfassung

Externe Bedingungen in Visual Planning ermöglichen eine externe, flexible Prüfung von Vorgängen. Durch die Angabe von Vorgangs-UID, Planungskontext, Benutzername und einem Access Token kann die API die Bedingungen extern prüfen und den Status als JSON-Antwort zurückgeben. Diese Methode erlaubt es, komplexe Prüfungen außerhalb von Visual Planning vorzunehmen, was eine größere Flexibilität und Anpassbarkeit der Prozesse ermöglicht.