Skip To Content

Hinzufügen und Konfigurieren des Schrittes "Pro-Geoverarbeitungswerkzeug ausführen"

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 Starting auf der Auftragskachel angezeigt. Wenn das Werkzeug gestartet wird, wird das Symbol Wird ausgeführt Running 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.

When the step is run, the following actions can be performed:

  • 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

To configure the step, do the following:

  1. Create or edit a workflow diagram to access the Step Library panel.
  2. Ziehen Sie Pro-Geoverarbeitungswerkzeug ausführen aus dem Fenster Schrittbibliothek auf den Verbindungspfeil eines Schrittes auf der Workflow-Zeichenfläche.

    The Step Details panel appears.

  3. Provide a name for the step in the Step Name text box.
  4. Optionally, add the message you want to appear when the step is run in the User Prompt text box.

    You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:

    'This job is currently assigned to ' + jobOwner($job) + '.'
  5. Wählen Sie im Abschnitt Argumente den Werkzeugtyp aus, den Sie ausführen möchten:
    • 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
  6. 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 dann 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.

  7. Geben Sie den Namen des Werkzeugs, das Sie ausführen möchten, in das Textfeld Werkzeugname ein.

    Den Werkzeugnamen finden Sie auf der Registerkarte Python auf der Hilfeseite des Werkzeugs in der ArcGIS Pro-Dokumentation.

  8. 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.
  9. Klicken Sie auf Neuen Parameter hinzufügen.
  10. 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.

  11. Optional klicken Sie auf die Schaltfläche Standardwert anzeigen Show Default Value, um den Standardwert des Parameters zu definieren, wenn der Schritt ausgeführt wird.
    1. 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.
    2. Geben Sie einen Standardwert für die Eigenschaft in das Textfeld Wert oder das Textfeld Arcade-Ausdruck ein.
  12. Wiederholen Sie die Schritte 9 bis 11, um weitere Parameter hinzuzufügen.
  13. Optional geben Sie den Namen des abgeleiteten Ausgabeparameters ein, den Sie als Ausgabewert verwenden möchten, wenn die Ausführung des Werkzeugs beendet wird.

    Die abgeleiteten Ausgabeparameter des Werkzeugs finden Sie auf der Registerkarte Python auf der Hilfeseite des Werkzeugs in der ArcGIS Pro-Dokumentation.

  14. Optional aktivieren Sie das Kontrollkästchen GP-Protokoll anhängen, um den Verlauf des Werkzeugs als Auftragsanlage zu speichern.
  15. Optional können Sie auch in das Textfeld Ordner den Namen des Ordners eingeben, in dem die Protokolle gespeichert werden sollen.

    Der Ordnername darf keine Sonderzeichen enthalten.

    Hinweis:

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

  16. Click the Options tab.
  17. Configure Step Options as necessary.
    • Manual—Run the step manually.
      • Optional—Allow the step to be finished without being run.
    • Automatic—Run the step as soon as it becomes active.
      Hinweis:

      If your workflow diagram is configured to automatically run a sequence of steps that includes the Evaluate Data Quality or the Run GP Service step, steps that attempt to run after the user token that started the sequence of steps expires will not run automatically. You must have a license for the ArcGIS Workflow Manager Server Advanced role to continue running the additional automated steps without manual intervention.

    • Run on a Schedule—Run the step according to a schedule you set.

      Learn more about scheduling options

  18. Optionally, provide help text for the step in the Step Help text box.

    You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:

    'For further assistance, please contact ' + jobCreator($job) + '.'
  19. Optionally, click the Style tab to change the shape and color of the step.
  20. Optionally, click the About tab and provide a description for the step in the Step Description text box.
    Hinweis:

    The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.

Return value

When the step is completed, its return value is stored to indicate the result of the step. The return value can be immediately evaluated using paths to determine the next steps in the workflow. You can also retrieve the return value for completed steps throughout the workflow using ArcGIS Arcade expressions. The following table lists the step's return values:

Return valuesDescription

S000001

The step completed successfully.

F000001

The step failed to complete successfully.

Ausgabewert

When the step is completed, its output value is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table shows the step's output value:

AusgabeBeschreibungSyntax für ArcGIS Arcade-Ausdruck

<DerivedOutputParameterValue>

Gibt den vom Werkzeug erhaltenen konfigurierten abgeleiteten Ausgabewert zurück.

jobOutputValue($job, '<step_id>','<derived_output_parameter_name>')

Hinweis:

derived_output_parameter_name ist ein optionaler Parameter. Wenn kein Name eines abgeleiteten Ausgabeparameters angegeben wurde, wird der erste abgeleitete Ausgabewert zurückgegeben.

Verwandte Themen