El paso Survey123 le permite recopilar, ver y editar encuestas de ArcGIS Survey123 en ArcGIS Workflow Manager.
El paso Survey123 requiere que se cree una tabla de propiedades extendidas desde el formulario de la encuesta para asociar los datos de la encuesta con los trabajos. Cuando se envía una encuesta, la tabla de propiedades extendidas asociada se rellena con los datos recopilados por la encuesta. Si no se crea una tabla de propiedades extendidas a partir del formulario de la encuesta, es posible recopilar encuestas, pero los trabajos no podrán acceder a los datos recopilados.
Sugerencia:
Para ver o editar datos de encuestas recopilados fuera de su flujo de trabajo, cree una tabla de propiedades extendidas a partir del formulario de la encuesta. Agregue el paso Actualizar propiedades del trabajo antes del paso Survey123 en su diagrama de flujo de trabajo y actualice el Id. de vínculo en la tabla de propiedades extendidas con el globalid de una encuesta existente.
Cuando el paso se ejecuta en la aplicación web Workflow Manager, la encuesta configurada en este paso aparece en la tesela de trabajo. Cuando el paso se ejecuta en ArcGIS Pro, aparece el botón Abrir en la web en la tesela de trabajo que abre la encuesta configurada en el paso de la aplicación web Workflow Manager. Si se ha configurado texto de ayuda para este paso, este aparece en la parte inferior de la tesela de trabajo.
Nota:
El usuario que ejecuta el paso debe tener suficientes privilegios en Survey123 para ver, editar o enviar el formulario de la encuesta configurado en este paso.
Precaución:
Cuando la encuesta configurada en el paso no se aloja en el mismo portal de ArcGIS Enterprise que ArcGIS Workflow Manager Server, se recomienda iniciar sesión en la aplicación web Workflow Manager y en Survey123 utilizando diferentes navegadores web. Si ha iniciado sesión en varios portales en el mismo navegador web cuando se ejecuta el paso, se utilizarán las credenciales de Survey123 para acceder a la encuesta en lugar de sus credenciales de Workflow Manager.
When the step is run, the following actions can be performed:
- La encuesta configurada se puede enviar, ver o editar.
- The step can be cancelled by clicking Cancel.
- The step can be finished by clicking Proceed.
Configurar el paso
To configure the step, do the following:
- Create or edit a workflow diagram to access the Step Library panel.
- Arrastre Survey123 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.
- En la sección Formulario de Survey123, haga clic en Agregar formulario de Survey123.
Aparece el cuadro de diálogo Agregar formulario de Survey123.
- Elija una de las siguientes opciones para especificar dónde se encuentra el formulario de Survey123:
- Esta empresa: agregue una encuesta que esté disponible en el mismo portal que Workflow Manager.
- ArcGIS Online: agregue una encuesta pública ubicada en ArcGIS Online.
- Otros: agregue una encuesta pública ubicada en otro portal.
- Si elige Otros, escriba la dirección URL del portal que contiene la encuesta en el cuadro de texto Dirección URL del portal y pulse Intro.
Por ejemplo, el formato puede ser https://webadaptorhost.domain.com/webadaptorname.
- Escriba el Id. del formulario para la encuesta en el cuadro de texto Id. de formulario.
- Proporcione un nombre para la encuesta en el cuadro de texto Nombre de referencia.
- Haga clic en Aceptar.
La encuesta aparece en el panel Detalles del paso.
Nota:
Puede eliminar una encuesta haciendo clic en el botón Eliminar encuesta
. - Haga clic en el botón de alternancia Relación para cambiar entre una relación de encuesta de uno a uno (1-1) o una relación de encuesta de uno a muchos (1-M) con los trabajos de Workflow Manager.
- 1-1: establezca la relación de uno a uno para permitir que solo se asocie una encuesta con un trabajo.
- 1-M: establezca la relación de uno a muchos para permitir que varias encuestas se asocien con un trabajo.
- Elija una de las siguientes opciones como la configuración de Modo:
- Crear nueva: cree y recopile una encuesta.
Nota:
Esta opción solo está disponible para encuestas que tengan una relación de uno a muchos (1-M).
- Editar: edite una encuesta.
Nota:
Si no existe ninguna encuesta para el trabajo, se crea y recopila una encuesta. Si la encuesta está configurada con una relación de uno a muchos (1-M), se edita la última encuesta recopilada.
- Ver: vea una encuesta.
Nota:
Si la encuesta está configurada con una relación de uno a muchos (1-M), se abrirá la última encuesta recopilada para su visualización.
- Crear nueva: cree y recopile una encuesta.
- 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. |
Valores 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 | ArcGIS Arcade sintaxis de expresión |
|---|---|---|
<GlobalID> | Devuelve el globalid de la encuesta que se creó, visualizó o editó por última vez. | jobOutputValue($job, '<step_id>') |