HTTP-Aktivität 'Anforderung senden'

Die HTTP-Aktivität Anforderung senden sendet eine HTTP-Anforderung an die angegebene Position, den HTTP-Endpunkt, und empfängt eine HTTP-Antwort, die von dieser Position zurückgesendet wird.

Die folgende Abbildung zeigt die HTTP-Aktivität Anforderung senden, die eine HTTP-Anforderung an die angegebene Position, den HTTP-Endpunkt, sendet und eine HTTP-Antwort empfängt:

Abbildung 1.

HTTP-Aktivität 'Anforderung senden' zur Orchestrierung hinzufügen

  1. Erstellen oder öffnen Sie eine Orchestrierung. Eine grafische Darstellung der Orchestrierung wird angezeigt.
  2. Wählen Sie die Registerkarte Aktivitäten aus und erweitern Sie den HTTP-Ordner.
  3. Ziehen Sie die Aktivität Anforderung senden auf die Orchestrierung.
  4. Wählen Sie die Aktivität aus. Die Prüfliste wird angezeigt.

HTTP-Endpunkt erstellen, auswählen oder bearbeiten

  1. Klicken Sie auf die Task Endpunkt auswählen in der Prüfliste und wählen Sie eine der folgenden Aktionen aus:
    • Wählen Sie einen vorhandenen Endpunkt aus:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK. Fahren Sie mit der Prozedur zum Konfigurieren der Aktivität fort.
    • Wählen Sie einen vorhandenen Endpunkt und bearbeiten Sie den Endpunkt:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK.
      3. Klicken Sie auf Bearbeiten. Das Fenster Endpunkt bearbeiten wird angezeigt.
    • Erstellen Sie einen neuen Endpunkt: Wählen Sie Neu aus. Das Fenster Endpunkt erstellen wird angezeigt.
  2. Erstellen oder bearbeiten Sie einen HTTP-Endpunkt. Informationen hierzu finden Sie in HTTP-Endpunkt erstellen oder bearbeiten.

Aktivität konfigurieren

  1. Wählen Sie die Task Konfigurieren in der Prüfliste aus. Das Fenster Konfigurieren wird angezeigt.
  2. Konfigurieren Sie alle Felder und Kontrollkästchen in diesem Fenster, wie in der folgenden Tabelle beschrieben:
    Tabelle 1.
    Feld oder Kontrollkästchen Beschreibung
    URL (Pfad nach Hostname) Gibt den Ressourcenpfad an, an den die Aktivität Anforderung senden die Anforderung sendet, z. B. /mypath. Die hier angegebene Zeichenfolge darf Folgendes nicht enthalten: http://, den Hostnamen und die Portnummer der Integrationseinheit (Integration Appliance). Die vollständige URL wird automatisch aus dem Hostnamen der Integrationseinheit, der im HTTP-Endpunkt angegebenen Portnummer und dem in diesem Feld angegebenen Pfad gebildet. Beispiel: Wenn die vollständige URL, an die die Aktivität Anforderung senden die Anforderung sendet, http://myAR:myPort/myPath lautet, muss in diesem Feld nur die Zeichenfolge /myPath eingegeben werden. Der angegebene Pfad muss für die Anforderung senden-Aktivitäten, die zum selben Zeitpunkt in derselben Integrationseinheit mit demselben Port implementiert werden, eindeutig sein.  
    Anforderungsnachricht: Gibt den erwarteten Nachrichtentyp der HTTP-Anforderung an: Text oder Binär.  
    Antwortnachricht: Gibt den Nachrichtentyp der HTTP-Antwort an: Text oder Binär.
    Verarbeitung des Orchestrierungsjobs stoppen

    oder

    Verarbeitung fortsetzen und HTTP-Fehlercode zurückgeben

    Gibt das Laufzeitverhalten der Aktivität bei der Rückgabe einer Fehlerantwort vom HTTP-Server an:
    • Verarbeitung des Orchestrierungsjobs stoppen. Wählen Sie diese Option aus, wenn die Verarbeitung des Orchestrierungsjobs gestoppt werden soll, falls während der Laufzeit eine Fehlerantwort vom HTTP-Server zurückgegeben wird. Die Verarbeitung der Orchestrierung wird in der HTTP-Aktivität Anforderung senden gestoppt; die Aktivitäten nach der HTTP-Aktivität Anforderung senden in der Orchestrierung werden nicht verarbeitet und eine Ausnahmebedingung mit einem Fehler wird gesendet.
    • Verarbeitung fortsetzen und HTTP-Fehlercode zurückgeben. Wählen Sie diese Option aus, wenn die Verarbeitung des Orchestrierungsjobs fortgesetzt werden soll, falls während der Laufzeit eine Fehlerantwort vom HTTP-Server empfangen wird. Der Orchestrierungsjob soll die Verarbeitung von Aktivitäten nach der HTTP-Aktivität Anforderung senden in der Orchestrierung fortsetzen; der Fehlerantwortcode und die Fehlerantwortnachricht werden im Ausgabeparameter 'responsecode' bzw. 'responsemessage' zurückgegeben.
    Komprimierung/Dekomprimierung verwenden Gibt an, ob die Komprimierung/Dekomprimierung auf der Aktivitätsebene aktiviert oder inaktiviert ist. Standardmäßig ist das Kontrollkästchen Komprimierung/Dekomprimierung verwenden abgewählt und damit die Komprimierung/Dekomprimierung für diese Aktivität inaktiviert. Wählen Sie das Kontrollkästchen Komprimierung/Dekomprimierung verwenden aus, um die Komprimierung/Dekomprimierung für diese Aktivität zu aktivieren. Weitere Informationen finden Sie unter Komprimierung/Dekomprimierung mit der HTTP-Aktivität 'Anforderung senden'.

Wiederholungsoptionen angeben

  1. Wählen Sie die Task Wiederholung in der Prüfliste aus. Das Fenster Wiederholung wird angezeigt.
  2. Konfigurieren Sie die Wiederholungsoptionen für die Verbindung zu einem HTTP-Server. In der folgenden Tabelle sind die Wiederholungsoptionen für eine Verbindung zu einem HTTP-Server definiert:
    Tabelle 2.
    Felder Beschreibung
    Wiederholung  
    1) __ Sekunden zwischen den einzelnen Wiederholungen warten. Gibt den Zeitraum in Sekunden an, während dessen die Integrationseinheit wartet, bevor sie versucht, eine Verbindung zur HTTP-Server herzustellen.
    2) Verbindungsherstellung __ mal versuchen, bevor ein Fehler zurückgegeben wird. Gibt die Anzahl der Wiederholungen an, d. h. die maximale Anzahl von Versuchen der Integrationseinheit, eine Verbindung zum HTTP-Server herzustellen, bevor ein Fehler ausgegeben und die Verarbeitung des aktuellen Orchestrierungsjobs gestoppt wird.

    Wenn Sie eine Orchestrierung implementieren, die eine HTTP-Aktivität Anforderung senden enthält, und die Integrationseinheit keine Verbindung zum angegebenen HTTP-Server herstellen kann, protokolliert die Integrationseinheit die Verbindungsfehler als Warnungen im System- und Orchestrierungsprotokoll, bis der Wert für die Anzahl der Wiederholungen erreicht ist. Wenn der Wert für die Anzahl der Wiederholungen erreicht ist, protokolliert die Integrationseinheit einen Fehler im System- und Orchestrierungsprotokoll und stoppt dann die Verarbeitung des aktuellen Orchestrierungsjobs.

    Wenn Sie für die Anzahl der Wiederholungen beispielsweise den Wert 3 angeben, werden der erste, zweite und dritte Verbindungsfehler als Warnungen im Systemprotokoll aufgezeichnet. Die Integrationseinheit protokolliert den vierten Verbindungsfehler als Fehler und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs.

    Aktivitätszeitlimit  
    3) Zeitlimitüberschreitung nach __ Sekunden, wenn der Endpunkt nicht auf eine Anforderung antwortet. Gibt den Zeitraum (in Sekunden) an, der zwischen dem Senden einer Anforderung an den Endpunkt durch die Aktivität und der Antwort des Endpunkts auf die Anforderung liegt, bevor eine Zeitlimitüberschreitung auftritt. Für eine HTTP-Aktivität Anforderung senden ist das Aktivitätszeitlimit der Zeitraum, während dessen die Integrationseinheit nach dem Senden einer HTTP-Anforderung auf eine Antwort vom HTTP-Server wartet, bevor sie einen Fehler aufgrund einer Zeitlimitüberschreitung ausgibt. Ein Aktivitätszeitlimit unterscheidet sich von einem Verbindungszeitlimit, da eine Aktivitätszeitlimitüberschreitung auftritt, nachdem die Verbindung zum Endpunkt bereits hergestellt ist. Ein Verbindungszeitlimit gibt den Zeitraum (in Sekunden) an, der zwischen dem Versuch der Integrationseinheit, eine Verbindung zum Endpunkt herzustellen, und der Antwort des Endpunkts auf die Verbindungsanforderung liegt, bevor eine Zeitlimitüberschreitung auftritt. Das Verbindungszeitlimit wird auf der Registerkarte HTTP-Endpunkt festgelegt. Weitere Informationen zu Verbindungszeitlimits finden Sie in HTTP-Endpunkt erstellen oder bearbeiten.

Eingabe der Aktivität zuordnen

  1. Wählen Sie die Task Eingaben zuordnen in der Prüfliste aus. Der Eingabeparameter 'body' wird im Teilfenster An Aktivität der Task Eingaben zuordnen angezeigt. Dem Eingabeparameter 'body' muss mindestens eine Variable zugeordnet werden, da es sich um einen verbindlichen Parameter handelt. Der Eingabeparameter 'body' enthält den Hauptteil der HTTP-Anforderungsnachricht, die an den HTTP-Server gesendet wird.
  2. Wenn Sie die optionalen Eingabeparameter im Teilfenster An Aktivität des Teilfensters Eingaben zuordnen anzeigen möchten, wählen Sie Option Zuordnen > Optionale Parameter anzeigen im Symbolleistenmenü aus oder klicken Sie mit der rechten Maustaste im Teilfenster An Aktivität und wählen Sie die Option 'Optionale Parameter anzeigen' aus. Wenn die Option Zuordnen > Optionale Parameter anzeigen im Symbolleistenmenü nicht auswählbar ist, klicken Sie auf einen Knoten im Teilfenster 'Eingaben zuordnen', um diese Option zu aktivieren. Die Eingabeparameter 'httpheaders' und 'httpConnParameter' werden angezeigt.
    In der folgenden Tabelle sind die Knoten des optionalen Parameters 'httpheaders' definiert:
    Tabelle 3.
    Knoten des Eingabeparameters 'httpheaders' Beschreibung
    httpheaders/uri Gibt den Ressourcenpfad an, z. B. /myPath..
    httpheaders/method Gibt den HTTP-Anforderungstyp an.
    httpheaders/otherHeaders/headerItem Gibt ein Element an, das eine Gruppe von HTTP-Headerparametern als Name/Wert-Paare enthält. In der HTTP-Anforderung können mehrere HTTP-Headerparameter angegeben werden, d. h., hierbei handelt es sich um einen wiederholten Knoten.
    ttpheaders/otherHeaders/headerItem/name Gibt den Namen des HTTP-Headerparameters an.
    httpheaders/otherHeaders/headerItem/value Gibt den Wert des HTTP-Headerparameters an.
    Anmerkung: Wenn der Header für die Inhaltslänge während der Laufzeit explizit mit httpheaders/otherHeaders/headerItem/name und httpheaders/otherHeaders/headerItem/value festgelegt wird, wird dieser Wert ignoriert. Diese Aktivität legt für den Header für die Inhaltslänge automatisch die Größe des Hauptteils fest.
    In der folgenden Tabelle sind die Knoten des optionalen Eingabeparameters 'httpConnParameter' definiert. Sie können die Einstellungen, die Sie in der Task Endpunkt auswählen der Prüfliste ausgewählt haben, optional während der Laufzeit dynamisch überschreiben, indem Sie Werte aus Variablen in die Knoten übergeben, wie in der folgenden Tabelle beschrieben. So können Sie zum Beispiel den im Endpunkt angegebenen Hostnamen während der Laufzeit überschreiben, indem Sie dem Hostknoten des Eingabeparameters 'httpConnParameter' eine Variable zuordnen. Während der Laufzeit ist der Wert der Variablen der Hostname, der für die Verbindung zum HTTP-Server verwendet wird.
    Tabelle 4.
    Knoten des Eingabeparameters 'httpConnParameter' Beschreibung Welche Einstellungen im HTTP-Endpunkt werden überschrieben?
    timeout    
    host Gibt den Hostnamen oder die IP-Adresse des fernen HTTP-Servers an.   Der Knoten host des Eingabeparameters 'httpConnParameter' überschreibt das Feld Hostname des HTTP-Endpunkts.
    port Gibt die Portnummer des fernen HTTP-Servers an.   Der Knoten port des Eingabeparameters 'httpConnParameter' überschreibt das Feld Port des HTTP-Endpunkts.
    isSecure Diesen booleschen Wert auf 'true' setzen, um HTTPS (gesichertes HTTP over SSL) zu aktivieren. Den booleschen Wert auf 'false' setzen, um diese Sicherheitseinstellung zu inaktivieren. Der Knoten isSecure des Eingabeparameters 'httpConnParameter' überschreibt die Option Sicherheit des HTTP-Endpunkts.
    username Gibt den Benutzernamen für den Accout an, der für die Verbindung zum HTTP-Server verwendet wird. Der Knoten username des Eingabeparameters 'httpConnParameter' überschreibt das Feld Benutzername des HTTP-Endpunkts.
    password Gibt das Kennwort für den Accout an, der für die Verbindung zum HTTP-Server verwendet wird. Der Knoten password des Eingabeparameters 'httpConnParameter' überschreibt das Feld Kennwort des HTTP-Endpunkts.
  3. Erstellen Sie eine Zuordnung zwischen der bzw. den Orchestrierungsvariablen und dem Eingabeparameter bzw. den Eingabeparametern. Allgemeine Anweisungen zur Zuordnung finden Sie unter Zuordnung erstellen.

Ausgabe der Aktivität zuordnen

  1. Wählen Sie die Task Ausgaben zuordnen in der Prüfliste aus. Die Ausgabeparameter der Aktivität werden im Teilfenster Von Aktivität der Task Ausgaben zuordnen angezeigt, wie in der folgenden Tabelle beschrieben:
    Tabelle 5.
    Ausgabeparameter Beschreibung
    httpheaders Gibt den Header der HTTP-Antwort an.
    body Gibt den Hauptteil der HTTP-Antwortnachricht an.
    responsecode Gibt den HTTP-Antwortcode an, der während der Laufzeit vom HTTP-Server zurückgegeben wird.  
    responsemessage Gibt die zum HTTP-Antwortcode gehörende Nachricht an.
    In der folgenden Tabelle sind die Knoten des Ausgabeparameters 'httpheaders' definiert:
    Tabelle 6.
    Knoten des Ausgabeparameters 'httpheaders' Beschreibung
    httpheaders/uri Gibt den Ressourcenpfad an, z. B. /myPath..
    httpheaders/method Gibt den HTTP-Antworttyp an.
    httpheaders/otherHeaders/headerItem Gibt eine Reihe von Name/Wert-Paaren an, die die HTTP-Parameter der HTTP-Antwort enthalten. In der HTTP-Anwort können mehrere HTTP-Parameter angegeben werden, d. h., 'headerItem' ist ein wiederholter Knoten.
    httpheaders/otherHeaders/headerItem/name Gibt den Namen des HTTP-Parameters an.
    httpheaders/otherHeaders/headerItem/value Gibt den Wert des HTTP-Parameters an.
  2. Erstellen Sie eine Zuordnung zwischen dem Ausgabeparameter bzw. den Ausgabeparametern der Aktivität und der bzw. den Orchestrierungsvariablen. Allgemeine Anweisungen zur Zuordnung finden Sie unter Zuordnung erstellen.

Zertifikate in Microsoft Internet Explorer verwenden

Wenn Sie die HTTPS-Sicherheitsoption im HTTP-Endpunkt ausgewählt haben, müssen Sie beachten, dass Microsoft® Internet Explorer ein modifiziertes Zertifikat nicht erkennt und den SSL-Status im Cache speichert. Wenn Sie Zertifikate modifizieren, müssen Sie den SSL-Status löschen. Gehen Sie wie folgt vor, um den SSL-Status in Microsoft Internet Explorer zu löschen:
  1. Wählen Sie in der Symbolleiste von Microsoft Internet Explorer Extras > Internetoptionen aus. Das Fenster mit den Internetoptionen wird angezeigt.
  2. Klicken Sie auf die Registerkarte Inhalte.
  3. Klicken Sie im Bereich Zertifikate auf SSL-Status löschen. Es wird ein Dialogfenster mit der Nachricht angezeigt, dass der SSL-Cache erfolgreich gelöscht wurde.
  4. Klicken Sie auf OK und anschließend erneut auf OK.