El paso Ejecutar herramienta de geoprocesamiento de Pro ejecuta una herramienta de geoprocesamiento configurada, script de Python o modelo de ModelBuilder en ArcGIS Pro.
Cuando se ejecuta este paso, aparece el icono Iniciándose 
en la tesela de trabajo. Cuando se inicia la herramienta, aparece el icono Ejecutándose para indicar que la herramienta se está ejecutando.
Si alguno de los parámetros del paso se configura con expresiones de ArcGIS Arcade, estos se convierten a los valores adecuados antes de que la herramienta comience a ejecutarse.
Si la opción Visible en tiempo de ejecución está habilitada, la herramienta configurada en el paso abre en el panel Geoprocesamiento y le permite definir los valores de los parámetros antes de ejecutar la herramienta. Si se configuraron valores de parámetro predeterminados, estos aparecen al ejecutar el paso y se pueden invalidar. Si los valores Mensaje de usuario y Ayuda del paso no están configurados para el paso, el paso se completa automáticamente cuando se ejecuta.
Nota:
Si un valor de parámetro obtenido de una expresión de ArcGIS Arcade no es compatible con la herramienta, el paso fallará.
When the step is run, the following actions can be performed:
- Si la opción Visible en tiempo de ejecución está habilitada, se pueden proporcionar valores de parámetro y el paso se puede ejecutar haciendo clic en Ejecutar en el panel Geoprocesamiento.
- El paso se puede cancelar haciendo clic en Cancelar.
Nota:
En algunos casos, es posible que no pueda cancelar este paso después de que empiece a ejecutarse.
Configurar el paso
To configure the step, do the following:
- Create or edit a workflow diagram to access the Step Library panel.
- Arrastre Ejecutar herramienta de geoprocesamiento de Pro desde el panel Biblioteca de pasos a una flecha de conexión de un paso en el lienzo del flujo de trabajo.
The Step Details panel appears.
- Provide a name for the step in the Step Name text box.
- 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) + '.' - Elija el tipo de herramienta que desea ejecutar en la sección Argumentos:
- Caja de herramientas del sistema: herramientas de geoprocesamiento incluidas con ArcGIS Pro y cajas de herramientas importadas en un proyecto de ArcGIS Pro.
- Otra caja de herramientas: secuencias de comandos y herramientas de geoprocesamiento personalizadas.
- Realice una de las siguientes acciones:
Herramientas de la caja de herramientas del sistema
Escriba el alias de la caja de herramientas que contiene la herramienta que desea ejecutar en el cuadro de texto Alias de caja de herramientas.
El alias de la caja de herramientas se puede encontrar en la pestaña Python de la página de ayuda de la herramienta en la documentación de ArcGIS Pro.
Herramientas importadas a un proyecto de ArcGIS Pro
Escriba el alias de la caja de herramientas que contiene la herramienta que desea ejecutar en el cuadro de texto Alias de caja de herramientas.
Haga clic con el botón derecho en la caja de herramientas del panel Catálogo y luego haga clic en Propiedades para ver el alias de la caja de herramientas.
Secuencias de comandos y herramientas de geoprocesamiento personalizadas
Escriba la ruta completa a la caja de herramientas en el cuadro de texto Ruta de la caja de herramientas. La ruta a la caja de herramientas también puede hacer referencia a cajas de herramientas almacenadas en una geodatabase de archivos o en una geodatabase corporativa. La ruta debe ser accesible en ArcGIS Pro.
- Escriba el nombre de la herramienta que desea ejecutar en el cuadro de texto Nombre de la herramienta.
El nombre de la herramienta se puede encontrar en la pestaña Python de la página de ayuda de la herramienta en la documentación de ArcGIS Pro.
- Si lo desea, active la casilla de verificación Visible en tiempo de ejecución para permitir que los valores de los parámetros se definan cuando el paso se ejecuta en ArcGIS Pro.
- Haga clic en Agregar nuevo parámetro.
- Escriba el nombre del parámetro en el cuadro de texto Nombre del parámetro.
Los nombres de los parámetros de la herramienta se pueden encontrar en la pestaña Python de la página de ayuda de la herramienta de geoprocesamiento en la documentación de ArcGIS Pro.
- Si lo desea, haga clic en el botón Mostrar valor predeterminado
para definir el valor predeterminado del parámetro cuando se ejecuta el paso.- Elija una de las siguientes opciones:
- Valor: proporcione un valor estático.
- Expresión de Arcade: proporcione un valor dinámico usando una expresión de Arcade.
- Proporcione un valor predeterminado para la propiedad en el cuadro de texto Valor o Expresión de Arcade.
- Elija una de las siguientes opciones:
- Repita los pasos 9-11 para agregar más parámetros.
- Si lo desea, escriba el nombre del parámetro de salida derivada que desee utilizar como valor de salida cuando la herramienta termine de ejecutarse.
Los parámetros de salida derivadas de la herramienta se pueden encontrar en la pestaña Python de la página de ayuda de la herramienta en la documentación de ArcGIS Pro.
- SI lo desea, active la casilla de verificación Adjuntar registro de GP para guardar el historial de la herramienta como adjunto del trabajo.
- Si lo desea, proporcione el nombre de la carpeta en la que se almacenarán los registros en el cuadro de texto Carpeta.
El nombre de la carpeta no puede contener caracteres especiales.
Nota:
Si no se proporciona ningún nombre de carpeta, se crea automáticamente una carpeta denominada General.
- Click the Options tab.
- 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.
Nota:
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.
- Manual—Run the step manually.
- 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) + '.' - Optionally, click the Style tab to change the shape and color of the step.
- Optionally, click the About tab and provide a description for the step in the Step Description text box.
Nota:
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 values | Description |
|---|---|
| S000001 | The step completed successfully. |
F000001 | The step failed to complete successfully. |
Valor de salida
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:
| Salida | Descripción | Sintaxis de la expresión de ArcGIS Arcade |
|---|---|---|
<DerivedOutputParameterValue> | Devuelve el valor de salida derivada configurado recibido de la herramienta. | jobOutputValue($job, '<step_id>','<derived_output_parameter_name>') Nota:derived_output_parameter_name es un parámetro opcional. Si no se proporciona un nombre de parámetro de salida derivada, se devuelve el primer valor de salida derivada. |