Agregar y configurar Ejecutar herramienta de geoprocesamiento de Pro

El paso Ejecutar herramienta de geoprocesamiento de Pro ejecuta una herramienta configurada, un script de Python o un modelo de ModelBuilder en ArcGIS Pro.

Cuando se ejecuta el paso, aparece el icono Iniciando Starting en la tesela del trabajo. Cuando se inicia la herramienta, aparece el icono Ejecutándose Running para indicar que la herramienta se está ejecutando.

Si alguno de los parámetros de paso se configura con una expresión de ArcGIS Arcade, se convierten a los valores adecuados antes de que se ejecute el servicio de geoprocesamiento.

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 no se han configurado los valores de Mensaje de usuario y Ayuda del paso 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 Arcade no es compatible con la herramienta, el paso fallará.

Cuando el paso se ejecuta, pueden realizarse las siguientes acciones:

  • 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 se ejecute.

Configurar el paso

Para configurar el paso, haga lo siguiente:

  1. Cree o edite un diagrama de flujo de trabajo para acceder al panel Biblioteca de pasos.
  2. 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.

    Aparece el panel Detalles del paso.

  3. Proporcione un nombre para el paso en el cuadro de texto Nombre de paso.
  4. Si lo desea, agregue el mensaje que desea que aparezca cuando se ejecute el paso en el cuadro de texto Indicación al usuario.

    Si el mensaje de usuario contiene texto sin formato y expresiones de ArcGIS Arcade, formatee el texto de la siguiente manera:

    'This job is currently assigned to ' + JobOwner($Job) + '.'
    Sugerencia:

    Haga clic en La entrada admite expresiones de Arcade This input supports Arcade expressions y elija una expresión de Arcade para agregarla su cuadro de texto asociado.

  5. 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 o cajas de herramientas importadas en un proyecto de ArcGIS Pro.
    • Otra caja de herramientas: secuencias de comandos y herramientas de geoprocesamiento personalizadas.
  6. Si elige Caja de herramientas del sistema, elija un alias de caja de herramientas en el menú desplegable Alias de caja de herramientas.

    Para hacer referencia a un alias de caja de herramientas con una expresión Arcade, haga clic en la flecha desplegable Cambiar tipo de entrada y luego en Arcade.

  7. Si no tiene ninguna caja de herramientas asociada con el diagrama de flujo de trabajo, agregue una referencia de datos de ArcGIS Pro:
    1. Haga clic en Agregar referencia de datos de ArcGIS Pro en el menú desplegable Alias de herramienta de datos.

      Se abre el cuadro de diálogo Agregar referencia de datos de ArcGIS Pro con la casilla Tipo de elemento Pro establecida en Caja de herramientas del sistema.

    2. Introduzca en el cuadro de texto Alias de caja de herramientas de Pro el alias de una caja de herramientas del sistema o una caja de herramientas importada en un proyecto de ArcGIS Pro que contenga la herramienta que desea ejecutar.

      El alias de la caja de herramientas de una caja de herramientas del sistema se puede encontrar en la pestaña Python de la página de ayuda de la herramienta en la documentación de ArcGIS Pro.

      Para ver el alias de una caja de herramientas importad en un proyecto de ArcGIS Pro, haga clic con el botón derecho en el panel Catálogo y luego haga clic en Propiedades.

    3. Haga clic en Aceptar para guardar la referencia de datos de ArcGIS Pro o en Cancelar para salir.

      El alias de la caja de herramientas aparece en el menú desplegable Alias de caja de herramientas.

      Más información sobre cómo administrar las referencias de datos

  8. Si elige Otra caja de herramientas, especifique 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 puede hacer referencia a cajas de herramientas almacenadas en una geodatabase de archivos o en una geodatabase corporativa. La ruta debe ser accesible desde ArcGIS Pro.

  9. Especifique 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.

    Para hacer referencia a un nombre de herramienta con una expresión Arcade, haga clic en la flecha desplegable Cambiar tipo de entrada y luego en Arcade.

    Nota:

    Si el nombre de la herramienta de geoprocesamiento en el cuadro de texto Nombre de la herramienta coincide con el nombre de una función de Arcade, por ejemplo, Zona de influencia o Recortar, especifique el nombre de la herramienta entre comillas simples o dobles para que no se considere como una expresión de Arcade.

    Más información sobre el uso de nombres de herramientas de geoprocesamiento que coinciden con expresiones Arcade

  10. 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.
  11. Haga clic en Agregar nuevo parámetro.
  12. Especifique 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.

  13. También puede hacer clic en Mostrar valor predeterminado Show Default Value para definir el valor predeterminado del parámetro cuando se ejecute el paso y proporcionar un valor predeterminado para la propiedad en el cuadro de texto Valor o Expresión Arcade.
    • Valor: proporcione un valor estático.
    • Expresión de Arcade: proporcione un valor dinámico usando una expresión de Arcade.
  14. Si lo desea, repita los pasos del 11 al 13 para agregar más parámetros.
  15. Si lo desea, proporcione en el cuadro de texto Valor de retorno 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.

  16. Si lo desea, active la casilla de verificación Adjuntar registro de GP para guardar el historial de la herramienta como adjunto del trabajo.
    Nota:

    Cuando la casilla de verificación Adjuntar registro de GP está activada, el Id. de adjunto del registro del historial de la herramienta se incluye en los valores de salida del paso.

  17. 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 una ruta de sistema de archivos ni caracteres especiales. Si no se proporciona un nombre de carpeta, se crea automáticamente una carpeta denominada General.

    Nota:

    La carpeta está contenida dentro del elemento de flujo de trabajo y no es una ruta de sistema de archivos.

  18. Haga clic en la pestaña Opciones.
  19. Configure Opciones de pasos según sea necesario.
    • Manual: el paso se ejecuta manualmente.
      • Opcional: se permite finalizar el paso sin haberlo ejecutado.
    • Automático: el paso se ejecuta tan pronto como se activa.
      Nota:

      Si el diagrama del flujo de trabajo se configura para que se ejecute automáticamente una secuencia de pasos que incluya el paso Ejecutar servicio GP, los pasos que se intenten ejecutar después de que caduque el token de usuario no se ejecutarán de forma automática. Se requiere la extensión Advanced de organización de ArcGIS Workflow Manager para ejecutar pasos automatizados adicionales sin intervención manual.

    • Ejecutar según programa: ejecute el paso según un programa establecido.

      Más información sobre las opciones de programación

  20. Opcionalmente, elija una de las siguientes opciones para configurar la ayuda en el paso:
    • Ninguno: configure el paso sin ayuda de pasos.
    • Texto: configure el texto de ayuda para el paso en el cuadro de texto Texto.

      Puede usar expresiones de ArcGIS Arcade para proporcionar un valor dinámico para la ayuda del paso. Si la ayuda del paso contiene texto sin formato y expresiones de Arcade, asigne formato al texto del siguiente modo:

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

    • URL: configure el paso con un vínculo a un recurso de ayuda en el cuadro de texto URL.
      Nota:

      Los pasos que se ejecutan en la aplicación web solo admiten los formatos URL HTTP y HTTPS. Los pasos que se ejecutan en ArcGIS Pro admiten los formatos de archivo, HTTP y HTTPS.

      También puede usar expresiones de Arcade para proporcionar un valor dinámico. Si la URL contiene texto sin formato y expresiones de Arcade, formatee el texto de la siguiente manera:

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

      Configure la casilla de verificación Codificar automáticamente el resultado de Arcade del siguiente modo:

      • Si una expresión de Arcade devuelve caracteres especiales que deben ser de escape al convertirlos en una URL, como un espacio o una barra diagonal, asegúrese de que la casilla de verificación Codificar automáticamente el resultado de Arcade está activada.
      • Si se utiliza una expresión Arcade para formar la URL base, desmarque la casilla de verificación Codificar automáticamente el resultado de Arcade.

  21. También puede hacer clic en la pestaña Estilo para cambiar la forma y el color del paso.
  22. Si lo desea, haga clic en la pestaña Acerca de y proporcione una descripción para el paso en el cuadro de texto Descripción del paso.
    Sugerencia:

    La pestaña Acerca de también contiene un Id. del paso que puede utilizarse con propiedades del paso dinámico para obtener una salida del paso. Haga clic en Copiar Id. del paso Copy Step ID para copiar el Id. del paso en el portapapeles.

Valor de retorno

Cuando el paso se completa, el valor de retorno se almacena para indicar el resultado del paso. El valor de retorno puede evaluarse de inmediato utilizando rutas para determinar los pasos siguientes del flujo de trabajo. También puede recuperar el valor de retorno correspondiente a los pasos completados por medio del flujo de trabajo utilizando las expresiones de ArcGIS Arcade. En la tabla siguiente figuran los valores de retorno del paso:

Valor de retornoDescripción

S000001

El paso se ha completado correctamente.

F000001

El paso no ha podido completarse correctamente.

Valor de salida

Cuando el paso se completa, su valor de salida se almacena y se puede utilizar para determinar la ruta que sigue el flujo de trabajo o puede usarse como entradas para otros pasos del flujo de trabajo. En la tabla siguiente figura el valor de salida del paso:

SalidaDescripción

<DerivedOutputParameterValue>

Devuelve el valor de salida derivada configurado recibido de la herramienta.

attachmentId

Devuelve un conjunto de Id. de adjunto agregados al paso.

Temas relacionados