Cette page contient les problèmes connus susceptibles de survenir lors de l’utilisation de l’application de terrain Survey123 pour compléter une enquête et propose des suggestions pour les résoudre.
Erreur d'envoi
Le message d’erreur suivant peut apparaître si l’enquête terminée n’a pas été envoyée :
Cliquez sur Yes (Oui) dans la zone de message pour revenir à l’enquête et modifier vos réponses avant d’envoyer. Cliquez sur No (Non) pour fermer le message d’erreur et revenir à la boîte d’envoi.
Certaines erreurs d’envoi courantes sont présentées dans le tableau suivant :
| Numéro d’erreur | Description de l’erreur | Diagnostic |
|---|---|---|
Aucun | Configuration requise non satisfaite pour le service d’entités. La propriété supportsApplyEditsWithGlobalIds doit être vraie. | La propriété supportsApplyEditsWithGlobalIds de la couche d’entités n’est pas définie sur true (vrai). Suivez les étapes décrites dans ce billet de blog pour activer la propriété supportsApplyEditsWithGlobalIds. |
400 | URL non valide | La couche d’entités indiquée au chargement du formulaire n’est plus présente, ce qui peut être la conséquence d’un changement apporté au formulaire qui modifie la structure. La seule solution consiste à migrer manuellement les données avec des techniques de récupération. |
498 | Jeton non valide | Le jeton que l’application de terrain tente de transmettre à ArcGIS est rejeté. La raison est souvent que le jeton que l’application tente de transmettre a expiré. Dans ce cas, répétez l’action et l’erreur ne devrait pas se reproduire. |
1000 | Une chaîne ou des données binaires sont tronquées | Le résultat d’une question est trop long pour le champ dans la couche d’entités. Modifiez votre réponse de sorte qu’elle respecte le nombre limite de caractères. |
1000 | Nom de colonne « Shape__Extents » non valide | Le point soumis est en dehors de la vue générale de la couche d’entités. Si ce problème est récurrent et que l’emplacement que vous tentez de soumettre est correct, l’enquête d’entités doit être republiée avec une plus grande étendue. Toutefois, si vous procédez ainsi, sachez que vous perdrez les informations déjà enregistrées dans la couche d’entités. |
1003 | Opération Survey123 annulée | Cela peut se produire lorsqu’une enquête possède des questions masquées ou de calcul contenant le mauvais type de données. Le type de données d’un calcul dépend du type de données de chaque élément du calcul. Le type de liaison XLSForm par défaut pour une question masquée et de calcul est une chaîne. Pour remplacer cette valeur par défaut, saisissez le type requis (par exemple, int ou decimal) dans la colonne bind::type pour votre question. |
1019 | L’entité spécifiée n’a pas pu être mise à jour | Cela peut se produire lorsque vous tentez d’envoyer une enquête mise à jour contenant une répétition dans des versions de l’application de terrain Survey123 avec lesquelles elle n’est pas compatible. La mise à jour d’enquêtes contenant des répétitions est prise en charge dans l’application de terrain Survey123 versions 2.4 et ultérieures. |
Erreur de la boîte de réception
L'erreur You don't have permissions to access this resource or perform this operation. Code 403 (Vous n’êtes pas autorisé à accéder à cette ressource ou à effectuer cette opération. Code 403) peut apparaître lorsqu'un utilisateur autre que l'auteur de la requête actualise la Inbox (Boîte de réception). Si la boîte de réception est activée avant la publication de l'enquête, les droits requis sont activés par défaut. Si l'auteur de l'enquête publie l'enquête avec la boîte de réception désactivée, puis active cette dernière ultérieurement, il doit activer Delete (Supprimer) ou Update (Mettre à jour) dans les paramètres de la couche d’entités afin que les droits requis soient mis à jour.
Référence spatiale non prise en charge lors du téléchargement de cartes
Ce message peut apparaître dans l’application de terrain Survey123 lorsque vous tentez de télécharger un fond de carte sur l’appareil. Survey123 exige que vos fonds de carte utilisent la référence spatiale Web Mercator Auxiliary Sphere. Il s’agit de la même référence spatiale que celle utilisée par le fond de carte World Topographic et d’autres fonds de carte d’Esri. Si l’application de terrain Survey123 détecte que votre enquête est associée à un fond de carte hors connexion qui n’est pas la projection Web Mercator Auxiliary Sphere, ou qui est incorrect ou manquant, un avertissement s’affiche. Notez que, dans certains cas, des informations concernant la référence spatiale peuvent manquer dans les fonds de carte en mode hors connexion. Le message d’avertissement indique alors que la référence spatiale est « none (aucun) ». Un fond de carte hors connexion avec une référence spatiale inconnue (répertoriée comme « none (aucun) ») peut cependant fonctionner correctement dans Survey123 s’il a été créé avec la projection Web Mercator Auxiliary Sphere.
Enregistrement automatique
En cas de plantage de votre appareil ou de votre application pendant que vous répondez à l’enquête, vous pourrez récupérer vos réponses. Tout changement d’approche dans l’enquête (par exemple, l’activation par l’utilisateur d’une nouvelle question) déclenche la copie, dans un fichier intitulé autosave.json, du contenu de toutes les questions auxquelles des réponses ont déjà été données. Ce fichier se trouve dans le dossier My Surveys (Mes enquêtes) pendant la saisie de l’enquête et est utilisé si l’application se ferme de manière anormale avant la fin de la saisie de l’enquête dans la base de données.
Au démarrage, l’application de terrain Survey123 vérifie la présence du fichier d’enregistrement automatique. S’il est trouvé, vous êtes informé que les réponses apportées à l’enquête ont été récupérées, et le nom de l’enquête ainsi que le nom de l’instance sont affichés.
Si vous cliquez sur l’option Discard survey (Abandonner l’enquête), le fichier autosave.json est supprimé, ce qui entraîne la perte des données récupérées. L’option Continue survey (Poursuivre l’enquête) ouvre l’enquête et la renseigne avec les données récupérées. Le fichier autosave.json est supprimé automatiquement lorsqu’une enquête est complétée avec succès, ou enregistrée comme brouillon.
Remarque :
L’enquête récupérée inclut toutes les questions auxquelles des réponses ont été données au préalable, hormis la question en cours de traitement lors de la panne de l’appareil. Il en est ainsi parce que l’élément déclencheur de l’enregistrement d’une question est le passage à une autre question.
Si vous ne souhaitez pas que l’enquête soit enregistrée automatiquement chaque fois que vous abordez une nouvelle question, vous pouvez utiliser la colonne bind::saveIncomplete pour ajouter des étapes d’enregistrement à votre enquête. Définissez la valeur sur true pour chaque question pour laquelle vous souhaitez déclencher un enregistrement. Vous pouvez appliquer la colonne bind::saveIncomplete aux types de questions suivants :
- Texte
- Entier
- Durée
- Date
- Date-heure
- Questions à choix multiples
- Choix unique
Activer la journalisation des diagnostics
Si vous observez des messages d’erreur ne figurant pas dans cette rubrique ou d’autres comportements inattendus, il peut être utile de constituer un journal d’informations provenant de l’application de terrain Survey123 à partager (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. L’option 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 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, puis 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.
Récupérer des données avec l’application de terrain bureautique
Il arrive que vous ne puissiez pas envoyer d’enquêtes à partir de votre appareil mobile, soit parce qu’aucune connexion Internet sans fil n’est disponible, soit parce qu’un événement inattendu s’est produit sur votre mobile ou votre base de données serveur.
Les données de votre enquête sont stockées sur votre appareil mobile sous la forme d’une base de données .sqlite. Vous pouvez copier et mettre à jour cette base de données pour faciliter la récupération des données.
Si le problème est lié à la connexion Internet à partir de votre appareil mobile, vous pouvez copier votre base de données .sqlite sur votre ordinateur de bureau, l’ouvrir dans la version bureautique de l’application de terrain Survey123, puis envoyer vos enquêtes.
Avant de démarrer la procédure, téléchargez l’enquête dont vous tentez de récupérer les résultats sur votre version bureautique de l’application de terrain Survey123.
- Copiez le fichier .sqlite depuis votre appareil.
Remarque :
Si vous utilisez un appareil iOS, vous devez utiliser une application de navigateur de fichiers iOS. Sur macOS version 10.15 Catalina ou version ultérieure, vous pouvez utiliser Finder comme navigateur de fichiers. Sur les versions antérieures de macOS ou sur Windows, vous pouvez utiliser iTunes ou une autre application de navigateur de fichiers. Le fichier est automatiquement stocké dans Survey123/ArcGIS/My Surveys/Databases.
Si vous utilisez un appareil Android, le fichier est automatiquement stocké dans l’emplacement de stockage propre à l’application : Android/data/com.esri.survey123/files/ArcGIS/My Surveys/Databases. Avant Survey123 version 3.12, les fichiers étaient stockés dans l’emplacement de stockage interne ArcGIS/My Surveys/Databases.
- Collez ce fichier .sqlite dans le dossier Survey123 équivalent sur votre ordinateur de bureau (par exemple, sur Windows, il s’agit de C:\Users\<username>\ArcGIS\My Surveys\Databases).
Remarque :
Si vous avez déjà collecté des enquêtes sur le Bureau, vous y avez peut-être déjà une base de données. Si tel est le cas, vous pouvez l’enregistrer dans un sous-dossier ou renommer le dossier de base de données et en créer un pour les fichiers copiés. Si vous n’avez pas renseigné les enquêtes que vous devez envoyer, vous pouvez les supprimer de la base de données sur le Bureau en toute sécurité.
- Si votre enquête comporte des questions de type image, audio ou fichier, copiez également le répertoire My Survey Attachments (Pièces jointes de mon enquête) depuis votre appareil sur votre bureau.
- Ouvrez l’application de terrain Survey123, accédez à Settings (Paramètres) > Advanced (Avancé), puis cliquez sur le bouton Fix Database (Corriger la base de données).
- Localisez votre enquête et vérifiez que des enquêtes sont prêtes à être envoyées.
- Envoyez vos enquêtes.
Récupérer des données avec l’application de terrain bureautique et en apportant des mises à jour manuelles à la base de données
Il arrive que l’outil Corriger la base de données ne parvienne pas à récupérer vos données, ou que d’autres erreurs se soient produites avec votre base de données. Dans ce cas, vous pouvez également modifier manuellement les chemins stockés dans la base de données .sqlite.
La procédure suivante explique comment modifier manuellement votre base de données .sqlite.
- Copiez le fichier .sqlite depuis votre appareil. Le fichier se trouve dans ArcGIS/My Surveys/Databases.
- Collez ce fichier .sqlite dans le dossier Survey123 équivalent sur votre ordinateur de bureau (par exemple, sur Windows, il s’agit de C:\Users\<username>\ArcGIS\My Surveys\Databases).
- Ouvrez la base de données .sqlite dans un éditeur de base de données. DB Browser for SQLite est un exemple d’éditeur.
- Si vous utilisez DB Browser for SQLite, regardez la colonne de chemin sous l’onglet Browse Data (Parcourir les données). Vous verrez que chaque enregistrement représente une seule enquête complétée et que chaque chemin fait référence à l’appareil sur lequel elle a été renseignée. Pour pouvoir envoyer les enquêtes contenues sur le Bureau, vous devez changer le chemin pour qu'il corresponde au chemin vers les données d’enquête du Bureau.
- Pour modifier l’enregistrement, sous l’onglet Execute SQL (Exécuter le SQL), tapez ce qui suit, en utilisant vos informations de chemin local.
UPDATE Surveys SET path = REPLACE (path,"/sdcard", "C:/Users/Me") where path LIKE "/sdcard%" - Retournez sous l’onglet Browse Data (Parcourir les données) et vérifiez que les chemins ont changé.
- Fermez l’application SQLite.
- Ouvrez l’application de terrain Survey123 et vérifiez qu’il y a désormais plusieurs enquêtes prêtes à être envoyées (un numéro rouge doit apparaître dans l’angle de la miniature de l’enquête).
- Envoyez vos enquêtes.
Vous avez un commentaire à formuler concernant cette rubrique ?