Hinzufügen und Konfigurieren des Schrittes "Web-Anforderung senden"

Mit dem Schritt "Web-Anforderung senden" können Sie Anforderungen an REST-Endpunkte senden, um Daten abzurufen oder Updates zu veröffentlichen. Wenn ArcGIS Workflow Manager mit der Rolle ArcGIS Workflow Manager Server Advanced lizenziert ist, können Sie die Antwort des REST-Endpunktes als benutzerdefinierte Ausgabewerte konfigurieren, als Datei speichern und an den Auftrag anhängen. Die benutzerdefinierten Ausgabewerte können zum Abrufen von Token für nachfolgende REST-Aufrufe, zum Festlegen des Pfades, dem der Workflow folgt, oder als Eingaben für weitere Schritte während des gesamten Workflows verwendet werden.

Wenn der Schritt ausgeführt wird, wird die Web-Anforderung an den in dem Schritt definierten REST-Endpunkt gesendet und die folgenden Aktionen können ausgeführt werden:

• Schritt aktualisieren : Wenn Ihnen der Schritt zugewiesen ist oder Sie über die Berechtigung "adminAdvanced" oder "adminBasic" verfügen, überpüfen Sie den Status des Schrittes erneut, falls die Verbindung zum Server unterbrochen wurde.
• Schritt abschließen : Hiermit schließen Sie den Schritt ab.

Konfigurieren des Schrittes

Um den Schritt zu konfigurieren, gehen Sie wie folgt vor:

Vorsicht:

Um Sicherheitslücken zu reduzieren, konfigurieren Sie den Schritt "Web-Anforderung senden" nur für vertrauenswürdige Webseiten und Web-Apps.

1. Erstellen oder bearbeiten Sie ein Workflow-Diagramm, um das Fenster Schrittbibliothek aufzurufen.
2. Ziehen Sie Web-Anforderung senden aus dem Fenster Schrittbibliothek auf den Verbindungspfeil eines Schrittes auf der Workflow-Zeichenfläche.

   Weitere Informationen zum Hinzufügen von Schritten zu einem Workflow-Diagramm

   Das Fenster Schrittdetails wird angezeigt.

3. Geben Sie in das Textfeld Schrittname einen Namen für den Schritt ein.
4. Klicken Sie im Abschnitt Argumente auf Bearbeiten.
5. Klicken Sie auf den Dropdown-Pfeil URL, und wählen Sie aus, welchen Anforderungstyp Sie senden möchten.
6. Geben Sie die URL des REST-Endpunktes in das Textfeld URL ein.
7. Optional fügen Sie der URL mithilfe der folgenden Syntax Pfadvariablen hinzu:

   https://gisserver.domain.com/webadaptorname/apps/workflowmanager/:pathVariable/

   Pfadvariablen werden im Abschnitt Pfadvariablen angezeigt.

8. Wenn Sie der URL Pfadvariablen hinzugefügt haben, geben Sie im Abschnitt Pfadvariablen einen Wert für jede Variable ein.
9. Optional können Sie der Web-Anforderung auch Abfrageparameter hinzufügen, indem Sie die folgenden Schritte ausführen:
   1. Klicken Sie auf Schlüssel und Wert hinzufügen im Abschnitt Abfrageparameter.
   2. Geben Sie in das Textfeld Schlüssel einen Schlüssel ein.
   3. Geben Sie in das Textfeld Wert einen Wert ein.
   4. Lassen Sie das Kontrollkästchen Aktiviert aktiviert.
   5. Wiederholen Sie diese Teilschritte, um weitere Schlüssel/Wert-Paare hinzuzufügen.
10. Klicken Sie auf die Registerkarte Autorisierung.
11. Wählen Sie die Authentifizierungsmethode des REST-Endpunktes aus, und geben Sie nach Bedarf Authentifizierungsinformationen ein.

    Vorsicht:

    Die Authentifizierungsinformationen, die Sie in dem Schritt eingeben, werden nicht verschlüsselt. Um die Informationen abzusichern, fügen Sie eine verschlüsselte benutzerdefinierte Einstellung hinzu, um die Informationen zu speichern und in dem Schritt mithilfe dynamischer Auftragseigenschaften zu referenzieren.

12. Klicken Sie optional auf die Registerkarte Header, und fügen Sie der Web-Anforderung benutzerdefinierte Header-Schlüssel/Wert-Paare hinzu, indem Sie folgende Schritte ausführen:
    1. Klicken Sie im Abschnitt Benutzerdefinierte Header auf Schlüssel und Wert hinzufügen.
    2. Geben Sie in das Textfeld Schlüssel einen Schlüssel ein.
    3. Geben Sie in das Textfeld Wert einen Wert ein.
    4. Lassen Sie das Kontrollkästchen Aktiviert aktiviert.
    5. Wiederholen Sie diese Teilschritte, um weitere Schlüssel/Wert-Paare hinzuzufügen.
13. Sie können auch auf die Registerkarte Text klicken, um der Web-Anforderung Daten hinzuzufügen.

    Der Anforderungstext unterstützt Formulardaten-Schlüssel/Wert-Paare, URL-codierte Schlüssel/Wert-Paare und Rohdaten im JSON- oder im einfachen Textdateiformat.

    Tipp:

    Sie können auch einen ArcGIS Arcade-Ausdruck verwenden, um benutzerdefinierte Einstellungen abzurufen oder im Text einen dynamischen Wert anzugeben.

14. Wenn Sie eine Lizenz für ArcGIS Workflow Manager Server Advanced haben, können Sie auch die Ausgabeeinstellungen des Schrittes konfigurieren.
15. Klicken Sie auf Speichern, um das Dialogfeld Web-Anforderung konfigurieren zu schließen.
16. Klicken Sie auf die Registerkarte Options.
17. Konfigurieren Sie Schrittoptionen nach Bedarf.
    • Manuell: Der Schritt wird manuell ausgeführt.
      • Optional: Der Schritt kann fertiggestellt werden, ohne dass er ausgeführt wird.
    • Automatisch: Der Schritt wird ausgeführt, sobald er aktiviert wird.

      Hinweis:

      Wenn das Workflow-Diagramm so konfiguriert ist, dass automatisch eine Folge von Schritten ausgeführt wird, in der der Schritt "Datenqualität bewerten" oder der Schritt "GP-Service ausführen" enthalten ist, werden Schritte, die nach Ablauf des Benutzer-Tokens, mit dem diese Schrittfolge gestartet wurde, nicht automatisch ausgeführt. Wenn die zusätzlichen automatisierten Schritte ohne manuellen Eingriff ausgeführt werden sollen, müssen Sie über eine Lizenz für die Rolle ArcGIS Workflow Manager Server Advanced verfügen.

    • Nach einem Zeitplan ausführen: Der Schritt wird nach einem von Ihnen festgelegten Zeitplan ausgeführt.

      Weitere Informationen zu Planungsoptionen

18. Im Textfeld Hilfe zum Schritt können Sie einen Hilfetext zum Schritt bereitstellen.

    Sie können auch wie im folgenden Beispiel ArcGIS Arcade-Ausdrücke verwenden, um einen dynamischen Wert anzuzeigen:

    
    'For further assistance, please contact ' + jobCreator($job) + '.'

19. Klicken Sie ggf. auf die Registerkarte Style, um Form und Farbe für den Schritt zu ändern.
20. Klicken Sie ggf. auf die Registerkarte Info, und geben Sie im Textfeld Schrittbeschreibung eine Beschreibung für den Schritt ein.

    Hinweis:

    Die Registerkarte Info enthält auch die ID des Schrittes, die zusammen mit dynamischen Auftragseigenschaften verwendet werden kann, um das Ergebnis eines Schrittes abzurufen.

Konfigurieren von Ausgabeeinstellungen

Lizenz:

Für diese Funktionalität ist eine Lizenz für die Rolle ArcGIS Workflow Manager Server Advanced erforderlich.

Mit der Rolle ArcGIS Workflow Manager Server Advanced können Sie die Antwort des REST-Endpunktes als Datei speichern, an den Auftrag anhängen und als benutzerdefinierte Ausgabewerte konfigurieren. Die Ausgabewerte können zum Festlegen des Pfades, dem der Workflow folgt, oder als Eingaben für weitere Schritte während des gesamten Workflows verwendet werden. Wenn für den Schritt kein Ausgabewert konfiguriert wird, wird der HTTP-Statuscode als Ausgabewert des Schrittes gespeichert.

Führen Sie die folgenden Schritte aus, um die Ausgabeeinstellungen des Schrittes zu konfigurieren:

1. Klicken Sie im Dialogfeld Web-Anforderung konfigurieren auf die Registerkarte Ausgabe.

   Wenn das Dialogfeld Web-Anforderung konfigurieren nicht verfügbar ist, klicken Sie auf den Schritt Web-Anforderung senden auf der Workflow-Zeichenfläche und dann im Abschnitt Argumente im Fenster Schrittdetails auf Bearbeiten.

2. Sie können auch im Abschnitt Antwort anhängen die Umschaltfläche Aktiviert aktivieren, um die Antwort des REST-Endpunktes als Datei zu speichern und an den Auftrag anzuhängen.
3. Sie können den Namen der Anlage und den Ordner, in dem die Antwort gespeichert werden soll, wie folgt konfigurieren:
   1. Geben Sie in das Textfeld Ordnername den Namen des Ordners ein, in dem die Anlage gespeichert werden soll.

      Der Ordnername darf keine Sonderzeichen enthalten.

      Hinweis:

      Wenn kein Ordnername angegeben wird, wird automatisch ein Ordner mit dem Namen "Allgemein" erstellt.

   2. Wählen Sie als Anlagennamen eine der folgenden Optionen aus:
      • Automatisch generiert: Hierüber wird die Anlage automatisch unter Verwendung der folgenden Syntax benannt: <StepName>_<RunDate>_<RunTime>.
      • Benutzerdefiniert: Hierüber kann ein benutzerdefinierter Anlagenname eingegeben werden.
4. Sie können optional benutzerdefinierte Ausgabewerte für die Antwort des REST-Endpunktes konfigurieren, indem Sie folgende Schritte ausführen:
   1. Aktivieren Sie die Umschaltfläche Testmodus im Abschnitt Ausgabewerte.
   2. Fügen Sie ein Beispiel der Antwort des REST-Endpunktes in das Textfeld Beispielantwort ein.

      Beispielantwort im JSON-Format:

      {"access_token": "",
      "expires_in":7199,
      "spatialReference": {
        "wkid": 4326,
        "latestWkid": 4326
      },
      "locations": [
        {
          "name": "380 New York Street",
          "extent": {
            "xmin": -117.196701,
            "ymin": 34.055489
          }
        }
      ]}

   3. Klicken Sie auf Ausgabe und Pfad hinzufügen.
   4. Geben Sie in das Textfeld Ausgabewert einen Namen für den Ausgabewert ein.

      Dies ist der Wertname, der verwendet wird, um den benutzerdefinierten Ausgabewert zu erhalten.

   5. Geben Sie in das Textfeld Extraktionspfad in Punktnotation oder Klammernotation einen JSONPath-Ausdruck für den Wert ein, den Sie speichern möchten.

      Beispiel-JSONPath in Punktnotation:

      $.locations.0.name

      Beispiel-JSONPath in Klammernotation:

      $['locations'][0]['name']

      Der Wert wird in der Spalte Beispielergebnis angezeigt.

   6. Optional wiederholen Sie die Teilschritte c bis e, um weitere benutzerdefinierte Ausgabewerte hinzuzufügen.
5. Klicken Sie auf Speichern, um das Dialogfeld Web-Anforderung konfigurieren zu schließen.

Rückgabewert

Nach Abschluss des Schrittes wird der Rückgabewert gespeichert, um das Ergebnis des Schrittes anzuzeigen. Der Rückgabewert kann mithilfe von Pfaden sofort ausgewertet werden, um die nächsten Schritte im Workflow zu bestimmen. Mithilfe von ArcGIS Arcade-Ausdrücken können Sie während des gesamten Workflows auch den Rückgabewert eines abgeschlossenen Schrittes abrufen. In der folgenden Tabelle sind die Rückgabewerte des Schrittes aufgeführt:

Rückgabewerte	Beschreibung
S000001	Der Schritt wurde erfolgreich abgeschlossen.
F000001	Der Schritt wurde nicht erfolgreich abgeschlossen.

Ausgabewert

Lizenz:

Für diese Funktionalität ist eine Lizenz für die Rolle ArcGIS Workflow Manager Server Advanced erforderlich.

Nach Abschluss des Schrittes wird der Ausgabewert gespeichert. Er kann dann zum Festlegen des Pfades, dem der Workflow folgt, oder als Eingaben für weitere Schritte während des gesamten Workflows verwendet werden. In der folgenden Tabelle wird der Ausgabewert des Schrittes angezeigt:

Ausgabe	Beschreibung	Syntax für ArcGIS Arcade-Ausdruck
Status	Gibt den HTTP-Antwortcode zurück, wenn für den Schritt kein Ausgabewert konfiguriert ist.	jobOutputValue($job, '<step_id>', 'Status')
<CustomOutputValue>	Gibt den benutzerdefinierten Ausgabewert zurück, der für den Schritt konfiguriert wurde.	jobOutputValue($job, '<step_id>', '<custom_output_value_name>')