Neben den System-Rückgabewerten können Sie auch selbst definierte Rückgabewerte in Ihrer Verarbeitung verwenden. Der Name des zugehörigen Zustandes ist frei wählbar, z. B. USER_100 mit dem BenutzerIn einem Automation Engine-System bezieht sich ein Benutzer auf eine Instanz eines Benutzer-Objektes, aber ganz allgemein ist ein Benutzer auch die Person, die mit Automic-Produkten arbeitet. Jedes Benutzer-Objekt hat eine Benutzerkennung und bestimmte Zugriffsrechte auf unterschiedliche Bereiche eines Automation Engine-Systems und der zugehörigen Produktpalette. In der Automation Engine werden die Zugriffsrechte über Rechte und Privilegien, in Decision über Benutzerrollen und EventBase-Rechte und in der ARA-Webanwendung über Objektberechtigungen geregelt. Zentral können diese Zugriffsrechte in den Funktionen der AWI-Benutzerverwaltung geregelt werden. Weitere Informationen sind im Kapitel Unified User Management vorhanden.-RückgabewertWert, der das Ergebnis von Aufgaben und Script-Funktionen repräsentiert. 100.
Diese benutzerdefinierten Zustände kommen in Workflows und Schedules zur Anwendung. Im Tab Ergebnis (Schedule) und Post-Conditions (Workflow) sind sie als erwarteter Endstatus festlegbar. Sie können die StatusZustand einer Aufgabe (z.B. aktiv, blockiert, in Generierung, usw.). auch im Tab Abhängigkeiten (Workflow"Ermöglicht das Hinzufügen, Anordnen, Verknüpfen, Definition von Eigenschaften und Entfernen von Aufgaben eines Workflows. Ein eigener Objekttyp in der Automation Engine. [Früher ""AblaufPlan"" und ""JobPlan"" gennant.]") festlegen, um auf die Rückgabewerte der vorangegangenen Aufgaben reagieren zu können.
Benutzer-Rückgabewerte definieren
Die benutzerdefinierten Rückgabewerte sind mit der Zustandsbezeichnung in der Tabelle UC_ZUTYP gespeichert. Nehmen Sie Änderungen oder Erweiterungen direkt in dieser Datenbanktabelle vor. Der Rückgabewert muss kleiner als 1000 sein und ist 4-stellig mit führenden Nullen anzugeben. Tragen Sie für die Zustandsbezeichnung eine alphanumerische Zeichenkette ein. Die Benutzer-Rückgabewerte sind in allen Mandanten auswählbar.
Beispiele:
|
Aufgaben-Status/Zustand |
Benutzer-Rückgabewert |
Beschreibung |
|---|---|---|
|
USER_100 |
0100 |
Dem Zustand USER_100 wird ein einzelner Benutzer-Rückgabewert (100) zugeordnet. |
|
USER_200_300 |
0200-0300 |
Dem Zustand USER_200_300 wird ein Bereich an Benutzer-Rückgabewerten (200 bis 300) zugeordnet. |
|
USER_301_401_501 |
0301,0401,0501 |
Dem Zustand USER_301_401_501 wird eine Aufzählung von Benutzer-Rückgabewerten (301, 401 und 501) zugeordnet. |
Benutzer-Rückgabewerte setzen
Script
Benutzer-Rückgabewerte können durch das ScriptEigener Objekttyp in der Automation Engine-Statement:EXIT gesetzt werden. Haben Sie im Tab Attribute die Option Zur LaufzeitDurchführungsdauer einer Aufgabe. Das ist der Zeitraum zwischen Start und Ende. Der Aktivierungszeitraum wird nicht dazugerechnet (siehe auch Aktivierung und Start). generieren aktiviert, ist es möglich, auf den benutzerdefinierten Rückgabewert innerhalb eines Workflows zu reagieren.
Um auf Bedingungen zu reagieren, die ein bereits generierter JobVerarbeitung auf einem Zielsystem. Auch ein eigener Objekttyp in der Automation Engine. im Zielsystem vorfindet, werden Benutzer-Rückgabewerte in einer speziellen Weise gesetzt und ausgewertet. In den Job-Trailern wurde der Aufruf des Jobmelders davon abhängig gemacht, ob der Job mit oder ohne Fehler beendet wurde. Bei einem Abbruch übernimmt der Jobmelder den im Job gesetzten Rückgabewert.
Windows
Sie können innerhalb eines Jobs einen bestimmten Rückgabewert setzen. Der Job wird mit diesem Benutzer-Rückgabewert abnormal beendet. Verwenden Sie dabei folgende Syntax:
SET RETCODE=nnn
GOTO RETCODE
Anstatt einen festen Wert als Rückgabewert anzugeben, können Sie auch die DOS-Fehlernummer „Errorlevel“ verwenden. Dabei sind Sie natürlich an die Vorgaben des Betriebssystems gebunden. Verwenden Sie dabei folgende Syntax:
SET RETCODE=%ERRORLEVEL%
GOTO RETCODE
UNIX
In UNIX können Sie einen Job jederzeit mit dem UNIX-Statement EXIT nnn beenden.
BS2000
Der BS2000-Jobmelder kann den Rückgabewert über Jobvariablen oder über einen Dateikommando ermitteln. Im BS2000-Trailer sind zwei Sprungmarken definiert, an denen die entsprechende Verarbeitung erfolgt.
Wenn Sie Jobvariablen verwenden möchten, so ist eine Jobvariable mit dem Linknamen *RETCODE zuzuweisen. Verwenden Sie dabei folgende Syntax:
/DCLJV #RETCODE,LINK=*RETCODE
/SETJV #RETCODE,'421'
/SKIP .RETJV
Soll der Rückgabewert über ein Dateikommando ermittelt werden, so ist eine Datei mit dem Linknamen RETCODE zuzuweisen. Im Dateinamen wird der String „RETCODE“ gesucht. Anschließend daran muss der Benutzer-Rückgabewert stehen. Verwenden Sie dabei folgende Syntax:
/FILE #RETCODE421,LINK=RETCODE
/SKIP .RETTFT
Siehe auch:
System-Rückgabewerte von ausführbaren Objekten
Script-Statement :EXIT