HTTP-Aktivität 'Put-Anforderung'

Die HTTP-Aktivität Put-Anforderung sendet eine Put-Anforderung an die angegebene Position (den HTTP-Endpunkt) und empfängt eine HTTP-Antwort von dieser Position.

HTTP-Aktivität 'Put-Anforderung' 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 Put-Anforderung 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 "Aktivität konfigurieren" fort.
    • Wählen Sie einen vorhandenen Endpunkt aus 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 Teilfenster 'Endpunkt bearbeiten' wird angezeigt.
    • Erstellen Sie einen neuen Endpunkt: Wählen Sie Neu aus. Das Teilfenster '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 Teilfenster '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 Put-Anforderung die Anforderung sendet, z. B. /mypath. Die hier angegebene Zeichenfolge darf die Zeichenfolge http://, den Hostnamen und die Portnummer der Integrationseinheit (Integration Appliance) nicht enthalten. 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 Put-Anforderung 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 Aktivitäten Put-Anforderung, die zum selben Zeitpunkt auf derselben Integrationseinheit mit demselben Port implementiert werden, eindeutig sein.

    Zur Verwendung der Pfad- und Abfrageparameter geben Sie eine URL im folgenden Format ein: "url/{path}?name1=wert1&name2=wert2". Dadurch können Sie dem Parameter "{path}" einen Zeichenfolgewert zuordnen und Abfrageparameternamen angeben. Dies sind in diesem Beispiel "name1" und "name2". Wenn Sie mehrere Parameter "{path}" deklarieren, wird empfohlen, jeden Parameter mit einem eindeutigen Namen zu versehen. Parameter mit demselben Namen werden in der Zuordnung nur durch einen einzigen Knoten dargestellt. Die Pfadparameter werden in 'Eingaben zuordnen' unter /httpheaders/pathParameters angezeigt. Abfrageparameter werden in 'Eingaben zuordnen' unter /httpheaders/queryParameters angezeigt.

    Anmerkung: In der URL wird jeder Wert, den Sie einem Abfrageparameter zuordnen, nicht an den Mapper (Zuordnungsfunktion) übergeben. Für die Zuordnung eines Werts zum Abfrageparameter müssen Sie dem Abfrageparameter entweder explizit einen Wert im Mapper zuordnen oder einen Standardwert definieren.
    Anforderungsnachricht: Gibt den Nachrichtentyp der HTTP-Antwort 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 Aktivität Put-Anforderung gestoppt; die Aktivitäten nach der Aktivität Put-Anforderung in der Orchestrierung werden nicht verarbeitet und eine Ausnahmebedingung mit einem Fehler wird ausgelöst.
    • 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 Aktivität Put-Anforderung 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 in Komprimierung/Dekomprimierung mit den HTTP-Aktivitäten 'Anforderung aufrufen', 'Anforderung abrufen', 'Anforderung senden', 'Head-Anforderung', 'Put-Anforderung', 'Anforderung löschen'.

Anforderungsheader angeben

  1. Wählen Sie die Task Anforderungsheader in der Prüfliste aus. Das Teilfenster Anforderungsheader wird angezeigt. Eine Tabelle Angepasste Header wird oben, ein Kontrollkästchen Vordefinierte Standardheader einbeziehen in der Mitte und eine Tabelle Standardheader unten angezeigt.
  2. Klicken Sie auf die Schaltfläche Hinzufügen, um der Tabelle Angepasste Header einen Header hinzuzufügen. Klicken Sie auf den neuen Eintrag, um einen Headernamen einzugeben, oder wählen Sie einen Headernamen in der Dropdown-Liste aus. Wenn der Headername ein vordefinierter Headername ist, wird eine Beschreibung in der Spalte Beschreibung angezeigt. Andernfalls geben Sie eine eigene Beschreibung für Ihre Header ein.
  3. Wählen Sie zur Verwendung der vordefinierten Standardheader das Kontrollkästchen Vordefinierte Standardheader einbeziehen aus. Beachten Sie, dass doppelte Headernamen nicht zulässig sind (Groß-/Kleinschreibung wird nicht unterschieden). Sie werden in diesem Fall aufgefordert, alle doppelten Header in der Tabelle Angepasste Header zu entfernen. Die ausgewählten HTTP-Header werden unter /httpheaders im Fenster 'Eingaben zuordnen' angezeigt.

Antwortheader angeben

  1. Wählen Sie die Task Antwortheader in der Prüfliste aus. Das Teilfenster Antwortheader wird angezeigt. Eine Tabelle Angepasste Header wird oben, ein Kontrollkästchen Vordefinierte Standardheader einbeziehen in der Mitte und eine Tabelle Standardheader unten angezeigt.
  2. Klicken Sie auf die Schaltfläche Hinzufügen, um der Tabelle Angepasste Header einen Header hinzuzufügen. Klicken Sie auf den neuen Eintrag, um einen Headernamen einzugeben, oder wählen Sie einen Headernamen in der Dropdown-Liste aus. Wenn der Headername ein vordefinierter Headername ist, wird eine Beschreibung in der Spalte Beschreibung angezeigt. Andernfalls geben Sie eine eigene Beschreibung für Ihre Header ein.
  3. Wählen Sie zur Verwendung der vordefinierten Standardheader das Kontrollkästchen Vordefinierte Standardheader einbeziehen aus. Beachten Sie, dass doppelte Headernamen nicht zulässig sind (Groß-/Kleinschreibung wird nicht unterschieden). Sie werden möglicherweise aufgefordert, alle doppelten Header in der Tabelle Angepasste Header zu entfernen. Die ausgewählten HTTP-Header werden unter /httpheaders im Fenster 'Ausgaben zuordnen' angezeigt.

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 die Verbindung zu einem HTTP-Server definiert:
    Feld Beschreibung
    Wiederholung  
    1) ___ Sekunden zwischen den einzelnen Wiederholungen warten. Gibt die Zeitdauer in Sekunden an, die die Integrationseinheit wartet, bevor sie erneut versucht, eine Verbindung zum 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 Put-Anforderung 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 die Wiederholungsanzahl erreicht wird, protokolliert die Integrationseinheit einen Fehler im System- und Orchestrierungsprotokoll und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs. Wenn Sie den Wiederholungszähler beispielsweise auf den Wert 3 setzen, werden der erste, zweite und dritte Verbindungsfehler als Warnung im Systemprotokoll aufgezeichnet. Die Integrationseinheit protokolliert den vierten Verbindungsfehler als Fehler und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs.
    3) Zeitlimitüberschreitung nach ___ Sekunden, wenn der Endpunkt nicht auf eine Anforderung antwortet. Gibt die Zeitdauer (in Sekunden) an, die zwischen dem Zeitpunkt, zu dem eine Aktivität auf einem Endpunkt eine Anforderung aufruft, und dem Zeitpunkt, zu dem der Endpunkt antwortet, verstreichen darf, bevor eine Zeitlimitüberschreitung auftritt. Für die HTTP-Aktivität Put-Anforderung 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 Web-Service-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. Der Eingabeparameter body ist obligatorisch und muss mindestens eine zugeordnete Variable haben. Der Eingabeparameter body enthält den Hauptteil der HTTP-Antwortnachricht, die an den HTTP-Server zurückgesendet 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 2.
    Knoten des Eingabeparameters httpheaders Beschreibung
    httpheaders/uri Gibt den Ressourcenpfad an. Beispiel: /myPath
    httpheaders/<konfigurierter_headername> Wenn Sie mindestens einen Anforderungsheader im Schritt für Anforderungsheader konfiguriert haben, werden die Anforderungsheader hier angezeigt. Der Wert <konfigurierter_headername> steht für die tatsächlichen Headernamen, die Sie ausgewählt oder eingegeben haben.
    httpheaders/pathParameters Wenn Sie Pfadparameter in der URL im Konfigurationsschritt konfiguriert haben, werden diese hier angezeigt. Wenn kein Pfadparameter angegeben ist, wird dieser Knoten nicht angezeigt.
    httpheaders/queryParameters Wenn Sie Abfrageparameter in der URL im Konfigurationsschritt konfiguriert haben, werden diese hier angezeigt. Wenn kein Abfrageparameter angegeben ist, wird dieser Knoten nicht angezeigt.
    httpheaders/otherHeaders/headerItem Gibt ein Element, das eine Gruppe von HTTP-Headerparametern als Name/Wert-Paare enthält, für die HTTP-Antwort an. In der HTTP-Antwort können mehrere HTTP-Parameter angegeben werden, d. h., hierbei handelt es sich um einen wiederholten Knoten.
    httpheaders/otherHeaders/headerItem/name Gibt den Namen des HTTP-Parameters an.
    httpheaders/otherHeaders/headerItem/value Gibt den Wert des HTTP-Parameters an.
    Anmerkung: Wenn der Content-Length-Header (Inhaltslänge) mithilfe von httpheaders/otherHeaders/headerItem/name und httpheaders/otherHeaders/headerItem/value explizit festgelegt wird, wird dieser Wert während der Ausführung ignoriert. Diese Aktivität setzt den Content-Length-Header automatisch auf die Größe des Hauptteils.
    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 3.
    Knoten des Eingabeparameters httpConnParameter Beschreibung Welche Einstellungen im HTTP-Endpunkt werden überschrieben?
    timeout (Zeitlimit) Gibt die Zeitdauer in Sekunden an, bis ein Zeitlimit auftritt.  
    host Gibt den Hostnamen oder die IP-Adresse des fernen HTTP-Servers an. Der Hostknoten des Eingabeparameters httpConnParameter überschreibt das Feld 'Hostname' des HTTP-Endpunkts.
    port Gibt die Portnummer des fernen HTTP-Servers an. Der Portknoten des Eingabeparameters httpConnParameter überschreibt das Feld 'Port' des HTTP-Endpunkts.
    isSecure Setzen Sie diesen booleschen Wert auf 'true', um HTTPS (gesichertes HTTP over SSL) zu aktivieren. Setzen Sie den booleschen Wert auf 'false', 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 Account 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 Account 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; dies wird in der folgenden Tabelle beschrieben:
    Tabelle 4.
    Ausgabeparameter Beschreibung
    httpheaders Gibt den Header der HTTP-Anforderung an.
    body Gibt den Hauptteil der HTTP-Anforderungsnachricht 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 werden die Knoten des optionalen Ausgabeparameters httpheaders definiert.  
    Tabelle 5.
    Knoten des Ausgabeparameters httpheaders Beschreibung
    httpheaders/uri Gibt den Ressourcenpfad der eingehenden Anforderung an, z. B. /myPath.
    httpheaders/<konfigurierter_headername> Wenn Sie mindestens einen Antwortheader im Schritt für Antwortheader konfiguriert haben, werden die Antwortheader hier angezeigt. Der Wert <konfigurierter_headername> steht für die tatsächlichen Headernamen, die Sie ausgewählt oder eingegeben haben.
    httpheaders/otherHeaders/headerItem Gibt ein Element an, das eine Gruppe von HTTP-Headerparametern als Name/Wert-Paare enthält. Es können mehrere HTTP-Headerparameter in der HTTP-Anforderung angegeben werden, sodass dies ein wiederholt auftretender Knoten ist.
    httpheaders/otherHeaders/headerItem/name Gibt den Namen des HTTP-Headerparameters an.
    httpheaders/otherHeaders/headerItem/value Gibt den Wert des HTTP-Headerparameters an.
  2. Erstellen Sie eine Zuordnung zwischen dem bzw. den Ausgabeparameter/n 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.



Feedback | Notices


Timestamp icon Letzte Aktualisierung: Friday, November 8, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/http_put_request_activity.html