Agregar y configurar Abrir elementos de proyecto de Pro

El paso Abrir elementos de proyecto de Pro le permite abrir proyectos o paquetes de proyectos existentes en ArcGIS Pro. Puede configurar los elementos que desee agregar al proyecto, como mapas, diseños, escenas, elementos de tarea y mapas web, para garantizar que el trabajo se esté realizando en los elementos correctos. Si el proyecto contiene elementos de representación cartográfica, las capas de datos pueden apuntar automáticamente a las versiones correspondientes de los datos específicas del trabajo.

Nota:

Si un paquete de proyecto se está usando para editar y sincronizar capas de réplicas sin conexión, el paquete de proyecto no se puede compartir con la opción Compartir fuera de la organización habilitada.

Al ejecutar el paso en ArcGIS Pro, los elementos definidos en el paso se abren en el proyecto de ArcGIS Pro especificado. Si el paso está configurado con la opción Ejecutar comando de ArcGIS Pro, el comando de add-in personalizado de ArcGIS Pro configurado en el paso se ejecuta al abrir el proyecto. Si el paso se ha configurado con la opción Ver Inspector de errores, el panel Inspector de errores aparece cuando se abre el proyecto y se agrega una capa con entidades de error al mapa en ArcGIS Pro. Cuando el paso se ha configurado con ayuda para pasos, dicha ayuda aparece en la parte inferior de la tesela del trabajo.

Cuando ejecuta el paso en la aplicación web de ArcGIS Workflow Manager, aparece el botón Descargar proyecto de ArcGIS Pro en la tesela del trabajo. Descargue el archivo .pitemx y haga doble clic en el archivo para abrir el proyecto en ArcGIS Pro. Si el paso está configurado con la opción Ejecutar comando de ArcGIS Pro, ArcGIS Pro ejecutará el comando de add-in personalizado configurado. Si el paso se ha configurado con la opción Ver Inspector de errores, el panel Inspector de errores aparece y se agrega al mapa una capa con entidades de error. Cuando el paso se ha configurado con ayuda para pasos, aparece en la parte inferior de la tesela del trabajo.

Precaución:

Antes de abrir el archivo .pitemx descargado en ArcGIS Pro, agregue una conexión de portal que contenga su elemento de flujo de trabajo.

El archivo .pitemx solo se puede utilizar una vez para abrir el proyecto en ArcGIS Pro. Para volver a abrir el proyecto, debe descargar un nuevo archivo .pitemx desde la tesela del trabajo en la aplicación web de Workflow Manager.

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

• El paso se puede pausar haciendo clic en Pausa.
• El paso se puede finalizar haciendo clic en Finalizar.

Nota:

Si el paso no es opcional, el paso se debe ejecutar o poner en pausa antes de que pueda finalizar.

Configurar el paso

Puede agregar paquetes de proyecto alojados en un portal de ArcGIS Enterprise, ArcGIS Online o un sistema de archivos. Puede configurar los elementos que desee agregar al proyecto, como mapas, diseños, escenas, mapas web y elementos de tarea. El orden de apertura de los elementos en ArcGIS Pro se define según el orden en que los agrega al 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 Abrir elementos de proyectos de Pro desde el panel Biblioteca de pasos a una flecha de conexión de un paso en el lienzo del flujo de trabajo.

   Más información sobre cómo agregar pasos a un diagrama de 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 y elija una expresión de Arcade para agregarla su cuadro de texto asociado.

5. En la sección Argumentos, haga clic en Editar.

   Aparece el cuadro de diálogo Paso de representación cartográfica de ArcGIS Pro.

6. En la sección Proyecto de Pro, elija una de las siguientes opciones para especificar dónde se encuentra el proyecto:
   • Actual: paquete de proyecto abierto actualmente en ArcGIS Pro.

     Más información sobre cómo abrir un proyecto en ArcGIS Pro

   • Portal: un paquete de proyecto alojado en un portal de ArcGIS Enterprise o ArcGIS Online.
   • Ruta de archivo: un paquete de proyecto alojado en un recurso compartido de archivos de red o en un sistema de archivos local.

     También puede usar expresiones de ArcGIS Arcade para proporcionar un valor dinámico.

7. Si elige Portal, elija una referencia de datos del proyecto de ArcGIS Pro en el menú desplegable Proyecto de Pro.
8. Si no tiene ningún proyecto de ArcGIS Pro asociado con el diagrama de flujo de trabajo, agregue una referencia de datos de proyecto de ArcGIS Pro:
   1. Haga clic en Agregar referencia de datos en el menú desplegable.

      Aparecerá el cuadro de diálogo Agregar referencia de datos.

   2. Agregue una referencia de datos de una de las maneras siguiente:
      • Buscar elemento: examine y elija de una lista de elementos en el portal actual.

        Sugerencia:

        Puede aplicar filtros y etiquetas a la búsqueda para ajustarla.

      • Introducir Id. de elemento manualmente: Elija el entorno donde se encuentra la referencia de datos y proporcione el Id. del elemento y el nombre de referencia en los cuadros de texto Id. del elemento y Nombre de referencia. Si elige Otro, proporcione la URL de la organización de ArcGIS que contiene la referencia de datos en el cuadro de texto URL del portal.

        El elemento es validado automáticamente por Workflow Manager y el tipo de referencia de datos se establece en la barra Tipo.

        Si la referencia de datos no puede validarse, debe proporcionar el Id. del elemento a una referencia de datos válida que esté en correlación con el tipo de referencia de datos establecido.

   3. Haga clic en Aceptar para guardar la referencia de datos o en Cancelar para salir.
9. Si elige Ruta de archivo, proporcione la ruta local o de red al paquete de proyecto en el cuadro de texto Ruta de archivo.
10. En la sección Abrir elementos, haga clic en Abrir nuevo elemento para agregar los elementos que desee abrir en el proyecto.

    Nota:

    Los elementos deben estar en el proyecto de ArcGIS Pro cuando se ejecute el paso, o el paso fallará.

11. Haga clic en la flecha desplegable Cambiar tipo de entrada y seleccione un tipo de entrada para el cuadro de texto Nombre:

    • Selección: elija de una lista de referencias de datos de ArcGIS Pro asociadas con el diagrama de flujo de trabajo. Si no tiene ninguna referencia de datos de ArcGIS Pro asociada al diagrama de flujo de trabajo, haga clic en Agregar referencia de datos de ArcGIS Pro.

      Elija el tipo de elemento en el menú desplegable Tipo de elemento de Pro y especifique un nombre para el elemento en el cuadro de texto Nombre de elemento de Pro.

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

    • Arcade: elija el tipo de elemento en el menú desplegable Tipo y especifique un valor dinámico para el nombre del elemento utilizando una expresión Arcade.
12. Si se utiliza el paso Crear versión en el diagrama de flujo de trabajo para crear una versión de los datos específica del trabajo, active la casilla Reasignar versión para reasignar capas de datos de elementos de representación cartográfica a la versión específica del trabajo cuando se ejecute el paso.

    Nota:

    La casilla Reasignar versión no está disponible para los elementos de tarea.

13. Opcionalmente, si el paso Crear réplica se utiliza en el diagrama de flujo de trabajo para editar capas de réplica, marque la casilla Sincronizar cambios de réplica para sincronizar los cambios cuando se abra el proyecto en ArcGIS Pro.

    La casilla de verificación Sincronizar cambios de réplica solo está disponible con las opciones de proyecto Portal y Ruta de archivo del proyecto de Pro.

14. Si lo desea, repita los pasos para agregar más elementos.

    Sugerencia:

    Para eliminar un elemento, mantenga el puntero en él y haga clic en Eliminar elemento .

15. Si lo desea, haga clic en la pestaña Finalizar y active la casilla Restablecer a los valores predeterminados para que las capas de datos del elemento de representación cartográfica vuelvan a su versión original cuando se complete el paso.

    Nota:

    La casilla Restablecer a los valores predeterminados no está disponible para los elementos de tarea.

16. De manera opcional, si elige Portal o Ruta de archivo como la configuración del Proyecto de Pro, active la casilla de verificación Cerrar proyecto de ArcGIS Pro para cerrar el proyecto cuando el paso se pone en pausa o se completa.

    Cuando el paso se pone en pausa o se completa, el proyecto se cierra y ArcGIS Pro permanece abierto para que pueda reanudar el paso o completar más pasos.

17. Opcionalmente, si utiliza el paso para editar capas de réplica en ArcGIS Pro, marque la casilla Sincronizar cambios de réplica para sincronizar las ediciones cuando el paso se pone en pausa o se completa.

    La casilla de verificación Sincronizar cambios de réplica solo está disponible con las opciones de proyecto Portal y Ruta de archivo del proyecto de Pro.

18. Si lo desea, haga clic en la pestaña Opciones avanzadas y configure las opciones según sea necesario.
    • Acercar a ubicación: acerca el mapa a la ubicación del trabajo si se define una ubicación para el trabajo.
    • Ver Inspector de errores: abre el panel Inspector de errores para revisar las entidades de error en el mapa.

      En el caso de las fuentes de datos de servicio de entidades, las capas de error se deben almacenar en el servicio y la fuente de datos debe ser una versión en rama con la capacidad de validación.

    • Ejecutar comando de ArcGIS Pro: ejecuta comandos de add-ins personalizados de ArcGIS Pro cuando se abren los elementos configurados en el paso. Elija un comando de ArcGIS Pro en el menú desplegable.

      Si no tiene ninguna referencia de datos de comandos de ArcGIS Pro asociada al diagrama de flujo de trabajo, haga clic en Agregar referencia de datos de ArcGIS Pro y especifique el nombre y el Id. del comando en los cuadros de texto Nombre del comando e Id. del comando.

      Si lo desea, haga clic en Agregar comando para agregar más comandos de ArcGIS Pro.

      Nota:

      Solo se pueden utilizar los Id. de comando de add-ins personalizados. Si se especifican varios comandos, los comandos se ejecutan en el orden en que están configurados en el paso.

      Más información sobre cómo mostrar los Id. de comando en la información en pantalla en ArcGIS Pro

19. Si lo desea, active Restringir ediciones a la ubicación del trabajo para restringir las ediciones a la ubicación del trabajo.
    1. Haga clic en la flecha desplegable Operador y elija una de las opciones siguientes:
       • Intersecar con la ubicación del trabajo: permite editar las entidades que intersecan con la ubicación del trabajo.
       • Completamente dentro de la ubicación del trabajo: permite editar las entidades que están completamente dentro de la ubicación del trabajo.
    2. Si lo desea, proporcione un valor en el cuadro de texto Zona de influencia para permitir las ediciones de entidades dentro de la distancia especificada de la ubicación del trabajo.

       También puede usar expresiones de ArcGIS Arcade para proporcionar un valor dinámico.

       Si la zona de influencia contiene una expresión Arcade, debe evaluarla a un entero.

20. Haga clic en Guardar.

    Nota:

    Guardar no está disponible cuando los parámetros se configuran con valores no válidos.

21. Haga clic en la pestaña Opciones.
22. 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 no se ejecutarán de forma automática. Se requiere el rol ArcGIS Workflow Manager Server Advanced 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

23. También puede activar la casilla de verificación Habilitado en la sección Comentarios del paso para permitir que un usuario agregue un comentario al paso cuando se ejecute el paso.
24. Si lo desea y ha habilitado los comentarios del paso, active la casilla de verificación Obligatorio en la sección Comentarios del paso para que sea obligatorio agregar un comentario al paso para que pueda completarse.
25. 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.

26. También puede hacer clic en la pestaña Estilo para cambiar la forma y el color del paso.
27. 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 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 retorno	Descripción
S000001	El paso se ha completado correctamente.
F000001	El paso no ha podido completarse correctamente.