Zum Inhalt springen

HTTP v2 BULK-Aktivität

Einführung

Eine HTTP v2 BULK-Aktivität, die ihre HTTP v2-Verbindung verwendet, sendet mehrere Anfragen an einen über das HTTP- oder HTTPS-Protokoll zugänglichen Dienst und kann entweder als Quelle (um Daten in einer Operation bereitzustellen) oder als Ziel (um Daten in einer Operation zu konsumieren) verwendet werden.

Erstellen einer HTTP v2 BULK-Aktivität

Eine Instanz einer HTTP v2 BULK-Aktivität wird aus einer HTTP v2-Verbindung unter Verwendung des Aktivitätstyps BULK erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene HTTP v2 BULK-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer HTTP v2 BULK-Aktivität

Befolgen Sie diese Schritte, um eine HTTP v2 BULK-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und spezifizieren Sie die Einstellungen

In diesem Schritt geben Sie einen Namen für die Aktivität an und spezifizieren die Methode, den Pfad, die Anfrageparameter, die Anfrageheader und zusätzliche Einstellungen. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte desselben Verbindungstyps konfiguriert haben, wird ein Menü oben auf dem Bildschirm angezeigt, das den aktuellen Endpunktnamen anzeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Erscheint, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungsconfiguration 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, eine der POST, PUT, GET, DELETE, HEAD, PATCH oder OPTIONS.

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

      • Wenn das Feld leer gelassen wird, wird die im HTTP v2-Verbindung konfigurierte Basis-URL zur Laufzeit verwendet.
      • Wenn ein teilweiser Pfad angegeben wird, wird er an die im HTTP v2-Verbindung konfigurierte Basis-URL angehängt.
      • Wenn eine vollständige URL angegeben wird, überschreibt sie die im HTTP v2-Verbindung konfigurierte Basis-URL.

      Anfrageparameter können durch Einfügen in geschweifte Klammern { } eingeschlossen 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 Hinzufügen-Symbol , um eine Zeile in der Tabelle unten hinzuzufügen, und geben Sie einen Namen und Wert für jeden Anfrageparameter ein. Die bereitgestellten Anfrageparameter werden automatisch URL-codiert.

Alternativ können Anforderungsparameter in der Anforderungsumwandlung bereitgestellt werden. Anforderungsparameter, die keinen gemeinsamen Schlüssel haben, werden kumulativ gesendet, unabhängig davon, wo sie angegeben sind. Wenn derselbe Parameter-Schlüssel sowohl in diesem Feld als auch in der Anforderungsumwandlung angegeben ist, hat der in der Umwandlung angegebene Vorrang.

Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol 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 Bearbeiten-Symbol oder das Löschen-Symbol .

Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.

Wichtig

Felder in der Anforderungsparameter-Tabelle zeigen das Variablen-Symbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.

Felder in der Anforderungsparameter-Tabelle unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.

  • Anforderungsheader: Klicken Sie auf das Hinzufügen-Symbol , um eine Zeile zur Tabelle unten hinzuzufügen, und geben Sie einen Namen und Wert für jeden Anforderungsheader ein.

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

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

    1. Ein Header, der in der Anforderungsumwandlung bereitgestellt wird, überschreibt alle Felder darunter.
    2. Ein Header, der im Feld Anforderungsheader einer HTTP v2 BULK-Aktivität (dieses Feld) bereitgestellt wird, überschreibt das verbleibende Feld darunter.

    3. Ein Header, der im Feld Anforderungsheader einer HTTP v2-Verbindung bereitgestellt wird, hat, wenn Anforderungsheader in der Aktivitätsausführung senden aktiviert ist, die geringste Priorität.

      Hinweis

      Wenn ein Header an mehreren Stellen definiert ist, wird jede Instanz des Headers in die Anfrage einer Aktivität gemäß der oben genannten Reihenfolge hinzugefügt. Diese Reihenfolge basiert darauf, wie Dienste typischerweise mit doppelten Headern in einer Anfrage umgehen.

      Warnung

      Definieren Sie keine Authorization-Anforderungsheader manuell in HTTP v2-Aktivitäten, wenn die HTTP v2-Verbindung so konfiguriert ist, dass sie ihre eigenen Authorization-Anforderungsheader je nach ausgewähltem Authentifizierungstyp sendet. Dies führt zu einer Beendigung der Operation und einem Fehler, bevor der Zielendpunkt erreicht wird, und wird als 400 Bad Request-Fehler protokolliert.

      Wenn auf Aktivitätsebene eine dynamische Authentifizierung erforderlich ist, setzen Sie den Authentifizierungstyp der Verbindung auf No Auth und konfigurieren Sie die Authorization-Anforderungsheader der Aktivität nach Bedarf.

      Um die Zeile zu speichern, klicken Sie auf das Symbol zum Einreichen 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 Anforderungsheader zeigen das Variablen-Symbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.

      Felder in der Tabelle Anforderungsheader unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.

    4. Zusätzliche Einstellungen: Klicken Sie auf das Hinzufügen-Symbol , um eine Zeile zur Tabelle unten hinzuzufügen, und geben Sie einen Namen und Wert für jede zusätzliche Einstellung ein.

      Diese zusätzlichen Einstellungen werden unterstützt:

      Schlüssel
      		 Standardwert Datentyp Beschreibung
      connection-timeout 30000 Ganzzahl Der Übertragungszeitüberschreitung in Millisekunden. Wenn diese Einstellung nicht angegeben ist, beträgt die Standardübertragungszeitüberschreitung 30000 Millisekunden (30 Sekunden). Auf 0 setzen für eine unbegrenzte Zeitüberschreitung.
      content-type — Zeichenkette Der Inhaltstyp der Anforderungsstruktur, die von der jeweiligen API erwartet wird. Zum Beispiel text/plain, application/json, application/x-www-form-urlencoded usw. Wenn diese Einstellung nicht angegeben ist, gibt es keinen Standardwert.
      max-redirect 50 Ganzzahl Die maximale Anzahl an Weiterleitungen, die verfolgt werden sollen. Wenn diese Einstellung nicht angegeben ist, beträgt der Standardwert 50 Weiterleitungen. Auf 0 oder eine negative Zahl setzen, um das Verfolgen von Weiterleitungen zu verhindern.
      trailing-linebreaks false Zeichenkette Entfernt führende und nachfolgende Leerzeichen und Zeilenumbrüche, wenn auf true gesetzt. Wenn diese Einstellung nicht angegeben oder auf false gesetzt ist, bleibt die Daten unverändert.

      Alternativ können zusätzliche Einstellungen in der Anforderungsumwandlung 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 dem Inhaltstyp gilt: Wenn der gleiche Einstellungs-Schlüssel sowohl in diesem Feld als auch in der Anforderungsumwandlung angegeben ist, hat die in der Umwandlung angegebene Vorrang.

      Für content-type hat ein hier angegebener Wert Vorrang vor allen anderen Stellen in der Benutzeroberfläche, an denen der Inhaltstyp angegeben werden kann. Wenn der Inhaltstyp an mehreren Stellen angegeben ist, wird folgende Reihenfolge des Vorrangs beachtet:

      1. Ein Content-Type-Header, der in der Tabelle Zusätzliche Einstellungen einer HTTP v2 BULK-Aktivität (diese Tabelle) bereitgestellt wird, überschreibt alle untenstehenden Felder.
      2. Das bodyContentType-Feld, das in einer Anforderungsumwandlung angegeben ist, überschreibt die verbleibenden Felder unten.
      3. Ein Content-Type-Header, der im headers-Knoten der Anforderungsumwandlung bereitgestellt wird, überschreibt die verbleibenden Felder unten.
      4. Ein Content-Type-Header, der im Feld Anforderungsheader einer HTTP v2 BULK-Aktivität bereitgestellt wird, überschreibt das verbleibende Feld unten.
      5. Ein Content-Type-Header, der im Feld Anforderungsheader einer HTTP v2-Verbindung bereitgestellt wird, hat, wenn Anforderungsheader bei der Aktivitätsausführung senden aktiviert ist, den geringsten Vorrang.

      Hinweis

      Wenn ein Header an mehreren Stellen definiert ist, wird jede Instanz des Headers in die Anfrage einer Aktivität gemäß der oben genannten Reihenfolge des Vorrangs aufgenommen. Diese Reihenfolge basiert darauf, wie Dienste typischerweise mit doppelten Headern in einer Anfrage umgehen.

      Um die Zeile zu speichern, klicken Sie auf das Symbol zum Einreichen 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 Zusätzliche Einstellungen zeigen das -Variablen-Symbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein.

      Felder in der Tabelle Zusätzliche Einstellungen unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.

    5. Ignoriere Betriebsfehler im Falle eines nicht erfolgreichen Statuscodes: Wählen Sie diese Option, um zu ermöglichen, dass Operationen einen erfolgreichen Status melden, selbst wenn ein nicht erfolgreicher Statuscode von der API zurückgegeben wird, die der Connector aufruft. Der Standardwert ist nicht ausgewählt.

    6. Wählen Sie den HTTP-Statuscode, der zur Laufzeit der Operation als erfolgreich betrachtet werden soll: Wählen Sie entweder Gruppiert nach Klasse oder Granular (Manuelle Eingabe), um die angegebenen Statuscodes in den Betriebsprotokollen als erfolgreich zu betrachten.

      • Gruppiert nach Klasse: Wenn ausgewählt, wird ein Dropdown-Menü angezeigt, das Klassen von nicht erfolgreichen Statuscodes zeigt, 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, um manuell eine durch Kommas getrennte Liste von nicht erfolgreichen Statuscodes einzugeben, die als erfolgreich behandelt werden sollen. Diese Liste kann gleichzeitig verschiedene Klassen von Statuscodes enthalten. Der Standardwert des Feldes ist leer.

    7. Multipart: Wählen Sie diese Option, um multipart/form-data-Anfragen bei Verwendung der Standard-Schemas zu unterstützen. Dies ist erforderlich für Anfragen, die RFC 1867 Formular-Uploads enthalten.

    8. Fortfahren bei Fehler: Wählen Sie diese Option, um die Ausführung der Aktivität fortzusetzen, wenn ein Fehler für einen Datensatz in einer Batch-Anfrage auftritt. Wenn Fehler auftreten, werden diese in das Betriebsprotokoll geschrieben.

  • Speichern & 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 fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Überprüfen der Datenschemas

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

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

    Hinweis

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

    Die Standardanfrage- und Antwortschemas bestehen aus diesen Knoten und Feldern:

    • Anfrage:

      Anfrage-Schema Knoten/Feld Hinweise
      json Format des Anfrage-Schemas
      requests Anfragen-Knoten
      item Elemente-Knoten
      request Knoten einer spezifischen Anfrage
      root Knoten der Anfragewurzel
      identifier Identifikator der Anfrage
      path Pfad der Anfrage, ohne die Basis-URL des Endpunkts
      headers Header-Knoten
      item Knoten eines spezifischen Headers
      key Schlüssel des Headers
      value Wert des Headers
      method Methode der Anfrage
      requestParameters Knoten der Anfrageparameter
      item Knoten eines spezifischen Anfrageparameters
      key Schlüssel des Anfrageparameters
      value Wert des Anfrageparameters
      body Anfragekörper

    • Antwort:

      Antwort-Schema Knoten/Feld Hinweise
      json Format des Antwortschemas
      responses Knoten für Antworten
      items Knoten für Elemente
      response Knoten einer spezifischen Antwort
      responseItem Knoten eines Antwortelements
      identifier Identifikator der Antwort
      headers Knoten für Header
      item Knoten eines spezifischen Headers
      key Schlüssel des Headers
      value Wert des Headers
      error Fehlerknoten
      statusCode HTTP-Statuscode der Antwort
      statusMessage Statusnachricht der Antwort
      details Einzelheiten der Antwort
      properties Eigenschaften der Antwort
      responseContent Der Antwortinhalt oder die Payload
      status Ein Boolean, der angibt, ob eine Antwort zurückgegeben wurde

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemata vom HTTP v2-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, wie zum Beispiel in einer benachbarten 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: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Nächste Schritte

Nachdem Sie eine HTTP v2 BULK-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration der Operation, indem Sie andere Aktivitäten oder Werkzeuge als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Operationen zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Für Details siehe Aktivitätsaktionsmenü in Connector-Grundlagen.

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

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

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Ort und verwenden Sie dann diesen temporären Ort in der Skriptfunktion.

Wenn Sie bereit sind, setzen Sie die Operation ein und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.