Utilizar Survey123 con capas de entidades existentes

De forma predeterminada, cuando se publica una encuesta en ArcGIS Survey123 Connect, se crea una capa de entidades usando el esquema de la encuesta. Como alternativa, puede asociar su encuesta a una capa de entidades existente.

Preparar una capa de entidades

Para utilizar una capa de entidades con Survey123, debe ser un elemento en ArcGIS Enterprise o ArcGIS Online. Se incluyen las capas de entidades alojadas y las capas de entidades publicadas en servidores federados y no federados.

Nota:

Para trabajar con servicios de entidades no federados se requiere configuración adicional, ya que debe crear manualmente un elemento de la capa de entidades en su organización de ArcGIS que represente el servicio. Para obtener información detallada, consulte este artículo de la Base de conocimiento sobre cómo conectar con servicios de ArcGIS Server no federados.

El propietario y los usuarios de la encuesta deben tener acceso a la capa de entidades y esta debe ser editable. Además, tenga en cuenta:

  • Si los usuarios recopilan nuevas encuestas, se necesita la funcionalidad Create.
  • Si los usuarios editan encuestas existentes, se necesita la funcionalidad Update en la capa.
  • Si los usuarios recopilan imágenes, audio o archivos, es necesario establecer hasAttachments como true.

Las repeticiones no pueden hacer referencia a tablas o capas relacionadas a menos que la tabla o la capa secundaria utilice un campo GUID para la relación. Aunque no es obligatorio en las versiones de ArcGIS Server compatibles con Survey123, se recomienda usar un campo GUID para la relación en la capa secundaria.

Si prevé editar sus encuestas, asegúrese de que la capa de entidades permita los valores nulos o que la encuesta utilice campos obligatorios. Survey123 utiliza valores nulos en la edición si se elimina una respuesta sin sustituirla; por tanto, Survey123 no envía encuestas desde una capa de entidades que no permita los valores nulos.

Es necesario establecer como true las siguientes dos capacidades adicionales para la capa de entidades:

  • supportsAttachmentsByUploadId: esta funcionalidad se activa automáticamente cuando se habilitan adjuntos en la capa de entidades. Permite que la aplicación cargue todos los adjuntos asociados con una encuesta antes de enviarla. Si se produce un error en alguno de los adjuntos, se revierte todo el envío de la encuesta, evitando así la pérdida de datos.
  • supportsApplyEditsWithGlobalIds: la capa de entidades debe admitir la aplicación de ediciones con Id. globales. Permite que la aplicación cree y administre los Id. globales en entidades creadas (en lugar de que el servidor cree un nuevo Id. global para entidades creadas).

Para que una capa de entidades permita aplicar ediciones con Id. globales, se deben cumplir los siguientes requisitos:

  • Las capas de la capa de entidades deben tener una columna GlobalID con un índice único. La mejor forma de hacerlo es habilitar la sincronización al publicar la capa de entidades.
  • Si utiliza una geodatabase multiusuario, las capas pueden utilizar el versionado en rama, pero no el versionado tradicional. Survey123 dirigirá a la versión predeterminada si se utiliza una geodatabase versionada en rama. Para obtener más información, consulte Tipos de versionado.
  • La tabla o capa de entidades debe contener Id. globales antes de habilitar los adjuntos en cualquiera de ellas.
  • Si la capa de entidades contiene capas habilitadas para valores m, la edición sin valores m debe estar habilitada.

Para obtener información sobre cómo admitir la edición en una capa de entidades, consulte supportsApplyEditsWithGlobalIds en Capa (servicio de entidades) de la documentación de la API REST de ArcGIS.

Nota:

Survey123 solo admite relaciones GUID de uno a muchos al trabajar con capas de entidades existentes y tablas relacionadas. No se admiten las relaciones de uno a uno.

Crear una encuesta a partir de una capa de entidades

Puede crear una encuesta a partir de una capa de entidades existente en Survey123 Connect. Inicie sesión en su organización de ArcGIS y haga clic en Nueva encuesta. Elija la categoría Servicio de entidades. Busque y seleccione la capa de entidades que desee y haga clic en Crear encuesta. Se generará un XLSForm a partir de la capa de entidades. Puede publicar esta encuesta inmediatamente o personalizarla más. Por ejemplo, puede agregar más etiquetas descriptivas a las preguntas u organizarlas en grupos.

Si la capa de entidades que eligió tiene más de una capa, la encuesta se genera basándose en la primera capa. Para que la encuesta se base en otra capa de una capa de entidades, debe crear manualmente la encuesta y actualizar las propiedades form_id y submission_url de la pestaña settings de la hoja de cálculo. Para obtener más información, consulte la sección Crear una encuesta que coincida con una capa de entidades.

Nota:

Si la encuesta que está creando requiere preguntas de audio o archivo, debe agregarlas a la encuesta manualmente. Después de generar la encuesta, abra la hoja de cálculo y agregue las preguntas. Para obtener más información, consulte Preguntas sobre los elementos multimedia. La capa de entidades también debe tener habilitados los adjuntos.

Crear una encuesta que coincida con una capa de entidades

Puede crear manualmente una nueva encuesta que coincida con una capa de entidades existente, pero debe actualizar las propiedades form_id y submission_url en la pestaña settings de la hoja de cálculo para definir un vínculo entre la encuesta y el elemento de la capa de entidades en su portal o ArcGIS Online.

La propiedad form_id define explícitamente el nombre de la capa en la capa de entidades que utiliza la encuesta. Para obtener más información, consulte este artículo de la base de conocimientos sobre la forma de crear una encuesta que coincida con un servicio de entidades.

La propiedad submission_url es la dirección URL del elemento de capa de entidades.

Dirección URL de envío en el formulario de Survey123
Sugerencia:

Debe proporcionar la URL del elemento de capa de entidades, como se mostró anteriormente. Un error habitual es utilizar en su lugar la URL de la capa de entidades, lo cual no se admite.

Para crear esta dirección URL, debe concatenar el Id. de elemento con la Raíz de contenido del portal. El ejemplo de la imagen anterior muestra un vínculo a un elemento de ArcGIS Online; el vínculo al mismo elemento en un portal tiene este aspecto:

https://<host>:<port>/arcgis/sharing/rest/content/items/21a6c530b31a4523bdff7gg94c9c5d9a

Si necesita una encuesta que requiera algunos, pero no todos los campos de una capa de entidades existente, es recomendable generar una encuesta a partir de la capa de entidades (como se ha descrito en la sección anterior) y eliminar las preguntas que no se necesiten antes de publicar la encuesta. De este modo, las propiedades form_id y submission_url se crean automáticamente.