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 su 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 tratarse de una capa alojada de ArcGIS Enterprise o ArcGIS Online.

Nota:

Para trabajar con servicios de entidades no federados se requiere configuración adicional, ya que necesitará 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 conocimientos 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 principal.

Si prevé editar sus encuestas, asegúrese de que su capa de entidades permita los valores nulos o que su 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 dos capacidades adicionales para la capa de entidades:

  • supportsAttachmentsByUploadId: esta funcionalidad debe activarse automáticamente si se habilitan adjuntos en la capa de entidades. Permite que la aplicación cargue todos los adjuntos asociados con una encuesta antes de intentar enviarla. Si se produce un error en alguno de los adjuntos, se revertirá 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 fuerce 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 forma más sencilla de hacerlo es habilitar la sincronización al publicar su capa de entidades.
  • Si utiliza una geodatabase multiusuario, las capas pueden utilizar el versionado en rama, pero no el versionado tradicional. 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 su 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 esta edición en su 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. Seleccione 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 su hoja de cálculo. Para obtener más información, consulte Crear una encuesta que coincida con una capa de entidades en la sección siguiente.

Nota:

Si la encuesta que está creando requiere preguntas de audio o archivo, se deberán agregar a su 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

Es posible 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 su 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. Con este método, se crean las propiedades form_id y submission_url.