Vordefinierte Variablen

Vordefinierte Variablen

Verwendung

---

Allgemeine Informationen

In AE besteht die Möglichkeit, spezielle Variablen in Attributen oder im Script aktivierbarer Objekte zu verwenden, die bei der Ausführung durch den entsprechenden Wert ersetzt werden. Dabei handelt es sich entweder um system- oder objektbezogene Werte.

Vordefinierte Variablen sind Platzhalter für Werte des eigenen Objektes, eines Variablen-Objektes oder des Automation Engine Systems. Diese Werte können auch mittels Script-Funktionen (zum Beispiel: SYS_ACT_ME_NAME) ermittelt und verwendet werden. Die Funktionalität der Variablen vereinfacht diesen Vorgang jedoch und hilft Ihnen somit das Script von Objekten zu reduzieren.

Die Verwendung ist entweder in Attributen oder im AE Script von aktivierbaren Objekten möglich. Vordefinierte Variablen können außerdem an folgenden Stellen verwendet werden, wobei in diesem Fall die Auflösung durch den entsprechenden Wert erst zum Zeitpunkt des Zugriffs erfolgt:

• Variablen-Objekte - Registerkarte Variable - Innerhalb von SQL-Anweisungen (SQL-Variablen)
  
• Aktivierbare Objekte - Registerkarte "Variablen & Prompts": Als Wert für Objektvariablen und PromptSet-Elemente
• Workflow - Eigenschaften der Objekte - Registerkarte Allgemein: Alias.
  Nur in diesem Feld kann die vordefinierte Variable &$TASK_NAME# verwendet werden.
• Workflow - Eigenschaften der Objekte - Registerkarten Pre-Conditions und Post-Conditions:
  Für Parameter der Bedingungen und Anweisungen Beachten Sie, dass sich vordefinierte Variablen an dieser Stelle auf den Workflow und nicht auf die Aufgabe beziehen!
  
• PromptSet - Registerkarte Designer- Als Standardwert für die PromptSet-Elemente.

Vordefinierte Variablen für Variablen-Objekte werden im AE Script nicht unterstützt und daher auch nicht ersetzt! Verwenden Sie die Sprachmittel GET_VAR / PUT_VAR um auf Variablen-Objekte zuzugreifen!

Vordefinierte Variablen können entweder manuell oder mit Hilfe des Dialoges Variablenauswahl im UserInterface eingefügt werden. Dieser ist über die Symbolleiste von Objekten aufrufbar.

Eine Liste der vordefinierten Variablen für System und Objektwerte finden Sie hier.

Scriptvariablen oder Objektvariablen können ebenfalls in Attributen verwendet werden. Die Beschreibung dazu finden Sie unter Attribute.

Syntax

Variablen, die Werte des Automation Engine Systems oder des eigenen Objektes repräsentieren, beginnen mit &$ und enden mit #. Dazwischen befindet sich eine Zeichenfolge, die bis auf das Format bei Datums- und Zeit-Werten, konstant ist. Diese Werte enstprechen entweder dem Rückgabewert von Script-Funktionen oder Objektattributen.

Um Werte von Variablen-Objekten dynamisch zur Laufzeit in Attribute einzusetzen, dient ein spezieller Platzhalter. Dieser besitzt folgende Schreibweise:
{ Variablen-Objekt [, Key [, Spaltennummer ]] }

Key: Key-Spalte bei statischen Variablen-Objekten, die erste Wertespalte (erste Rohspalte) bei dynamischen Variablen. Ist Key und Spalte nicht angegeben, so wird der Wert des ersten Eintrages bzw. der Result-Spalte / ersten Wertespalte verwendet.

Diese Platzhalter sind auch im Dialog Variablenauswahl verfügbar, wenn dieser nicht im Script aufgerufen wurde. In dem Dokument Verwendung von Variablen-Objektenist erläutert, an welchen Stellen diese Platzhalter verwendet werden können.

Die Verwendung dieser Platzhalter ist nicht in den Form-Registerkarten möglich! In den Forms werdennur vordefinierte Variablen für System- und Objektwerte unterstützt.

Vordefinierte Variablen werden wie Script-Variablen farblich hervorgehoben.

Die Verwendung ist auch in Feldern der Form-Registerkarten möglich (zum Beispiel bei SAP-Jobs). Dort erfolgt jedoch keine farbliche Markierung der Variablen!

Siehe auch:

Verwendung von Variablen-Objekten
Liste der vordefinierten Variablen für System- und Objektwerte
Dialog "Variablen-Auswahl"
Verwendung von vordefinierten Variablen