Mit dem Schritt "Pro-Geoverarbeitungswerkzeug ausführen" wird ein konfiguriertes Geoverarbeitungswerkzeug, Python-Skript oder ModelBuilder-Modell in ArcGIS Pro ausgeführt.
Wenn der Schritt ausgeführt wird, wird das Symbol Wird gestartet auf der Auftragskachel angezeigt. Wenn das Werkzeug gestartet wird, wird das Symbol Wird ausgeführt angezeigt, was darauf hinweist, dass das Geoverarbeitungswerkzeug ausgeführt wird.
Wenn alle oder einige Schrittparameter mit ArcGIS Arcade-Ausdrücken konfiguriert werden, werden sie in die entsprechenden Werte konvertiert, bevor das Geoverarbeitungswerkzeug ausgeführt wird.
Wenn die Option Zur Laufzeit sichtbar aktiviert ist, wird das in dem Schritt konfigurierte Werkzeug im Bereich Geoverarbeitung geöffnet, und Sie können bestimmte Parameterwerte definieren, bevor das Werkzeug ausgeführt wird. Wenn Standardparameterwerte konfiguriert wurden, werden sie angezeigt, wenn Sie den Schritt ausführen, und können überschrieben werden. Wenn die Werte Eingabeaufforderung und Hilfe zum Schritt für diesen Schritt nicht konfiguriert worden sind, wird der Schritt automatisch abgeschlossen, wenn er ausgeführt wird.
Hinweis:
Wenn ein aus einem ArcGIS Arcade-Ausdruck erhaltener Parameterwert mit dem Werkzeug nicht kompatibel ist, schlägt der Schritt fehl.
BEim Ausführen des Schrittes können die folgenden Aktionen durchgeführt werden:
- Wenn die Option Zur Laufzeit sichtbar aktiviert ist, können Parameterwerte angegeben werden, und der Schritt kann ausgeführt werden, indem Sie im Bereich Geoverarbeitung auf Ausführen klicken.
- Sie können den Schritt abbrechen, indem Sie auf Abbrechen klicken.
Hinweis:
In einigen Fällen können Sie diesen Schritt möglicherweise nicht abbrechen, nachdem seine Ausführung begonnen hat.
Konfigurieren des Schrittes
Um den Schritt zu konfigurieren, gehen Sie wie folgt vor:
- Erstellen oder bearbeiten Sie ein Workflow-Diagramm, um das Fenster Schrittbibliothek aufzurufen.
- Ziehen Sie Pro-Geoverarbeitungswerkzeug ausführen aus dem Fenster Schrittbibliothek auf den Verbindungspfeil eines Schrittes auf der Workflow-Zeichenfläche.
Das Fenster Schrittdetails wird angezeigt.
- Geben Sie in das Textfeld Schrittname einen Namen für den Schritt ein.
- Fügen Sie ggf. im Textfeld Eingabeaufforderung die Meldung hinzu, die beim Ausführen des Schrittes angezeigt werden soll.
Wenn die Eingabeaufforderung einfachen Text und Arcade-Ausdrücke enthält, muss der Text wie folgt formatiert werden:
'This job is currently assigned to ' + JobOwner($Job) + '.'
Tipp:
Klicken Sie auf die Schaltfläche Diese Eingabe unterstützt Arcade-Ausdrücke , und wählen Sie einen ArcGIS Arcade-Ausdruck für das zugehörige Textfeld aus.
- Wählen Sie im Abschnitt Argumente den auszuführenden Werkzeugtyp aus:
- System-Toolbox: Geoverarbeitungswerkzeuge, die in ArcGIS Pro enthalten sind, und Toolboxes, die in ein ArcGIS Pro-Projekt importiert wurden
- Sonstige Toolbox: Benutzerdefinierte Geoverarbeitungswerkzeuge und -skripte
- Führen Sie einen der folgenden Vorgänge aus:
Werkzeuge in den System-Toolboxes
Geben Sie in das Textfeld Toolbox-Aliasname den Toolbox-Aliasnamen der Toolbox ein, die das Werkzeug enthält, das Sie ausführen möchten.
Den Toolbox-Aliasnamen finden Sie auf der Registerkarte Python auf der Hilfeseite des Werkzeugs in der ArcGIS Pro-Dokumentation.
In ein ArcGIS Pro-Projekt importierte Werkzeuge
Geben Sie in das Textfeld Toolbox-Aliasname den Toolbox-Aliasnamen der Toolbox ein, die das Werkzeug enthält, das Sie ausführen möchten.
Klicken Sie mit der rechten Maustaste auf die Toolbox im Bereich Katalog, und klicken Sie auf Eigenschaften, um den Toolbox-Aliasnamen anzuzeigen.
Benutzerdefinierte Geoverarbeitungswerkzeuge und -skripte
Geben Sie den vollständigen Pfad zu der Toolbox in das Textfeld Toolbox-Pfad ein. Der Pfad zu der Toolbox kann zudem Toolboxes referenzieren, die in einer File-Geodatabase oder einer Enterprise-Geodatabase gespeichert sind. Auf den Pfad muss in ArcGIS Pro zugegriffen werden können.
Sie können auch ArcGIS Arcade-Ausdrücke verwenden, um einen dynamischen Wert bereitzustellen.
- Geben Sie den Namen des Werkzeugs, das Sie ausführen möchten, in das Textfeld Werkzeugname ein.
Hinweis:
Wenn der Name des Geoverarbeitungswerkzeugs im Textfeld Werkzeugname mit dem Namen einer Arcade-Funktion übereinstimmt (z. B. Puffer oder Ausschneiden), müssen Sie den Namen des Werkzeugs in einfachen oder doppelten Anführungszeichen einschließen, damit er nicht als Arcade-Ausdruck ausgewertet wird.
Den Werkzeugnamen finden Sie auf der Registerkarte Python auf der Hilfeseite des Werkzeugs in der ArcGIS Pro-Dokumentation.
Sie können auch ArcGIS Arcade-Ausdrücke verwenden, um einen dynamischen Wert bereitzustellen.
- Optional aktivieren Sie das Kontrollkästchen Zur Laufzeit sichtbar, damit die Parameterwerte festgelegt werden können, wenn der Schritt in ArcGIS Pro ausgeführt wird.
- Klicken Sie auf Neuen Parameter hinzufügen.
- Geben Sie den Namen des Parameters in das Textfeld Parametername ein.
Die Parameternamen des Werkzeugs finden Sie auf der Registerkarte Python auf der Hilfeseite des Geoverarbeitungswerkzeug in der ArcGIS Pro-Dokumentation.
- Optional klicken Sie auf die Schaltfläche Standardwert anzeigen , um den Standardwert des Parameters zu definieren, wenn der Schritt ausgeführt wird.
- Wählen Sie eine der folgenden Optionen:
- Wert: Geben Sie einen statischen Wert ein.
- Arcade-Ausdruck: Geben Sie einen dynamischen Wert mithilfe eines Arcade-Ausdrucks ein.
- Geben Sie einen Standardwert für die Eigenschaft in das Textfeld Wert oder das Textfeld Arcade-Ausdruck ein.
- Wählen Sie eine der folgenden Optionen:
- Wiederholen Sie die Schritte 9 bis 11, um weitere Parameter hinzuzufügen.
- Geben Sie optional den Namen des abgeleiteten Ausgabeparameters an, den Sie als Ausgabewert verwenden möchten, wenn die Ausführung des Werkzeugs beendet ist.
Die abgeleiteten Ausgabeparameter des Werkzeugs finden Sie auf der Registerkarte Python auf der Hilfeseite des Werkzeugs in der ArcGIS Pro-Dokumentation.
- Optional aktivieren Sie das Kontrollkästchen GP-Protokoll anhängen, um den Verlauf des Werkzeugs als Auftragsanlage zu speichern.
- Optional können Sie auch in das Textfeld Ordner den Namen des Ordners eingeben, in dem die Protokolle gespeichert werden sollen.
Der Ordnername darf keinen Dateisystempfad und keine Sonderzeichen enthalten. Wenn kein Ordnername angegeben wird, wird automatisch ein Ordner mit dem Namen "Allgemein" erstellt.
Hinweis:
Der Ordner ist im Workflow-Element enthalten und ist kein Dateisystempfad.
- Klicken Sie auf die Registerkarte Options.
- 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 ein 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.
- Manuell: Der Schritt wird manuell ausgeführt.
- Im Textfeld Hilfe zum Schritt können Sie einen Hilfetext zum Schritt bereitstellen.
Sie können auch ArcGIS Arcade-Ausdrücke verwenden, um für die Hilfe zum Schritt einen dynamischen Wert bereitzustellen. Wenn die Hilfe zum Schritt einfachen Text und Arcade-Ausdrücke enthält, muss der Text wie folgt formatiert werden:
'For further assistance, please contact ' + JobCreator($Job) + '.'
- Klicken Sie ggf. auf die Registerkarte Style, um Form und Farbe für den Schritt zu ändern.
- 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.
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
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 |
---|---|
<DerivedOutputParameterValue> | Gibt den vom Werkzeug erhaltenen konfigurierten abgeleiteten Ausgabewert zurück. |