Skip to main content

Sélections de la rédaction

Neuf erreurs courantes dans ArcGIS Survey123 et leur résolution

Published Date

Avez-vous déjà rencontré des erreurs dans ArcGIS Survey123, sans savoir exactement comment les résoudre? Eh bien, dans ce billet de blogue, je vais vous montrer comment interpréter et résoudre les erreurs de façon professionnelle dans ArcGIS Survey123 Connect.

Avez-vous récemment obtenu une erreur dans ArcGIS Survey123, sans savoir exactement comment la résoudre? Ne vous inquiétez pas, nous allons vous montrer! Ce billet de blogue passe en revue neuf erreurs courantes dans ArcGIS Survey123 et la façon de les corriger. En un rien de temps, vous vous attaquerez aux erreurs comme un pro de l’assistance technique.

Les différents types d’erreurs

Examinons les erreurs courantes que les utilisateurs rencontrent lors de l’utilisation d’ArcGIS Survey123.

Remarque : Ce billet de blogue porte sur les erreurs que vous pourriez rencontrer dans ArcGIS Survey123 Connect, et non avec le concepteur de sites web.

Il existe trois grands types d’erreurs :

  1. Erreurs d’enregistrement

  2. Erreurs de publication 

  3. Erreurs d’envoi

1) Erreurs d’enregistrement

Une erreur se produit lors de la tentative d’enregistrement d’un sondage dans ArcGIS Survey123 Connect. Ce genre de problème survient généralement en raison d’une mauvaise utilisation de la feuille .xlsx lors de la création du sondage.

Un message d’erreur dans ArcGIS Survey123 Connect avec un point d’exclamation rouge indiquant « Error converting XLSForm » (erreur de conversion de la feuille XLSForm). Sous le message figure une mention indiquant « Unmatched begin statement: group » (instruction de début sans correspondance : groupe).

Exemple d’erreur d’enregistrement

2) Erreurs de publication

Des erreurs de publication se produisent lorsque vous essayez de publier le sondage. Elles vous empêcheront de publier votre sondage ou feront en sorte que le logiciel ne le publie pas.

Une boîte verte dans ArcGIS Survey123 Connect, qui porte l’en-tête « Publish Form 5 » (publier le formulaire 5). Le texte suivant s’affiche à l’intérieur de cette boîte : « This survey cannot be published » (ce sondage ne peut être publié). Sous ce message : « Only one geometry field is allowed per table, 2 found in Form_5 » (un seul champ géométrique est autorisé par table; le formulaire 5 en compte 2).

Exemple d’erreur de publication

3) Erreurs d’envoi

Les erreurs d’envoi se produisent lors de la soumission d’un sondage. Par exemple, si un utilisateur télécharge et soumet un sondage, il recevra un message d’erreur (de couleur rouge) ou un avertissement (de couleur dorée).

Capture d’un écran de téléphone avec une boîte de dialogue d’erreur au centre. La capture d’écran montre l’application ArcGIS Field Maps. Dans la boîte de dialogue, un message d’erreur avec un point d’exclamation rouge indique « Send Error » (erreur d’envoi). Sous ce message se trouve le texte suivant : « This survey could not be sent due to the following error: String or binary data would be truncated. The statement has been terminated » (ce sondage n’a pu être envoyé en raison de l’erreur suivante : les données de chaîne ou binaires seraient tronquées; l’instruction a été interrompue). Puis suit le texte suivant : « Shows: yes, diameter: 25, radius: 5, Areas: 79, test : 1231231. Do you want to edit the survey? » (affichage : oui, diamètre : 25, rayon : 5, Zones : 79, test : 1231231. Voulez-vous modifier le sondage?) En dessous, deux options s’offrent à vous : oui et non.

Exemple d’erreur d’envoi à partir de l’application de terrain ArcGIS Survey123

Capture d’écran d’une erreur de sondage dans ArcGIS Survey123. Une boîte de dialogue rouge s’affiche en haut de l’écran. Cette boîte comporte le texte suivant : « Failed to submit » (échec de l’envoi). En dessous se trouve un encadré rouge foncé avec le texte suivant : “[{“id”:0”addResults”:[{“objectId”:-1”uniqueID”:-1,”GlobalID”:”{89FA472A-0091-4429-82D1-77371348802}”,”success”:false,”error”:{“code”:1000,”description”:”String or binary data would be truncated.\r\nThe statement has been terminated.”}}]}]

Exemple d’erreur provenant d’une soumission en ligne avec ArcGIS Survey123 

Capture d’écran d’une erreur de sondage dans ArcGIS Survey123. L’erreur est affichée en haut de l’écran dans une boîte de dialogue orange. La boîte contient le texte suivant : « Survey submitted successfully, but an error occurred while triggering webhook » (le sondage a été soumis avec succès, mais une erreur s’est produite lors du déclenchement du rappel web). En dessous, une boîte orange plus foncé affiche plus de texte : « https://hook.us1.make.com/fkfeajb18tqs8hnteji6e4qnkskscc4t Load failed ».

Exemple d’avertissement provenant d’une soumission en ligne avec ArcGIS Survey123 

Erreurs courantes et façons de les résoudre

Dans cette section, je vous montrerai neuf erreurs courantes (trois pour chaque type d’erreurs). Je parlerai de leurs causes et de la manière d’y remédier.

Erreurs d’enregistrement

  • Erreur : « Unmatched begin statement: group » (instruction de début sans correspondance : groupe).

  • Erreur : « Something broke the parser (dependency cycle amongst the Xpath expressions: related question) » (quelque chose a interrompu l’analyseur [cycle de dépendance entre les expressions Xpath : question connexe]).

  • Erreur : « There has been a problem trying to replace ${field} with the XPath to the survey element named ‘field’ » (un problème s’est posé lors du remplacement de ${field} par le chemin XPath vers l’élément de sondage nommé « champ »). « There is no survey element by this name » (il n’existe pas d’élément de sondage portant ce nom).

Erreurs de publication

  • Erreur : « Unmatched begin statement: group » (instruction de début sans correspondance : groupe).

  • Erreur : « Something broke the parser (dependency cycle amongst the Xpath expressions: related question) » (quelque chose a interrompu l’analyseur [cycle de dépendance entre les expressions Xpath : question connexe]).

  • Erreur : « There has been a problem trying to replace ${field} with the XPath to the survey element named ‘field’ » (un problème s’est posé lors du remplacement de ${field} par le chemin XPath vers l’élément de sondage nommé « champ »). « There is no survey element by this name » (il n’existe pas d’élément de sondage portant ce nom).

Erreurs d’envoi

  • Erreur : « Only one geometry field is allowed per table, 2 found in Survey_Name » (un seul champ géométrique est autorisé par table; le sondage [NOM] en compte 2).

  • Erreur : « Warning: This survey has already been published » (avertissement : ce sondage a déjà été publié). « The existing feature service is not compatible with the survey) » (le service d’entités existant n’est pas compatible avec le sondage).

  • Erreur : « The custom feature service submission_url is not compatible with this survey » (l’adresse URL d’envoi du service d’entité personnalisé n’est pas compatible avec ce sondage).

Erreurs d’enregistrement courantes

Erreur : « Unmatched begin statement: group » (instruction de début sans correspondance : groupe).

Un message d’erreur dans ArcGIS Survey123 avec un point d’exclamation rouge indiquant « Error converting XLSForm » (erreur de conversion de la feuille XLSForm). Sous le message figure une mention indiquant « Unmatched begin statement: group » (instruction de début sans correspondance : groupe).

Cause : Cette erreur se produit lorsque vous ouvrez une instruction de groupe ou de répétition dans ArcGIS Survey123, mais que vous ne la fermez pas, ou vice versa.

Solution : Pour inclure un groupe dans votre sondage, vous devez avoir à la fois un groupe de départ et un groupe d’arrivée dans vos questions. Si ce n’est pas le cas, il faut les supprimer pour résoudre l’erreur. Il en va de même pour les portions répétées.

Erreur : « Something broke the parser (dependency cycle amongst the Xpath expressions: related question) » (quelque chose a interrompu l’analyseur [cycle de dépendance entre les expressions Xpath : question connexe]).

Un message d’erreur dans ArcGIS Survey123 avec un point d’exclamation rouge indiquant « Error converting XLSForm » (erreur de conversion de la feuille XLSForm). Sous le message se trouve l’instruction suivante : « b’ODK Validate Errors:\n>> Something broke the parser. See above for a hint.\n Dependency cycles amongst the xpath expressions ».

Cause : Cette erreur se produit lorsqu’un calcul se répète en boucle. Une question avec calcul ne peut pas s’inclure elle-même dans le calcul. Par exemple, si votre question s’appelle « carré », vous ne pouvez pas l’inclure dans un calcul sur la question « carré », car le calcul tournerait en boucle.

Solution : Faites défiler l’erreur en la survolant pour identifier l’endroit où elle se produit dans le sondage. Ensuite, supprimez le calcul qui pose problème et placez-le dans un champ caché. De cette manière, vous pouvez toujours obtenir le résultat souhaité sans rompre le sondage.

Erreur : « There has been a problem trying to replace ${field} with the XPath to the survey element named ‘field’ » (un problème s’est posé lors du remplacement de ${field} par le chemin XPath vers l’élément de sondage nommé « champ »). « There is no survey element by this name » (il n’existe pas d’élément de sondage portant ce nom).

Un message d’erreur dans ArcGIS Survey123 avec un point d’exclamation rouge indiquant « Error converting XLSForm » (erreur de conversion de la feuille XLSForm). Sous le message figure un texte indiquant : « There has been a problem trying to replace ${Diameter} with the XPath to the survey element named ‘Diameter’ » (un problème s’est produit lors du remplacement de ${Diameter} avec le XPath de l’élément de sondage nommé « Diamètre »). « There is no survey element by this name » (il n’existe pas d’élément de sondage portant ce nom).

Cause : Cette erreur est due au fait que le nom du champ ou de la question suggérés ne figure pas dans votre sondage. Cela se produit généralement lorsque vous ajoutez des valeurs dynamiques au champ de calcul. Celles-ci sont sensibles à la casse, ce qui donne facilement lieu à des erreurs.

Solution : Faites défiler l’erreur en la survolant pour identifier l’endroit où elle se produit dans le sondage. Modifiez ensuite le calcul pour obtenir le nom correct du champ avec les caractères appropriés.

Erreurs de publication courantes

Erreur : « Only one geometry field is allowed per table, 2 found in Survey_Name » (un seul champ géométrique est autorisé par table; le sondage [NOM] en compte 2).

Une boîte verte dans ArcGIS Survey123, qui porte l’en-tête « Publish Form 5 » (publier le formulaire 5). À l’intérieur de la boîte, le texte suivant s’affiche : « This survey cannot be published » (ce sondage ne peut être publié). En dessous, un autre message indique : « Only one geometry field is allowed per table, 2 found in Form_5 » (un seul champ géométrique est autorisé par table; le formulaire 5 en compte 2).

Cause : Cette erreur est causée par la présence simultanée de deux questions de géométrie dans un sondage. Par exemple, une question de géopoint et de géotrace.

Solution : Supprimez la question de géométrie supplémentaire en faisant un clic droit sur la ligne à laquelle elle est associée et en appuyant sur Supprimer. Si vous souhaitez que l’utilisateur entre plusieurs points dans un sondage, utilisez plutôt une question répétitive.

Erreur : « Warning: This survey has already been published » (avertissement : ce sondage a déjà été publié). « The existing feature service is not compatible with the survey) » (le service d’entités existant n’est pas compatible avec le sondage).

Une boîte verte dans ArcGIS Survey123, qui porte l’en-tête « Publish Form 5 » (publier le formulaire 5). À l’intérieur de la boîte, un texte s’affiche en rouge : « Warning: This survey has already been published » (avertissement : ce sondage a déjà été publié). Le texte qui suit en noir indique : « The existing feature service is not compatible with the survey » (le service d’entités existant n’est pas compatible avec le sondage). En dessous, en gras, un message indique : « Field diameter in Form_5 has a type mismatch: esriFieldTypeString != esriFieldTypeInteger ». En dessous, encore du texte en rouge : « If you republish this survey all previously collected data will be lost » (si vous republiez ce sondage, toutes les données collectées précédemment seront perdues). Il y a ensuite un bouton à bascule accompagné du texte suivant : « I understand the existing feature service will be deleted » (je comprends que le service d’entités existant sera supprimé).

Cause : Cette erreur se produit lorsque vous tentez de republier un sondage après avoir modifié le type d’une question déjà publiée.

Remarque : Cette erreur ne vous empêche pas de publier, mais elle supprimera tous les enregistrements actuels et produira un nouveau service d’entités avec une adresse URL ou un identificateur différents.

Solution : Lors de la republication d’un sondage, assurez-vous que tous les champs sont du même type que lors du téléversement précédent. Si vous écrasez votre fichier local, vous pouvez relancer le processus d’édition en téléchargeant à nouveau le sondage. En outre, si vous n’avez pas besoin de transférer des pièces jointes, vous pouvez copier les enregistrements actuels du service d’entités existant et les ajouter au nouveau service d’entités.

Erreur : « The custom feature service submission_url is not compatible with this survey » (l’adresse URL d’envoi du service d’entités personnalisé n’est pas compatible avec ce sondage).

Une boîte verte dans ArcGIS Survey123 Connect, qui porte l’en-tête « Publish Damage Assessment » (identification de l’erreur de publication). À l’intérieur de la boîte, le texte suivant s’affiche : « The custom feature service submission_url is not compatible with this survey » (l’adresse URL d’envoi du service d’entité personnalisé n’est pas compatible avec ce sondage). En dessous, un texte en rouge et en gras indique « Fields not found in the feature service: 1 » (champs non trouvés dans le service d’entités : 1).

Cause : Cette erreur se produit lorsque l’adresse URL de soumission du service d’entités n’est pas la même que celle de ce sondage, ce qui crée une incompatibilité.

Solution : Assurez-vous que l’adresse URL de soumission de votre sondage pointe vers la bonne couche d’entités hébergée dans votre compte d’organisation ArcGIS Online ou ArcGIS Enterprise et que tous les champs concordent entre cette couche et le sondage.

Erreurs d’envoi courantes

Erreur : « Survey submitted successfully, but an error occurred while triggering webhook » (le sondage a été envoyé avec succès, mais une erreur s’est produite lors du déclenchement du rappel web).

Capture d’écran d’une erreur de sondage ArcGIS Survey123 affichée en haut de l’écran de l’utilisateur dans une boîte de dialogue orange. La boîte contient le texte suivant : « Survey submitted successfully, but an error occurred while triggering webhook » (le sondage a été soumis avec succès, mais une erreur s’est produite lors du déclenchement du rappel web). En dessous, une boîte orange plus foncé affiche plus de texte : « https://hook.us1.make.com/fkfeajb18tqs8hnteji6e4qnkskscc4t - Load failed ».

Cause : Cette erreur indique qu’un rappel web joint à votre sondage ne s’est pas déclenché correctement. La cause peut aller de la désactivation du rappel web à l’insuffisance de crédits dans votre compte de rappel web.

Solution : Supprimez le rappel web s’il n’est pas nécessaire ou corrigez-le si vous prévoyez de continuer à l’utiliser.

Remarque : Si cet avertissement apparaît, le sondage sera toujours soumis et enregistré dans ArcGIS Survey123, mais le rappel web ne sera pas exécuté.

Erreur : « String or binary data would be truncated » (les données de type chaîne ou binaire seraient tronquées). « This statement has been terminated » (cette instruction a été annulée).

Capture d’un écran de téléphone avec une boîte de dialogue d’erreur au centre dans l’application ArcGIS Field Maps. Dans la boîte de dialogue, un message d’erreur avec un point d’exclamation rouge indique « Send Error » (erreur d’envoi). En dessous, on peut lire le texte suivant : « This survey could not be sent do to the following error: String or binary data would be truncated. The statement has been terminated » (ce sondage n’a pu être envoyé en raison de l’erreur suivante : les données de chaîne ou binaires seraient tronquées; l’instruction a été interrompue). Le texte suivant figure en dessous : « Shows: yes, diameter: 25, radius: 5, Areas: 79, test : 1231231. Do you want to edit the survey? » (affichage : oui, diamètre : 25, rayon : 5, Zones : 79, test : 1231231. Voulez-vous modifier le sondage?) En dessous, deux options s’offrent à vous : oui et non.

Cause : Cette erreur se produit lorsqu’une question select_one (choisissez une réponse) ou select_multiple (choisissez toutes les réponses qui s’appliquent) dépasse les limites de caractères du champ. Par exemple, une réponse select_one qui dépasse la limite par défaut de 255 caractères.

Solution : Ajustez les réponses possibles au sondage pour respecter la limite de 255 caractères. Si vous avez besoin de plus de 255 caractères, vous pouvez augmenter la limite de caractères pour un champ de sondage en configurant une longueur de champ plus importante dans la colonne bind::esri:fieldLength pour ce champ ou cette question.

Erreur : « Error connecting to ArcGIS Online » (erreur de connexion à ArcGIS Online). « Error code:3 Host not found » (code d’erreur 3 : hôte introuvable).

Capture d’un écran de téléphone montrant une boîte de dialogue d’erreur dans l’application ArcGIS Survey123. La boîte contient un signe triangulaire rouge avec un point d’exclamation à l’intérieur. En dessous, un texte en gras indique : « Error connecting to ArcGIS Online » (erreur de connexion à ArcGIS Online). En dessous, il y a plus de texte : « Error code: 3 Host not found » (code d’erreur 3 : hôte introuvable). En dessous, il y a un bouton « Try again » (réessayer) à gauche et un bouton « Cancel » (annuler) à droite.

Cause : Cette erreur se produit lorsque la connexion est insuffisante pour envoyer le sondage. Par exemple, lorsqu’on est connecté à une source sans fil non connectée à Internet pour faire l’envoi (par exemple, une imprimante sans fil).

Solution : Effectuez un test de vitesse Internet pour vous assurer que votre connexion actuelle offre la vitesse de téléversement minimale recommandée de 5 Mb/s. Si ce n’est pas le cas, connectez-vous à un point de connexion plus rapide ou plus fort et renvoyez le sondage. Si vous avez besoin d’utiliser votre sondage hors connexion, regardez ici pour plus d’informations.

Comment résoudre les erreurs par soi-même

Que faire si votre erreur ne figure pas dans la liste ci-dessus? Dans cette section, nous verrons comment afficher et interpréter les erreurs, ainsi que la façon d’utiliser les outils de dépannage intégrés dans ArcGIS Survey123 Connect pour mieux comprendre les erreurs.

Interprétation d’une erreur

La plupart des erreurs indiquent le numéro de ligne ou le nom de la question où le problème se produit dans le fichier de sondage, ce qui vous aide à localiser le problème et rend le dépannage plus efficace. Nous vous conseillons de rechercher ces erreurs sur le site de la communauté Esri pour voir si d’autres utilisateurs les ont rencontrées. Souvent, les utilisateurs ont été confrontés à des problèmes similaires et ont trouvé des solutions.

Analyse d’un sondage pour détecter les erreurs

Avant de publier ou de republier un sondage dans ArcGIS Survey123 Connect, vous pouvez l’analyser pour trouver les erreurs ou problèmes de lisibilité. Il suffit de cliquer sur le bouton Analyze (analyser) dans la boîte de dialogue de publication pour qu’ArcGIS Survey123 vous informe de toute erreur potentielle dans votre sondage.

Capture d’écran d’une boîte de dialogue verte dans ArcGIS Survey123 Connect dont l’en-tête est « Publish Form 5 » (publier le formulaire 5). Dans cette boîte, un texte indique ce qui suit : « The survey will be updated without affecting the existing data » (le sondage sera mis à jour sans affecter les données existantes). En dessous, au bas de la boîte, se trouvent quatre boutons. De gauche à droite, on peut lire : « Options », « Analyze » (analyser), « Publish survey » (publier le sondage) et « Cancel » (annuler). Le bouton « Analyze » est entouré d’un carré rouge qui le met en évidence.

Cliquez sur « Analyze » (analyser)

Dans cette boîte de dialogue, ArcGIS Survey123 vous informe des erreurs critiques, des avertissements et des problèmes d’information.

  • Les erreurs critiques sont urgentes et doivent toujours être résolues avant d’aller de l’avant.

  • Les avertissements peuvent poser des problèmes, en fonction de votre sondage; il est donc conseillé de les passer en revue.

  • Les problèmes ou recommandations au volet Information sont des suggestions de meilleures pratiques pour votre sondage.

    • Par exemple, l’ajout d’un titre au sondage.

Des informations plus détaillées sont fournies dans le rapport d’erreur Excel joint à l’analyse.

Capture d’écran d’une boîte de dialogue blanche dans ArcGIS Survey123 Connect, qui porte l’en-tête « Analyze survey » (analyser le sondage). Cette boîte comprend le sous-titre « Results » (résultats), suivi d’un paragraphe : « The Analyze survey tool checked the survey’s XLSForm for errors, issues and recommendations. The following table provides a summary of the results. For detailed information, see analysis-20240909160206.xlsx » (l’outil d’analyse a vérifié le formulaire XLSForm du sondage pour détecter les erreurs, les problèmes et les recommandations. Le tableau suivant fournit un résumé des résultats. Pour des informations détaillées, voir analysis-20240909160206.xlsx). Le nom du fichier .xlsx est mis en évidence par un cadre rouge. Sous cet encadré se trouvent trois instructions. La première est accompagnée d’un cercle rouge avec un point d’exclamation au centre, suivi du texte : « Critical: 0. Issues that impact publishing or data storage » (critique : 0 – problèmes ayant une incidence sur la publication ou le stockage des données). En dessous, un signe triangulaire noir avec un point d’exclamation, accompagné du texte « Warning: 0. Issues that impact survey behaviour and performance » (avertissement : 0 – problèmes ayant une incidence sur le comportement et la performance des sondages). Enfin, un symbole circulaire avec un point d’exclamation au centre s’accompagne du texte suivant : « Information: 3. Recommendation and best practices » (information 3 – recommandations et meilleures pratiques). Au-dessous se trouve un bouton « Close » (fermer).

Cliquez sur le lien du rapport d’erreurs

Le rapport d’analyse du sondage signale des problèmes comme les chaînes de caractères tronquées, par exemple, ce qui vous permet d’appliquer la solution avant même de publier votre travail. Vous pouvez également accéder à des liens directs vers des documents pour en savoir plus sur les erreurs et les résoudre facilement.

Capture d’écran d’une feuille de calcul Microsoft Excel comportant six colonnes et deux lignes. La première colonne, intitulée « Severity » (gravité), contient une cellule avec le texte « Critical » (critique). La deuxième colonne, intitulée « Message », contient une cellule avec le texte : « One or more choices in the test choice list exceed the field length for the select_one test question » (la question à une réponse du test comporte une liste dans laquelle un ou plusieurs choix dépassent la longueur du champ). La troisième colonne, intitulée « Description », contient une cellule avec le texte : « Choice names must not exceed the field lengths for the questions that use the choice list. The test choice list contains the following choices that exceed the field length for the select_one test question: 1231231, 123123 » (les noms de choix ne doivent pas dépasser la longueur des champs pour les questions qui utilisent la liste de choix; la liste du test contient les choix suivants qui dépassent la longueur du champ pour la question à une réponse : 1231231, 123123). La quatrième colonne, intitulée « Worksheet » (feuille de calcul), contient une cellule avec le texte : « choices » (choix). La cinquième colonne, intitulée « Cell reference » (référence de cellule), contient une cellule vide. Enfin, la sixième colonne, intitulée « Learn more » (en savoir plus), contient une cellule avec l’hyperlien « Learn more » (en savoir plus) en bleu.

Exemple d’enregistrement de rapport d’erreur

Pour conclure

Quand vous créez un sondage dans ArcGIS Survey123 Connect, les erreurs peuvent être frustrantes, surtout si vous ne savez pas par où commencer pour les résoudre. Toutefois, grâce aux informations contenues dans ce billet de blogue, vous pouvez vous attaquer à ces erreurs en toute confiance. Comprendre pourquoi les erreurs se produisent vous aidera à les traiter efficacement, ce qui réduira la nécessité de contacter l’assistance technique. Cependant, si ce blogue n’a pas résolu votre erreur, communiquez avec l’assistance technique d’Esri Canada ou votre distributeur local.

Ne vivez pas dans la terreur et la crainte d’une erreur! Vous avez maintenant les compétences nécessaires pour être un réparateur d’erreurs dans ArcGIS Survey123 Connect.

Autres ressources

Ce billet a été écrit en anglais par Jordan Tishler et peut être consulté ici.