Agregar y configurar Ejecutar servicio GP

El paso Ejecutar servicio GP ejecuta un servicio de geoprocesamiento configurado. El paso puede utilizarse para ejecutar herramientas de geoprocesamiento, herramientas de script de Python y modelos de ModelBuilder que se hayan publicado en un portal de ArcGIS Enterprise como servicios.

Cuando se ejecuta el paso, aparece el icono Iniciando Starting en la tesela del trabajo. Cuando se inicia el servicio, aparece el icono Ejecutando Running para indicar que el servicio de geoprocesamiento 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 está habilitada, el paso le permite definir los valores de los parámetros antes de iniciar el servicio de geoprocesamiento. Si se configuraron valores predeterminados para los parámetros, aparecen al ejecutar el paso y se pueden invalidar. Los parámetros requeridos se resaltan en rojo.

Si el paso se ejecuta correctamente, aparece el icono Paso completo Step Complete. Si el paso falla, aparece el icono Error en el paso de geoprocesamiento Step Failed.

Nota:

Si el valor de un parámetro obtenido de una expresión de ArcGIS Arcade no es compatible con el servicio de geoprocesamiento, el paso fallará.

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

  • Si la opción Visible está habilitada, se pueden proporcionar valores de parámetro y el paso se puede ejecutar haciendo clic en Continuar.
  • El paso puede cancelarse haciendo clic en Cancelar paso Cancel Step.
    Nota:

    Es posible que no pueda cancelar este paso después de que empiece a ejecutarse.

  • El paso se puede finalizar haciendo clic en Completar paso Complete Step.

Configurar el paso

Haga lo siguiente para configurar el paso:

  1. Cree o edite un diagrama de flujo de trabajo para acceder al panel Biblioteca de pasos.
  2. Arrastre Ejecutar servicio GP desde el panel de la 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. Indique la URL del servicio de geoprocesamiento en el cuadro de texto URL de servicio de GP.
  5. De manera opcional, desactive la casilla de verificación Proteger si el servicio de geoprocesamiento no está protegido y no requiere que se proporcione un token en la solicitud.
  6. Haga clic en Editar en la sección Argumentos.

    Aparece el cuadro de diálogo Descripción de pasos.

  7. Configure los valores de los parámetros en los cuadros de texto de Valor de parámetro según sea necesario.

    Para utilizar expresiones ArcGIS Arcade para valores de parámetros, haga clic en la flecha desplegable Cambiar tipo de entrada y elija el tipo de entrada para el cuadro de texto Valor de parámetro asociado. Esta opción no está disponible para los valores de cadena de caracteres.

    Sugerencia:

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

  8. Opcionalmente, active la casilla de verificación Visible junto a un parámetro para permitir que su valor se establezca cuando se ejecute el paso en ArcGIS Pro.
  9. Actualice el valor Medición final si es necesario.
  10. Haga clic en la pestaña Opciones.
  11. 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 Evaluar calidad de datos o Ejecutar servicio GP, los pasos que se intenten ejecutar después de que caduque el token de usuario que inició la secuencia de pasos no se ejecutarán de forma automática. Debe tener una licencia para que el rol de ArcGIS Workflow Manager Server Advanced siga ejecutando más pasos automáticos 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

  12. 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, tendrá que formatear el 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 ejecutados 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, deberá formatear el texto como se indica a continuación:

      
      '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:

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

  13. También puede hacer clic en la pestaña Estilo para cambiar la forma y el color del paso.
  14. 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:

Nombre de campo de valor de salidaDescripción

<GeoprocessingServiceOutput>

Devuelve todos los valores de salida recibidos desde el servicio de geoprocesamiento.

Temas relacionados