Hinzufügen und Konfigurieren des Schrittes "GP-Service ausführen"

Mit dem Schritt "GP-Service ausführen" wird ein konfigurierter Geoverarbeitungsservice ausgeführt. Mit dem Schritt können Geoverarbeitungswerkzeuge, Python-Skriptwerkzeuge und ModelBuilder-Modelle ausgeführt werden, die als Services in Ihrer ArcGIS-Organisation veröffentlicht worden sind.

Wenn der Schritt ausgeführt wird, wird das Symbol Wird gestartet auf der Auftragskachel angezeigt. Wenn der Service gestartet wird, wird das Symbol Wird ausgeführt angezeigt, was darauf hinweist, dass der Geoverarbeitungsservice ausgeführt wird.

Wenn alle oder einige Schrittparameter mit einem ArcGIS Arcade-Ausdruck konfiguriert werden, werden sie in die entsprechenden Werte konvertiert, bevor der Geoverarbeitungsservice ausgeführt wird.

Wenn die Option Sichtbar aktiviert ist, können Sie mit dem Schritt Parameterwerte definieren, bevor der Geoverarbeitungsservice gestartet wird. Wenn Standardwerte für Parameter konfiguriert wurden, werden sie angezeigt, wenn Sie den Schritt ausführen, und können überschrieben werden. Erforderliche Parameter werden rot markiert.

Wenn der Schritt erfolgreich ausgeführt wurde, wird das Symbol Schritt abgeschlossen angezeigt. Wenn der Schritt fehlschlägt, wird das Symbol GP-Schritt fehlgeschlagen angezeigt.

Hinweis:

Wenn ein aus einem ArcGIS Arcade-Ausdruck erhaltener Parameterwert mit dem Geoverarbeitungsservice nicht kompatibel ist, schlägt der Schritt fehl.

Beim Ausführen des Schrittes können die folgenden Aktionen durchgeführt werden:

• Wenn die Option Sichtbar aktiviert ist, können Parameterwerte angegeben werden, und der Schritt kann ausgeführt werden, indem Sie auf Fortfahren klicken.
• Sie können den Schritt abbrechen, indem Sie auf Schritt abbrechen klicken.

  Hinweis:

  In einigen Fällen können Sie diesen Schritt möglicherweise nicht abbrechen, nachdem seine Ausführung begonnen hat.

• Sie können den Schritt fertigstellen, indem Sie auf Schritt abschließen klicken.

Konfigurieren des Schrittes

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

1. Erstellen oder bearbeiten Sie ein Workflow-Diagramm, um das Fenster Schrittbibliothek aufzurufen.
2. Ziehen Sie GP-Service ausführen 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. Wählen Sie einen Geoverarbeitungsservice aus dem Dropdown-Menü GP-Service aus.
5. Wenn kein Geoverarbeitungsservice mit dem Workflow-Diagramm verknüpft ist, fügen Sie eine Datenreferenz für den Geoverarbeitungsservice hinzu:
   1. Klicken Sie im Dropdown-Menü auf Datenreferenz hinzufügen.

      Das Dialogfeld Datenreferenz hinzufügen wird angezeigt.

   2. Fügen Sie eine Datenreferenz hinzu, indem Sie einen der folgenden Schritte ausführen:
      • Nach Element suchen: Durchsuchen Sie eine Elementliste im aktuellen Portal, und nehmen Sie eine Auswahl vor.

        Tipp:

        Sie können die Ergebnisse optimieren, indem Sie bei der Suche Filter und Tags anwenden.

      • Element-ID manuell eingeben: Wählen Sie die Umgebung aus, in der sich die Datenreferenz befindet, und geben Sie die Element-ID und den Referenznamen in den Textfeldern Element-ID und Referenzname an.

        Wenn Sie Andere ausgewählt haben, geben Sie im Textfeld Portal-URL die URL der ArcGIS-Organisation an, die die Datenreferenz enthält. Wenn Sie Eigenständiger Server für den Geoverarbeitungsservice ausgewählt haben, geben Sie die Service-URL des Geoverarbeitungsservice an, der das Werkzeug enthält, das Sie verwenden möchten.

        Beispiel:

        https://machine.domain.com/webadaptor/rest/services/<GP Service Name>/GPServer

        Das Element wird automatisch von Workflow Manager überprüft, und der Datenreferenztyp wird in der Leiste Typ festgelegt.

        Wenn die Datenreferenz nicht überprüft werden kann, müssen Sie die Element-ID einer gültigen Datenreferenz angeben, die dem festgelegten Datenreferenztyp entspricht.

      Weitere Informationen zum Verwalten von Datenreferenzen

   3. Klicken Sie auf OK, um die Datenreferenzen zu speichern, oder auf Abbrechen, um den Vorgang zu beenden.
6. Wenn der Geoverarbeitungsservice mehr als ein Werkzeug enthält, wählen Sie das Werkzeug, das Sie ausführen möchten, aus dem Dropdown-Menü Werkzeug aus.
7. Klicken Sie im Abschnitt Argumente auf Bearbeiten.

   Das Dialogfeld Schrittargumente wird angezeigt.

8. Konfigurieren Sie nach Bedarf die Parameterwerte in den Textfeldern Parameterwert.

   Um ArcGIS Arcade-Ausdrücke für Parameterwerte zu verwenden, klicken Sie auf den Dropdown-Pfeil Eingabetyp ändern, und wählen Sie den Eingabetyp für das zugehörige Textfeld Parameterwert aus. Diese Option ist für Zeichenfolgenwerte nicht verfügbar.

   Tipp:

   Klicken Sie auf Diese Eingabe unterstützt Arcade-Ausdrücke , und wählen Sie einen Arcade-Ausdruck für das zugehörige Textfeld aus.

9. Optional aktivieren Sie das Kontrollkästchen Sichtbar neben einem Parameter, damit sein Wert festgelegt wird, wenn der Schritt in ArcGIS Pro ausgeführt wird.
10. Aktualisieren Sie den Rückgabewert nach Bedarf.
11. Klicken Sie auf die Registerkarte Options.
12. 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 "GP-Service ausführen" enthalten ist, werden Schritte nach Ablauf des Benutzer-Token nicht automatisch ausgeführt. Wenn zusätzliche automatisierte Schritte ohne manuellen Eingriff ausgeführt werden sollen, müssen Sie über die Organisationserweiterung "ArcGIS Workflow Manager Advanced" verfügen.

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

      Weitere Informationen zu Planungsoptionen

13. Wählen Sie optional eine der folgenden Optionen, um die Hilfe in diesem Schritt zu konfigurieren:
    • Keine: Hierüber konfigurieren Sie den Schritt ohne Schritthilfe.
    • Text: Hierüber konfigurieren Sie den Hilfetext für den Schritt im Textfeld Text.

      Sie können ArcGIS Arcade-Ausdrücke verwenden, um für die Hilfe zum Schritt einen dynamischen Wert bereitzustellen. Wenn die Schritthilfe Text und Arcade-Ausdrücke enthält, muss der Text wie folgt formatiert werden:

      
      'For further assistance, please contact' + JobCreator($Job) + '.'

    • URL: Hierüber konfigurieren Sie den Schritt mit einem Link zu einer Hilfe im Textfeld URL.

      Hinweis:

      Bei in der Web-App ausgeführten Schritten werden nur die URL-Formate HTTP und HTTPS unterstützt. Bei in ArcGIS Pro ausgeführten Schritten werden HTTP, HTTPS und Dateiformate unterstützt.

      Sie können auch Arcade-Ausdrücke verwenden, um einen dynamischen Wert bereitzustellen. Wenn die URL Text und Arcade-Ausdrücke enthält, muss der Text wie folgt formatiert werden:

      
      'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'

      Konfigurieren Sie das Kontrollkästchen Arcade-Ergebnis automatisch codieren wie folgt:

      • Wenn ein Arcade-Ausdruck ein Ergebnis zurückgibt, in dem Sonderzeichen enthalten sind, die beim Konvertieren in eine URL mit Escape-Zeichen versehen werden müssen, wie zum Beispiel ein Leerzeichen oder ein Schrägstrich, dann stellen Sie sicher, dass das Kontrollkästchen Arcade-Ergebnis automatisch codieren aktiviert ist.
      • Wenn ein Arcade-Ausdruck zum Erstellen der Basis-URL verwendet wird, dann deaktivieren Sie das Kontrollkästchen Arcade-Ergebnis automatisch codieren.

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

    Tipp:

    Die Registerkarte Info enthält auch die ID des Schrittes, die zusammen mit dynamischen Auftragseigenschaften verwendet werden kann, um das Ergebnis eines Schrittes abzurufen. Klicken Sie auf Schritt-ID kopieren , um die Schritt-ID in die Zwischenablage zu kopieren.

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ückgabewert	Beschreibung
S000001	Der Schritt wurde erfolgreich abgeschlossen.
F000001	Der Schritt wurde nicht erfolgreich abgeschlossen.

Ausgabewert

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 ist der Ausgabewert des Schrittes aufgeführt:

Ausgabewertname	Beschreibung
<GeoprocessingServiceOutput>	Gibt alle vom Geoverarbeitungsservice erhaltenen Ausgabewerte zurück.