HTTP-Methode, URL und URL-Parameter konfigurieren

Geben Sie die HTTP-Methode und URL der auszuführenden REST-Anforderung an, und konfigurieren Sie alle URL-Parameter für die REST-Aufgabe.

Die folgenden Verfahren können auch verwendet werden, wenn Sie die optionale Polling-URL und die Beendigungs-URL eingeben (oder bearbeiten).

HTTP-Methode und URL konfigurieren

Die Methode ist eine Standard-HTTP-Methode wie GET oder POST. Die URL ist der REST-API-Endpunkt für die Ressource, auf die in der REST-Anforderung zugegriffen wird.

Beispiel: Der folgende REST-Endpunkt listet die Datenassets in der Workspace-ID finance123 auf:

http://myserver.com:8081/workspaces/finance123/dataAssets

Die URL kann Parameter mit der Syntax ${} enthalten. Beispiel: Der folgende REST-Endpunkt listet die Datenassets in einem Workspace auf, indem Parametersyntax für die Variablenabschnitte der URL verwendet wird, die den Serverhost und die Workspace-ID angeben.

http://${myserver}:8081/workspaces/${workspaceId}/dataAssets

Wenn Sie Teile der URL mit der Parametersyntax angeben, werden diese Teile in Zeichenfolgen-URL-Parameter für die REST-Aufgabe konvertiert. Jedem URL-Parameter muss ein Standardwert zugewiesen werden.

Bei Ausführung der Aufgabe können Sie die Werte dieser URL-Parameter ändern. Beispiel: Sie können zur Laufzeit verschiedene Werte für den Server und die Workspace-ID angeben.

Mit dem folgenden Verfahren können Sie auch die optionale Polling-URL und die Beendigungs-URL eingeben (oder bearbeiten).

So konfigurieren Sie die HTTP-Methode und den URL:

  1. Wählen Sie auf der Seite "REST-API-Details konfigurieren" im Schritt Details zur Ausführung definieren unter HTTP-Methode die HTTP-Methode für die URL dieser REST-Aufgabe aus.

    Um die optionale Polling-URL und die Beendigungs-URL zu konfigurieren, gehen Sie zum Schritt Abschlusskriterien angeben, wählen Sie die Registerkarte Polling oder Beendigung aus, und wählen Sie die HTTP-Methode aus. Beachten Sie, dass die Registerkarten Polling und Austritt nur angezeigt werden, wenn das Kontrollkästchen Polling- und Beendigungsbedingung für einen REST-Aufruf ohne Wartezeiten konfigurieren aktiviert ist.

  2. Geben Sie im Feld URL die vollständige URL ein, und drücken Sie die Eingabe.

    Wenn die Parametersyntax ${} für Teile der URL verwendet wird, werden diese Teile in URL-Parameter für die REST-Aufgabe konvertiert.

    Die Tabelle auf der Registerkarte URL-Parameter unter dem Feld "URL" wird mit den Parametern aktualisiert. Der Standarddatentyp für jeden URL-Parameter lautet "Zeichenfolge".

    Informationen zum Zuweisen eines Standardwerts zu jedem URL-Parameter finden Sie unter URL-Parameter konfigurieren. Sie können den Datentyp ändern und jedem Parameter eine Beschreibung hinzufügen.

  3. Wenn Sie die URL durch Hinzufügen oder Entfernen von Parametersyntax bearbeiten, wird die URL-Parametertabelle entsprechend aktualisiert.
URL-Parameter konfigurieren

Nachdem Sie die URL eingegeben (oder bearbeitet) und die Eingabetaste gedrückt haben, werden alle Abschnitte in der URL, die die Parametersyntax ${} verwenden, in URL-Parameter für die REST-Aufgabe konvertiert.

Der Standarddatentyp für alle neu hinzugefügten URL-Parameter lautet "Zeichenfolge". Auf der Registerkarte URL-Parameter können Sie Standardwerte für die REST-Aufgabenparameter hinzufügen sowie gegebenenfalls den Parameterdatentyp ändern.

Mit der folgenden Prozedur können Sie auch URL-Parameter für die optionale Polling-URL und die Beendigungs-URL bearbeiten.

So konfigurieren Sie URL-Parameter:

  1. Wählen Sie im Schritt Ausführungsdetails definieren auf der Seite REST-API-Details konfigurieren die Registerkarte URL-Parameter aus.

    Um URL-Parameter für die optionale Polling- und Beendigungs-URL zu konfigurieren, gehen Sie zum Schritt Abschlusskriterien angeben, wählen Sie die Registerkarte Polling oder Beendigung und dann URL-Parameter aus. Beachten Sie, dass die Registerkarten Polling und Austritt nur angezeigt werden, wenn das Kontrollkästchen Polling- und Beendigungsbedingung für einen REST-Aufruf ohne Wartezeiten konfigurieren aktiviert ist.

  2. Wählen Sie in der Tabellenzeile für einen neuen URL-Parameter im Menü "Aktionen" die Option Bearbeiten aus (Menü Aktionen).
  3. Im Bereich "Parameter bearbeiten" ist das schreibgeschützte Feld ID der Name des REST-Aufgabenparameters für den parametrisierten Abschnitt "URL-Variable".
    1. Geben Sie eine optionale Beschreibung für den Parameter ein.
    2. Verwenden Sie das Menü Datentyp, um den Datentyp des Parameters zu ändern.
    3. Geben Sie im Feld Wert den Standardwert für den Parameter ein.
    4. Wählen Sie Speichern aus.
      Der URL-Parameter wird in der Tabelle aktualisiert.
  4. Um die URL mit den konfigurierten Parameterstandardwerten anzuzeigen oder auszublenden, wählen Sie Vorschau-URL anzeigen oder Vorschau-URL ausblenden aus.