HTTP v2 PATCH-Aktivität in Jitterbit Studio
Einführung
Eine HTTP v2 PATCH-Aktivität wendet mit ihrer HTTP v2-Verbindung Teiländerungen auf eine vorhandene Ressource auf einem Dienst an, auf den über das HTTP- oder HTTPS-Protokoll zugegriffen werden kann. 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 PATCH-Aktivität erstellen
Eine Instanz einer HTTP v2 PATCH-Aktivität wird aus einer HTTP v2-Verbindung mit ihrem PATCH-Aktivitätstyp erstellt.
Um eine Instanz einer Aktivität 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 Komponentenwiederverwendung.
Eine vorhandene HTTP v2 PATCH-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 PATCH-Aktivität konfigurieren
Führen Sie diese Schritte aus, um eine HTTP v2 PATCH-Aktivität zu konfigurieren:
-
Schritt 1: Namen eingeben und Einstellungen festlegen
Geben Sie einen Namen für die Aktivität an und legen Sie die URL, Anforderungsparameter, Anforderungsheader und zusätzliche Einstellungen fest. -
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 Anforderungs- und Antwortschemas werden angezeigt.
Schritt 1: Namen eingeben und Einstellungen festlegen
Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie die URL, Anforderungsparameter, Anforderungsheader und zusätzliche Einstellungen fest. 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 Namen des aktuellen Endpunkts 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 Namen des aktuellen Endpunkts 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 PATCH-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 rohem JSON. Wenn Ihr Anwendungsfall das direkte Definieren von rohem 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 die folgende Rangfolge beachtet:
- Eine in der Anfragetransformation bereitgestellte Kopfzeile überschreibt alle folgenden Felder.
- Eine im Feld Anfragekopfzeilen einer HTTP v2-Aktivität vom Typ PATCH (dieses Feld) bereitgestellte Kopfzeile überschreibt das verbleibende Feld unten.
- Eine im Feld Anfragekopfzeilen einer HTTP v2-Verbindung bereitgestellte Kopfzeile 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 gemäß der oben beschriebenen Rangfolge zur Anfrage einer Aktivität hinzugefügt. Diese Reihenfolge basiert darauf, wie Services 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 je nach ausgewähltem Authentifizierungstyp sendet. 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 eine Zeile zur folgenden Tabelle 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 PATCH-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 PATCH-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 Send Request Headers in Activity Execution 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 außer Kraft zu setzen, 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 Speichersymbol <span class="icon-success" style="color: #908c94"></span> 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
<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 <span class="icon-variable"></span> Variablensymbol 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 rohem JSON. Wenn Ihr Anwendungsfall das direkte Definieren von rohem 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 ein nicht erfolgreicher Statuscode von der API zurückgegeben wird, die der Connector aufruft. Der Standardwert ist nicht ausgewählt.
-
HTTP-Statuscode auswählen, der zur Laufzeit der Operation als erfolgreich betrachtet werden soll: Wählen Sie entweder Nach Klasse gruppiert oder Granular (Manuelle Eingabe), um bestimmte Statuscodes in Operationsprotokollen als erfolgreich zu betrachten.
-
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 PATCH-Aktivität verwendet werden. Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter Schemas, die in einer Aktivität definiert sind.
-
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-Aktivität PATCH 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, wodurch zusätzliche Parameter im Schema zugänglich werden.
{ "__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 Header zurück, die vom Anforderungsaufruf bereitgestellt werden. -
__jitterbit_api_statuscode__: Gibt den Statuscode des Anforderungsaufrufs zurück. -
__jitterbit_api_errorbody__: Gibt den Antwortteil des Anforderungsaufrufs im Stringformat zurück, wenn der Anforderungsaufruf 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:
| Anforderungsschema-Knoten/Feld | Hinweise |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **json** | Format des Anforderungsschemas |
| | |
| **request** | Anforderungsknoten |
| | |
| **root** | Stammknoten |
| | |
| **headers** | Knoten der Header |
| | |
| **item** | Knoten eines bestimmten Headers |
| key | Schlüssel des Headers |
| value | Wert des Headers |
| | |
| **requestParameters** | Knoten der Anforderungsparameter |
| | |
| **item** | Knoten eines bestimmten Anforderungsparameters |
| key | Schlüssel des Anforderungsparameters |
| value | Wert des Anforderungsparameters |
| | |
| **multipart** | Knoten eines mehrteiligen Inhalts (nur enthalten, wenn „Multipart" in der Aktivitätskonfigurationsbenutzeroberfläche ausgewählt ist und Standardschemas verwendet werden) |
| | |
| **plainText** | Knoten der Nur-Text-Teile eines mehrteiligen Inhalts |
| | |
| **item** | Knoten eines bestimmten Nur-Text-Teils im mehrteiligen Inhalt |
| key | Schlüssel des Nur-Text-Teils, der seinem Attribut `name` in der Anforderungs-Payload zugeordnet ist |
| value | Wert des Nur-Text-Teils, der seinem Inhalt in der Anforderungs-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 mehrteiligen Inhalts |
| | |
| **item** | Knoten eines bestimmten Datendateiteils im mehrteiligen Inhalt |
| key | Schlüssel des Datendateiteils, der seinen Attributen `name` und `filename` in der Anforderungs-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 Dateierweiterung.</p> </div> |
| value | Wert des Datendateiteils, der seinem Inhalt in der Anforderungs-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. Informationen zum Codieren einer Datei mit einem Skript finden Sie unter [Base64encodefile](/de/integration-studio/design/functions/cryptographic-functions/#cryptographicfunctions-base64encodefile) in [Kryptografische Funktionen](/de/integration-studio/design/functions/cryptographic-functions).</p> </div> |
| fileName | Zeichenkette, die den Dateinamen des Datendateiteils darstellt und seinem Attribut `filename` in der Anforderungs-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 Dateierweiterungen, die in den Feldern `key` oder `fileName` angegeben sind |
| | |
| **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 | Anforderungs-Body |
| bodyContentType | `Content-Type` des Anforderungs-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-Kodierung `UTF-8` zu überschreiben, indem ein `charset`-Parameter mit diesem Feld angegeben wird. 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, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.
-
Ä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.
Nächste Schritte
Nach der Konfiguration einer HTTP v2 PATCH-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 PATCH-Aktivitäten, die als Quelle verwendet werden, können mit diesen Vorgangsmustern verwendet werden:
- Transformationsmuster
- Zwei-Ziel-Archivmuster (nur als erste Quelle)
- Zwei-Ziel-HTTP-Archivmuster (nur als erste Quelle)
- Zwei-Transformationsmuster (als erste oder zweite Quelle)
HTTP v2 PATCH-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.