El paso Definir ubicación identifica dónde se debe realizar una tarea para un trabajo. La ubicación puede ser un punto, una línea o un polígono de un servicio de entidades existente, un proyecto de ArcGIS Pro o en un mapa web de la aplicación web ArcGIS Workflow Manager.
Si el paso se ejecuta en la aplicación web Workflow Manager y se elige Mapa como método de ubicación, el mapa web configurado en el paso aparece en la tesela del trabajo. Si el paso se ha configurado con ayuda para pasos, aparecerá en la parte inferior de la tesela del trabajo. Las capas seleccionables aparecen en el mapa y todas las capas adicionales, excepto la capa Ubicación del trabajo, son de solo lectura. Utilice el widget Administrar capas 
para cambiar la visibilidad de capas individuales y utilizar el widget Dibujar una entidad 
o Seleccionar entidades 
para definir la ubicación del trabajo.
Nota:
Si la ubicación del trabajo ya está definida, esta no se puede editar, pero se puede reemplazar dibujando o seleccionando nuevas entidades.
Si el paso se ejecuta en ArcGIS Pro y se elige Mapa como método de ubicación, la capa Ubicación del trabajo se agrega al mapa configurado en el paso cuando se ejecuta el paso y aparece el panel Crear entidades con la capa Ubicación del trabajo. Si el paso se ha configurado con ayuda para pasos, aparecerá en la parte inferior de la tesela del trabajo. Use el panel Crear entidades para definir la ubicación del trabajo.
El tipo de geometría utilizado para la ubicación del trabajo se basa en el tipo de geometría configurado en el paso. Tenga en cuenta las siguientes condiciones al definir la ubicación de un trabajo:
- Solo se pueden guardar como ubicación del trabajo las entidades con tipos de geometría de polígono, polilínea o multipunto. Las geometrías de curva no son compatibles.
- Las herramientas de construcción de polilíneas y polígonos Círculo, Elipse, Flujo, Mano alzada y Autocompletar a mano alzada no se pueden utilizar para definir la ubicación del trabajo.
- Si se seleccionan más de un polígono o varias entidades de línea del tipo de geometría correcto, la ubicación se guarda como una entidad multiparte.
- Al dibujar una ubicación en la aplicación web Workflow Manager se eliminan todas las selecciones existentes, y al seleccionar entidades se eliminan las ubicaciones dibujadas.
Si se elige Mapa como método de ubicación, se pueden realizar las siguientes acciones cuando se ejecuta el paso:
- Se puede definir la ubicación del trabajo.
- El paso se puede cancelar haciendo clic en Cancelar.
- El paso se puede finalizar haciendo clic en Continuar.
Si se elige Geometría como método de ubicación, la ubicación del trabajo se define automáticamente cuando se ejecuta el paso, y este se completa automáticamente. Si la geometría devuelta por una expresión de Arcade es nula o no es válida, el paso falla. Si el tipo de geometría devuelve una expresión de Arcade que no coincide con el tipo de geometría configurado en el paso, el paso fallará.
Configurar el paso
Para configurar el paso, haga lo siguiente:
- Cree o edite un diagrama de flujo de trabajo para acceder al panel Biblioteca de pasos.
- Arrastre Definir ubicación 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.
- Proporcione un nombre para el paso en el cuadro de texto Nombre de paso.
- 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. - Haga clic en la flecha desplegable Tipo de geometría y elija un tipo de selección de geometría para la ubicación del trabajo.
También puede usar expresiones de ArcGIS Arcade para proporcionar un valor dinámico.
- Elija una de las siguientes opciones:
- Mapa: permite que un usuario defina la ubicación del trabajo en un mapa.
- Geometría: define automáticamente la ubicación del trabajo utilizando coordenadas en formato JSON de Esri.
- Si ha elegido Mapa, siga estos pasos:
- Elija las opciones de Método de ubicación según sea necesario:
- Seleccionar: seleccione entidades existentes en el mapa.
- Dibujar: cree entidades con las herramientas de dibujo en ArcGIS Pro o los widgets de la aplicación web Workflow Manager.
- En la sección Mapa que se encuentra en Mapa web, haga clic en Agregar para agregar el mapa web con el que desee trabajar en la aplicación web Workflow Manager.
Aparece el cuadro de diálogo Paso Definir ubicación.
Nota:
Los mapas web no se pueden usar para definir una ubicación en ArcGIS Pro. Debe proporcionar el nombre del mapa con el que desea trabajar en un proyecto de ArcGIS Pro para definir una ubicación.
- Elija una de las siguientes opciones para especificar dónde se encuentra el mapa web:
- ArcGIS Online: agregue un mapa web ubicado en ArcGIS Online.
- Otros: agregue un mapa web público ubicado en un portal ArcGIS Enterprise.
- Si elige Otros, indique la dirección URL del portal que contiene el mapa web en el cuadro de texto Dirección URL del portal y pulse Intro.
Para ArcGIS Enterprise, utilice el formato https://webadaptorhost.domain.com/webadaptorname.
- Indique el Id. de elemento para el mapa web en el cuadro de texto Id. de elemento.
- Proporcione un nombre para el mapa web en el cuadro de texto Nombre de referencia.
- Haga clic en Aceptar.
La dirección URL del mapa web aparece en el panel Detalles del paso.
Nota:
El mapa web se puede editar haciendo clic en Editar, o se puede eliminar haciendo clic en Eliminar.
- Proporcione el nombre del mapa con el que desea trabajar en su proyecto de ArcGIS Pro en el cuadro de texto ArcGIS Pro.
- Si lo desea, si se ha configurado Habilitar búsqueda para su mapa web, proporcione una consulta de definición, un texto de búsqueda o una expresión de Arcade en el cuadro de texto Texto de búsqueda para acercarse a una extensión de mapa inicial cuando se ejecute el paso en la aplicación web Workflow Manager.
- Elija las opciones de Método de ubicación según sea necesario:
- Si elige Geometría, utilice los siguientes ejemplos para definir la ubicación del trabajo utilizando coordenadas en formato JSON de Esri.
Puede utilizar una cadena de caracteres, una expresión de Arcade o una combinación de ambas para definir la ubicación.
Defina una ubicación de punto mediante una cadena de caracteres JSON.
{"x" : -118.15, "y" : 33.80, "spatialReference" : {"wkid" : 4326}}Defina una ubicación de punto utilizando una expresión de Arcade.
'{"x":' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'testx') + ', "y":' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'testy') + ', "spatialReference" : {"wkid" : ' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'wkid') + "}}"Defina una ubicación de punto utilizando una expresión de Arcade que convierta las coordenadas de GeoJSON al formato JSON de Esri.
{GeoJsonToEsriJson(JobExtendedProperty($Job, 'assets', 'geojson'), 'Point'), "spatialReference" : {"wkid" : 4326}}Defina una ubicación utilizando el campo shape.
JobExtendedProperty($Job, '<table_name>','shape')Nota:
El campo shape es el nombre del campo utilizado para obtener la geometría de una tabla de propiedades extendidas.
La referencia espacial predeterminada es Web Mercator Auxiliary Sphere (wkid 3857). Si la geometría devuelta por la expresión de Arcade tiene una referencia espacial diferente, la ubicación se define y la referencia espacial se convierte a wkid 3857.
- Haga clic en la pestaña Opciones.
- 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.
- Manual: el paso se ejecuta manualmente.
- 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.
- También puede hacer clic en la pestaña Estilo para cambiar la forma y el color del paso.
- 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 figura el valor de salida del paso:
| Salida | Descripción |
|---|---|
<Location> | Devuelve la ubicación definida. |