System-Variablen

AMQP_APPLICATION_PROPERTY_<key>

String

Setzt in einem Antwortweg AMQP eine benutzerdefinierte Application Property. <key> ist der Schlüssel der Property (Groß- und Kleinschreibung wird beachtet), der Variablenwert ist der Wert der Property.  

AMQP_FIXED_PROPERTY_CONTENT_TYPE

AMQP_FIXED_PROPERTY_SUBJECT

AMQP_FIXED_PROPERTY_GROUP_ID

AMQP_FIXED_PROPERTY_TTL

AMQP_FIXED_PROPERTY_MESSAGE_ID

AMQP_FIXED_PROPERTY_CORRELATION_ID

AMQP_FIXED_PROPERTY_BODY_TYPE

String

Setzen in einem Antwortweg AMQP die jeweilige vordefinierte Property (Content type, Subject, Group ID, Time to live, Message ID, Correlation ID, Body type).

Body type: Werte data, sequence, value (Standard: value). Sind Message ID und Correlation ID nicht gesetzt, werden sie als UUID automatisch generiert.

AMQP_SYS_MESSAGE_CORRELATION_ID_FORMAT

String

Legt in einem Antwortweg AMQP das Format von Message ID und Correlation ID fest. Werte: string, long, binary. Ist die Variable nicht gesetzt oder enthält einen anderen Wert, werden Message ID und Correlation ID als UUID erzeugt; nur bei einem der drei genannten Werten wird das entsprechende Format verwendet. Wird nur der Typ gesetzt, ohne eine Message ID bzw. Correlation ID anzugeben, wird die jeweilige ID automatisch im entsprechenden Typ generiert.

MSG_CALL_AMQP_APPLICATION_PROPERTY_<key>

String

Enthält im Eingangsagenten AMQP den Wert der empfangenen Application Property <key>. Alle Application Properties werden gesammelt.

MSG_CALL_AMQP_FIXED_PROPERTY_MESSAGE_ID

MSG_CALL_AMQP_FIXED_PROPERTY_CORRELATION_ID

MSG_CALL_AMQP_FIXED_PROPERTY_USER_ID

MSG_CALL_AMQP_FIXED_PROPERTY_TO

MSG_CALL_AMQP_FIXED_PROPERTY_SUBJECT

MSG_CALL_AMQP_FIXED_PROPERTY_REPLY_TO

MSG_CALL_AMQP_FIXED_PROPERTY_CONTENT_TYPE

MSG_CALL_AMQP_FIXED_PROPERTY_CONTENT_ENCODING

MSG_CALL_AMQP_FIXED_PROPERTY_ABSOLUTE_EXPIRY_TIME

MSG_CALL_AMQP_FIXED_PROPERTY_CREATION_TIME

MSG_CALL_AMQP_FIXED_PROPERTY_GROUP_ID

MSG_CALL_AMQP_FIXED_PROPERTY_GROUP_SEQUENCE

MSG_CALL_AMQP_FIXED_PROPERTY_REPLY_TO_GROUP_ID

String

Enthalten im Eingangsagenten AMQP die jeweilige vordefinierte Property einer empfangenen Nachricht, sofern gesetzt (ist die Property nicht gesetzt, wird keine Variable angelegt). MSG_CALL_AMQP_FIXED_PROPERTY_GROUP_SEQUENCE nur, wenn eine Group ID vorhanden ist.

AMQP_091BASIC_CONTENT_TYPE

AMQP_091BASIC_CONTENT_ENCODING

AMQP_091BASIC_MESSAGE_ID

AMQP_091BASIC_TIMESTAMP

AMQP_091BASIC_EXPIRATION

AMQP_091BASIC_APP_ID

AMQP_091BASIC_USER_ID

AMQP_091BASIC_TYPE

AMQP_091BASIC_PRIORITY

AMQP_091BASIC_CORRELATION_ID

String

Nur relevant für AMQP 0.9.1. Siehe Abschnitt Antwortweg AMQP (Legacy).

MSG_CALL_CONTENTTYPE_091BASIC

MSG_CALL_CONTENTENCODING_091BASIC

MSG_CALL_MESSAGEID

MSG_CALL_TIMESTAMP_091BASIC

MSG_CALL_EXPIRATION_091BASIC

MSG_CALL_APPID_091BASIC

MSG_CALL_USERID_091BASIC

MSG_CALL_TYPE_091BASIC

MSG_CALL_PRIORITY_091BASIC

MSG_CALL_CORRELATIONID

String

Nur relevant für AMQP 0.9.1. Siehe Abschnitt AMQP (Eingangsagent, Legacy).

AMQP_<Name der Message Property>

String

Mit diesen Variablen können in einem Antwortweg AMQP/JMS Message Properties (bei JMS und AMQP) gesetzt werden.

AMQP_JMS_TEXTMESSAGE

Boolean

Per Default übergibt der Antwortweg AMQP/JMS Daten an den empfangenden Server als Byte-Nachricht. Um das zu ändern, da manche Server damit nicht zurechtkommen, kann im Profil die Variable AMQP_JMS_TEXTMESSAGE mit dem Wert true angelegt werden, dann werden die Daten als Text-Nachricht übergeben. Zudem muss im Antwortweg die Kodierung auf UTF-8 gesetzt sein.

AMQP_JMS_CORRELATIONID

String

Setzt den JMS Message Header JMSCorrelationID.

 HINWEIS: Die Variable funktioniert nur bei der JMS-Anbindungsmethode.

AMQP_JMS_EXPIRATION

String

Setzt den JMS Message Header JMSExpiration.

 HINWEIS: Die Variable funktioniert nur bei der JMS-Anbindungsmethode.

AMQP_JMS_PRIORITY

String

Setzt den JMS Message Header JMSPriority.

 HINWEIS:  Die Variable funktioniert nur bei der JMS-Anbindungsmethode.

AMQP_JMS_REPLYTO

String

Setzt den JMS Message Header JMSReplyTo.

 HINWEIS: Die Variable funktioniert nur bei der JMS-Anbindungsmethode.

AMQP_TTL

String

Setzt den JMS Message Header JMSTimeToLive.

 HINWEIS: Die Variable funktioniert nur bei der JMS-Anbindungsmethode.

AMQP_TYPE

String

Setzt den JMS Message Header JMSType.

 HINWEIS: Die Variable funktioniert nur bei der JMS-Anbindungsmethode.

AMQP_<Name des Message Headers>

String

Bei AMQP-Verbindungen der Version 1.0 (und nur dort) können mit diesen Variablen in einem Antwortweg AMQP/JMS AMQP Message Header gesetzt werden.

AMQP_SYS_BodyType

String

Legt im Antwortweg AMQP/JMS den Body Type fest. Erlaubte Werte: data, sequence, value. Default: value.

AMQP_SYS_ContentType

AMQP_ContentType

String

Bei AMQP-Verbindungen (Legacy) der Version 1.0 (und nur dort) wird der Message Header ContentType mit dem Wert der System-Variable AMQP_SYS_ContentType gesetzt. Die Message Property ContentType wird mit dem Wert der System-Variable AMQP_ContentType gesetzt. Beispielwert: application/json

(JMS_JMSCorrelationID)

String

(veraltet) Kann verwendet werden, um den entsprechenden JMS Message Header JMSCorrelationID zu setzen.

(JMS_JMSExpiration)

String

(veraltet) Kann verwendet werden, um den entsprechenden JMS Message Header JMSExpiration (Timestamp in ms) zu setzen.

(JMS_JMSPriority)

String

(veraltet) Kann verwendet werden, um den entsprechenden JMS Message Header JMSPriority (0–9) zu setzen.

KAFKA_<keyname>

String

Erlaubt in einem Antwortweg des Typs Kafka und in der Funktion send Kafka message() Header-Properties (Key, Value) zu übergeben.

 HINWEIS: Da man als Value für eine Header-Property nur Byte-Arrays angeben kann, wird immer UTF-8 als Encoding verwendet!

KAFKA_PARTITION

Integer

Falls die Variable definiert ist und einen Wert >=0 hat, wird dieser als zu verwendende Partition des Topics im Antwortweg des Typs Kafka übergeben.

KAFKA_TOMBSTONE

Boolean

Wird die Variable auf true gesetzt, dann wird ein Tombstone Record versendet (damit kann man in gewissen Topics Records vorzeitig löschen).

MQTT_<keyname>

String

Gilt für MQTT-Version 5. Erlaubt in einem Antwortweg MQTT User-Properties (Key, Value) zu übergeben.

MQTT_SYS_CONTENTTYPE

String

Gilt für MQTT-Version 5. Erlaubt in einem Antwortweg MQTT das Setzen des (optionalen) Content Types, zum Beispiel plain/text.

MQTT_SYS_CORRELATIONDATA

String

Gilt für MQTT-Version 5. Setzt die Correlation ID in einen Antwortweg MQTT. Das erlaubt die Zuordnung von Requests und Responses. Details entnehmen Sie bitte der Dokumentation Ihres MQTT-Servers.

MSG_CALL_<Name des Parameters in Großbuchstaben>

String

In Lobster Integrations Rolle als HTTP-Server können damit HTTP-Request-Parameter ausgelesen werden. Siehe auch call SOAP-WebService without template().

MSG_CALL_HEADER_HTTP_<Name des Headers in Großbuchstaben>

String

In Lobster Integrations Rolle als HTTP-Server können damit HTTP-Request-Header ausgelesen werden. Siehe auch call SOAP-WebService without template().

MSG_CALL_HEADER_HTTP_METHOD

String

In Lobster Integrations Rolle als HTTP-Server kann damit die Methode des HTTP-Requests (zum Beispiel GET oder POST) ausgelesen werden. Siehe auch call SOAP-WebService without template().

MSG_CALL_HEADER_HTTP_PROTOCOL

String

In Lobster Integrations Rolle als HTTP-Server kann damit ausgelesen werden, ob der Request per HTTP oder HTTPS gesendet wurde. Siehe auch call SOAP-WebService without template().

MSG_CALL_HEADER_HTTP_QUERY

String

In Lobster Integrations Rolle als HTTP(S)-Server wird diese Variable gefüllt mit den Query-Parametern des Requests. Beispiel: Nehmen wir an, der komplette Request lautet http://example.com/dw/Request/get_orders?from=20170101&to=20170630. Die Variable hat dann den Wert from=20170101&to=20170630.

Siehe auch call SOAP-WebService without template().

MSG_CALL_HEADER_HTTP_REMOTE_HOST

String

In Lobster Integrations Rolle als HTTP(S)-Server wird diese Variable mit der Adresse des Clients gefüllt. Siehe auch call SOAP-WebService without template().

MSG_CALL_HEADER_HTTP_URI

String

In Lobster Integrations Rolle als HTTP(S)-Server wird diese Variable gefüllt mit dem Teilpfad nach /dw/Request bzw. /dw/Trigger der aufgerufenen Ressource.

Beispiel: Nehmen wir an, der komplette Request lautet http://example.com/dw/Request/get_orders?from=20170101&to=20170630. Die Variable hätte dann den Wert get_orders.

Siehe auch call SOAP-WebService without template().

MSG_CALL_HTTP_AUTH_USER

String

In Lobster Integrations Rolle als HTTP(S)-Server wird diese Variable mit dem verwendeten Benutzernamen gefüllt, wenn eine Authentifizierung stattgefunden hat. Siehe auch:

• VAR_SYS_TRIGGER_HTTP_CHANNEL_ID

• VAR_SYS_COMM_CHANNEL_ID

• VAR_SYS_COMM_CHANNEL_TYPE

Siehe auch call SOAP-WebService without template().

MSG_CALL_HTTP_MULTIPARTn_NAME

String

Name des Parts n + 1. Siehe HTTP (Eingangsagent) (→ Multipart).

MSG_CALL_HTTP_MULTIPARTn_VALUE

String

Inhalt des Parts n + 1. Siehe HTTP (Eingangsagent) (→ Multipart).

MSG_CALL_HTTP_MULTIPARTS

Integer

Anzahl der Parts. Siehe HTTP (Eingangsagent) (→ Multipart).

MSG_CALL_HTTP_PATH_DATA

String

Die Variable wird gefüllt, wenn im Eingangsagenten HTTP die Option Als REST-Schnittstelle behandeln verwendet wird. Ist die URL des Eingangsagenten zum Beispiel http://localhost/dw/Request/example, dann würde bei einem Request http://localhost/dw/Request/example/orders bzw. http://localhost/dw/Request/example/invoice/test in der Variable der Wert orders bzw. invoice/test gespeichert werden.

Siehe auch HTTP (Eingangsagent).

MSG_CALL_KAFKA_KEY

String

Ist diese Variable angelegt, dann wird im Eingangsagenten des Typs Kafka beim Empfang einer Nachricht der Key der Nachricht in dieser Variable gespeichert.

Siehe auch Kafka (Eingangsagent).

MSG_CALL_MQTT_CONTENTTYPE

String

Gilt für MQTT-Version 5. Enthält bei der Verwendung eines Eingangsagenten des Typs MQTT den Content Type, zum Beispiel plain/text. Siehe auch MQTT (Eingangsagent).

MSG_CALL_MQTT_CORRELATIONDATA

String

Gilt für MQTT-Version 5. Enthält bei der Verwendung eines Eingangsagenten des Typs MQTT die Correlation ID. Das erlaubt die Zuordnung von Requests und Responses. Details entnehmen Sie bitte der Dokumentation Ihres MQTT-Servers.

Siehe auch MQTT (Eingangsagent).

MSG_CALL_REF_IDS

String

Wird diese Variable angelegt, dann enthält sie die Interchange Control References aller mit dem Content-Inspection-Modul zusammengeführten EDIFACT-Dokumente.

Beispiel: 339;338;337

Siehe auch Zusammenführer (Merger).

MSG_CALL_HTTP_REST_API_PATH_<Name des Pfad-Parameters>

String

Enthält den Wert des im eventgesteuerten Eingangsagenten HTTP (→ siehe API-Variablen) definierten Pfad-Parameters.

Siehe auch HTTP (Eingangsagent).

MSG_CALL_var__ci_filename_to_use

(var__ci_filename_to_use)

String

Ist diese Variable gesetzt, dann wird mit dem Wert in den Klassen ContentInspectionResponse, ContentInspectionResponseAsync, ContentInspectionResponseUTF8 und ContentInspectionResponseUTF8Async der Dateiname überschrieben, der an die CI (Content Inspection) geschickt wird.

MSG_CALL_VAR_SYS_PORTAL_LANG

String

Die Variable (wenn angelegt) enthält die gewählte Sprache des DataCockpit. Sprache/Code: Deutsch: de Englisch: en Französisch: fr Italienisch: it Spanisch: es Dänisch: da Niederländisch: nl

MSG_CALL_VAR_SYS_WF_ID

String

Nur relevant im Zusammenhang mit dem Modul Workflow (siehe dort).

MSG_CALL_VAR_SYS_WF_LINK

String

Nur relevant im Zusammenhang mit dem Modul Workflow (siehe dort).

MSG_CALL_VAR_HTTP_<Name des Headers in Großbuchstaben>

String

In Lobster Integrations Rolle als HTTP-Client können mit diesen Variablen die HTTP-Response-Header aus der Response des Servers ausgelesen werden. Siehe auch call SOAP-WebService without template().

MSG_CALL_VAR_HTTP_STATUS_CODE

Integer

In Lobster Integrations Rolle als HTTP-Client wird diese Variable mit dem HTTP-Status-Code der Response des Servers gefüllt. Siehe auch call SOAP-WebService without template().

MSG_CALL_VAR_HTTP_STATUS_LINE

String

In Lobster Integrations Rolle als HTTP-Client wird diese Variable mit der HTTP-Status-Line der Response des Servers gefüllt. Siehe auch call SOAP-WebService without template().

VAR_AUTH_CERT_ID

String

Der nicht leere Inhalt dieser Variable wird als ID eines eigenen Zertifikats in der Partnerverwaltung interpretiert. Siehe Zertifikate und  HTTP.

VAR_AUTOSERIALIZE_DATA

String

Siehe die Funktionen serialize map/list(a,b) und deserialize map/list(a,b).

VAR_ERROR

String

Fehlermeldung im Fehlerfall.

VAR_FILENAME

String

Originaldateiname. Ist kein Dateiname vorhanden, erhält die Variable einen der folgenden Werte:

• db_query, wenn im Profil der zeitgesteuerte Eingangsagent mit Datenquelle DB verwendet wird.

• den Namen der verwendeten Klasse, wenn im Profil der zeitgesteuerte Eingangsagent mit Datenquelle API verwendet wird.

• unknown, in allen anderen Fällen.

Siehe auch VAR_FILENAME_PREFIX, VAR_FILENAME_SUFFIX und VAR_SYS_ATTACHMENT_NAME.

VAR_FILENAME_PREFIX

String

Originaldateiname ohne Dateiendung.

Beispiel: Enthält den Wert test bei Originaldateiname test.txt. Siehe auch VAR_FILENAME, VAR_FILENAME_SUFFIX.

VAR_FILENAME_SUFFIX

String

Dateiendung des Originaldateinamens.

Beispiel: Enthält den Wert txt bei Originaldateiname test.txt. Siehe auch VAR_FILENAME, VAR_FILENAME_PREFIX.

VAR_FILESIZE

Integer

Anzahl Bytes der Eingangsdaten.

 HINWEIS: Beim Testen eines Profils erhält die Variable den Wert 0.

VAR_IS_NOT_TEST

Boolean

Ist false bei Testlauf. Siehe auch VAR_IS_TEST.

VAR_IS_TEST

Boolean

Ist true bei Testlauf. Die Variable wird, falls es sich um einen Testlauf des Profils handelt (Neudurchlauf-Dialog, Datei hochladen und Checkbox ist ein Testlauf), mit dem Wert true belegt (im Neudurchlauf-Dialog und Button Cron starten erfolgt das nicht). Andernfalls hat die Variable den Wert false.

 HINWEIS: Auch beim Mapping-Test erhält die Variable den Wert true.

Siehe auch VAR_IS_NOT_TEST.

VAR_JOBNR

(MSG_CALL_VAR_JOBNR)

String

Aktuelle Jobnummer.  HINWEIS: Beim Testen eines Profils erhält die Variable den Wert -1. Bei Subprofil-Aufrufen mit den Funktionen call profile() und trigger profile(a,b) kann die Jobnummer des rufenden Profils im gerufenen Profil mit der System-Variablen MSG_CALL_VAR_JOBNR abgerufen werden.

VAR_MAILSUBJECT

String

Enthält den Inhalt des Betreffs, wenn es sich bei den Eingangsdaten des aktuellen Jobs um eine E-Mail, eine X.400-Mail oder AS2-Nachricht handelt. Bei einem Neudurchlauf eines bereits gelaufenen Profils kann die Variable nur dann mit dem Inhalt des Betreffs belegt werden, wenn im Profil die Checkbox Eingangsinformationen vorhalten bereits beim ersten Durchlauf des Profils gesetzt war (siehe Allgemein (Basis-Daten)).

 HINWEIS: Beim Testen eines Profils erhält die Variable keinen Wert.

VAR_ORIGINATOR_JOBNR

String

Werden Daten in einem Archiv geliefert, wird jede der aus dem Archiv entpackten Dateien in einem eigenen Job verarbeitet. Die System-Variable enthält dann in allen Folgejobs die Jobnummer des Ausgangsjobs. Wird ein Profil mit dem zeitgesteuerten Eingangsagenten Mail durch ein anderes Profil getriggert, dann erhalten Folgejobs ebenfalls die Jobnummer des Ausgangsjobs (der getriggert hatte).

Siehe auch:

• Allgemein (Basis-Daten)

• Verteilungsregeln (Mail)

• Mail/X.400 (Eingangsagent Cron)

VAR_PROFILENAME

String

Wird mit dem Namen des Profils belegt.

VAR_PROFILE_VERSION

String

Wird mit der Version des Profils belegt.

VAR_RECORDS

Integer

Die Variable wird mit der Anzahl der Datenblätter belegt. Die Variable kann nur benutzt werden, wenn sie auch gemappt wird. Wenn die Daten von einem Profil ohne Mapping nur durchgereicht werden, hat die Variable den Wert 0. Siehe auch Parsen.

VAR_RESPONSE_HTTP_HEADER_<Name des Response-Headers>

String

In Lobster Integrations Rolle als HTTP(S)-Server können hiermit HTTP-Response-Header gesetzt werden. Siehe call SOAP-WebService without template() (Details bei den entsprechenden Varianten).

VAR_RESPONSE_HTTP_HEADER_RESP_STATUS

String

In Lobster Integrations Rolle als HTTP(S)-Server (siehe Details bei den entsprechenden Varianten) kann hiermit der HTTP-Response-Status gesetzt werden. Siehe auch call SOAP-WebService without template().

VAR_RESPONSE_MAIL_HEADER_<Name des Mail-Headers>

String

Werden die entsprechenden Variablen mit Werten belegt, dann werden bei einem Antwortweg Mail (SMTP) die entsprechenden Mail-Header mit diesen Werten gesetzt.

 HINWEIS: Hier wird Groß- und Kleinschreibung beachtet. Der E-Mail-Header wird also so übernommen, wie in der Variable geschrieben. Man sollte sich dabei an die RFC-Schreibweise des Headers halten. Wird über ASM versendet, dann werden diese Variablen an ASM weitergeleitet und dann dort verwendet.

VAR_SENDER

String

Enthält den Absender der Eingangsdaten, wenn es sich bei den Eingangsdaten des aktuellen Jobs um eine E-Mail, eine X.400-Mail, eine (S)FTP(S)-, eine OFTP-, eine FAX-, eine AS2- oder eine SMS-Nachricht handelt. Bei Formular-Profilen erhält die Variable den Wert WebMonitor:<Login-Name>. In laufenden Workflows enthält die Variable den Namen des Lobster Integration- oder DataCockpit-Benutzers (Präfix WebMonitor:), der den Workflow gestartet hat.

 HINWEIS:

• Vor dem Versenden einer Fehler-E-Mail wird die Variable neu ausgewertet.

• Bei einem Neudurchlauf eines bereits gelaufenen Profils kann die Variable nur dann mit dem Absender belegt werden, wenn im Profil die Checkbox Eingangsinformationen vorhalten bereits beim ersten Durchlauf des Profils gesetzt war.

• Beim Testen eines Profils enthält die Variable keinen Wert. Bei einem Neustart wird die Variable mit dem Benutzernamen belegt.

Siehe auch Formulare und Workflow-Übersicht.

VAR_SYS_ARCHENTRY_PATH

String

Wird mit dem Pfad des aktuellen Archiv-Eintrags belegt (wenn dieser in einem Unterordner des empfangenen Archivs liegt).

VAR_SYS_ARCHIVE_NAME

String

Wird mit dem Namen (ohne Pfad) einer empfangenen Archiv-Datei belegt (zum Beispiel MyZip.zip).

VAR_SYS_ARCHIVE_ENTRY_n

String

Der Name der Datei in einem Archiv des Antwortwegs mit der Positionsnummer n (in der Liste der Antwortwege) kann über die System-Variable VAR_SYS_ARCHIVE_ENTRY_n gesetzt werden. Siehe auch Inhalts-Einstellungen.

VAR_SYS_AS2_MIME_TYPE

String

MIME-Type einer empfangenen AS2-Nachricht.

VAR_SYS_ASM_RESPONSE[1..n]

String

Wenn eine dieser Variablen mit einem Wert belegt ist, wird für den jeweiligen Antwortweg mit der Nummer [1..n] der Name des ASM-Eintrags im Antwortweg durch den entsprechenden Variablenwert überschrieben. Beispiel: VAR_SYS_ASM_RESPONSE1 überschreibt im Antwortweg mit der Nummer 1 den ASM-Eintrag mit dem Wert der Variable.

Siehe auch ASM-Einstellungen.

VAR_SYS_ATTACHMENT_NAME

String

Wird ein zeitgesteuerter Eingangsagent des Typs Mail (POP3, IMAP, X.400) oder ein eventgesteuerter Eingangsagent des Typs SMTP verwendet, enthält die Variable den „original name“ der Anhangsdatei. Dies ist nützlich, da die Variable VAR_FILENAME bei einem Attachment mit Namen test/asdf.pdf nur asdf.pdf zurückgeben würde.

VAR_SYS_BACKUP

String

Die Variable wird mit dem Namen der Backupdatei der Eingangsdaten des aktuellen Jobs belegt, zum Beispiel Job_25995.

 HINWEIS: Beim Testen eines Profils erhält die Variable den Wert Job_-1.

Siehe auch die Funktionen get path of backup-file() und read env-file().

VAR_SYS_CHANNEL_NAME_RESPONSE[1..n]

String

Name eines Partner-Kanals. Siehe auch die Beschreibung der Variable VAR_SYS_CHANNEL_RESPONSE[1..n].

Siehe auch Kanäle.

VAR_SYS_CHANNEL_RESPONSE[1..n]

String

Ist die Variable mit einem Wert > 0 belegt, dann wird die ID eines gesetzten Partner-Kanals des Antwortweges [1..n] durch den Inhalt der Variable überschrieben. Dies gilt für alle Antwortwegtypen, die einen Partner-Kanal festlegen können. Siehe auch find channel(). Hat die Variable keinen Wert > 0, so wird versucht, aus der Kombination der Werte der Variablen VAR_SYS_CHANNEL_NAME_RESPONSE[1..n] und VAR_SYS_PARTNER_NAME_RESPONSE[1..n] einen passenden Partner-Kanal zu ermitteln. Dies erfolgt nur dann, wenn diese Variablen mit Werten (also einem Partner- bzw. Partner-Kanal-Namen) belegt sind. Die Ermittlung des Partner-Kanals erfolgt mittels einer Case-sensitiven Suche. Wird kein gültiger Partner-Kanal gefunden, dann wird der im Antwortweg gesetzte Partner-Kanal verwendet. Siehe auch VAR_SYS_TRIGGER_CHANNEL_ID.

Siehe auch Kanäle.

VAR_SYS_CLIENTNAME

String

Name des momentan ausgewählten Mandanten.

VAR_SYS_COLLECTED_MSGS

String

In dieser Variable werden die Inhalte der Variable VAR_SYS_MESSAGE für jedes fehlerhafte/übersprungene Datenblatt akkumuliert. Siehe Bei SQL-Fehler mit nächstem Datenblatt fortfahren.

VAR_SYS_COMM_CHANNEL_ID

BigInteger

Erfolgte in einem Eingangsagenten eine Authentifizierung über einen Kanal, dann finden Sie hier die ID des Kanals.

 HINWEIS: Gilt nicht für Profile mit zeitgesteuertem Eingangsagenten, die per HTTP getriggert wurden. Siehe VAR_SYS_TRIGGER_HTTP_CHANNEL_ID und MSG_CALL_HTTP_AUTH_USER.

VAR_SYS_COMM_CHANNEL_TYPE

String

Erfolgte in einem Eingangsagenten eine Authentifizierung über einen Kanal, dann finden Sie hier den Typ des Kanals, zum Beispiel den Wert HTTP.

 HINWEIS: Gilt nicht für Profile mit zeitgesteuertem Eingangsagenten, die per HTTP getriggert wurden.

Siehe auch MSG_CALL_HTTP_AUTH_USER.

VAR_SYS_CTRL_FILE

String

Die Variable wird mit dem Inhalt der Kontrolldatei bei einer Datenübertragung per FTP belegt. Siehe FTP/FTPS/SFTP (Eingangsagent Cron) für zeitgesteuerte Eingangsagenten.

VAR_SYS_CURRENT_RECORD

String

Die Variable enthält die Nummer des aktuellen Datenblattes im Fehlerfall in Phase 3, sonst immer 0.

VAR_SYS_DMZ_ID

String

Wenn definiert, steht dort gegebenenfalls die Factory-ID des DMZ-Servers (aus ./etc/factory.xml), der die Nachricht entgegengenommen hat. Das ist hilfreich, wenn mehrere DMZ-Server vorhanden sind. Außerdem kann man sehen, ob die Nachricht per DMZ kam oder nicht. Gilt nicht für reine HTTP-Requests (/dw/Request/).

VAR_SYS_ENABLE_SEMANTIC_CHECK

Boolean

Siehe Abschnitt Semantische Prüfung.

VAR_SYS_EXCEL_SHEET_NAMES

String

Liste aller Excel-Tabellen-Namen, getrennt durch \n. Siehe Excel (Dokumentenart)

VAR_SYS_EXCEPTION

(MSG_CALL_VAR_SYS_EXCEPTION)

String

Die Variable enthält die Fehlermeldung der Exception im Fehlerfall. Tritt bei Profil-Aufrufen mit den Funktionen call profile() und trigger profile() eine Exception auf, weil der MessageService nicht erreichbar ist, liefern die Funktionen lediglich false zurück. Die Exception-Fehlermeldung lässt sich über die System-Variable MSG_CALL_VAR_SYS_EXCEPTION abrufen (wenn diese angelegt ist). Siehe auch call SOAP-WebService()

VAR_SYS_EXCEPTION_STACKTRACE

String

Diese Variable ist gefüllt, falls in Phase 4 (SQL) oder in den Funktionen call db procedure, select-statement, select into map() ein Fehler auftritt.

VAR_SYS_FILE_PATH

String

Die Variable wird bei Profilen mit zeitgesteuertem Eingangsagenten mit Datenquelle Datei, dem Pfad der gelesenen Eingangsdatei ohne den Dateinamen belegt. Der Wert der Variable entspricht dem Eintrag im Feld Verzeichnis der Konfigurationsmaske für den Eingangsagenten.

VAR_SYS_HAS_INVALID_RECORD

Boolean

Die Variable hat den Wert true, wenn in Phase 3 bei mindestens einem Datenblatt ein Fehler aufgetreten ist.

VAR_SYS_HAS_SQL_ERROR

Boolean

Die Variable hat den Wert true, wenn in der Phase 4 bei der Verarbeitung bei mindestens einem Datensatz ein SQL-Fehler aufgetreten ist.

VAR_SYS_LAST_IN_ARCHIVE

Boolean

Die Variable hat den Wert true, wenn es sich um die letzte Datei eines Archivs (zum Beispiel Zip-Datei) handelt.

VAR_SYS_LASTINBULK

Boolean

Die Variable hat den Wert true, wenn die Datei die letzte Datei einer SSH-, OFTP- oder FTP-Übertragung war. Die Variable wird nur gesetzt, wenn beim Eingangsagenten in Phase 1 die Checkbox Daten erst bei Logout verarbeiten gesetzt ist. Das Modul CI (Content Inspection) setzt diese Variable auch auf true, wenn die letzte Datei eines Dateiverbundes verarbeitet wird.

VAR_SYS_LINES

Integer

Die Variable wird mit der Anzahl der verarbeiteten Zeilen von Eingangsdateien des Typs CSV, Excel, IDoc und Feste Länge belegt.

VAR_SYS_MAIL_ARCHIVE

String

Bei aktiver Archivierung von E-Mails und X.400-Mails wird die Variable mit dem Pfad der archivierten Mail-Datei belegt.

VAR_SYS_MAIL_ATTACHMENTS

Integer

Anzahl der Attachments einer (X.400-)Mail.

VAR_SYS_MAIL_BODY

String

Die Variable wird bei Mail-Empfang mit dem Mail-Body belegt, wenn es kein Profil mit aktiver Option Nachrichtentext (Mail body) verarbeiten gibt. Siehe auch Mail (SMTP) (Eingangsagent)

VAR_SYS_MAIL_HEADER_<Name des Mail-Headers in Großbuchstaben>

String

Die Variable wird bei den Eingangsagenten Mail (Imap/Pop3) und SMTP gesetzt. Siehe Mail/X.400 (Eingangsagent Cron) und Mail (SMTP) (Eingangsagent).

 HINWEIS: Hier dürfen nur Großbuchstaben verwendet werden. Beispiel: Die Variable VAR_SYS_MAIL_HEADER_DATE erhält den originalen String-Wert des Mail-Headers Date. Aus der Mail-Header-Zeile Date: Wed, 6 Sep 2017 13:50:01 +0300 wird der Variableninhalt Wed, 6 Sep 2017 13:50:01 +0300.

VAR_SYS_MAIL_HEADER_RECEIVED_ALLB64

String

Wird die System-Variable VAR_SYS_MAIL_HEADER_RECEIVED verwendet, enthält sie nur den ersten „Received“-Mail-Header. Um alle zu erhalten, verwenden Sie VAR_SYS_MAIL_HEADER_RECEIVED_ALLB64. Diese Variable enthält alle Received-Mail-Header, kommagetrennt und Base64-kodiert.

VAR_SYS_MAIL_RECIPIENTS

String

Die Variable enthält eine Liste der Empfänger (und CCs, aber nicht BCCs), wenn es sich bei den Eingangsdaten des aktuellen Jobs um eine E-Mail oder eine X.400-Mail handelt. Bei einem Neudurchlauf eines bereits gelaufenen Profils kann die Variable nur dann belegt werden, wenn im Profil die Checkbox Eingangsinformationen vorhalten bereits beim ersten Durchlauf des Profils gesetzt war.

 HINWEIS:

• Die Variable muss explizit definiert werden. Beim Testen eines Profils erhält die Variable keinen Wert.

• In die Variable werden nur die einfachen Mailadressen eingetragen. Sollen die vollen Mailadressen verwendet werden, muss der Integration Server mit der Startoption -Dhub.datawizard.fullMailAddress=true gestartet werden.

VAR_SYS_MESSAGE

String

In der Variable werden relevante Informationen für das Datenblatt gesammelt, bei dessen Verarbeitung ein Fehler aufgetreten ist.

VAR_SYS_MESSAGE_ID

String

In dieser Variable wird die Message-ID einer empfangenen oder in einem zeitgesteuerten Eingangsagenten mit Datenquelle Mail abgeholten E-Mail, einer X.400-Mail, einer AS2-Nachricht oder einer OFTP-Nachricht gespeichert. Bei einem SAP-ALE-Eingangsagenten enthält die Variable den Wert <DOCNUM>@<TID>. Bei gruppierten IDocs ist dies immer die letzte empfangene DOCNUM. Bei einem event-gesteuerten HTTP-Eingangsagenten enthält die Variable eine UUID.

 HINWEIS: Die Variable muss explizit definiert werden.

VAR_SYS_MTS_ID

String

Enthält den MTS Identifier von X.400-Nachrichten.

VAR_SYS_OFTP_FILE_COUNTER

String

OFTP File Counter. Siehe OFTP (Eingangsagent).

VAR_SYS_OFTP_ORIGINATOR

String

Die Variable wird mit dem Urheber der OFTP-Nachricht gefüllt. Dieser kann vom Absender der Nachricht abweichen. Siehe auch OFTP (Eingangsagent).

VAR_SYS_OFTP_DESTINATION

String

Die Variable wird mit der Zieladresse der OFTP-Nachricht gefüllt. Diese kann vom Empfänger der Nachricht abweichen.

VAR_SYS_OFTP_SFID

String

Die Variable wird mit der Zieladresse der OFTP-Nachricht gefüllt. Diese kann vom Empfänger der Nachricht abweichen. Siehe auch OFTP (Eingangsagent).

VAR_SYS_PARTNER_NAME_RESPONSE[1..n]

String

Name eines Partner-Kanals. Siehe die Beschreibung der Variable VAR_SYS_CHANNEL_RESPONSE[1..n].

VAR_SYS_PROFILECALL_PATH

String

Wird intern verwendet bei Aufruf von Sub-Profilen in der Zielstruktur. Siehe Profil als Unterknoten einhängen in Zielstruktur.

VAR_SYS_RESPONSE_WORKFLOW_<Antwortwegs-Positionsnummer>

String

Mit diesen Variablen kann der Display-Name von Workflows gesetzt werden, die mit einer der Klassen WorkflowResponse oder WorkflowResponseWithoutAttachment gestartet werden (siehe dort). Siehe auch Variablen (Workflows).

VAR_SYS_RESTART

Boolean

Die Variable hat den Wert true, wenn der aktuelle Job durch einen Neustart eines fehlerhaften Jobs gestartet wurde.

VAR_SYS_SAP_TID

String

Bei einem Antwortweg des Typs SAP ALE enthält die Variable (falls definiert) die zum Senden verwendete TID (automatisch erzeugt). Die TID kann auch manuell erzeugt werden, mit der Funktion create-sap-tid(), um diese dann der Variable zuzuweisen.

VAR_SYS_SEMANTIC_FORMAT

String

Siehe Abschnitt Semantische Prüfung.

VAR_SYS_SEMANTIC_TYPE

String

Siehe Abschnitt Semantische Prüfung.

VAR_SYS_SOAP_FAULT

String

Enthält Webservice-Fehlermeldung. Siehe Parameter i in Funktion call SOAP-WebService() und Parameter g in Funktion call SOAP-WebService without template().

VAR_SYS_SYSTEM_TYPE

Integer

Der Wert kodiert den Typ des Lobster-Systems (0 = Prod, 1 = Test, 2 = Standby, 3 = DMZ). Siehe auch Funktion get system-type().

VAR_SYS_TRIGGER_CHANNEL_ID

bzw.

MSG_CALL_VAR_SYS_TRIGGER_CHANNEL_ID

Integer

Wenn > 0, dann wird der Kanal in einem zeitgesteuerten Eingangsagenten durch den Kanal mit dieser ID ersetzt. Ist der Wert 0 oder die Variable nicht definiert, wird der im Eingangsagenten hinterlegte Kanal verwendet (oder keiner, falls kein Kanal gesetzt ist). Siehe auch find channel(). Siehe auch Variablen mit Präfix MSG_CALL_ und den Variablen VAR_SYS_CHANNEL_RESPONSE[1..n].

VAR_SYS_TRIGGER_HTTP_CHANNEL_ID

String

In Profilen mit zeitgesteuertem Eingangsagenten, der über HTTP getriggert wurde, wird diese Variable mit der ID des Kanals gefüllt, wenn über diesen Kanal eine Authentifizierung stattgefunden hat. Siehe auch MSG_CALL_HTTP_AUTH_USER.

VAR_SYS_VALIDATION_ERRORS

Integer

Die Funktion dump validation data () speichert die Anzahl der Fehler (errors) in dieser Variable.

VAR_TIMESTAMP

TimeStamp

Zeitstempel der Backup-Datei bzw. E-Mail. Wenn die Checkbox Eingangsinformationen vorhalten nicht gesetzt ist, wird der Zeitstempel der Backupdatei verwendet. Das ist bei erster Ausführung der Startzeitpunkt des Jobs, aber bei Neudurchlauf der Zeitpunkt des originalen Jobs. Wenn die Checkbox gesetzt ist, wird bei der Verarbeitung einer E-Mail oder X.400-Mail der Absende-Zeitpunkt der Nachricht verwendet. Bei Datenquelle Datei wird die letzte Modifikation der Datei verwendet, in allen anderen Fällen der Startzeitpunkt des originalen Jobs. Siehe auch Allgemein (Basis-Daten)