De forma predeterminada, cuando se publica una encuesta en Survey123, 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 existente con Survey123, esta debe cumplir los siguientes requisitos:
- La capa de entidades 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 requieren ajustes adicionales: 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.
- La capa de entidades debe ser editable.
- Las siguientes propiedades adicionales deben definirse como true:
- 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).
- supportsAttachmentsByUploadId: esta propiedad 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.
Tenga en cuenta los siguientes requisitos adicionales en función del diseño de la encuesta y del uso que se le vaya a dar:
- Para que los usuarios puedan capturar nuevas encuestas y agregar registros, se requiere la funcionalidad Create.
- Para que los usuarios puedan editar registros de encuestas existentes:
- Se necesita la funcionalidad Update en la capa.
- 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.
- Para que los usuarios puedan enviar imágenes, audio o archivos, es necesario habilitar los archivos adjuntos (establecer hasAttachments en true).
- Las repeticiones en una encuesta 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. El nombre de la repetición se definirá mediante el nombre de la tabla o capa relacionada y no se puede cambiar.
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.
Aplicar modificaciones con Id. globales
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 Id. global 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.
- Si la capa de entidades contiene capas habilitadas para valores m, la edición sin valores m debe estar habilitada.
- La tabla o capa de entidades debe contener Id. globales antes de habilitar los adjuntos en cualquiera de ellas.
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 API REST de ArcGIS.
Habilitar adjuntos
Al habilitar los archivos adjuntos en una capa de entidades, las columnas KEYWORD y EXIFINFO no se agregan al esquema de manera predeterminada. Esta columna se necesita para poder asociar archivos adjuntos al registro correcto. Tras habilitar los archivos adjuntos, ejecute Actualizar la herramienta de geoprocesamiento de archivos adjuntos para habilitar las palabras clave.
Nota:
Se recomienda agregar las columnas KEYWORD y EXIFINFO antes de recopilar registros con Survey123 para que todos los archivos adjuntos que se envían tengan palabras clave. Si las columnas KEYWORD y EXIFINFO no existen antes de enviar los archivos adjuntos, el notebook Actualizar palabras clave de archivos adjuntos Python se puede utilizar para actualizar los archivos adjuntos.
Modificar esquema
Una vez que se ha creado una encuesta a partir de una capa de entidades existente, solo se pueden agregar nuevas preguntas y valores de listas de opciones a la encuesta después de agregar el campo o dominio correspondiente a la capa de entidades. Cuando se crea una encuesta a partir de una vista de capa de entidades, solo se pueden agregar nuevas preguntas y valores de listas de opciones a la encuesta después de agregar el campo o dominio correspondiente a la capa de entidades subyacente y que este se haya propagado a la vista de capa de entidades.