HTTP-Request-Parameter und HTTP-Header
HTTP-Request-Parameter bei Methode GET
In seiner Rolle als HTTP(S)-Server kann Lobster_data auf die Werte aller HTTP(S)-Request-Parameter über Variablen mit folgender Syntax zugreifen.
|
MSG_CALL_<Name des Parameters in Großbuchstaben> |
Beispielsweise kann auf die Parameter param1 und param2 des folgenden HTTP(S)-Requests über die Variablen MSG_CALL_PARAM1 und MSG_CALL_PARAM2 innerhalb des Profils zugegriffen werden.
|
http://192.168.213.64:8080/dw/trigger/example?param1=value1¶m2=value2 |
Hinweis: Diese Variablen sind also im selben Profil verfügbar und nicht erst in einem Folgeprofil, wie das sonst für Variablen mit dem Präfix MSG_CALL_ üblich ist. Siehe auch Abschnitt Variablen mit Präfix MSG_CALL_.
Festlegung der Pflicht-Request-Parameter
Sowohl für die Übergabe von Daten per Eingangsagent des Typs HTTP(S) als auch für das Triggering per HTTP(S)-Request können Sie festlegen, welche Parameter im jeweiligen HTTP(S)-Request mindestens vorhanden sein müssen. Die folgende Abbildung zeigt ein Beispiel für die Festlegung der HTTP(S)-Request-Parameter.
(1) Name des HTTP(S)-Request-Parameters, der vorhanden sein muss.
(2) Wird in diesem Feld ein Wert eingetragen, dann muss der betroffene Parameter im HTTP(S)-Request genau diesen Wert annehmen. Wird in diesem Feld statt eines Wertes das Symbol * eingegeben, dann können im HTTP(S)-Request für den betroffenen Parameter beliebige Werte stehen. Auf diese Weise kann festgelegt werden, dass der betreffende Parameter lediglich im Request vorhanden sein muss.
Folgende HTTP(S)-Requests werden im Beispiel akzeptiert.
|
...?param1=value1¶m2=value2¶m3=value3¶m4=value4 |
|
...?param1=value1¶m2=value2¶m3=value3¶m4=valueX |
|
...?param1=value1¶m2=value2¶m3=value3¶m4=valueX¶m5=value5 |
Die folgenden HTTP(S)-Requests werden hingegen nicht akzeptiert.
|
...?param1=value1¶m2=value2¶m3=value3 |
|
...?param1=value1¶m2=value2¶m3=valueX¶m4=valueY |
Existieren für einen eingehenden HTTP(S)-Request mehrere Profile mit gleichem URL-Suffix und zutreffender HTTP(S)-Request-Parameter-Festlegung, dann sind diese Profile gleichermaßen bereit, den Request zu akzeptieren. In diesem Fall wird das erstbeste Profil verwendet, das passt.
HTTP-Header auslesen
Der Zugriff auf HTTP-Header erfolgt über System-Variablen. Das gilt auch für Webservices und AS2, weil diese über HTTP transportiert werden.
HTTP-Header setzen
Siehe Abschnitte System-Variablen, HTTP (Eingangsagent Cron) und Antwortweg HTTP(S).