Solución de problemas

Survey123 Connect convertirá sus 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.

Errores de conversión de formularios

Cuando se crea una nueva encuesta enSurvey123 Connect 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:

  1. Guarde los cambios en la hoja de cálculo.
  2. 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 explica 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.

Mensaje de error

La siguiente tabla muestra algunos errores de formulario frecuentes:

Descripción del errorDiagnó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:

Mensaje de error de red

La siguiente tabla muestra algunos errores de red frecuentes:

Número de errorDescripción del errorDiagnó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:

  • Compruebe que el certificado sea válido, incluidos detalles como la fecha de caducidad, el nombre común y el emisor.
  • Compruebe que el certificado raíz de la cadena de certificados sea correcto y esté implantado en todos los dispositivos.
  • Compruebe los certificados intermedios de la cadena de certificados.
  • Compruebe que el dispositivo admita el algoritmo de cifrado utilizado en el certificado. El algoritmo que se utiliza normalmente es SHA256.

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, tiene la oportunidad de 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.

Mensaje de error de publicación

En la siguiente tabla se muestran los errores de publicación más frecuentes:

ErrorDiagnó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 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. Para obtener más información, consulte escenarios de versiones tradicionales.

Registrar errores en una consola

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 la aplicación para compartirlo con otras personas (por ejemplo, con los representantes del Soporte técnico de Esri) con el fin de solucionar los problemas. Survey123 Connect es compatible con la herramienta Consola de ArcGIS AppStudio, lo que permite capturar los mensajes enviados desde una aplicación en un registro que se puede visualizar en un equipo de escritorio o en la web o se puede guardar en un archivo. No tiene que instalar ni ejecutar AppStudio para usar esta característica. Para habilitar el inicio de sesión en Survey123 Connect, abra Configuración a través del menú principal de la esquina superior derecha y haga clic en la pestaña Diagnóstico.

Iniciar sesión en

Para capturar mensajes en un archivo, haga clic en el conmutador Registro para permitir el registro. Si no hay ninguna consola de AppStudio seleccionada, 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 Ubicación de salida de registro en lugar de la ubicación del archivo de registro.

La pestaña Diagnóstico muestra las instancias de la consola de AppStudio que están abiertas actualmente en la red. Se mostrará 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 conmutador 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.