Zum Inhalt springen

HTTP v2 BULK-Aktivität in Jitterbit Studio

Einführung

Eine HTTP v2 BULK-Aktivität verwendet ihre HTTP v2-Verbindung und sendet mehrere Anfragen an einen 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 BULK-Aktivität erstellen

Eine Instanz einer HTTP v2 BULK-Aktivität wird aus einer HTTP v2-Verbindung mit dem Aktivitätstyp BULK 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 BULK-Aktivität kann an diesen Orten bearbeitet werden:

HTTP v2 BULK-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine HTTP v2 BULK-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie die Methode, den Pfad, die Anfrageparameter, die Anfrage-Header und zusätzliche Einstellungen fest. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. 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 BULK-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Methode: Geben Sie die zu verwendende HTTP-Methode an: POST, PUT, GET, DELETE, HEAD, PATCH oder OPTIONS.

    • Pfad: Geben Sie eine URL ein, die für die Aktivität verwendet werden soll:

      • Wenn das Feld leer gelassen wird, wird die in der HTTP v2-Verbindung konfigurierte Basis-URL zur Laufzeit verwendet.
      • Wenn ein Teilpfad angegeben wird, wird dieser an die in der HTTP v2-Verbindung konfigurierte Basis-URL angehängt.
      • Wenn eine vollständige URL angegeben wird, überschreibt diese die in der HTTP v2-Verbindung konfigurierte Basis-URL.

      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. Query-Parameter (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\"}; maskiert.

  • Anfrage-Header: 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 Anfrage-Header ein.

    Alternativ können Header in anderen UI-Konfigurationsfeldern definiert oder in der Anfragetransformation bereitgestellt werden. Header, die keinen gemeinsamen Schlüssel haben, werden kumulativ gesendet, unabhängig davon, wo sie angegeben sind. Anfrage-Header-Werte sind nicht in Laufzeitprotokollen enthalten.

    Wenn derselbe Header-Schlüssel an mehreren Stellen angegeben ist, wird diese Reihenfolge der Priorität befolgt:

    1. Ein Header, der in der Anfragetransformation bereitgestellt wird, überschreibt alle folgenden Felder.
    2. Ein Header, der im Feld Anfrage-Header einer HTTP v2 BULK-Aktivität (dieses Feld) bereitgestellt wird, überschreibt das verbleibende Feld unten.
    3. Ein Header, der im Feld Anfrage-Header einer HTTP v2-Verbindung bereitgestellt wird, wenn Anfrage-Header in Aktivitätsausführung senden aktiviert ist, hat die niedrigste Priorität.

    Hinweis

    Wenn ein Header an mehreren Stellen definiert ist, wird jede Instanz des Headers zur Anfrage einer Aktivität hinzugefügt, wobei die oben angegebene Prioritätsreihenfolge befolgt wird. Diese Reihenfolge basiert darauf, wie Services typischerweise doppelte Header in einer Anfrage verarbeiten.

    Warnung

    Definieren Sie nicht manuell Authorization-Anfrage-Header in HTTP v2-Aktivitäten, wenn die HTTP v2-Verbindung so konfiguriert ist, dass sie ihre eigenen Authorization-Anfrage-Header sendet, je nach dem ausgewählten Authentifizierungstyp. Dies führt zu einer Beendigung und einem Fehler des Vorgangs, bevor der Zielendpunkt erreicht wird, und wird als 400 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-Anfrage-Header der Aktivität nach Bedarf.

    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 Anfrage-Header 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 Anfrage-Header 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 Plussymbol , um eine Zeile zur folgenden Tabelle hinzuzufügen, und geben Sie für jede zusätzliche Einstellung einen Namen und einen Wert ein.

    Diese zusätzlichen Einstellungen werden unterstützt:

    Schlüssel
    		 Standardwert Datentyp Beschreibung
    connection-timeout 30000 Integer Das Übertragungszeitlimit in Millisekunden. Wenn diese Einstellung nicht angegeben ist, beträgt das Standard-Übertragungszeitlimit 30000 Millisekunden (30 Sekunden). Auf 0 setzen für unbegrenztes Zeitlimit.
    content-type — String Der Content-Type der Anforderungsstruktur, die die jeweilige API erwartet. Beispiele: text/plain, application/json, application/x-www-form-urlencoded usw.
    max-redirect 50 Integer Die maximale Anzahl von Weiterleitungen, denen gefolgt werden soll. Wenn diese Einstellung nicht angegeben ist, beträgt der Standard 50 Weiterleitungen. Auf 0 oder eine negative Zahl setzen, um keine Weiterleitungen zu folgen.
    trailing-linebreaks false String Entfernt führende und nachfolgende Leerzeichen sowie Zeilenumbrüche, wenn auf true gesetzt. Wenn diese Einstellung nicht angegeben oder auf false gesetzt 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-type hat 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, gilt diese Rangfolge:

    1. Ein Content-Type-Header in der Tabelle Zusätzliche Einstellungen einer HTTP v2 BULK-Aktivität (diese Tabelle) setzt alle folgenden Felder außer Kraft.
    2. Das Feld bodyContentType in einer Anforderungstransformation setzt die folgenden Felder außer Kraft.
    3. Ein Content-Type-Header im Knoten headers einer Anforderungstransformation setzt die folgenden Felder außer Kraft.
    4. Ein Content-Type-Header im Feld Anforderungsheader einer HTTP v2 BULK-Aktivität setzt das folgende Feld außer Kraft.
    5. Ein Content-Type-Header im Feld Anforderungsheader einer HTTP v2-Verbindung hat die niedrigste Priorität, wenn Anforderungsheader bei Aktivitätsausführung senden aktiviert ist.

    Hinweis

    Wenn keine Content-Type-Header definiert sind, wird der Standard-Medientyp automatisch basierend auf dem gewählten Schematyp (application/json oder application/xml) festgelegt.

    Wenn ein Header an mehreren Stellen definiert ist, wird jede Instanz des Headers zur Anforderung einer Aktivität hinzugefügt, wobei die oben angegebene Rangfolge beachtet wird. Diese Reihenfolge basiert darauf, wie Services typischerweise doppelte Header in einer Anforderung verarbeiten.

    Klicken Sie auf das Bestätigungssymbol in der rechten Spalte, um die Zeile zu speichern.

    Um eine einzelne Zeile zu bearbeiten oder zu löschen, fahren Sie ü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 Zusätzliche Einstellungen zeigen das Symbol für Variablen nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit aufgefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

Felder in der Tabelle Zusätzliche Einstellungen unterstützen nicht die Verwendung von Variablen zur Übergabe von Raw JSON. Falls dein Anwendungsfall nicht die direkte Definition von Raw JSON in den Feldern unterstützt, maskiere den JSON-Inhalt, bevor du ihn mit einer Variablen übergibst. Beispiel: {"success": "true"}; wird zu {\"success\": \"true\"};.

  • Fehler bei nicht erfolgreichem Statuscode ignorieren: Wähle diese Option, damit Operationen einen erfolgreichen Status melden, auch wenn die API, die der Connector aufruft, einen nicht erfolgreichen Statuscode zurückgibt. Der Standardwert ist nicht ausgewählt.

  • HTTP-Statuscode auswählen, der zur Laufzeit als erfolgreich gilt: Wähle entweder Nach Klasse gruppiert oder Granular (Manuelle Eingabe), um bestimmte Statuscodes in Operationsprotokollen als erfolgreich zu behandeln.

    • Nach Klasse gruppiert: Wenn ausgewählt, 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 ausgewählt, wird ein Feld angezeigt, in das du eine kommagetrennte Liste von nicht erfolgreichen Statuscodes eingeben kannst, die als erfolgreich behandelt werden sollen. Diese Liste kann gleichzeitig verschiedene Klassen von Statuscodes enthalten. Der Standardwert des Feldes ist leer.

  • Multipart: Wähle diese Option, um multipart/form-data-Anfragen bei Verwendung von Standardschemas zu unterstützen. Dies ist erforderlich für Anfragen, die RFC 1867-Datei-Uploads enthalten.

  • Bei Fehler fortfahren: Wähle diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Batch-Anfrage ein Fehler auftritt. Falls Fehler auftreten, werden diese in das Operationsprotokoll geschrieben.

  • Speichern und beenden: Wenn aktiviert, klicke hier, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicke hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn du auf der letzten Seite auf die Schaltfläche Fertig klickst.

  • Änderungen verwerfen: Nachdem du Änderungen vorgenommen hast, klicke hier, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Meldung fordert dich auf zu bestätigen, dass du die Änderungen verwerfen möchtest.

Schritt 2: Datenschemas überprüfen

Alle Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden erneut während der Transformationszuordnung angezeigt.

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

    Die Standard-Request- und Response-Schemas bestehen aus diesen Knoten und Feldern:

    • Request:

      Request-Schema-Knoten/Feld Hinweise
      json Format des Request-Schemas
      requests Requests-Knoten
      item Items-Knoten
      request Knoten einer bestimmten Anfrage
      root Knoten eines Request-Root
      identifier Kennung der Anfrage
      path Pfad der Anfrage, ohne die Basis-URL des Endpunkts
      headers Headers-Knoten
      item Knoten eines bestimmten Headers
      key Schlüssel des Headers
      value Wert des Headers
      method Methode der Anfrage
      requestParameters Knoten von Request-Parametern
      item Knoten eines bestimmten Request-Parameters
      key Schlüssel des Request-Parameters
      value Wert des Request-Parameters
      body Request-Body

  • Antwort:

    | Knoten/Feld des Antwortsschemas | Hinweise                                              |
| ------------------------------- | ---------------------------------------------------- |
| **json**                        | Format des Antwortsschemas                           |
|                                 |                                                      |
| **responses**                   | Knoten „Responses"                                   |
|                                 |                                                      |
| **items**                       | Knoten „Items"                                       |
|                                 |                                                      |
| **response**                    | Knoten einer bestimmten Antwort                      |
|                                 |                                                      |
| **responseItem**                | Knoten eines Antwortelements                         |
| identifier                      | Kennung der Antwort                                  |
|                                 |                                                      |
| **headers**                     | Knoten „Headers"                                     |
|                                 |                                                      |
| **item**                        | Knoten eines bestimmten Headers                      |
| key                             | Schlüssel des Headers                                |
| value                           | Wert des Headers                                     |
|                                 |                                                      |
| **error**                       | Fehlerknoten                                         |
| statusCode                      | HTTP-Statuscode der Antwort                          |
| statusMessage                   | Statusmeldung der Antwort                            |
| details                         | Antwortdetails                                       |
|                                 |                                                      |
| properties                      | Eigenschaften der Antwort                            |
| responseContent                 | Der Antwortkörper oder die Inhaltsnutzlast           |
| status                          | Ein boolescher Wert, der angibt, ob eine Antwort zurückgegeben wurde |
|                                 |                                                      |

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom HTTP v2-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • 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 Änderungen an einem Schritt 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-Aktivität vom Typ BULK 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 Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

HTTP v2-Aktivitäten vom Typ BULK, die als Quelle verwendet werden, können mit diesen Vorgangsmustern verwendet werden:

HTTP v2 BULK-Aktivitäten, die als Ziel verwendet werden, können mit diesen Operationsmustern verwendet werden:

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 Sie bereit sind, stellen Sie die Operation bereit und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Operationsprotokolle überprüfen.