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 weitere Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

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

• Die Entwurfsfläche (siehe Komponentenaktionsmenü in Entwurfsfläche).
• Der Komponenten-Tab im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Tab).

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
  Geben Sie einen Namen für die Aktivität ein und spezifizieren Sie die Methode, den Pfad, die Anfrageparameter, die Anfrageheader und zusätzliche Einstellungen.

• Schritt 2: Überprüfen Sie die Datenschemas
  Alle Anfrage- oder Antwortschemas werden angezeigt.

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 unten beschrieben.

• Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede HTTP v2 BULK-Aktivität einzigartig 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 Teilpfad angegeben wird, wird dieser an die im HTTP v2-Verbindung konfigurierte Basis-URL angehängt.
    • Wenn eine vollständige URL angegeben wird, überschreibt diese 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-kodiert.

    Alternativ können Anfrageparameter in der Anfrage-Transformation bereitgestellt werden. Anfrageparameter, 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 Anfrage-Transformation angegeben wird, hat der in der Transformation 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 Bearbeitungssymbol oder das Löschsymbol .

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

    Wichtig

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

  • Anfrage-Header: Klicken Sie auf das Hinzufügen-Symbol , um eine Zeile in die 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 beachtet:

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

    Hinweis

    Wenn ein Header an mehreren Orten definiert ist, wird jede Instanz des Headers der Anfrage einer Aktivität gemäß 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. Andernfalls führt dies 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 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 betragen.

    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\"};.

  • 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	Das Übertragungs-Timeout in Millisekunden. Wenn diese Einstellung nicht angegeben ist, beträgt das Standardübertragungs-Timeout 30000 Millisekunden (30 Sekunden). Setzen Sie es auf 0 für ein unbegrenztes Timeout.
    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 es 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 des Inhalts-Typs, hat der in diesem Feld angegebene Schlüssel Vorrang vor dem, der in der Anforderungsumwandlung angegeben ist, wenn derselbe Schlüssel sowohl in diesem Feld als auch in der Anforderungsumwandlung angegeben ist.

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

1. Ein Content-Type-Header, der in der Zusätzliche Einstellungen-Tabelle einer HTTP v2 BULK-Aktivität (dieser 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 Anforderungsheader-Feld einer HTTP v2 BULK-Aktivität bereitgestellt wird, überschreibt das verbleibende Feld unten.
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.

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.

    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\"};`.

• Speichern & Beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Nächster Schritt: 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 vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen 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 übernommen und während der Transformation Mapping 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 einer Anfrage-Wurzel
    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	Knoten für Fehler
    statusCode	HTTP-Statuscode der Antwort
    statusMessage	Statusnachricht der Antwort
    details	Einzelheiten der Antwort
    properties	Eigenschaften der Antwort
    responseContent	Inhalt der Antwort
    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: 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 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:

• 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 BULK Aktivitäten, die als Ziel verwendet werden, können mit diesen Betriebsmustern 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 Ort und verwenden Sie dann diesen temporären Ort in der Skriptfunktion.

Wenn Sie bereit sind, bereitstellen und ausführen Sie den Betrieb und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.