El paso Definir ubicación le permite identificar 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, en 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 selección, el mapa web configurado en el paso aparece en la tesela del trabajo. Si se ha configurado texto de ayuda para este paso, este aparece 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 selecció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 se ha configurado texto de ayuda para este paso, este aparece 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 las entidades con el tipo de geometría correcto se pueden guardar como 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 selección, se pueden realizar las siguientes acciones cuando se ejecuta el paso:
- Se puede definir la ubicación del trabajo.
- The step can be cancelled by clicking Cancel.
- The step can be finished by clicking Proceed.
Si se elige Arcade como método de selecció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 la expresión de Arcade es nula o no es válida, el paso falla. Si el tipo de geometría devuelto por la expresión de Arcade no coincide con el tipo de geometría configurado en el paso, el paso fallará.
Configurar el paso
To configure the step, do the following:
- Create or edit a workflow diagram to access the Step Library panel.
- 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.
The Step Details panel appears.
- Provide a name for the step in the Step Name text box.
- Optionally, add the message you want to appear when the step is run in the User Prompt text box.
You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:
'This job is currently assigned to ' + jobOwner($job) + '.' - 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.
- 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:
- Esta empresa: agregue un mapa web que esté disponible en el mismo portal que Workflow Manager.
- ArcGIS Online: agregue un mapa web público ubicado en ArcGIS Online.
- Otros: agregue un mapa web público ubicado en otro portal.
- Si elige Otros, escriba la dirección URL del portal que contiene el mapa web en el cuadro de texto Dirección URL del portal y pulse Intro.
Por ejemplo, https://webadaptorhost.domain.com/webadaptorname.
- Escriba 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.
- Click the Options tab.
- Configure Step Options as necessary.
- Manual—Run the step manually.
- Optional—Allow the step to be finished without being run.
- Automatic—Run the step as soon as it becomes active.
Nota:
If your workflow diagram is configured to automatically run a sequence of steps that includes the Evaluate Data Quality or the Run GP Service step, steps that attempt to run after the user token that started the sequence of steps expires will not run automatically. You must have a license for the ArcGIS Workflow Manager Server Advanced role to continue running the additional automated steps without manual intervention.
- Run on a Schedule—Run the step according to a schedule you set.
- Manual—Run the step manually.
- Optionally, provide help text for the step in the Step Help text box.
You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:
'For further assistance, please contact ' + jobCreator($job) + '.' - Optionally, click the Style tab to change the shape and color of the step.
- Optionally, click the About tab and provide a description for the step in the Step Description text box.
Nota:
The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.
Return value
When the step is completed, its return value is stored to indicate the result of the step. The return value can be immediately evaluated using paths to determine the next steps in the workflow. You can also retrieve the return value for completed steps throughout the workflow using ArcGIS Arcade expressions. The following table lists the step's return values:
| Return values | Description |
|---|---|
| S000001 | The step completed successfully. |
F000001 | The step failed to complete successfully. |
Valor de salida
When the step is completed, its output value is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table shows the step's output value:
| Salida | Descripción | Sintaxis de la expresión de ArcGIS Arcade |
|---|---|---|
<Location> | Devuelve la ubicación definida. | jobOutputValue($job, '<step_id>') |