Preparar la edición datos existentes de la encuesta

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

De forma predeterminada, puede editar cualquier encuesta enviada previamente que exista en el cuadro Enviados de la aplicación de campo Survey123. Para obtener más información sobre cómo configurar opciones para encuestas enviadas, consulte la Bandeja 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.

Nota:

Para habilitar la edición de la encuesta, la edición también debe estar habilitada para la capa de entidades subyacente.

Para habilitar la Bandeja de entrada, vaya a la pestaña Opciones de la encuesta en Survey123 Connect y haga clic en Habilitar carpeta 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.

Edición de la encuesta habilitada en

Elija si las encuestas de la Bandeja de entrada se pueden ver (solo lectura), editar 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 elegir aplicar un filtro espacial.

Sugerencia:

A partir de Survey123 versión 3.13, la bandeja de entrada se puede utilizar para encuestas públicas.

Precaución:

Cuando la casilla Enviados y la Bandeja de entrada están habilitadas para una encuesta, la actualización de la Bandeja de entrada no descarga las respuestas actualmente en la casilla Enviados. Esto significa que, si otro usuario ha actualizado una respuesta actualmente en la casilla Enviados, esta respuesta actualizada no se descarga.

Por este motivo, se recomienda que no habilite la casilla 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 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'

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.

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.

Pestaña Mapa del filtrado espacial

Repeticiones

Survey123 permite editar las entidades que presentan registros relacionados, ya sea desde la Bandeja de entrada o la casilla 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 bandeja Enviado. 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 3.13 y versiones posteriores permiten al usuario agregar imágenes a los registros de la 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, introduzca allowAdds=false en la columna bind::esri:parameters.

Existen algunas limitaciones conocidas a la hora de editar imágenes:

  • La apariencia signature no es compatible.
  • Los flujos de trabajo sin conexión no son compatibles.
  • 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.