Erstellen Sie einen gehosteten HTTP- Endpoint in Jitterbit Design Studio

Übersicht

Ein gehosteter HTTP- Endpoint stellt eine URL mit einer oder mehreren damit verbundenen Operationen dar. Beim Zugriff auf die URL werden die konfigurierten Operationen mit den Anforderungsdaten als Eingabe (sofern vorhanden) ausgelöst. Der Endpoint kann so konfiguriert werden, dass er als Antwort eine Zieldatei oder den Inhalt eines Datenelements zurückgibt.

Erstellen eines gehosteten HTTP- Endpoint

Befolgen Sie diese Schritte, um einen gehosteten HTTP- Endpoint zu erstellen:

1. Sofern Sie dies noch nicht getan haben, melden Sie sich bei Jitterbit Studio an.
2. Stellen Sie sicher, dass Sie das entsprechende Projekt geöffnet haben, in dem Sie den neuen gehosteten HTTP- Endpoint erstellen möchten.
3. Erstellen und testen Sie die Operationen, die Sie mit dem gehosteten HTTP- Endpoint auslösen möchten.

4. Klicken Sie mit der rechten Maustaste auf den Knoten Gehostete HTTP- Endpoints im Projektbaum und wählen Sie Neuer gehosteter HTTP- Endpoint oder wählen Sie Neu aus dem Dateimenü und wählen Sie Neuer gehosteter HTTP- Endpoint aus dem Untermenü. Im rechten Bereich wird eine neue Tab mit dem Titel „Neuer gehosteter HTTP- Endpoint“ angezeigt:

   

5. Füllen Sie die Eigenschaften des HTTP- Endpoint aus:

   1. Der Name Ihres Endpoint muss innerhalb Ihres Projekts eindeutig sein.

   2. Endpoint URL ist die URL, auf der dieser Endpoint lauschen soll. Wenn Sie beispielsweise "company/po_import", wird der Endpoint ausgelöst, wenn die URL "http://[server name]:[server port]/company/po_import" wird angefordert.

      1. Der Servername ist der Server, auf dem der private Agent installiert ist. Wenn Sie einen Load Balancer oder eine Firewall vor Ihrem privaten Agenten haben, dann ist dies die IP/der Hostname, der für die Kommunikation mit dem privaten Agenten konfiguriert ist.

      2. Der Server-Port für HTTP ist 46908.

      3. Wenn Sie eine HTTPS- URL (anstelle von HTTP) erstellen, müssen Sie SSL auf Jitterbit Apache auf dem privaten Jitterbit-Agenten konfigurieren. Weitere Informationen finden Sie unter diesen Links:

         • Verwenden der HTTPD-Konfigurationsdatei
         • Jitterbit mit SSL konfigurieren

      4. Der Server-Port für HTTPS ist 46909.

   3. Auszulösende Operationen ist eine Liste der Operationen, die Sie mit diesem Endpoint auslösen möchten. Mindestens eine Operation muss angegeben werden. Um eine Operation hinzuzufügen , klicken Sie auf die Schaltfläche Operation hinzufügen. Eine Liste der verfügbaren Operationen wird angezeigt. Wählen Sie eine oder mehrere Operationen aus und klicken Sie auf OK. Wenn Sie eine vorhandene Operation auswählen und auf Operation bearbeiten klicken, wird die ausgewählte Operation in einem neuen Fenster oder Tab angezeigt. Um eine oder mehrere Operationen aus der Liste der auszulösenden Operationen zu entfernen, wählen Sie die Operation(en) aus und klicken Sie auf Operationen entfernen.

   4. Jeder Operation kann entweder synchron oder asynchron ausgelöst werden. Wählen Sie für jeden Operation den entsprechenden Modus aus der Dropdown-Liste aus. Wenn Sie das Ergebnis eines Operation als Antwort verwenden möchten, muss es synchron ausgeführt werden. Asynchrone Vorgänge werden einfach zur Operation für die zukünftige Verarbeitung hinzugefügt.

   5. Wenn Sie möchten, dass das endgültige Ziel einer Operation als Antwort zurückgegeben wird, aktivieren Sie das Kontrollkästchen Endgültiges Ziel als Antwort für die Operation, die Sie verwenden möchten. Diese Option kann nur für eine Operation aktiviert sein.

   6. In den Anforderungseinstellungen können Sie optional festlegen, dass die Anforderungsdaten in eine globale Variable geschrieben werden. Wenn dies nicht erforderlich ist, lassen Sie dieses Feld leer. Wenn Sie beispielsweise die Zeichenfolge request In diesem Feld sind die Anforderungsdaten in Scripts und Zuordnungen zugänglich als $request oder Get("request").In den Antworteinstellungen wird das Antwortverhalten konfiguriert. Die Standardeinstellung ist Keine Antwort. Wenn Sie als Teil der Antwort Daten zurückgeben müssen, können Sie als Antwort entweder das endgültige Ziel einer Operation oder in ein globales Datenelement geschriebene Daten verwenden. Aktivieren Sie das entsprechende Optionsfeld und wählen Sie entweder eine Operation aus oder geben Sie den Namen eines globalen Datenelements ein.

6. Standardmäßig erfordert ein gehosteter HTTP- Endpoint einen authentifizierten Benutzer. Der Benutzer authentifiziert sich mithilfe der HTTP-Authentifizierung und bei allen ausgelösten Vorgängen muss das Ausführungsberechtigungsflag für den authentifizierten Benutzer gesetzt sein. Wenn Sie möchten, dass jeder den Endpoint auslösen kann, oder wenn Sie die Authentifizierung selbst implementieren, muss der anonyme Benutzer über die Ausführungsberechtigung für den Operation verfügen. Die Vorgänge werden immer als Eigentümer des Operation ausgeführt.

7. Stellen Sie Ihr Projekt bereit. Sobald der gehostete HTTP- Endpoint bereitgestellt ist, wartet er auf eingehende Anfragen unter der konfigurierten URL.

Globale Datenelemente

Diese globalen Datenelemente werden ausgefüllt, wenn auf einen gehosteten HTTP- Endpoint zugegriffen wird:

1. jitterbit.networking.http.request.header.HeaderName

   Enthält die in der Anfrage enthaltenen HTTP-Header. Beispielsweise wird der Content-Type-Header in das globale Datenelement geschrieben $jitterbit.networking.http.request.header.content_typeHINWEIS: Verwenden Sie entweder $jitterbit.networking.http.request.header.content_type oder Get("jitterbit.networking.http.request.header.content-type") um den Wert abzurufen.

2. jitterbit.networking.http.query.ParameterName

   Enthält die URL Abfrage, falls vorhanden. Wenn die aufgerufene URL http://server:port/company/po_import?po_id=dlsho394&uid=arcade, Dann $jitterbit.networking.http.query.po_id wird den Wert haben "dlsho394" Und $jitterbit.networking.http.query.uid wird den Wert haben "arcade".

3. jitterbit.networking.peer.ip

   Enthält die IP-Adresse des aufrufenden Rechners.

Diese globalen Datenelemente können festgelegt werden, um das Verhalten eines gehosteten HTTP- Endpoint zu ändern:

1. jitterbit.networking.http.response.content_type

   Überschreibt den standardmäßigen Content-Type-Header. Der standardmäßige Content-Type-Header wird nach diesen Regeln festgelegt: Wenn ein Operation die Antwort ist, wird der Content-Type-Header für ein Textziel auf „text“ und für ein XML-Ziel auf „text/xml“ festgelegt. Wenn der Endpoint den Inhalt eines Datenelements als Antwort zurückgibt, wird der Content-Type-Header auf „text/html“ festgelegt. Wenn der Endpoint nicht für die Rückgabe von Antwortdaten konfiguriert ist, wird der Content-Type Header nicht festgelegt. Legen Sie dieses globale Datenelement fest, um diese Standardeinstellungen zu überschreiben.