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 einem Operation bereitzustellen) oder als Ziel (um Daten in einem Operation zu verwenden) verwendet werden.

Erstellen einer HTTP v2 BULK-Aktivität

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

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 Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

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

• Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

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 legen Sie die Einstellungen fest
  Geben Sie einen Namen für die Aktivität an und geben Sie Methode, Pfad, Anforderungsparameter, Anforderungsheader und zusätzliche Einstellungen an.

• Schritt 2: Überprüfen Sie die Datenschemata
  Alle Anforderungs- oder Antwortschemata werden angezeigt.

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und geben Sie Methode, Pfad, Anforderungsparameter, Anforderungsheader und zusätzliche Einstellungen an. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

• Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede HTTP v2 BULK-Aktivität eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

• Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen einzublenden:

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

  • Pfad: Geben Sie eine für die Aktivität zu verwendende URL ein:

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

    Anforderungsparameter können eingefügt werden, indem sie in geschweifte Klammern eingeschlossen werden { }. Abfrageparameter (wie /queryrecord?id=10) kann ebenfalls verwendet werden.

    • URL: Zeigt die vollständige URL an, die zur Laufzeit verwendet werden soll.

  • Anforderungsparameter: Klicken Sie auf das Symbol „Hinzufügen“ , um der Tabelle unten eine Zeile hinzuzufügen, und geben Sie für jeden Anforderungsparameter einen Namen und einen Wert ein. Die angegebenen Anforderungsparameter werden automatisch URL-codiert.

    Alternativ können Anforderungsparameter in der Transformation angegeben werden. Anforderungsparameter, die keinen gemeinsamen Schlüssel haben, werden kumulativ gesendet, unabhängig davon, wo sie angegeben werden. Wenn sowohl in diesem Feld als auch in der Transformation derselbe Parameterschlüssel angegeben wird, hat der in der Transformation angegebene Schlüssel Vorrang.

    Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol in der Spalte ganz rechts.

    Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und verwenden Sie das Bearbeitungssymbol oder Symbol „Löschen“ .

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

  • Anforderungsheader: Klicken Sie auf das Symbol „Hinzufügen“ , um der Tabelle unten eine Zeile hinzuzufügen und für jeden Header einen Namen und einen Wert einzugeben.

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

    Wenn der gleiche Header Schlüssel an mehreren Stellen angegeben wird, gilt diese Rangfolge:

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

    Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol in der Spalte ganz rechts.

    Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und verwenden Sie das Bearbeitungssymbol oder Symbol „Löschen“ .

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

  • Zusätzliche Einstellungen: Klicken Sie auf das Symbol „Hinzufügen“ um der Tabelle unten eine Zeile hinzuzufügen und für jede zusätzliche Einstellung einen Namen und Wert einzugeben.

    Diese zusätzlichen Einstellungen werden unterstützt:

    Schlüssel	Standardwert	Datentyp	Beschreibung
    connection-timeout	30000	Integer	Das Übertragungstimeout in Millisekunden. Wenn diese Einstellung nicht angegeben ist, beträgt das Standardübertragungstimeout 30000 Millisekunden (30 Sekunden). Eingestellt auf 0 für eine unbegrenzte Zeitüberschreitung.
    content-type	—	String	Der Inhaltstyp der Anforderungsstruktur, der von der jeweiligen API erwartet wird. Beispiel: text/plain, application/json, application/x-www-form-urlencoded, usw. Wenn diese Einstellung nicht angegeben ist, gibt es keinen Standardwert.
    max-redirect	50	Integer	Die maximale Anzahl der zu befolgenden Weiterleitungen. Wenn diese Einstellung nicht angegeben ist, wird standardmäßig 50 Weiterleitungen. Eingestellt auf 0 oder eine negative Zahl, um das Folgen von Weiterleitungen zu verhindern.
    trailing-linebreaks	false	String	Entfernt führende und nachfolgende Leerzeichen und Zeilenumbrüche, wenn eingestellt auf true Wenn diese Einstellung nicht angegeben oder auf false, die Daten bleiben unverändert.

    Alternativ können zusätzliche Einstellungen in der Transformation bereitgestellt werden. Zusätzliche Einstellungen, die keinen gemeinsamen Schlüssel haben, werden kumulativ gesendet, unabhängig davon, wo sie angegeben werden. Für alle Einstellungen außer dem Inhaltstyp gilt: Wenn sowohl in diesem Feld als auch in der Transformation derselbe Einstellungsschlüssel angegeben wird, hat der in der Transformation angegebene Schlüssel Vorrang.

    Für content-type, ein hier angegebener Wert hat Vorrang vor allen anderen Stellen in der Benutzeroberfläche, an denen der Inhaltstyp angegeben werden kann. Wenn der Inhaltstyp an mehreren Stellen angegeben wird, gilt diese Rangfolge:

    1. A Content-Type Der in der Tabelle Zusätzliche Einstellungen einer HTTP v2 BULK-Aktivität (diese Tabelle) bereitgestellte Header überschreibt alle folgenden Felder.
    2. Die bodyContentType Das in einer Transformation angegebene Feld überschreibt die verbleibenden Felder unten.
    3. EIN Content-Type Header, der in der Transformation bereitgestellt wird headers Knoten überschreibt die verbleibenden Felder unten.
    4. A Content-Type Der im Feld Anforderungsheader einer HTTP v2 BULK-Aktivität angegebene Header überschreibt das verbleibende Feld unten.
    5. EIN Content-Type Der im Feld Anforderungsheader einer HTTP v2-Verbindung angegebene Header hat die niedrigste Priorität, wenn Anforderungsheader in Aktivitätsausführung senden aktiviert ist.

    Notiz

    Wenn ein Header an mehreren Stellen definiert ist, wird jede Instanz des Header der Anforderung einer Aktivität gemäß der oben genannten Rangfolge hinzugefügt. Diese Reihenfolge basiert darauf, wie Dienste normalerweise doppelte Header in einer Anforderung verarbeiten.

    Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol in der Spalte ganz rechts.

    Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und verwenden Sie das Bearbeitungssymbol oder Symbol „Löschen“ .

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

  • Operation bei nicht erfolgreichem Statuscode ignorieren: Wählen Sie diese Option aus, damit Operationen einen erfolgreichen Status melden, auch wenn von der API, die der Connector aufruft, ein nicht erfolgreicher Statuscode zurückgegeben wird. Der Standardwert ist nicht ausgewählt.

  • Wählen Sie den HTTP-Statuscode aus, der zur Laufzeit des Operation als erfolgreich gewertet werden soll: Wählen Sie entweder Nach Klasse gruppiert oder Granular (Manuelle Eingabe) aus, um die angegebenen Statuscodes in Operation als erfolgreich zu werten.

    • Gruppiert nach Klasse: Wenn ausgewählt, wird ein Dropdown-Menü mit Klassen nicht erfolgreicher Statuscodes angezeigt, die als erfolgreich behandelt werden sollen. Zu den Dropdown-Optionen gehören 3xx Umleitung, 4xx Client-Fehler und 5xx Server-Fehler. Der Standardwert des Dropdown-Menüs ist nicht ausgewählt.

    • Granular (manuelle Eingabe): Wenn ausgewählt, wird ein Feld angezeigt, in das Sie manuell eine durch Kommas getrennte Liste nicht erfolgreicher Statuscodes eingeben können, die als erfolgreich behandelt werden sollen. Diese Liste kann gleichzeitig verschiedene Klassen von Statuscodes enthalten. Der Standardwert des Felds ist leer.

      

  • Multipart: Zur Unterstützung auswählen multipart/form-data Anfragen bei Verwendung von Standardschemata. Dies ist für Anfragen erforderlich, die RFC 1867 enthalten Formular-Uploads.

  • Bei Fehler fortfahren: Wählen Sie diese Option aus, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Charge-Anforderung ein Fehler auftritt. Wenn Fehler auftreten, werden diese in das Operation geschrieben.

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

• Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemata

Alle Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

• Datenschemata: Diese Datenschemata werden von benachbarten Transformations übernommen und beim Transformation erneut angezeigt.

  Notiz

  Die in einer Transformation bereitgestellten Daten haben Vorrang vor der Aktivitätskonfiguration.

  Die Standardanforderungs- und -antwortschemata bestehen aus diesen Knoten und Feldern:

  • Anfrage:

    Schemaknoten/-feld anfordern	Hinweise
    json	Format des Schema
    Anfragen	Anfrageknoten
    Artikel	Artikelknoten
    Anfrage	Knoten einer bestimmten Anfrage
    root	Knoten einer Anforderungswurzel
    Kennung	Kennung der Anfrage
    Pfad	Pfad der Anfrage, ohne die Basis URL des Endpunkts
    Header	Header-Knoten
    Element	Knoten einer bestimmten Header
    Schlüssel	Schlüssel der Header
    Wert	Wert des Header
    Methode	Methode der Anfrage
    requestParameters	Knoten der Anforderungsparameter
    item	Knoten eines bestimmten Anfrageparameters
    Schlüssel	Schlüssel des Anfrageparameters
    Wert	Wert des Anfrageparameters
    Text	Anforderungstext

  • Antwort:

    Antwortschemaknoten/-feld	Hinweise
    json	Format des Schema
    Antworten	Antworten-Knoten
    Artikel	Artikelknoten
    Antwort	Knoten einer bestimmten Antwort
    responseItem	Knoten eines Antwortelements
    Kennung	Kennung der Antwort
    Header	Header-Knoten
    Element	Knoten einer bestimmten Header
    Schlüssel	Schlüssel der Header
    Wert	Wert des Header
    Fehler	Fehlerknoten
    statusCode	HTTP-Statuscode der Antwort
    statusMessage	Statusmeldung der Antwort
    Details	Antwortdetails
    Eigenschaften	Eigenschaften der Antwort
    responseContent	Inhalt der Antwort
    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- Endpoint neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im gesamten Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

• Zurück: Klicken Sie hier, 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 hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine HTTP v2 BULK-Aktivität konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation konfigurieren, die die Möglichkeit umfassen, Vorgänge zu verketten, die sich im selben oder in unterschiedlichen Workflows befinden.

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

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

• Transformation
• Zwei-Ziel-Archivmuster (nur als erste Quelle)
• HTTP-Archivmuster mit zwei Zielen (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 Operation verwendet werden:

• Transformation
• 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 dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, einsetzen und ausführen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.