Survey123 Connect convertit vos formulaires conçus avec la spécification XLSForm en un formulaire XForm à utiliser dans Survey123 et les publie sur ArcGIS Online ou ArcGIS Enterprise. Certains problèmes peuvent se produire pendant ce processus.
Erreurs de conversion de formulaire
Lorsque vous créez une enquête dans Survey123 Connect, vous utilisez la spécification XLSForm pour concevoir votre formulaire avec une feuille de calcul. Survey123 Connect convertit la feuille de calcul en XForm, qui vous permet d’afficher un aperçu de l’enquête telle qu’elle s’affichera dans Survey123.
La conversion se produit une fois que vous avez réalisé les opérations suivantes :
- Enregistrez les changements dans votre feuille de calcul.
- Cliquez sur le bouton Update (Mettre à jour) dans Survey123 Connect.
Si un problème se produit dans votre enquête, vous recevez un message d’erreur du service de conversion de formulaire. Dans l’exemple suivant, le message d’erreur explique que le problème concerne l’entrée de nom appelée nom. Dans ce cas, l’entrée contient un espace. L’espace doit être supprimé ou remplacé par un trait de soulignement ou un tiret.
Certaines erreurs de formulaire courantes sont présentées dans le tableau suivant :
| Description de l’erreur | Diagnostic |
|---|---|
Erreur de conversion XLSForm | Dans l’exemple ci-dessus, cette erreur mettait en surbrillance la question appelée nom. Dans ce cas, l’erreur est l’espace dans la colonne nom. Une autre erreur courante engendrant ce message survient lorsque les caractères autres qu’ASCII sont utilisés dans la colonne nom de la feuille de calcul enquête ou choix. Les caractères ASCII peuvent être utilisés dans la colonne étiquette, mais pas dans la colonne nom. |
[ligne : 2] Nom de la liste introuvable dans la feuille de choix : [JobType] | Cette erreur indique que l’une des questions select_one (sélection unique) ou select_multiple (sélection multiple) référence une liste qui n’existe pas dans la feuille de calcul choix. Dans cet exemple, les crochets doivent être supprimés. |
Des choix doivent être proposés pour cette question. | Cette erreur indique que l’une des questions select_one (sélection unique) ou select_multiple (sélection multiple) possédant le paramètre supplémentaire or_other dans le cadre du type a également un filtre de choix défini. Les questions de sélection comprenant l’option de saisie d'une valeur Autre ne peuvent pas être utilisées dans une sélection en cascade. |
Erreurs réseau
Si vous avez des difficultés à accéder au service de conversion de formulaire, une erreur semblable à celle-ci s’affiche :
Certaines erreurs réseau courantes sont présentées dans le tableau suivant :
| Numéro d’erreur | Description de l’erreur | Diagnostic |
|---|---|---|
-1 | Impossible d’ouvrir C:/Users/Username/ArcGIS/My Survey Designs/Form 1/Form 1.xlsx | Excel peut contenir un verrou sur votre fichier. Vérifiez que l'enquête n'est pas ouverte par une autre application ou un autre utilisateur. |
3 | Hôte survey123.arcgis.com introuvable | Vous utilisez une ancienne version de Survey123 Connect. Effectuez une mise à niveau vers la dernière version. |
6 | Echec de la poignée de main SSL | Plusieurs problèmes peuvent entraîner l’échec de la poignée de main SSL, par exemple :
Pour évaluer les certificats SSL utilisés sur un serveur web, vous pouvez utiliser un programme de test en ligne tel que SSL Labs. |
99 | Délai de connexion dépassé | Survient quelquefois lors de l’utilisation de très grandes enquêtes. Réessayez. |
202 | Erreur de téléchargement de https://survey123.esri.com/api/xls2xform - réponse du serveur : Accès non autorisé | Toute erreur dont le message contient esri.com pointe vers l’ancien serveur. Effectuez une mise à niveau vers la dernière version. |
203 | Erreur de téléchargement de https://survey123.esri.com/api/xls2xform - réponse du serveur : Introuvable | Toute erreur dont le message contient esri.com pointe vers l’ancien serveur. Effectuez une mise à niveau vers la dernière version. |
401 | Erreur de téléchargement de https://survey123.arcgis.com/api/xls2xform - réponse du serveur : Erreur interne du serveur | Cette erreur est généralement déclenchée par des expressions dans les colonnes pertinentes ou de calcul. Utilisez des accolades et un signe $ au début de la déclaration. |
403 | Erreur de téléchargement de https://survey123.esri.com/api/xls2xform - réponse du serveur : Service temporairement indisponible | Signalez immédiatement cette erreur à Esri. |
498 | Jeton non valide | Le jeton que Survey123 Connect a tenté de transmettre à ArcGIS n’a pas été accepté. Cette erreur est souvent provoquée par une URL d’envoi qui tente de transmettre un jeton vers une couche d’entités publique. |
499 | Erreur de transfert de https://survey123.arcgis.com/api/xls2xform - réponse du serveur : Erreur de proxy | L’API de Survey123 est indisponible ou ne répond plus. Réessayez dans quelques instants. Si le problème persiste, reportez-vous à Survey123 Communauté Esri pour plus d’informations. |
Dans la boîte de dialogue de l’erreur, vous avez l’opportunité de capturer l’erreur à envoyer à Esri. Ajoutez à l’e-mail toute information complémentaire qui pourrait aider à résoudre le problème.
Erreurs de publication
Ces erreurs sont généralement liées à un problème de création des éléments à partir de votre enquête dans in ArcGIS.
Les erreurs de publication courantes sont présentées dans le tableau suivant :
| Erreur | Diagnostic |
|---|---|
L’URL d’envoi n’est pas compatible (champ introuvable) | Le champ nommé n’est pas présent dans la couche d’entités désignée par l’URL d’envoi, ce qui signifie que les réponses de l’enquête sont incompatibles avec l’enquête. Vous devez soit annuler l’affectation de l’URL d’envoi pour en créer une nouvelle, soit vous assurer que l’URL d’envoi pointe sur la couche d’entités appropriée. Cette erreur est généralement provoquée par le champ supplémentaire créé lorsque l’option or_other est utilisée pour une question select_one ou select_multiple. Pour plus d’informations, reportez-vous à la rubrique Questions à choix multiples. |
L’URL d’envoi n’est pas compatible (erreur de requête) | Vérifiez que l’utilisateur avec lequel vous vous êtes connecté à Survey123 Connect détient les autorisations nécessaires pour accéder à la couche d’entités. |
Aucun champ de clé enfant dans SurveyName pour le parent repeat_1 | Cette erreur se produit si la couche d’entités à laquelle vous effectuez les envois utilise des clés parent d’identifiant global qui ne sont pas présentes dans l’enquête. Dans la fenêtre Options de publication, définissez l’option Utiliser des clés parent d'ID global dans les relations de répétition à la valeur true. |
L'opération CREATE TABLE a échoué car la colonne « x » dans le tableau « y » dépasse le maximum de 1 024 colonnes | L’enquête que vous tentez de publier possède plus de champs que le maximum autorisé par la couche d’entités dans une organisation ArcGIS (1 024). Réduisez le nombre de champs à moins de 1 024 et publiez à nouveau l'enquête. Pour plus d’informations sur ces limitations, reportez-vous à la rubrique Dépanner de l’aide d’ArcGIS Online. |
L’URL d'envoi du service d'entités personnalisé n’est pas compatible avec cette enquête (le service d'entités ne répond pas à la configuration requise pour une enquête avec répétitions : supportsApplyEditsWithGlobalIds) | La propriété supportsApplyEditsWithGlobalIds est définie sur la valeur false, alors qu’elle doit avoir la valeur true. Pour ce faire, la méthode la plus simple consiste à activer la synchronisation lors de la publication de votre couche d’entités. |
L’URL dʼenvoi du service dʼentités personnalisé nʼest pas compatible avec cette enquête (relation de destination introuvable pour la table) | Une répétition dans votre enquête est soit associée de façon erronée à une table liée dans la couche dʼentités, soit la table nʼexiste pas. Assurez-vous que votre répétition a le même nom que la table associée à la destination. |
Erreurs de portail
Les enquêtes publiées sur ArcGIS Enterprise présentent les limitations suivantes, qui diffèrent de celles des enquêtes publiées sur ArcGIS Online.
- Sur ArcGIS Enterprise, vous ne pouvez pas publier d’enquêtes utilisant certains mots-réservés en tant que noms de champ, par exemple end (les noms de champ contenant ces mots-clés sont acceptables, par exemple endSurvey, tant qu’ils ne correspondent pas exactement au mot-clé). Les mots-clés réservés sont répertoriés dans la feuille de calcul Reserved (Réservé) des modèles XLSForm Survey123.
- Tous les noms de champ doivent être en minuscules en cas de publication sur ArcGIS Enterprise.
- Le nombre maximal de colonnes pouvant être contenues dans une couche d’entités publiée sur un portail dépend de votre géodatabase d’entreprise. Reportez-vous à la documentation de votre système de gestion de bases de données pour déterminer les limites de taille. Si le nombre de questions de votre enquête est supérieur au nombre limite de colonnes dans votre géodatabase d’entreprise, la solution consiste à inclure une répétition et à définir repeat_count sur 1 pour étendre l’enquête sur plusieurs tables.
- Le nom d’une question dans la feuille de calcul de l’enquête doit compter moins de 32 caractères.
- Vous ne pouvez pas charger de contenu Survey123 dans ArcGIS Enterprise ou dans Portal for ArcGIS si vous n’utilisez pas ArcGIS Data Store.
- Lorsque ArcGIS Enterprise est déployé dans un environnement déconnecté, les modèles, exemples d’enquête et URL d’envoi à des couches d’entités ArcGIS Online ne fonctionnent pas.
- Les URL d’envoi ne peuvent pas être utilisées directement avec une couche d’entités ArcGIS Server non fédérée. L’une des solutions consiste à inscrire le service auprès de ArcGIS Online ou de ArcGIS Enterprise.
- Si vous utilisez une géodatabase multi-utilisateurs, les couches peuvent utiliser le versionnement de branche ou le versionnement traditionnel. Survey123 cible la version par défaut lors de l’utilisation d’une géodatabase de branche versionnée. Pour plus d’informations, consultez la rubrique Types de versionnement.
Activer la journalisation des diagnostics
Si vous recevez des messages d’erreur ne figurant pas dans cette rubrique, ou si vous observez d’autres comportements inattendus, il peut être utile d’enregistrer un journal d’informations provenant de Survey123 Connect, qui pourra être partagé (par exemple, avec le support technique Esri) afin de résoudre ces problèmes.
Pour activer la journalisation, ouvrez le menu sur la page d’accueil de l’application, cliquez sur Settings (Paramètres), puis sur l’onglet Diagnostics (Diagnostic).
Pour consigner les messages dans un fichier, cliquez sur le bouton bascule Logging (Journalisation) afin d’activer la journalisation. La zone de texte Log output location (Emplacement en sortie du journal) est renseignée automatiquement avec l’emplacement par défaut du fichier journal. Vous pouvez modifier ce chemin de fichier. Pour consigner les messages dans une console compatible avec syslog en ligne, saisissez son URL dans le champ Log output location (Emplacement en sortie du journal) à la place de l’emplacement du fichier journal.
Les fichiers journaux peuvent être partagés ou envoyés par courrier électronique. Lorsque vous choisissez d’envoyer le journal par courrier électronique à partir de l’application, le numéro de version de l’application, le nom du système d’exploitation et les paramètres régionaux du système sont inclus dans le corps du courrier électronique ; le journal est, quant à lui, inclus en pièce jointe.
Remarque :
Pour la journalisation en temps réel, l’onglet Diagnostics (Diagnostic) affiche toutes les instances de la console AppStudio actuellement ouvertes dans votre réseau. Un symbole circulaire de recherche apparaît sur l’onglet Diagnostics (Diagnostic) jusqu’à ce qu’il détecte une console AppStudio en cours d’exécution. Si vous sélectionnez d’abord une console AppStudio et que vous cliquez sur le bouton bascule Logging (Journalisation) pour activer la consignation, les informations de journalisation apparaissent dans cette console. Pour plus d’informations, reportez-vous à la rubrique Capturer la sortie de la console dans l’aide ArcGIS AppStudio.
Vous avez un commentaire à formuler concernant cette rubrique ?