HTTP v2 POST-Aktivität in Jitterbit Studio
Einführung
Eine HTTP v2 POST-Aktivität erstellt mit ihrer HTTP v2-Verbindung eine neue Ressource auf einem Dienst, der über das HTTP- oder HTTPS-Protokoll erreichbar ist. Sie kann entweder als Quelle (um Daten in einem Vorgang bereitzustellen) oder als Ziel (um Daten in einem Vorgang zu verarbeiten) verwendet werden.
HTTP v2 POST-Aktivität erstellen
Eine Instanz einer HTTP v2 POST-Aktivität wird aus einer HTTP v2-Verbindung mit ihrem POST-Aktivitätstyp erstellt.
Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Aktivitäts- oder Tool-Instanz erstellen in Komponenten wiederverwenden.
Eine vorhandene HTTP v2 POST-Aktivität kann von diesen Orten aus bearbeitet werden:
- Die Design-Canvas (siehe Komponentenaktionsmenü in Design-Canvas).
- Die Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Projektbereich – Registerkarte „Komponenten").
HTTP v2 POST-Aktivität konfigurieren
Führen Sie diese Schritte aus, um eine HTTP v2 POST-Aktivität zu konfigurieren:
-
Schritt 1: Namen eingeben und Einstellungen festlegen
Geben Sie einen Namen für die Aktivität ein und geben Sie die URL, Anfrageparameter, Anforderungsheader und zusätzliche Einstellungen an. -
Schritt 2: Anforderungsschema bereitstellen
Stellen Sie ein benutzerdefiniertes Anforderungsschema bereit (optional). Wenn Sie kein benutzerdefiniertes Antwortschema bereitstellen, wird das Standard-Antwortschema des Connectors verwendet. -
Schritt 3: Antwortschema bereitstellen
Stellen Sie ein benutzerdefiniertes Antwortschema bereit (optional). Wenn Sie kein benutzerdefiniertes Antwortschema bereitstellen, wird das Standard-Antwortschema des Connectors verwendet. -
Schritt 4: Datenschemas überprüfen
Die konfigurierten Anfrage- und Antwortschemas werden angezeigt.
Schritt 1: Namen eingeben und Einstellungen festlegen
Geben Sie in diesem Schritt einen Namen für die Aktivität ein und geben Sie die URL, Anfrageparameter, Anforderungsheader und zusätzliche Einstellungen an. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.
Tipp
Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.
Wichtig
Felder in den Tabellen zeigen das Variablensymbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit aufgefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.
-
Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.
- Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.
-
Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede HTTP v2 POST-Aktivität eindeutig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. -
Pfad: Geben Sie eine URL ein, die für die Aktivität verwendet werden soll:
- Wenn das Feld leer gelassen wird, verwendet die Aktivität zur Laufzeit die Basis-URL, die in der HTTP v2-Verbindung konfiguriert ist.
- Wenn ein Teilpfad angegeben wird, wird dieser an die Basis-URL angehängt, die in der HTTP v2-Verbindung konfiguriert ist.
- Wenn eine vollständige URL angegeben wird, überschreibt diese die Basis-URL, die in der HTTP v2-Verbindung konfiguriert ist.
Wichtig
Um Variablen in einem Pfad zu verwenden, geben Sie einen Teilpfad ein. Variablen werden in vollständigen URLs nicht unterstützt.
Anfrageparameter können durch Einschließen in geschweifte Klammern
{}eingefügt werden. Abfrageparameter (wie/queryrecord?id=10) können ebenfalls verwendet werden.- URL: Zeigt die vollständige URL an, die zur Laufzeit verwendet wird.
-
Anfrageparameter: Klicken Sie auf das Plussymbol , um eine Zeile in der folgenden Tabelle hinzuzufügen, und geben Sie einen Namen und einen Wert für jeden Anfrageparameter ein. Die bereitgestellten Anfrageparameter werden automatisch URL-codiert.
Alternativ können Anfrageparameter in der Anfragetransformation bereitgestellt werden. Anfrageparameter, die keinen gemeinsamen Schlüssel haben, werden kumulativ gesendet, unabhängig davon, wo sie angegeben sind. Wenn derselbe Parameterschlüssel sowohl in diesem Feld als auch in der Anfragetransformation angegeben ist, hat die Angabe in der Transformation Vorrang.
Um die Zeile zu speichern, klicken Sie auf das Bestätigungssymbol in der rechten Spalte.
Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die rechte Spalte und verwenden Sie das Bearbeitungssymbol oder das Löschsymbol .
Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.
Wichtig
Felder in der Tabelle Anfrageparameter zeigen das Variablensymbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit gefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.
Felder in der Tabelle Anfrageparameter unterstützen nicht die Verwendung von Variablen zum Übergeben von Raw JSON. Wenn Ihr Anwendungsfall das direkte Definieren von Raw JSON in den Feldern nicht unterstützt, maskieren Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Beispielsweise wird
{"success": "true"};zu{\"success\": \"true\"};. -
Anfragekopfzeilen: Klicken Sie auf das Plussymbol , um eine Zeile in der folgenden Tabelle hinzuzufügen, und geben Sie einen Namen und einen Wert für jede Anfragekopfzeile ein.
Alternativ können Kopfzeilen in anderen Konfigurationsfeldern der Benutzeroberfläche definiert oder in der Anfragetransformation bereitgestellt werden. Kopfzeilen, die keinen gemeinsamen Schlüssel haben, werden kumulativ gesendet, unabhängig davon, wo sie angegeben sind. Werte von Anfragekopfzeilen sind nicht in Laufzeitprotokollen enthalten.
Wenn derselbe Kopfzeilenschlüssel an mehreren Stellen angegeben ist, wird diese Rangfolge befolgt:
- Eine Kopfzeile, die in der Anfragetransformation bereitgestellt wird, überschreibt alle folgenden Felder.
- Eine Kopfzeile, die im Feld Anfragekopfzeilen einer HTTP v2-Aktivität vom Typ POST (dieses Feld) bereitgestellt wird, überschreibt das verbleibende Feld unten.
- Eine Kopfzeile, die im Feld Anfragekopfzeilen einer HTTP v2-Verbindung bereitgestellt wird, hat die niedrigste Priorität, wenn Anfragekopfzeilen bei Aktivitätsausführung senden aktiviert ist.
Hinweis
Wenn eine Kopfzeile an mehreren Stellen definiert ist, wird jede Instanz der Kopfzeile der Anfrage einer Aktivität gemäß der oben beschriebenen Rangfolge hinzugefügt. Diese Reihenfolge basiert darauf, wie Dienste typischerweise doppelte Kopfzeilen in einer Anfrage verarbeiten.
Warnung
Definieren Sie nicht manuell
Authorization-Anfragekopfzeilen in HTTP v2-Aktivitäten, wenn die HTTP v2-Verbindung so konfiguriert ist, dass sie ihre eigenenAuthorization-Anfragekopfzeilen sendet, je nach ausgewähltem Authentifizierungstyp. Dies führt zu einer Beendigung und einem Fehler des Vorgangs, bevor der Zielendpunkt erreicht wird, und wird als400 Bad Request-Fehler protokolliert.Wenn eine dynamische Authentifizierung auf Aktivitätsebene erforderlich ist, setzen Sie den Authentifizierungstyp der Verbindung auf Keine Authentifizierung und konfigurieren Sie die
Authorization-Anfragekopfzeilen der Aktivität nach Bedarf.
Um die Zeile zu speichern, klicken Sie auf das Speichersymbol in der rechten Spalte.
Um eine einzelne Zeile zu bearbeiten oder zu löschen, fahren Sie mit der Maus über die rechte Spalte und verwenden Sie das Bearbeitungssymbol oder das Löschsymbol .
Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.
Wichtig
Felder in der Tabelle Request Headers zeigen das Variablensymbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit gefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.
Felder in der Tabelle Request Headers unterstützen nicht die Verwendung von Variablen zum Übergeben von Raw JSON. Wenn Ihr Anwendungsfall das direkte Definieren von Raw JSON in den Feldern nicht unterstützt, maskieren Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Beispielsweise wird {"success": "true"}; zu {\"success\": \"true\"}; maskiert.
-
Zusätzliche Einstellungen: Klicken Sie auf das Hinzufügungssymbol , um der Tabelle unten eine Zeile hinzuzufügen, und geben Sie einen Namen und einen Wert für jede zusätzliche Einstellung ein.
Diese zusätzlichen Einstellungen werden unterstützt:
Schlüssel Standardwert Datentyp Beschreibung connection-timeout30000Integer Das Übertragungszeitlimit in Millisekunden. Wenn diese Einstellung nicht angegeben ist, beträgt das Standard-Übertragungszeitlimit 30000Millisekunden (30 Sekunden). Setzen Sie auf0für ein unbegrenztes Zeitlimit.content-type— String Der Content-Type der Anforderungsstruktur, die von der jeweiligen API erwartet wird. Beispiele: text/plain,application/json,application/x-www-form-urlencodedusw.max-redirect50Integer Die maximale Anzahl von Umleitungen, denen gefolgt werden soll. Wenn diese Einstellung nicht angegeben ist, beträgt der Standard 50Umleitungen. Setzen Sie auf0oder eine negative Zahl, um keine Umleitungen zu folgen.trailing-linebreaksfalseString Entfernt führende und nachfolgende Leerzeichen und Zeilenumbrüche, wenn auf truegesetzt. Wenn diese Einstellung nicht angegeben oder auffalsegesetzt ist, bleiben die Daten unverändert.Alternativ können zusätzliche Einstellungen in der Anforderungstransformation bereitgestellt werden. Zusätzliche Einstellungen, die keinen gemeinsamen Schlüssel haben, werden kumulativ gesendet, unabhängig davon, wo sie angegeben sind. Für alle Einstellungen außer Content-Type gilt: Wenn derselbe Einstellungsschlüssel sowohl in diesem Feld als auch in der Anforderungstransformation angegeben ist, hat die in der Transformation angegebene Einstellung Vorrang.
Für
content-typehat ein hier angegebener Wert Vorrang vor allen anderen Stellen in der Benutzeroberfläche, an denen der Content-Type angegeben werden kann. Wenn Content-Type an mehreren Stellen angegeben ist, wird diese Rangfolge befolgt:- Ein
Content-Type-Header, der in der Tabelle Zusätzliche Einstellungen einer HTTP v2 POST-Aktivität bereitgestellt wird (diese Tabelle), setzt alle folgenden Felder außer Kraft. - Das Feld
bodyContentType, das in einer Anforderungstransformation angegeben ist, setzt die folgenden Felder außer Kraft. - Ein
Content-Type-Header, der im Knotenheadersder Anforderungstransformation bereitgestellt wird, setzt die folgenden Felder außer Kraft. - Ein
Content-Type-Header, der im Feld Request Headers einer HTTP v2 POST-Aktivität bereitgestellt wird, setzt das folgende Feld außer Kraft. - Ein
Content-Type-Header, der im Feld Request Headers einer HTTP v2-Verbindung bereitgestellt wird, wenn Request Headers in Activity Execution senden aktiviert ist, hat die niedrigste Priorität.
Hinweis
Wenn keine
Content-Type-Header definiert sind, wird der Standard-Medientyp automatisch basierend auf dem gewählten Schematyp (application/jsonoderapplication/xml) festgelegt. Um die Standard-UTF-8-Zeichenkodierung zu überschreiben, müssen Sie einencharset-Parameter mit dem AnforderungsfeldbodyContentTypeangeben, das in Schritt 4: Überprüfen Sie die Datenschemas beschrieben ist. - Ein
Wenn ein Header an mehreren Stellen definiert ist, wird jede Instanz des Headers der Anfrage einer Aktivität gemäß der oben angegebenen Prioritätsreihenfolge hinzugefügt. Diese Reihenfolge basiert darauf, wie Services typischerweise doppelte Header in einer Anfrage verarbeiten.
Um die Zeile zu speichern, klicken Sie auf das Sendensymbol <span class="icon-success" style="color: #908c94"></span> in der rechten Spalte.
Um eine einzelne Zeile zu bearbeiten oder zu löschen, fahren Sie über die rechte Spalte und verwenden Sie das Bearbeitungssymbol
<span class="icon-edit"></span> oder das Löschsymbol <span class="icon-trash" style="color: #908c94"></span>.
Um alle Zeilen zu löschen, klicken Sie auf **Alle löschen**.
!!! important "Wichtig"
Felder in der Tabelle **Zusätzliche Einstellungen** zeigen das Symbol <span class="icon-variable"></span> für Variablen nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit gefüllt werden, muss die Agent-Version mindestens [10.75 / 11.13](/de/release-notes/harmony-release-notes/summer-2023/10-75-11-13/) sein.
Felder in der Tabelle **Zusätzliche Einstellungen** unterstützen nicht die Verwendung von Variablen zum Übergeben von Raw JSON. Wenn Ihr Anwendungsfall das direkte Definieren von Raw JSON in den Feldern nicht unterstützt, maskieren Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Beispielsweise wird `{"success": "true"};` zu `{\"success\": \"true\"};` maskiert.
-
Multipart: Wählen Sie diese Option, um
multipart/form-data-Anfragen bei Verwendung von Standardschemas zu unterstützen. Dies ist erforderlich für Anfragen, die RFC 1867-Formular-Uploads enthalten.Hinweis
Bei Verwendung von benutzerdefinierten Schemas wird
multipart/form-datanicht unterstützt. -
Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:
-
Operationsfehler bei nicht erfolgreichem Statuscode ignorieren: Wählen Sie diese Option, damit Operationen einen erfolgreichen Status melden, auch wenn der API ein nicht erfolgreicher Statuscode zurückgibt. Der Standardwert ist nicht ausgewählt.
-
HTTP-Statuscode auswählen, der zur Laufzeit der Operation als erfolgreich gilt: Wählen Sie entweder Nach Klasse gruppiert oder Granular (Manuelle Eingabe), um bestimmte Statuscodes in Operationsprotokollen als erfolgreich zu behandeln.
-
Nach Klasse gruppiert: Wenn diese Option ausgewählt ist, wird ein Dropdown mit Klassen von nicht erfolgreichen Statuscodes angezeigt, die als erfolgreich behandelt werden sollen. Die Dropdown-Optionen umfassen 3xx Umleitung, 4xx Client-Fehler und 5xx Server-Fehler. Der Standardwert des Dropdowns ist nicht ausgewählt.
-
Granular (Manuelle Eingabe): Wenn diese Option ausgewählt ist, wird ein Feld angezeigt, in dem Sie eine kommagetrennte Liste von nicht erfolgreichen Statuscodes eingeben können, die als erfolgreich behandelt werden sollen. Diese Liste kann gleichzeitig verschiedene Klassen von Statuscodes enthalten. Der Standardwert des Feldes ist leer.
-
-
-
Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.
-
Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.
-
Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 2: Anforderungsschema bereitstellen
In diesem Schritt können Sie ein benutzerdefiniertes Anforderungsschema bereitstellen. Wenn Sie kein benutzerdefiniertes Anforderungsschema bereitstellen, wird das Standardanforderungsschema des Connectors verwendet.
-
Anforderungsschema bereitstellen: Das Anforderungsschema definiert die Struktur der Anfragedaten, die von der HTTP v2 POST-Aktivität verwendet werden. Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter In einer Aktivität definierte Schemas.
-
Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.
-
Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 3: Antwortsschema bereitstellen
In diesem Schritt können Sie ein benutzerdefiniertes Antwortsschema bereitstellen. Wenn Sie kein benutzerdefiniertes Antwortsschema bereitstellen, wird das Standard-Antwortsschema des Connectors verwendet.
-
Antwortsschema bereitstellen: Das Antwortsschema definiert die Struktur der Antwortdaten, die von der HTTP v2 POST-Aktivität verwendet werden. Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter Schemas, die in einer Aktivität definiert sind.
-
Zusätzliche Eigenschaften aus HTTP-Antwort im Schema einschließen: Wenn Ja, gespeichertes Schema verwenden oder Ja, neues Schema bereitstellen ausgewählt ist und das verwendete Schema einen XML- oder JSON-Dateityp hat, wird das Kontrollkästchen Zusätzliche Eigenschaften aus HTTP-Antwort im Schema einschließen angezeigt. Wenn diese Option aktiviert ist, wird das Schema in eine von Jitterbit definierte Struktur eingebunden, sodass zusätzliche Parameter im Schema zugänglich sind.
{ "__jitterbit_aditional_properties__": { "__jitterbit_api_headers__": [ { "key": "", "value": "" }, { "key": "", "value": "" } ], "__jitterbit_api_statuscode__": 200, "__jitterbit_api_errorbody__": "" }, "root": { // Original JSON } }<__jitterbitResponse__> <__jitterbit_aditional_properties__> <__jitterbit_api_headers__> <key>headerKey1</key> <value>headerValue1</value> </__jitterbit_api_headers__> <__jitterbit_api_headers__> <key>headerKey2</key> <value>headerValue2</value> </__jitterbit_api_headers__> <__jitterbit_api_statuscode__>200</__jitterbit_api_statuscode__> <__jitterbit_api_errorbody__> </__jitterbit_api_errorbody__> </__jitterbit_aditional_properties__> <root> <!-- Original XML --> </root> </__jitterbitResponse__>-
__jitterbit_api_headers__: Gibt die von der Anfrageanforderung bereitgestellten Header zurück. -
__jitterbit_api_statuscode__: Gibt den Statuscode der Anfrageanforderung zurück. -
__jitterbit_api_errorbody__: Gibt den Antwortkörper der Anfrageanforderung im Stringformat zurück, wenn die Anfrageanforderung einen fehlgeschlagenen Statuscode zurückgibt. -
root: Enthält die ursprüngliche Struktur des Antwortsschemas.
Hinweis
Wenn diese Option aktiviert ist, wird ein neues Schema mit dem Wrapper generiert. Die Struktur des ursprünglichen Schemas bleibt in
rooterhalten. Da für diesen Zweck ein neues Schema generiert wird, kann das ursprüngliche Schema ohne Wrapper später bei Bedarf verwendet werden. -
-
Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.
-
Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 4: Datenschemas überprüfen
Die konfigurierten Request- und Response-Schemas werden angezeigt.
-
Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden während der Transformationszuordnung erneut angezeigt.
Wenn in den vorherigen Schritten benutzerdefinierte Schemas bereitgestellt wurden, werden diese angezeigt. Wenn benutzerdefinierte Schemas nicht bereitgestellt wurden, werden die im Connector enthaltenen Standard-Schemas angezeigt.
Bei HTTP v2-Aktivitäten werden Datenschemas automatisch basierend auf Updates der in vorherigen Schritten definierten Schemas neu generiert.
Vorsicht
HTTP v2-Aktivitäten, die vor dem Release 10.85 / 11.23 Harmony erstellt wurden, können aufgrund zuvor definierter Projektmetadaten eine manuelle Schaltfläche Aktualisieren enthalten. Falls vorhanden, interagieren Sie nicht mit dieser Schaltfläche. Erstellen Sie eine neue Instanz einer betroffenen Aktivität, um sie zu entfernen.
Die Standard-Request- und Response-Schemas bestehen aus diesen Knoten und Feldern:
- Request:
| Request-Schemaknoten/-feld | Hinweise |
| ------------------------- |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **json** | Format des Request-Schemas |
| | |
| **request** | Request-Knoten |
| | |
| **root** | Root-Knoten |
| | |
| **headers** | Knoten der Header |
| | |
| **item** | Knoten eines bestimmten Headers |
| key | Schlüssel des Headers |
| value | Wert des Headers |
| | |
| **requestParameters** | Knoten der Request-Parameter |
| | |
| **item** | Knoten eines bestimmten Request-Parameters |
| key | Schlüssel des Request-Parameters |
| value | Wert des Request-Parameters |
| | |
| **multipart** | Knoten eines Multipart (nur enthalten, wenn Multipart in der Aktivitätskonfiguration der Benutzeroberfläche ausgewählt ist und Standardschemas verwendet werden) |
| | |
| **plainText** | Knoten der Nur-Text-Teile eines Multipart |
| | |
| **item** | Knoten eines bestimmten Nur-Text-Teils im Multipart |
| key | Schlüssel des Nur-Text-Teils, der seinem Attribut `name` in der Request-Payload zugeordnet ist |
| value | Wert des Nur-Text-Teils, der seinem Inhalt in der Request-Payload zugeordnet ist |
| contentType | `Content-Type` des Nur-Text-Teils<br/> <div class="admonition note"> <p class="admonition-title">Hinweis</p> <p>Dieses Feld hat Vorrang vor einem `Content-Type`-Header, der im Knoten `headers` bereitgestellt wird.</p> </div> |
| | |
| **fileData** | Knoten der Datendateiteile eines Multipart |
| | |
| **item** | Knoten eines bestimmten Datendateiteils im Multipart |
| key | Schlüssel des Datendateiteils, der seinen Attributen `name` und `filename` in der Request-Payload zugeordnet ist. Er sollte die Dateierweiterung enthalten, falls bekannt<br/> <div class="admonition note"> <p class="admonition-title">Hinweis</p> <p>Wenn für diesen Schlüssel ein Pfad angegeben wird und das Feld `fileName` leer gelassen wird, enthält das Attribut `filename` nur den Dateinamen und die Erweiterung.</p> </div> |
| value | Wert des Datendateiteils, der seinem Inhalt in der Request-Payload zugeordnet ist<br/> <div class="admonition important"> <p class="admonition-title">Wichtig</p> <p>Die für diesen Wert angegebene Zeichenkette stellt die Datei selbst dar und muss im Base64-Format codiert sein. Weitere Informationen zum Codieren einer Datei mit einem Skript finden Sie unter [Base64encodefile](/de/integration-studio/design/functions/cryptographic-functions/#cryptographicfunctions-base64encodefile) in [Cryptographic functions](/de/integration-studio/design/functions/cryptographic-functions).</p> </div> |
| fileName | Zeichenkette, die den Dateinamen des Datendateiteils darstellt und seinem Attribut `filename` in der Request-Payload zugeordnet ist. Sie sollte die Dateierweiterung enthalten, falls bekannt. Dieses Feld hat Vorrang vor dem, was im Feld `key` für das Attribut `filename` definiert ist |
| mimeType | Zeichenkette, die den MIME-Typ (Medientyp) des Datendateiteils darstellt, unabhängig von den in den Feldern `key` oder `fileName` angegebenen Dateierweiterungen |
| | |
| **additionalSettings** | Knoten der zusätzlichen Einstellungen |
| | |
| **item** | Knoten einer bestimmten zusätzlichen Einstellung |
| key | Schlüssel der zusätzlichen Einstellung |
| value | Wert der zusätzlichen Einstellung |
| | |
| body | Request-Body |
| bodyContentType | `Content-Type` des Request-Body<br/> <div class="admonition note"> <p class="admonition-title">Hinweis</p> <p>Dieses Feld hat Vorrang vor einem `Content-Type`-Header, der im Knoten `headers` bereitgestellt wird. Es ist möglich, die Standard-`UTF-8`-Codierung zu überschreiben, indem Sie einen `charset`-Parameter mit diesem Feld angeben. Beispiel: `application/xml; charset=ISO-8859-1`.</p> </div> |
| | |
-
Antwort:
| Knoten/Feld des Antwortsschemas | Hinweise | | ------------------------------- | ---------------------------------------------------- | | **json** | Format des Antwortsschemas | | | | | **response** | Antwortknoten | | | | | **responseItem** | Knoten des Antwortelements | | status | Ein boolescher Wert, der angibt, ob eine Antwort zurückgegeben wurde | | properties | Eigenschaften der Antwort | | | | | **headers** | Knoten der Header | | | | | **item** | Knoten eines bestimmten Headers | | key | Schlüssel des Headers | | value | Wert des Headers | | | | | responseContent | Der Antwortkörper oder Content-Payload | | | | | **error** | Fehlerknoten | | statusCode | HTTP-Statuscode der Antwort | | statusMessage | Statusmeldung der Antwort | | details | Antwortdetails | | | | -
Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
Fertig: Klicken Sie hier, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.
-
Änderungen verwerfen: Klicken Sie nach Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Nächste Schritte
Nach der Konfiguration einer HTTP v2 POST-Aktivität schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.
Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktionsmenü für Aktivitäten in Connector-Grundlagen.
HTTP v2 POST-Aktivitäten, die als Quelle verwendet werden, können mit diesen Vorgangsmustern verwendet werden:
- Transformationsmuster
- Muster mit zwei Archivzielen (nur als erste Quelle)
- Muster mit zwei HTTP-Archivzielen (nur als erste Quelle)
- Muster mit zwei Transformationen (als erste oder zweite Quelle)
HTTP v2 POST-Aktivitäten, die als Ziel verwendet werden, können mit diesen Vorgangsmustern verwendet werden:
- Transformationsmuster
- Zwei-Transformationsmuster (als erstes oder zweites Ziel)
Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.
Wenn alles bereit ist, stellen Sie die Operation bereit und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Operationsprotokolle überprüfen.