Además de enviar datos nuevos a una capa de entidades mediante una encuesta, puede que necesite editar los datos de la encuesta que ha enviado recientemente, que se recopilaron hace un tiempo o que han recopilado otros usuarios de la encuesta.
Habilitar edición
Las respuestas de la encuesta se pueden editar desde la carpeta Enviados y la Bandeja de entrada. Para habilitar la edición de una encuesta, la edición también debe estar habilitada para la capa de entidades subyacente.
Puede editar las encuestas enviadas previamente presentes en la carpeta Enviados de la aplicación de campo Survey123. Para obtener más información sobre cómo configurar opciones para encuestas enviadas, consulte Carpeta Enviados.
Para editar los datos existentes de la encuesta almacenados en la capa de entidades de la encuesta (por ejemplo, los datos recopilados por otro usuario), debe habilitar la bandeja de entrada.
Precaución:
Al habilitar la bandeja de entrada se proporciona acceso de lectura a los datos de la encuesta, con lo que las respuestas de la encuesta quedarán expuestas. Para obtener más información y prácticas recomendadas para proteger sus datos, consulte Compartir una encuesta.
Para habilitar la bandeja de entrada, vaya a la pestaña Opciones de la encuesta en Survey123 Connect y haga clic en Habilitar bandeja de entrada. Aparece una serie de opciones que permiten controlar cómo interactúan los usuarios con las encuestas en la Bandeja de entrada. Cualquier cambio en estas opciones se aplicará cuando se publique la encuesta.
Elija si las encuestas de la bandeja de entrada se pueden editar, ver (solo lectura) o copiar en una nueva encuesta. Puede escribir una expresión de consulta para limitar las encuestas que se devuelven en la Bandeja de entrada. También puede aplicar un filtro espacial.
Nota:
La Bandeja de entrada puede contener un máximo de 5000 respuestas de encuesta. Este límite se aplica solo a los registros de encuestas principales (no se aplica a las repeticiones).
Cuantos más registros haya para devolver, más tiempo llevará actualizar la Bandeja de entrada. En el caso de las encuestas que contienen repeticiones, tenga en cuenta que la cantidad total de registros que recupera la Bandeja de entrada cuando se actualiza puede ser mucho mayor que la cantidad de registros principales. Por ejemplo, si una capa de entidades contiene 2000 registros principales y cada registro principal tiene 10 registros repetidos, la Bandeja de entrada recuperará un total de 22.000 registros. Puede limitar el número de registros principales aplicando una expresión de consulta o un filtro espacial. Puede limitar el número de registros repetidos definiendo una consulta en la columna bind::esri:parameters.
Precaución:
Una respuesta de encuesta solo puede existir en un dispositivo en una carpeta a la vez. Cuando la carpeta Enviados y la Bandeja de entrada están habilitadas para una encuesta, la actualización de la bandeja de entrada no descarga las respuestas que ya están en la carpeta Enviados. Esto significa que si un usuario actualiza una respuesta que está en la carpeta Enviados en otro dispositivo, la respuesta actualizada no se descargará en la bandeja de entrada.
Por este motivo, se recomienda que no habilite la carpeta Enviados y la bandeja de entrada para la misma encuesta si la intención es que varios usuarios editen y actualicen continuamente las respuestas existentes.
Expresiones WHERE
Las encuestas disponibles para editar en la bandeja de entrada en la aplicación de campo Survey123 están determinadas por la expresión de consulta especificada en la pestaña Opciones de su encuesta en Survey123 Connect. La encuesta debe publicarse cada vez que se modifique esta consulta para que los cambios surtan efecto.
Las expresiones de consulta deben utilizar funciones y sintaxis SQL comunes compatibles con ArcGIS. Todas las consultas se ejecutan en la capa de entidades de la encuesta, por lo que puede crear y probar su expresión utilizando la operación de consulta en el punto final REST de la capa de entidades. Para obtener más información sobre este proceso y consultar ejemplos de sintaxis de consultas, consulte Consulta (Servicio de entidades). Para obtener más información sobre las funciones compatibles, consulte Funciones SQL estandarizadas en ArcGIS Online.
A continuación, se muestran ejemplos de caso de uso y sintaxis:
- Este ejemplo devuelve las encuestas en las que el número del campo rating es mayor o igual que dos:
rating>=2
- Este ejemplo devuelve encuestas en las que la fecha del campo EditDate es el 13 de abril de 2017 o posterior:
EditDate>='2017-4-13'
- Este ejemplo devuelve encuestas en las que el campo Editor es igual a 'BKlauser':
Editor='BKlauser'
- Este ejemplo devuelve encuestas en las que el campo status es igual a 'for_review':
status='for_review'
- Este ejemplo devuelve encuestas en las que la fecha del campo inspection_date corresponde a los últimos siete días:
inspection_date>CURRENT_DATE-7 AND inspection_date<=CURRENT_DATE
- Este ejemplo devuelve encuestas en las que el campo project_status no es igual a 'completo':
project_status<>'complete'
- Este ejemplo devuelve encuestas en las que el campo final_approval está en blanco (nulo):
final_approval IS NULL
- Este ejemplo devuelve encuestas en las que el campo final_approval no está en blanco (nulo):
final_approval IS NOT NULL
Las consultas de la bandeja de entrada también admiten la variable username. Esta variable debe especificarse en el mismo formato que las expresiones XLSForm. Por ejemplo, la consulta Creator=${username} devolverá todos los registros de encuestas creados por el usuario que tiene la sesión actualmente iniciada.
Nota:
La variable username es el único caso en que la sintaxis XLSForm puede utilizarse en una expresión de consulta de la bandeja de entrada. Aunque la variable username debe escribirse como ${username}, su valor se deriva de la cuenta de ArcGIS con la que el usuario inicia sesión, en lugar de derivarse de una pregunta de la encuesta.
Para devolver registros del usuario que ha iniciado sesión desde un campo que contiene una lista de múltiples usuarios, es preciso utilizar la función POSITION() en la consulta. Por ejemplo, la consulta POSITION(${username} IN assigned_to) > 0 devolvería todos los registros de encuestas que incluyen el usuario que ha iniciado sesión en los que los valores del campo assigned_to pueden ser una lista de posibles usuarios asignados separados por comas, como 'George_Smith, Nick_Jones'.
Filtro espacial
En la Bandeja de entrada, al seleccionar Actualizar se actualiza la lista de encuestas que se muestra en la pestaña Lista. La acción de actualización suele devolver todas las encuestas que coinciden con la expresión de consulta de la Bandeja de entrada (si se ha definido) y que aún no están almacenadas en otras carpetas del dispositivo. Al seleccionar Actualizar en la pestaña Mapa, se puede aplicar un filtro espacial para actualizar la lista y mostrar solo las encuestas que están dentro de la extensión de mapa actual.
Para habilitar el filtro espacial, seleccione Aplicar filtro espacial cuando la pestaña del mapa esté visible en la pestaña Opciones de Survey123 Connect. En el siguiente ejemplo, cuando se selecciona Actualizar, la lista de encuestas se actualiza para mostrar solo las cuatro respuestas a la encuesta visibles en la extensión de mapa actual. Si la encuesta tiene establecido un nombre de instancia, cada entidad del mapa se etiqueta con su nombre de instancia.
Repeticiones
Survey123 permite editar las entidades que presentan registros relacionados, ya sea desde la Bandeja de entrada o la carpeta Enviados. Es posible agregar nuevos registros y editar los registros existentes, si bien no se admite la eliminación de registros existentes. La edición de registros existentes está desactivada de forma predeterminada, a menos que se active allowUpdates=true mediante un parámetro de consulta.
La columna bind::esri:parameters puede usarse para suministrar parámetros opcionales para una repetición. Estos parámetros se formatean como pares de clave y valor cuyos valores contienen espacios entrecomillados.
De forma predeterminada, no hay ningún registro relacionado disponible junto con las respuestas a la encuesta desde la Bandeja de entrada ni la carpeta Enviados. Para acceder a los registros relacionados de una respuesta, defina una consulta en la columna bind::esri:parameters para la pregunta de tipo begin repeat. La propiedad de consulta admite los mismos parámetros que las expresiones WHERE indicadas arriba, por ejemplo, query="Editor='BKlauser'", para descargar únicamente los registros relacionados con 'BKlauser' en el campo Editor.
Para descargar todos los registros de una tabla relacionada, especifique una consulta sin ningún parámetro (query).
Los parámetros que pueden aplicarse a las repeticiones a través de la columna bind::esri:parameters en una pregunta de tipo begin repeat son los siguientes:
- query: permite consultar y descargar registros a la tabla correspondiente, por ejemplo, query="severity='high'".
- allowAdds: permite agregar nuevos registros a la repetición durante la edición. El valor predeterminado es true. Puede cambiarse a false mediante allowAdds=false.
- allowUpdates: permite actualizar los registros existentes en una repetición durante la edición. El valor predeterminado es falso. Puede cambiarse a true mediante allowUpdates=true.
Es posible usar varios pares de clave y valor a la vez, separándolos por espacios; por ejemplo, allowUpdates=true query="Editor='BKlauser'". Si estos valores contienen espacios, es posible entrecomillarlos.
Imágenes
Survey123 permite al usuario agregar imágenes a los registros de encuesta existentes. Mientras que no se admite la edición de imágenes existentes, cada pregunta de imagen proporciona un botón Duplicar cuando se edita una encuesta para copiar una imagen existente que se puede editar por rotación, cambio de nombre o edición con las apariencias draw y annotate.
La opción de proporcionar nuevas imágenes está habilitada de forma predeterminada. Para deshabilitar esta funcionalidad, escriba allowAdds=false en la columna bind::esri:parameters.
Existen algunas limitaciones conocidas a la hora de editar imágenes:
- Los flujos de trabajo sin conexión no son compatibles.
- El aspecto signature no admite la función Duplicar.
- Los adjuntos de imagen utilizan propiedades de palabras clave para asociar una imagen con la pregunta para las que se enviaron. Las propiedades de palabra clave no son compatibles con versiones de ArcGIS Enterprise anteriores a la 10.8.1, por lo que una imagen enviada a una encuesta publicada en un portal de ArcGIS Enterprise anterior a la versión 10.8.1 no se asociará a una pregunta. Del mismo modo, es posible que las imágenes adjuntas a una entidad a través de un método distinto de una encuesta (por ejemplo, en ArcGIS Pro o un mapa web de ArcGIS Online) no tengan palabras clave.
- Cuando se descarga una encuesta actual en un dispositivo para usarlo desde la bandeja de entrada, las imágenes existentes no se descargan. La función count-selected solo contará las imágenes que estén en el dispositivo y devolverá 0 cuando se abra la encuesta por primera vez. Se contarán las nuevas imágenes capturadas.