Zum Inhalt springen

HTTP PUT-Aktivität in Jitterbit Studio

Einführung

Eine HTTP PUT-Aktivität verwendet ihre HTTP-Verbindung zum Ersetzen einer vorhandenen Ressource auf einem Dienst, der über das HTTP- oder HTTPS-Protokoll zugänglich ist. Sie kann entweder als Quelle (um Daten in einer Operation bereitzustellen) oder als Ziel (um Daten in einer Operation zu verarbeiten) verwendet werden.

Wichtig

Mit der Veröffentlichung des HTTP v2-Connectors empfehlen wir, vorhandene HTTP-Verbindungen und -Aktivitäten zu HTTP v2 zu konvertieren. Weitere Informationen zu den Vorteilen des HTTP v2-Connectors finden Sie in unserem HTTP v2-Blogbeitrag oder lesen Sie einen Vergleich der Funktionen des HTTP- und HTTP v2-Connectors.

Jitterbit beabsichtigt langfristig, den HTTP-Connector einzustellen, was gemäß der End-of-Life-Richtlinie von Jitterbit angekündigt wird. Derzeit gibt es keinen Zeitplan für die Einstellung, und der HTTP-Connector wird weiterhin vollständig unterstützt. Wir empfehlen, vorhandene HTTP-Verbindungen und -Aktivitäten nach Möglichkeit zu HTTP v2 zu konvertieren.

HTTP PUT-Aktivität erstellen

Eine Instanz einer HTTP PUT-Aktivität wird aus einer HTTP-Verbindung mit ihrem PUT-Aktivitätstyp 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ätsinstanz erstellen in Komponentenwiederverwendung.

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

HTTP PUT-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine HTTP PUT-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 URL, Anfrageparameter und Anforderungsheader fest. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

Tipp

Felder mit einem -Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das -Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

Wichtig

Felder in den Tabellen 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.

  • Endpoint-Menü: Wenn mehrere Endpoints desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den Namen des aktuellen Endpoints an. Klicken Sie auf das Menü, um zu einem anderen Endpoint zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpoint ändern in Konfigurationsbildschirme.

    • Endpoint bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den Namen des aktuellen Endpoints bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpoints zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede HTTP v2 PUT-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • HTTP-Verb: Das HTTP-Verb kann nicht geändert werden.

  • Pfad: Geben Sie einen Pfad und/oder Abfrageparameter ein, die an die Basis-URL angehängt werden sollen, die in der Konfiguration der HTTP-Verbindung angegeben wurde. Wenn Abfrageparameter bereitgestellt werden, geben Sie diese wie in einem Webbrowser an, z. B. /queryrecord?id=10.

  • URL: Die URL, die als Verkettung der Basis-URL und des oben eingegebenen Pfads erstellt wird, wird als Referenz bereitgestellt. Um die URL zu bearbeiten, nehmen Sie Änderungen entweder an der Basis-URL in der HTTP-Verbindung oder am oben eingegebenen Pfad vor.

  • Anfrageparameter: Klicken Sie auf die Schaltfläche Hinzufügen, um eine Zeile hinzuzufügen, und geben Sie dann einen bestimmten Namen und Wert für angeforderte Parameter ein. Klicken Sie auf die Schaltfläche Entfernen, um eine vorhandene Zeile zu entfernen. Die bereitgestellten Anfrageparameter werden automatisch URL-codiert.

  • Anfrage-Header: Klicken Sie auf die Schaltfläche Hinzufügen, um eine Zeile hinzuzufügen, und geben Sie dann einen bestimmten Namen und Wert für angeforderte Header-Informationen ein. Klicken Sie auf die Schaltfläche Entfernen, um eine vorhandene Zeile zu entfernen.

    Maskierung von Anfrage-Headern

    Sensitive Anfrage-Header werden standardmäßig in Runtime-Protokollen maskiert. Um zusätzliche Anfrage-Header bei Verwendung von privaten Agents zu maskieren, fügen Sie diese zum Abschnitt [Masking] der Konfigurationsdatei des privaten Agents hinzu.

  • Speichern und 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 zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Ä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.

Schritt 2: Anfrage-Schema bereitstellen

In diesem Schritt können Sie ein benutzerdefiniertes Anfrage-Schema bereitstellen (optional).

  • Anfrage-Schema bereitstellen: Das Anfrage-Schema definiert die Struktur der Anfragedaten, die von der HTTP-Aktivität verwendet werden. Ob ein Anfrage-Schema erforderlich ist, hängt davon ab, ob die Aktivität als Ziel einer Transformation verwendet wird und ob der Webservice strukturierte Anfragedaten erwartet (siehe Schema-Verwendung). Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter In einer Aktivität definierte Schemas.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

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

  • Ä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.

Schritt 3: Antwort-Schema bereitstellen

In diesem Schritt können Sie ein benutzerdefiniertes Antwort-Schema bereitstellen (optional).

  • Antwort-Schema bereitstellen: Das Antwort-Schema definiert die Struktur der Antwortdaten, die von der HTTP-Aktivität verwendet werden. Ob ein Antwort-Schema erforderlich ist, hängt davon ab, ob die Aktivität als Quelle einer Transformation verwendet wird und ob der Webservice strukturierte Antwortdaten zurückgibt (siehe Schema-Verwendung). Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter In einer Aktivität definierte Schemas.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu gehen. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

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

Schritt 4: Datenschemas überprüfen

Die konfigurierten Request- und Response-Schemas (falls vorhanden) werden angezeigt.

  • Datenschema: Falls während der Aktivitätskonfiguration angegeben, werden die Request- und/oder Response-Datenschemas angezeigt. Wenn der Vorgang eine Transformation verwendet, werden die Datenschemas später während des Transformationsmapping-Prozesses erneut angezeigt, wo Sie Zielfelder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können. Sie können auch Schemas direkt in einer Transformation definieren.

  • Plugin(s) hinzufügen: Plugins sind von Jitterbit oder Benutzern bereitgestellte Anwendungen, die die nativen Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Abschnitt zu erweitern, und aktivieren Sie das Kontrollkästchen neben dem zu verwendenden Plugin. Weitere Anweisungen zur Verwendung von Plugins, einschließlich Details zum Festlegen erforderlicher Variablen, die vom Plugin verwendet werden, finden Sie unter Plugins, die zu einer Aktivität hinzugefügt wurden.

  • 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 die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Jitterbit-Variablen, die die HTTP-Übermittlung beeinflussen

Das Harmony-System definiert bestimmte globale Variablen, die überall in einem Projekt verfügbar sind und als Jitterbit-Variablen oder vordefinierte globale Variablen bekannt sind. Die unten aufgeführten Jitterbit-Variablen sind besonders nützlich für HTTP-Aktivitäten. Weitere Informationen zur Verwendung von Jitterbit-Variablen finden Sie unter Jitterbit-Variablen.

Diese Jitterbit-Variablen beeinflussen die Art und Weise, wie HTTP-Quellenübermittlungen durchgeführt werden:

  • jitterbit.source.max_redirs
  • jitterbit.source.http.ssl_cert_id
  • jitterbit.source.http.transfer_timeout

Diese Jitterbit-Variablen beeinflussen die Art und Weise, wie HTTP-Zielübermittlungen durchgeführt werden:

  • jitterbit.target.http.form_data
  • jitterbit.target.http.form_data.ContentType
  • jitterbit.target.http.form_data.filename
  • jitterbit.target.http.form_data.name
  • jitterbit.target.http.max_redirs
  • jitterbit.target.http.remove_trailing_linebreaks
  • jitterbit.target.http.ssl_cert_id
  • jitterbit.target.http.transfer_timeout

Nächste Schritte

Nach der Konfiguration einer HTTP PUT-Aktivität können Sie diese wie unten beschrieben in einem Vorgang oder Skript verwenden. Sie können auch Chunking konfigurieren, um die Daten in kleinere Teile zur Verarbeitung aufzuteilen.

Vorgang abschließen

Nach der Konfiguration einer HTTP PUT-Aktivität 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 eines Vorgangs konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Nach der Erstellung einer HTTP PUT-Aktivität sind Menüaktionen für diese Aktivität im Projektbereich auf den Registerkarten Workflows oder Komponenten und auf der Entwurfsfläche verfügbar. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü.

Die Operationsmuster, die HTTP PUT-Aktivitäten verwenden können, hängen davon ab, ob die Aktivität Daten bereitstellt (als Quelle) oder Daten empfängt (als Ziel) in einer Operation, wie nachfolgend in Als Quelle verwendet und Als Ziel verwendet beschrieben.

Obwohl HTTP PUT-Aktivitäten typischerweise als Ziel verwendet werden, ist es möglich, eine HTTP PUT-Aktivität als Quelle zu verwenden. Ob der spezifische Webservice Request- oder Response-Schemas für jede Methode bereitstellt, bestimmt, ob eine Aktivität als Quelle oder Ziel verwendet werden kann, wie in Teile einer Operation in Operation erstellen und konfigurieren beschrieben.

Wenn alles bereit ist, stellen Sie die Operation bereit, führen Sie sie aus und überprüfen Sie das Verhalten durch Kontrolle der Operationsprotokolle.

Als Quelle verwendet

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

Andere Muster sind nicht gültig bei Verwendung von HTTP-Aktivitäten als Quelle.

Als Ziel verwendet

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

Andere Muster sind nicht gültig bei Verwendung von HTTP-Aktivitäten als Ziel.

HTTP-Aktivitäten in Skripten verwenden

HTTP-Aktivitäten können auch in einem Skript referenziert werden, um sie mit Skriptfunktionen zu verwenden, die einen sourceId oder targetId als Parameter verwenden, einschließlich dieser:

Jitterbit-Funktionen

JavaScript Jitterbit-Funktionen

Weitere Informationen zum Referenzieren von Aktivitäten in Skripten finden Sie unter Endpoints in Jitterbit Script oder Endpoints in JavaScript.

Chunking verwenden

Viele Web-Service-APIs haben Größenbeschränkungen. Falls Sie auf Datensatzlimits stoßen, die von der API vorgegeben werden, können Sie Chunking verwenden, um die Quelldaten in mehrere Chunks aufzuteilen. Die Transformation wird dann für jeden Chunk separat durchgeführt, wobei jeder Quell-Chunk einen Ziel-Chunk erzeugt. Die resultierenden Ziel-Chunks werden kombiniert, um das endgültige Ziel zu erzeugen.

Anweisungen und Best Practices zur Verwendung von Chunking finden Sie unter Operation options.