EXECUTE_REQ

Nachrichtentyp 03
Richtung C->S
Antwort(en) EXECUTE_ACK,DIALOG_REQ,ACTION_REQ,ERROR

Die Anforderung DLE Logik auszuführen. Die Ausführung kann direkt mit einem EXECUTE_ACK bestätigt werden. Als Antwort kann jedoch auch ein DIALOG_REQ im Falle einer Dialogaufforderung, ein ACTION_REQ im Falle eines Action Kommandos im Brick, oder eine ERROR Nachricht im Fehlerfall erfolgen.
Im Datenteil der Nachricht folgen mehrere Werteblöcke, die die Ausführungsparameter enthalten. Anschließend folgt ein Gruppenblock „FILTERS“. Diesem folgen mehrere optionale Werteblöcke mit den übergebenen Filtern. Der Wertename ist dabei jeweils „FILTER“.
Anschließend folgt ein Gruppenblock „VARIABLES“. Diesem folgen mehrere optionale Werteblöcke mit den übergebenen Variablen samt Werten. Zuletzt Folgen die übergebenen Datenobjekte. Jedes Datenobjekt wird mit einem Gruppenblock „DATAOBJECT“ gestartet. Danach folgt ein erforderlicher Werteblock mit den Wertenamen „OBJECT_NAME“ und dem Namen des Datenobjektes als Wert. Der Name muß mit dem Paketnamen beginnen. Soll das Datenobjekt in Beziehung zu einem vorher angegebenen Datenobjekt gesetzt werden, ohne das die Werte für die Fremdschlüssel gesetzt wurden, wird dem Werteblock „OBJECT_NAME“ der Werteblock „PARENT_NAME“ vorangestellt. Er bezeichnet den Namen des Vaterobjektes. Mehrere Kindobjekte können so definiert werden. Existieren mehrere Vaterobjekte, bezieht sich die Angabe immer auf das zuvor im Datenblock eingetragene Datenobjekt. Anschließend folgen mehrere optionale Werteblöcke mit den Attributnamen und Werten. Folgt ein weiteres Datenobjekt, beginnt dieses wieder mit einem Gruppenblock „DATAOBJECT“.

 

Ausführungsparameter Pflicht Beschreibung
FOLDER N Folderbezeichnung zur Ausführung.
BRICK_NAME N Alternativ zur Folderausführung. Wird ein Brickname angegeben, wird dieser direkt ausgeführt, anstatt im Folder nach Bricks zu suchen.
LOCALE N Optional kann die Sprachzone übersteuert werden.
SEARCHDATE N Mit welchem Datum die Brickversionen gesucht werden.
COMMIT_AFTER_EXEC N 0: Kein Commit oder Rollback durch die DLE nach Ausführung.
1: Automatisches Commit oder Rollback durch die DLE nach Ausführung.
BATCHMODE N 0: Kein Batchmode, Dialoge erlaubt.
1: Batchmode, keine Dialoge erlaubt.
INFO_TEXT N Hinweistext zur Ausführung, die später bei der Administration angezeigt werden kann. Z.B.: „EDI“ oder „Auftragsprüfung“.
RETURN_OBJECTS N 0: Es werden keine Datenobjekte im Resultat zurückgegeben.
1: Es werden Datenobjekte im Resultat zurückgegeben. (Default)
CLEAR_USER_LOG N 1: Das Logfile des angemeldeten Benutzers wird vor der Ausführung geleert (Verfügbar ab DLE Version 2.2.0)