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.
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.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.
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 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 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.
- 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 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. La capa de entidades debe estar preparada para su uso con Survey123. 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 Crear una encuesta que coincida con una capa de entidades.
Si la capa de entidades que eligió tiene archivos adjuntos, se creará una pregunta de una sola imagen en la encuesta con el nombre <layer_name>_image. Este nombre no coincidirá con una palabra clave en la tabla de archivos adjuntos y debe actualizarse. Si los archivos adjuntos existentes representan más de una pregunta, debe agregar preguntas con imágenes a la encuesta para que coincidan con cada una de las palabras clave en la tabla de archivos adjuntos.
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.
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.
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.