Survey123 Connect convertirá los formularios diseñados con la especificación XLSForm en un XForm para su uso en Survey123 y los publicará en ArcGIS Online o ArcGIS Enterprise. Pueden surgir algunos problemas durante este proceso.
Sugerencia:
La herramienta Analizar encuesta verifica el XLSForm de la encuesta en busca de problemas comunes y brinda recomendaciones para las mejores prácticas en el diseño de encuestas.Errores de conversión de formularios
Cuando se crea una encuesta en Survey123 Connect, se usa la especificación XLSForm para diseñar el formulario mediante una hoja de cálculo. Survey123 Connect convierte la hoja de cálculo en un XForm, lo que le permite obtener una vista previa de la encuesta tal y como aparecerá en Survey123.
La conversión se produce después de hacer lo siguiente:
- Guarde los cambios en la hoja de cálculo.
- Haga clic en el botón Actualizar en Survey123 Connect.
Si hay algún problema con la encuesta, el servicio de conversión de formularios mostrará un error. En el siguiente ejemplo, el mensaje de error indica que el problema tiene relación con la entrada de nombre denominada "last name". En este caso, la entrada contiene un espacio. Es necesario eliminar el espacio o reemplazarlo por un signo de subrayado o un guion.
La siguiente tabla muestra algunos errores de formulario frecuentes:
| Descripción del error | Diagnóstico |
|---|---|
Error al convertir XLSForm | En el ejemplo anterior, este error resaltaba la pregunta denominada last name. En ese caso, el error es el espacio de la columna name. Otro error frecuente que generará este mensaje es el uso de caracteres no ASCII en la columna name de la hoja de cálculo survey o choices. Los caracteres ASCII se pueden usar en la columna label, pero no en la columna name. |
[row : 2] List name not in choices sheet: [JobType] | Este error indica que una de las preguntas select_one o select_multiple hace referencia a una lista que no existe en la hoja de cálculo choices. En este ejemplo, se deben eliminar los corchetes. |
Debería haber opciones para esta pregunta. | Este error indica que una de las preguntas select_one o select_multiple que tiene el parámetro adicional or_other como parte del tipo también tiene definido un filtro de opciones. Las preguntas de selección que incluyen la opción de introducir un valor Other no se pueden usar en una selección en cascada. |
Errores de red
Si experimenta algún problema al acceder al servicio de conversión de formularios, recibirá un error similar al siguiente:
La siguiente tabla muestra algunos errores de red frecuentes:
| Número de error | Descripción del error | Diagnóstico |
|---|---|---|
-1 | Cannot open C:/Users/Username/ArcGIS/My Survey Designs/Form 1/Form 1.xlsx | Es posible que Excel tenga un bloqueo aplicado en el archivo. Asegúrese de que la encuesta no se ha abierto con otra aplicación o para otro usuario. |
3 | Host survey123.arcgis.com not found | Usted está ejecutando una versión anterior de Survey123 Connect. Actualice a la versión más reciente. |
6 | SSL handshake failed | Existen diversos problemas que podrían causar fallos en el protocolo SSL, como los siguientes:
Puede probar los certificados SSL utilizados en un servidor web con un servicio de comprobación en línea, por ejemplo, SSL Labs. |
99 | Connection timed out | Se observa en ocasiones cuando se trabaja con encuestas muy largas. Vuelva a intentarlo. |
202 | Error al descargar https://survey123.esri.com/api/xls2xform - el servidor respondió: Prohibido | Cualquier error que contenga esri.com en el mensaje está apuntando al servidor antiguo. Actualice a la versión más reciente. |
203 | Error al descargar https://survey123.esri.com/api/xls2xform - el servidor respondió: No encontrado | Cualquier error que contenga esri.com en el mensaje está apuntando al servidor antiguo. Actualice a la versión más reciente. |
401 | Error al descargar https://survey123.arcgis.com/api/xls2xform - el servidor respondió: Error interno del servidor | Este error suele deberse a expresiones existentes en las columnas relevant o calculation. Use llaves e incluya un símbolo $ al principio de la declaración. |
403 | Error al descargar https://survey123.esri.com/api/xls2xform - el servidor respondió: Servicio no disponible temporalmente | Notifíqueselo a Esri inmediatamente. |
498 | Invalid token | El token que Survey123 Connect ha intentado pasar a ArcGIS no ha sido aceptado. En la mayoría de los casos, se debe a que una dirección URL de envío está intentando entregar un token a una capa de entidades pública. |
499 | Error al transferir https://survey123.arcgis.com/api/xls2xform - el servidor respondió: Error de proxy | La API de Survey123 no está disponible o se agotó el tiempo de espera. Inténtelo de nuevo más tarde. Si el problema continúa, consulte el grupo de Survey123 Comunidad de Esri para obtener más información. |
En el cuadro de diálogo del error, puede capturar el error para enviarlo a Esri. Incluya en el correo electrónico cualquier información que pueda ayudar a depurar el error.
Errores de publicación
Estos errores proceden normalmente del problema de crear los elementos de la encuesta en ArcGIS.
En la siguiente tabla se muestran los errores de publicación más frecuentes:
| Error | Diagnóstico |
|---|---|
La dirección URL de envío no es compatible (campo no encontrado) | El campo indicado no está presente en la capa de entidades especificada por la dirección URL de envío, lo que significa que las respuestas de la encuesta son incompatibles con la encuesta. Anule la asignación de la dirección URL de envío para crear una nueva o asegúrese de que la dirección URL de envío corresponde a la capa de entidades correcta. Este error suele producirse por el campo adicional que se crea cuando se utiliza la opción or_other para una pregunta select_one o select_multiple. Para obtener más información, consulte los tipos de preguntas con varias opciones. |
Submission url is not compatible (Request error) | Compruebe que el usuario con el que ha iniciado sesión en Survey123 Connect tiene permiso para acceder a la capa de entidades. |
No child key field in SurveyName for parent repeat_1 | Este error se produce si la capa de entidades a la que se envía usa claves principales de Id. global que no están presentes en la encuesta. En la ventana Opciones de publicación, defina Usar claves principales de Id. global en relaciones de repetición como true. |
CREATE TABLE ha fallado porque la columna 'x' de la tabla 'y' supera la cantidad máxima de 1024 columnas | La encuesta que está intentando publicar tiene más campos de los que permite una capa de entidades en una organización de ArcGIS (1024). Reduzca la cantidad de campos a menos de 1024 y vuelva a publicar la encuesta. Para obtener más información sobre estas limitaciones, consulte Solución de problemas en la ayuda de ArcGIS Online. |
El servicio de entidades personalizado submission url no es compatible con esta encuesta (El servicio de entidades no cumple los requisitos de una encuesta con repeticiones: supportsApplyEditsWithGlobalIds) | La propiedad supportsApplyEditsWithGlobalIds tiene el valor false y debe ser true. La forma más sencilla de hacerlo es habilitar la sincronización al publicar su capa de entidades. |
La URL de envío del servicio de entidades personalizado no es compatible con esta encuesta (no se encontró la relación de destino para la tabla) | Una repetición en su encuesta o bien está asociada de forma incorrecta con una tabla relacionada en la capa de entidades o bien la tabla no existe. Asegúrese de que su repetición tiene el mismo nombre que la tabla relacionada de destino. |
Errores del portal
Las encuestas publicadas en ArcGIS Enterprise tienen las limitaciones que aparecen a continuación, que difieren de las publicadas en ArcGIS Online.
- No puede publicar en ArcGIS Enterprise las encuestas que usan determinadas palabras clave reservadas como nombres de campo, como end (los nombres de campo que contienen estas palabras clave, como endSurvey, son aceptables siempre y cuando no coincidan exactamente con la palabra clave). Las palabras clave reservadas se enumeran en la hoja de cálculo Reserved de las plantillas XLSForm de Survey123.
- Todos los nombres de campo deben estar en minúsculas al publicarlos en ArcGIS Enterprise.
- El número máximo de columnas que puede contener una capa de entidades publicada en un portal que depende de su geodatabase corporativa. Consulte la documentación correspondiente a su sistema de administración de bases de datos para determinar los límites de tamaño. Si el número de preguntas de la encuesta supera el límite de columna de la geodatabase corporativa, la alternativa consiste en incluir una repetición y ajustar repeat_count a 1 para ampliar la encuesta a varias tablas.
- El nombre de una pregunta en la hoja de cálculo survey debe tener menos de 32 caracteres.
- No puede cargar contenido de Survey123 en ArcGIS Enterprise o Portal for ArcGIS si no utiliza ArcGIS Data Store.
- Cuando ArcGIS Enterprise se implementa en un entorno desconectado, no funcionan las plantillas de las encuestas, las muestras ni las direcciones URL de envío a las capas de entidades de ArcGIS Online.
- No se pueden usar direcciones URL de envío directamente con una capa de entidades de ArcGIS Server no federada. Se proporciona una solución alternativa registrando el servicio con ArcGIS Online o ArcGIS Enterprise.
- 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.
- esriFieldTypeDateOnly, esriFieldTypeTimeOnly, esriFieldTypeTimestampOffset y esriFieldBigInteger solo pueden utilizarse en ArcGIS Online. Estos tipos de campos están disponibles en ArcGIS Enterprise 11.2 y versiones posteriores.
Habilitar registro de diagnóstico
Si observa mensajes de error que no se recogen en este tema o detecta otro comportamiento inesperado, puede resultar útil conservar un registro de información de Survey123 Connect para compartirlo con otras personas (por ejemplo, con los representantes del Soporte técnico de Esri) con el fin de solucionar los problemas.
Para habilitar el registro, abra el menú en la página de inicio de la aplicación, haga clic en Configuración y, a continuación, haga clic en la pestaña Diagnóstico.
Si desea capturar mensajes en un archivo, haga clic en el botón de alternancia Registro para habilitar el registro. El cuadro de texto Ubicación de salida de registro se rellena automáticamente con la ubicación predeterminada del archivo de registro. Puede editar esta ruta de archivo. Para capturar mensajes en una consola en línea compatible con syslog, introduzca su dirección URL en el cuadro de texto Ubicación de salida de registro en lugar de la ubicación del archivo de registro.
Los archivos de registro se pueden compartir o enviar por correo electrónico. Cuando elija enviar el registro por correo electrónico desde la aplicación, el número de versión de la aplicación, el nombre del sistema operativo y la configuración regional del sistema se incluirán en el cuerpo de correo electrónico y el registro se incluirá como adjunto.
Nota:
En el registro en tiempo real, la pestaña Diagnóstico muestra las instancias de una consola de AppStudio que están abiertas actualmente en la red. Aparece un símbolo de círculo de búsqueda en la pestaña Diagnóstico hasta que se encuentre una consola de AppStudio en funcionamiento. Si selecciona primero una consola de AppStudio y hace clic en el botón de alternancia Registro, la información de registro empezará a aparecer en esa consola. Para obtener más información, consulte Capturar salida de consola en la ayuda de ArcGIS AppStudio.