OCT-Handbuch
OCT-Handbuch
Breadcrumbs

3.2.3.14. Python

Der Python-Step kann nur erfolgreich ausgeführt werden, wenn Python auf dem Computer installiert ist. Ist Python nicht installiert, erscheint beim Ausführen der Pipeline in den Prozesslogs eine Fehlermeldung, welche einen Link zum Download von Python erhält. Installieren Sie die neueste Version auf dem Applikationsserver für den OCT Dienstbenutzer (oder für alle Anwender) und starten Sie den OCT-Dienst neu.

Um diesen Step hinzufügen oder ausführen zu können, muss auf Serverebene in den Applikationseinstellungen Python aktiviert sein (siehe: 2.3. Applikationseinstellungen | 2.3.2. Basiseinstellungen (C)).

Informationen zu den Bearbeitungsmöglichkeiten der Pipeline (hinzufügen, importieren, exportieren, Einstellungen, bearbeiten, usw.) sowie zur Bearbeitung einzelner Steps (Name, kopieren, Optionen mit Ausführungsbedingungen, Aufgabenplan hinzufügen, usw.) finden Sie auf der Startseite der Prozesspipelines: 3.2.3.1. Startseite

3.2.3.14.1. Python-Step hinzufügen

  • Wählen Sie den gewünschten Step aus:

image-20250429-094356.png
Ansicht 1 “Step hinzufügen”

  • Wenn der Step ausgewählt wird, öffnet sich eine Übersicht:

image-20250424-093223.png
Ansicht 2 “Step hinzufügen”

3.2.3.14.2. Skript (a)

Aus Sicherheitsgründen kann nur ein Applikationsadministrator auf Serverebene mit den entsprechenden Rechten den Editor sehen.

3.2.3.14.2.1. Editor

  • Der Editor ist ein Pflichtfeld.

  • Im Editor kann ein Python Skript für einen Datenabruf verfasst werden.

  • Das Python Skript wird mit den Rechten des OCT Dienstbenutzers ausgeführt.

  • Man kann sämtliche Python Befehle nutzen, die von der auf dem Applikationsserver installierten Python Version unterstützt werden.

image-20250425-085026.png

Icon image-20250114-131412.png “Skript-Editor öffnen”

  • Mit einem Linksklick auf das Icon kann ein separater Dialog mit einem vergrößerten Skript-Editor geöffnet werden.

image-20250425-085130.png

3.2.3.14.2.2. Server-Dateisystem

image-20250425-091753.png

Dateipfad

  • Es muss ein Pfad zu einer Python Skript Datei eingegeben werden, die auf dem OCT Applikationsserver abgelegt ist.

  • Absolute und UNC Pfade funktionieren, wenn der OCT Dienstbenutzer Rechte auf diese Pfade hat.

3.2.3.14.3. Parameter (b)

  • Im Step definierte Parameter sind im Skript in der Standard Python Variable sys.argv verfügbar.

  • Dem Skript können beliebig viele Parameter übergeben werden.

  • Der Wert der Parameter kann mit sys.argv[<ParameterNummer>] (Beispiel sys.argv[1] für den ersten Parameter) referenziert werden. Alternativ kann das Python Modul argparse verwendet werden.

image-20250916-131915.png

Button “Parameter hinzufügen”

  • Mit einem Linksklick auf den Button wird jedes Mal eine neue Zeile hinzugefügt, um neue Parameter zu definieren

Name

  • Eingabefeld für einen Parameternamen

Wert

  • Übergibt den Parameter mit einem dazugehörigem Wert.

Icon image-20250917-085858.png “Löschen”

  • Über das Icon kann die Zeile des Parameters mit all seinen Angaben gelöscht werden.

Nach dem Hinzufügen eines Steps muss dieser gespeichert werden. Danach kann über das Icon image-20250115-110419.png in der Menüleiste die Pipeline gestartet werden.

Während die Pipeline ausgeführt wird, erscheint solange ein sich drehender Kreis image-20250115-110355.png in der Pipelinezeile, bis der Prozess beendet ist.