Die Verwendung von Variablenobjekten ist an verschiedenen Stellen im AE-System möglich. Je nachdem, wo Sie diese verwenden wollen, sind einige Besonderheiten zu beachten.
Variablenobjekte und deren Werte können in mehreren Automation EngineDiese Komponente steuert ein Automation Engine-System. Besteht aus verschiedenen Serverprozessen.-Objekten eingesetzt werden: Die untenstehende Tabelle zeigt die gängigsten Objekte:
| ObjektTätigkeiten und Abläufe, welche die Automation Engine steuert, werden mit Hilfe von sogenannten Objekten abgebildet (siehe auch Aufgabe). | Bereich | Zulässige Vordefinierte Variablen |
|---|---|---|
| Alle ausführbaren Objekte | Felder auf dem Tab Attribute |
|
| Ausführbares Objekt mit den Seiten Seiten „Variablen & Prompts“ | Die Spalte Wert in der Tabelle Variablen auf dem Tab Variablen & Prompts |
|
| Ausführbare Objekte mit Scripts | PREP_PROCESS_VARPREP_PROCESS_VAR_XML | Statische Variablenobjekte |
| PREP_PROCESS_VAR_XML | XML Variablenobjekt | |
| :PUT_VAR | Statisches oder XML-Variablenobjekt | |
| :PUT_VAR_COL | ||
| :DELETE_VAR | ||
| PromptSet | Die Datenreferenz und der Standardwert auf dem Tab Designer. |
|
| SQL- und SEC_SQL-Variablenobjekte | Die Verbindungs- und LoginAnmeldedaten für Zielsysteme. Auch ein eigener Objekttyp in der Automation Engine.-Objekte |
|
| SQL-Variablenobjekte | Das SQL-Statement und Bind-Parameter |
|
| Workflows | Verschiedene Felder für Pre-Conditions, Post-Conditions, Bedingungen für 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.]"-Aufgaben |
Vordefinierte Variablen beziehen sich an dieser Stelle auf den Workflow und nicht auf die AufgabeEin gestartetes Objekt, welches gerade durchgeführt wird. Aufgaben werden auch als Aktivitäten bzw. Tasks bezeichnet.. |
| Das Feld Alias auf dem Tab Allgemein für Workflow-Aufgaben | Die Objekteigenschaften-Variable &$TASK_NAME# kann nur in diesem Feld verwendet werden. | |
| Cockpits | Numerische Inhalte von statischen Variablen können in CockpitObjekten verwendet werden. | Statische Variablenobjekte |
| Ereignisse | Felder in den Tabs Konsole, DatenbankEine Datenbank ist eine organisierte Sammlung von Daten und wichtigen Datenstrukturen. oder Zeit einschließlich Variablenquellen für DB-Ereignisobjekte. |
|
| Queues | Das Feld ZeitzoneDefiniert eine lokale Zeit. Auch ein eigener Objekttyp in der Automation Engine. auf dem Tab Attribute. |
|
Direkte Verwendung in Objekten
Mit vordefinierten Variablen ist es möglich, Werte von Variablenobjekten zur LaufzeitDurchführungsdauer einer Aufgabe. Das ist der Zeitraum zwischen Start und Ende. Der Aktivierungszeitraum wird nicht dazugerechnet (siehe auch Aktivierung und Start). in ausführbaren Objekten einzusetzen. Dazu dient folgender Variablenname, der sich aus dem Namen des VARA-Objektes zusammensetzt:
{ Variablenobjekt [, Key [, Spaltennummer ]] }
Dieser Platzhalter wird bei der Durchführung des Objektes durch den entsprechenden Wert des Variablen-Objektes ersetzt. Key und Nummer der Spalte sind dabei optional. Erfolgt keine Angabe einer bestimmten Spalte, wird der Wert automatisch aus der Result-SpalteErste Spalte von dynamischen Variablen-Objekten mit der Quelle "SQL", "SQL-intern" und "Multi". Der Inhalt dieser Spalte wird mit dem Result-Format festgelegt. (bei dynamischen Variablen) bzw. ersten Werte-Spalte (bei statischen Variablen) bezogen. Wenn der Key weggelassen wird, so wird die erste Zeile verwendet.
Das Verhalten, wenn die angegebene Variable nicht gefunden werden kann, kann mit der Einstellung VARA_ERROR_ON_REPLACEMENT in der Variable UC_CLIENT_SETTINGS festgelegt werden. Standardmäßig wird die Prozessierung abgebrochen.
Die Verwendung dieser Platzhalter ist nicht in den Form-Tabs möglich! In den Forms werden nur Vordefinierte Variablen für System- und Objektwerte unterstützt.
Platzhalter für Variablenobjekte werden in Scripts nicht unterstützt! Um auf Variablenobjekte zuzugreifen, verwenden Sie das Sprachmittel GET_VAR. Die Werte von dynamischen Variablen werden dabei immer direkt von der Datenquelle ermittelt. Die Verwendung von :PUT_VAR, :PUT_VAR_COL und :DELETE_VAR ist nur für statische Variablen möglich.
Auflösung von dynamischen Variablen
Bei der Auflösung von dynamischen Variablenobjekten werden die Werte direkt von der Datenquelle (Datenbank, Variable, Agent"Programm, das die Ausführung von Verarbeitungen auf Zielsystemen wie z.B. Rechner oder Geschäftslösungen ermöglicht. Auch ein eigener Objekttyp in der Automation Engine. [Früher ""Executor"" genannt.] Siehe auch ""Host"".") abgeholt und für das Objekt zur Verfügung gestellt. Dieser Prozess wird bei jedem Variablenzugriff durchgeführt, da die Werte nicht im Objekt gespeichert bleiben. Dasselbe Verhalten gilt auch für den WiederanlaufWiederholung einer bereits gelaufenen Objekt-Durchführung, wobei einige Besonderheiten gegenüber einem erneuten Start gelten. von Aufgaben.
Die Auflösung erfolgt zum Generierungszeitpunkt der Aufgabe, welche die Variable verwendet, und hängt daher von der Einstellung „Generieren zur Laufzeit“ ab.
Bei der Auflösung von Variablen werden diese zuerst im aktuellen Mandanten gesucht, bevor auf den Systemmandanten zugegriffen wird.
Beachten Sie, dass keine Auflösung erfolgt, wenn ein Attribut mit dem ScriptEigener Objekttyp in der Automation Engine-Sprachmittel GET_ATT gelesen wird, das einen Variablen-Platzhalter enthält. Der Wert des Attributs wird in diesem Fall nicht aufgelöst.
Ist bei der Ausführung kein Agent für die Variablentypen „SQL“ und „Dateiliste“ verfügbar, wechselt die Aufgabe in einen Wartezustand („Warten auf Variablen-Service“). Bei ungültigen Verzeichnisangaben oder SQL-Statements bricht die Aufgabe mit einem Fehler ab. Überprüfen Sie daher die Einstellungen des Variablenobjektes und stellen Sie sicher, dass der Agent gestartet wurde.
| StatusZustand einer Aufgabe (z.B. aktiv, blockiert, in Generierung, usw.). der Aufgabe | Beschreibung |
|---|---|
| Auflösung von Variablen | Dynamische Variablenobjekte, die im Objekt verwendet werden, werden gerade aufgelöst. |
| Warten auf Fortsetzung der Variablenauflösung | Wartezustand einer Aufgabe, welche die Auflösung von dynamischen Variablen nicht durchführen kann, da entweder der Agent bzw. die Datenquelle nicht verfügbar ist oder falsche Daten im Verbindungsobjekt eingetragen sind. |
Aufgaben im Zustand „Warten auf Fortsetzung der Variablenauflösung“ können nicht abgebrochen werden! Überprüfen Sie in diesem Fall, ob der Agent aktiv ist und die Einstellungen in den Objekten stimmen (je nach Variablen-Typ: Variablen-, Login- und/oder Verbindungsobjekt).
Die Variablen-Auflösung wird fortgesetzt, sobald der Agent wieder aktiv ist. Lag das Problem am Verbindungsobjekt oder an der Datenbank (bei Variablen mit der Quelle „SQL“), so wird die Prüfung nach dem mit VARIABLE_SERVICE_CHECK_INTERVAL (UC_SYSTEM_SETTINGS) definierten Zeitintervall wiederholt.
Attribute für vordefinierte Variablen
Folgende Auflistung zeigt jene Objektattribute, welche die Verwendung der Platzhalter für Variablenobjekte unterstützen.
[ Allgemeine Attribute] [ FileTransfer-Attribute] [ Ereignis-Attribute] [ Jobspezifische Attribute]
| Attribut | Attributname | Objekttypen |
|---|---|---|
| ARCHIVE_KEY1 | Archive Key 1 | CALL, CPIT, EVNT, JOBF, JOBG, JOBP, JOBQ, JOBS, JSCH, SCRI |
| ARCHIVE_KEY2 | Archive Key 2 | CALL, CPIT, EVNT, JOBF, JOBG, JOBP, JOBQ, JOBS, JSCH, SCRI |
| ATTACH_FILE | Datei mitsenden | CALL |
| ATTACH_REPORTS_RUNID | Reports mitsenden von | CALL |
| AUTO_DEACT_ERROR_FREE | Fehlerfrei-Status | JOBF, JOBP, JOBS |
| CALL_TEXT | Nachricht | CALL |
| CO_RISING_NAME | Eskalation: BenachrichtigungSendet Mitteilungen an einzelne Benutzer und BenutzerGruppen des Automation Engine-Systems. Auch ein eigener Objekttyp in der Automation Engine. [Früher "CallOperator" genannt.] | CALL |
| CODE | Code | JOBS |
| FSC_HOST | HostRechner, Zielsystem. für Dateiprüfung überschreiben (optional) - Host | JOBF, JOBQ, JOBS |
| FSC_LOGIN | Host für Dateiprüfung überschreiben (optional) - Login | JOBF, JOBQ, JOBS |
| HOST | Host | EVNT (Dateisystem, Konsole), JOBS, JOBQ |
| INT_ACCOUNT, INT_ACC, K | Kostenstelle | CALL, EVNT, JOBF, JOBP, JOBQ, JOBS, JSCH, SCRI |
| LOGIN | Login | JOBS |
| MAX_RET_EXECUTE | Ergebnis-Auswertung der Einzelaufgaben - Else | JOBQ |
| MAX_RETCODE | RückgabewertWert, der das Ergebnis von Aufgaben und Script-Funktionen repräsentiert. | CALL, CPIT, EVNT, JOBF, JOBG, JOBP, JOBQ, JOBS, JSCH, SCRI |
| GROUP, S | GruppeFasst Aufgaben zusammen, um diese gemeinsam durchzuführen. Auch ein eigener Objekttyp in der Automation Engine. | CALL, EVNT, JOBF, JOBP, JOBS, JSCH, SCRI |
| SUBJECT | Betreff | CALL |
| TIMEZONE | Zeitzone | CALL, EVNT, JOBF, JOBG, JOBP, JOBQ, JOBS, JSCH, SCRI |
[ Allgemeine Attribute] [FileTransfer-Attribute] [ Ereignis-Attribute] [ Jobspezifische Attribute]
| Attribut | Attributname |
|---|---|
| FT_DST_CODE | Nach - Code |
| FT_DST_FILE | Nach - Datei |
| FT_DST_FILE_ATTRIBUTES | Nach - Datei-Attribute |
| FT_DST_HOST | Nach - Host |
| FT_DST_LOGIN | Nach - Login |
| FT_SRC_CODE | Von - Code |
| FT_SRC_FILE | Von - Datei |
| FT_SRC_FILE_ATTRIBUTES | Von - Datei-Attribute |
| FT_SRC_HOST | Von - Host |
| FT_SRC_LOGIN | Von - Login |
[ Allgemeine Attribute] [ FileTransfer-Attribute] [Ereignis-Attribute] [ Jobspezifische Attribute]
| Attribut | Attributname | Ereignis-Typ |
|---|---|---|
| EVENT_FILE_PATH | Pfad | Dateisystem |
| EVENT_SOURCE | Quelle (nur Windows) | Konsole |
| OPERAND1_SQL_AGENT | Wert 1 - Host | Datenbank |
| OPERAND1_SQL_DATABASE_NAME | Wert 1 - Datenbank | Datenbank |
| OPERAND1_SQL_LOGIN | Wert 1 - Login | Datenbank |
| OPERAND1_SQL_QUERY | Wert 1 - SQL | Datenbank |
| OPERAND1_SQL_SERVER_NAME | Wert 1 - Server | Datenbank |
| OPERAND1_STATIC_VALUE | Wert 1 - Statischer Wert | Datenbank |
| OPERAND1_VARA_KEYWORD | Wert 1 - Key | Datenbank |
| OPERAND1_VARA_NAME | Wert 1 - Variablenobjekt | Datenbank |
| OPERAND2_SQL_AGENT | Wert 2 - Host | Datenbank |
| OPERAND2_SQL_DATABASE_NAME | Wert 2 - Datenbank | Datenbank |
| OPERAND2_SQL_LOGIN | Wert 2 - Login | Datenbank |
| OPERAND2_SQL_QUERY | Wert 2 - SQL | Datenbank |
| OPERAND2_SQL_SERVER_NAME | Wert 2 - Server | Datenbank |
| OPERAND2_STATIC_VALUE | Wert 2 - Statischer Wert | Datenbank |
| OPERAND2_VARA_KEYWORD | Wert 2 - Key | Datenbank |
[ Allgemeine Attribute] [ FileTransfer-Attribute] [ Ereignis-Attribute] [Jobspezifische Attribute]
| Attribut | Attributname | Plattform | |
|---|---|---|---|
|
|
AGENT_ID | MBean-Server - Agent ID | JMX |
|
|
DATA_SOURCE | Verbindung - Dateiname | Datenbank |
|
|
DATABASE_NAME | Verbindung - Datenbank | Datenbank |
|
|
ENTER_PARAMS, ENTER_PAR, EP | Laufzeit-Optionen - Enter-Parameter | BS2000 |
|
|
ENTERPRISE_SERVER | Startparameter - Enterprise Server | Siebel |
|
|
GATEWAY_SERVER | Startparameter - Gateway Server | Siebel |
| HOME_TERMINAL | Startparameter - Virtuelles Terminal | NSK | |
|
|
INITIAL_CONTEXT_FACTORY | MBean-Server - Initial Context Factory | JMX |
|
|
JCL_SOURCE | Laufzeit-Optionen - z/OS Dateiname | z/OS |
|
|
JOB_CLASS, JC | Laufzeit-Optionen - JobVerarbeitung auf einem Zielsystem. Auch ein eigener Objekttyp in der Automation Engine.-Klasse | BS2000 |
| JOB_NAME, JN | Startparameter/Laufzeit-Optionen - Auftragsname/Jobname | BS2000, MPE, z/OS, OS/400, SAP, VMS | |
|
|
MPE_OTHER | Laufzeit-Optionen - Sonstige | MPE |
|
|
MPE_QUEUE | Laufzeit-Optionen - QueueObjekttyp in der Automation Engine. Legt die maximale Anzahl parallel laufender Aufgaben, deren Prioritäten und somit die Reihenfolge von auszuführenden Objekten fest. | MPE |
|
|
MVS_ACCOUNT | Laufzeit-Optionen - Account | z/OS |
|
|
MVS_JOB_PARAMS | Laufzeit-Optionen - Job-Parameter | z/OS |
|
|
MVS_NOTIFY | Laufzeit-Optionen - Benachrichtigungen | z/OS |
|
|
MVS_PROG_NAME | Laufzeit-Optionen - Prog-Name | z/OS |
|
|
OA_APPL_NAME | Zuständigkeit - Anwendungskurzname | Oracle Applications |
|
|
OA_RESP_NAME | Zuständigkeit - Key | Oracle Applications |
|
|
OS400_JOBD | Laufzeit-Optionen - Jobbeschreibung | OS/400 |
|
|
OS400_JOBQ | Laufzeit-Optionen - Jobwarteschlange | OS/400 |
|
|
OS400_RTGDTA | Laufzeit-Optionen - Leitwegdaten | OS/400 |
|
|
SAP_DST_SYSTEM | Startparameter - Zielsystem | SAP |
|
|
SAP_RECIPIENT | Spoollisten-Empfänger - Adresse | SAP |
|
|
SERVER_NAME | Verbindung - Server | Datenbank |
|
|
SERVER_URL | MBean-Server - Server URL | JMX |
|
|
SIEBEL_SERVERS | Startparameter - Siebel Servers | Siebel |
|
|
UNIX_CMD | Startparameter - Kommando | UNIX |
|
|
UNIX_SHELL_OPTIONS | Startparameter - Shell-Optionen | UNIX |
|
|
VMS_QUEUE_NAME | Startparameter - Queuename | VMS |
|
|
WIN_CMD | Startparameter - Kommando | Windows |
|
|
WIN_WORK_DIR | Startparameter - Arbeitsverzeichnis | Windows |