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 Anforderungsparameter, die Anforderungsheader und zusätzliche Einstellungen. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • 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 Basis-URL, die in der HTTP v2-Verbindung konfiguriert ist, zur Laufzeit verwendet.
      • 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.

      Anforderungsparameter 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.

    • Anforderungsparameter: 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 Anforderungsparameter ein. Die bereitgestellten Anforderungsparameter werden automatisch URL-kodiert.

      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 wird, 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 Tabelle der Anfrageparameter zeigen das Symbol für Variablen 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 der Anfrageparameter 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\"};.

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

      Alternativ können Header in anderen UI-Konfigurationsfeldern definiert oder in der Anfrage-Transformation 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 Anfrage-Transformation bereitgestellt wird, überschreibt alle Felder darunter.
      2. Ein Header, der im Anfrage-Header-Feld einer HTTP v2 BULK-Aktivität (dieses Feld) bereitgestellt wird, überschreibt das verbleibende Feld darunter.
      3. Ein Header, der im Anfrage-Header-Feld einer HTTP v2-Verbindung bereitgestellt wird, hat, wenn Anfrage-Header 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 der Anfrage einer Aktivität in der oben genannten Reihenfolge der Priorität hinzugefügt. Diese Reihenfolge basiert darauf, wie Dienste typischerweise doppelte Header in einer Anfrage behandeln.

      Warnung

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

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

      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 Request Headers-Tabelle zeigen das Symbol für Variablen nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit gefüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 betragen.

      Felder in der Request Headers-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 {"success": "true"}; zu {\"success\": \"true\"};.

    • 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). Setzen Sie auf 0 für eine unbegrenzte Zeitüberschreitung.
      content-type — Zeichenfolge 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 von Weiterleitungen, denen gefolgt werden soll. Wenn diese Einstellung nicht angegeben ist, beträgt der Standardwert 50 Weiterleitungen. Setzen Sie auf 0 oder eine negative Zahl, um das Folgen von Weiterleitungen zu verhindern.
      trailing-linebreaks false Zeichenfolge 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, mit Ausnahme von content-type, hat der Schlüssel, der sowohl in diesem Feld als auch in der Anforderungsumwandlung angegeben ist, die höchste Priorität.

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 der content-type an mehreren Stellen angegeben ist, wird folgende Reihenfolge der Priorität beachtet:

  1. Ein Content-Type-Header, der in der Zusätzliche Einstellungen-Tabelle einer HTTP v2 BULK-Aktivität (diese Tabelle) bereitgestellt wird, überschreibt alle nachfolgenden Felder.
  2. Das bodyContentType-Feld, das in einer Anforderungsumwandlung angegeben ist, überschreibt die verbleibenden Felder.
  3. Ein Content-Type-Header, der im headers-Knoten der Anforderungsumwandlung bereitgestellt wird, überschreibt die verbleibenden Felder.
  4. Ein Content-Type-Header, der im Anforderungsheader-Feld einer HTTP v2 BULK-Aktivität bereitgestellt wird, überschreibt das verbleibende Feld.
  5. Ein Content-Type-Header, der im Anforderungsheader-Feld einer HTTP v2-Verbindung bereitgestellt wird, hat, wenn Anforderungsheader bei 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 der Anfrage einer Aktivität gemäß der oben genannten Prioritätsreihenfolge hinzugefügt. Diese Reihenfolge basiert darauf, wie Dienste typischerweise doppelte Header in einer Anfrage behandeln.

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 Zusätzliche Einstellungen-Tabelle zeigen das Symbol für Variablen nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 betragen.

    Felder in der **Zusätzliche Einstellungen**-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\"};`.

  • Fehler bei der Operation ignorieren, falls ein nicht erfolgreicher Statuscode zurückgegeben wird: Wählen Sie diese Option, um zu erreichen, dass 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 wird: Wählen Sie entweder Nach Klasse gruppiert oder Granular (Manuelle Eingabe), um bestimmte Statuscodes als erfolgreich in den Betriebsprotokollen zu betrachten.

    • Nach Klasse gruppiert: Wenn ausgewählt, wird ein Dropdown 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.

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

  • Bei Fehler fortfahren: 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 sie 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 dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemas

Alle Anforderungs- 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 Standardanforderungs- und Antwortschemas bestehen aus diesen Knoten und Feldern:

    • Anforderung:

      Anforderungs-Schema Knoten/Feld Hinweise
      json Format des Anforderungsschemas
      requests Anforderungs-Knoten
      item Elemente-Knoten
      request Knoten einer spezifischen Anforderung
      root Knoten einer Anforderungswurzel
      identifier Identifikator der Anforderung
      path Pfad der Anforderung, 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 Anforderung
      requestParameters Knoten der Anforderungsparameter
      item Knoten eines spezifischen Anforderungsparameters
      key Schlüssel des Anforderungsparameters
      value Wert des Anforderungsparameters
      body Anforderungsinhalt

    • 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 beispielsweise 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen 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 zu verketten, 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.