Agregar y configurar Crear versión

Licencia:

Los miembros de su organización deben tener una licencia asignada para la extensión de tipo de usuario ArcGIS Advanced Editing para utilizar este paso.

El versionado permite que varios usuarios completen el trabajo con su propia versión de los datos espaciales, con el fin de que puedan conciliar y publicar sus ediciones en la versión en rama predeterminada. Esto garantiza que los usuarios acceden a los datos correctos en el momento adecuado, y evita conflictos de edición.

Cuando se ejecuta el paso, se comprueba cada una de las fuentes de datos del servicio de entidades definidas en el flujo de trabajo para una versión de los datos específica del trabajo existente. Si la fuente de datos no contiene una versión específica del trabajo, el paso Crear versión crea automáticamente una y la asocia al trabajo. El paso Crear versión solo admite la creación de una única versión de trabajo por servicio de entidades para las fuentes de datos definidas en el diagrama de flujo de trabajo del trabajo.

Cuando el paso termina de ejecutarse, aparece un mensaje en el título del trabajo con el resultado del paso.

Si no se ha definido una fuente de datos para este paso, o si el paso no logra crear versiones, aparece el mensaje CreateVersionFailed y el trabajo no continúa con el siguiente paso. Pase el cursor por encima del mensaje de error para ver más información sobre el error.

Si el paso falla, los códigos que se devuelven no coinciden con ninguna de las rutas configuradas y el paso no es opcional, el paso permanece en un estado de fallo y no se puede omitir.

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 Crear versión 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, proporcione un nombre para la versión en el cuadro de texto Nombre de la versión.

   Sugerencia:

   Para agregar un Id. único al nombre de la versión, escriba [índice] allí donde desea que aparezca el Id. único en el nombre de la versión.

5. Configure los niveles de permiso para las versiones en la sección Permisos de acceso según sea necesario.

   Nota:

   La configuración de los permisos de acceso le permite restringir que usuarios que no sean el propietario de la versión vean o editen versiones. La configuración predeterminada es Privado.

6. En la sección Fuentes de datos, elija una de las siguientes opciones:
   • Todas: elija esta opción para crear una versión para todas las fuentes de datos configuradas en el diagrama de flujo de trabajo.
   • Seleccionar fuentes: elija esta opción y haga clic en Agregar fuente para elegir las fuentes de datos para las que desea crear versiones.

     Sugerencia:

     Para eliminar una fuente de datos, haga clic en Eliminar .

   • Expresión de Arcade: elija esta opción y proporcione una expresión ArcGIS Arcade para referenciar dinámicamente la fuente de datos para la que se crearán versiones cuando se ejecute el paso.

     La expresión Arcade debe devolver el Id. de la fuente de datos espaciales y no el nombre de la fuente de datos espaciales. Si necesita elegir más de una fuente de datos, tendrá que dar formato a la expresión de la siguiente manera:

     '["' + JobExtendedProperty($Job, 'versions', 'datasource1') + '"' + ',' + '"' + JobExtendedProperty($Job, 'versions', 'datasource2') + '"]'

     Sugerencia:

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

7. Haga clic en la pestaña Opciones.
8. 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

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

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

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 figuran los valores de salida del paso:

Salida	Descripción
versiones	Devuelve una matriz con todas las versiones creadas.
dataSources	Devuelve una matriz con todas las direcciones URL de la fuente de datos para la que se crearon correctamente las versiones.
dataSourceNames	Devuelve una matriz con todos los nombres de las fuentes de datos de cada versión creada.