Se préparer à modifier des données d’enquête existantes

Outre l’envoi de nouvelles données à une couche d’entités via une enquête, vous pouvez avoir besoin de modifier des données d’enquête que vous avez envoyées récemment, qui ont été collectées il y a quelque temps ou par d’autres utilisateurs de l’enquête.

Activer la mise à jour

Il est possible de mettre à jour les réponses à une enquête dans le dossier Sent (Éléments envoyés) et dans Inbox (Boîte de réception). Pour que la mise à jour soit autorisée pour une enquête, elle doit également l’être pour la couche d’entités sous-jacente.

Vous pouvez mettre à jour les enquêtes déjà envoyées présentes dans l’application de terrain Survey123, dans le dossier Sent (Éléments envoyés). Pour plus d’informations sur la configuration des options des enquêtes envoyées, reportez-vous à la rubrique Dossier Éléments envoyés.

Pour mettre à jour les données d’enquête existantes enregistrées dans la couche d’entités de l’enquête (les données collectées par un autre utilisateur, par exemple), vous devez activer la boîte de réception.

Attention :

Si vous activez la boîte de réception, l’accès en lecture à vos données d’enquête est activé, ce qui expose vos réponses. Pour plus d’informations et pour connaître les meilleures pratiques en matière de protection des données, consultez la rubrique Partager une enquête.

Pour activer la boîte de réception, cliquez sur l’onglet Options de votre enquête dans Survey123 Connect, puis sur Enable Inbox (Activer la boîte de réception). Une série d’options s’affiche, vous permettant de contrôler la manière dont les utilisateurs interagissent avec les enquêtes dans la boîte de réception. Toutes les modifications apportées à ces options prennent effet lors de la publication de l’enquête.

Choisissez si les enquêtes dans la boîte de réception peuvent être mises à jour, consultées (lecture seule) ou copiées dans une nouvelle enquête. Vous pouvez saisir une expression de requête pour limiter les enquêtes renvoyées dans la boîte de réception. Vous pouvez également appliquer un filtre spécial.

Remarque :

La boîte de réception (Inbox) peut contenir un maximum de 5 000 réponses à l’enquête. Cette limite s’applique aux enregistrements d’enquête parent uniquement (pas aux répétitions).

Plus il y a d’enregistrements à renvoyer, plus l’actualisation de la boîte de réception (Inbox) prend du temps. Dans le cas d’une enquête contenant des répétitions, sachez que le nombre total d’enregistrements récupérés par la boîte de réception (Inbox) au cours de son actualisation peut être bien supérieur au nombre d’enregistrements parent. Par exemple, si une couche d’entités contient 2 000 enregistrements parent et que chacun d’eux comporte 10 enregistrements de répétition, la boîte de réception (Inbox) récupère un total de 22 000 enregistrements. Vous pouvez appliquer une expression de requête ou un filtre spatial pour limiter le nombre d’enregistrements parent. Vous pouvez définir une requête dans la colonne bind::esri:parameters pour limiter le nombre d’enregistrements de répétition.

Attention :

Une réponse à l’enquête ne peut exister que sur un appareil et dans un dossier à la fois. Si les dossiers Sent (Éléments envoyés) et Inbox (Boîte de réception) sont tous les deux activés pour une enquête, l’actualisation de la boîte de réception ne permet pas de télécharger les réponses qui se trouvent déjà dans le dossier Sent (Éléments envoyés). En d’autres termes, si une réponse qui se trouve dans le dossier Sent (Éléments envoyés) est mise à jour par un utilisateur sur un autre appareil, la réponse mise à jour n’est pas téléchargée dans la boîte de réception.

C’est pour cette raison qu’il est recommandé de ne pas activer les dossiers Sent (Éléments envoyés) et Inbox (Boîte de réception) pour la même enquête, si plusieurs utilisateurs doivent pouvoir modifier et mettre à jour en continu les réponses existantes.

Expressions WHERE

Les enquêtes disponibles pour mise à jour dans la boîte de réception de l’application de terrain Survey123 sont déterminées par l’expression de requête spécifiée sous l’onglet Options de votre enquête dans Survey123 Connect. L’enquête doit être publiée chaque fois que cette requête est modifiée pour que les modifications prennent effet.

Les expressions de requête doivent utiliser la syntaxe SQL et les fonctions prises en charge par ArcGIS. Toutes les requêtes sont exécutées sur la couche d’entités de l’enquête ; vous pouvez ainsi créer et tester votre expression en utilisant l’opération de requête sur le point de terminaison REST de la couche d’entités. Pour en savoir plus sur ce processus et pour voir des exemples de syntaxe de requête, consultez Query (Feature Service). Pour plus d’informations sur les fonctions prises en charge, reportez-vous à la rubrique Fonctions SQL standard dans ArcGIS Online.

Voici des exemples de cas d’utilisation et de syntaxe :

• Cet exemple renvoie les enquêtes dans lesquelles le nombre indiqué dans le champ rating est supérieur ou égal à 2 :

  rating>=2

• Cet exemple renvoie les enquêtes dans lesquelles la date indiquée dans le champ EditDate est égale ou postérieure au 13 avril 2017 :

  EditDate>='2017-4-13'

• Cet exemple renvoie les enquêtes dans lesquelles le champ Editor est égal à « BKlauser » :

  Editor='BKlauser'

• Cet exemple renvoie les enquêtes dans lesquelles le champ status est égal à « for_review» :

  status='for_review'

• Cet exemple renvoie les enquêtes dans lesquelles la date du champ inspection_date remonte au sept derniers jours :

  inspection_date>CURRENT_DATE-7 AND inspection_date<=CURRENT_DATE

• Cet exemple renvoie les enquêtes dans lesquelles le champ project_status n’est pas égal à « complete » :

  project_status<>'complete'

• Cet exemple renvoie les enquêtes dans lesquelles le champ final_approval est vide (nul) :

  final_approval IS NULL

• Cet exemple renvoie les enquêtes dans lesquelles le champ final_approval n’est pas vide (nul) :

  final_approval IS NOT NULL

Les interrogations de la boîte de réception prennent également en charge la variable username. La variable doit être définie dans le même format que les expressions XLSForm. Par exemple, la requête Creator=${username} recherche tous les enregistrements d’enquête créés par l’utilisateur actuellement connecté.

Remarque :

La variable username représente le seul cas où la syntaxe XLSForm peut être utilisée dans une expression de requête de boîte de réception. La variable username doit être écrite sous la forme ${username}, mais sa valeur est dérivée du compte ArcGIS de l’utilisateur connecté et non d’une question de l’enquête.

Pour renvoyer les enregistrements concernant l’utilisateur connecté à partir d’un champ qui contient une liste de plusieurs utilisateurs, la fonction POSITION() doit être utilisée dans la requête. Par exemple, la requête POSITION(${username} IN assigned_to) > 0 renvoie tous les enregistrements d’enquête qui incluent l’utilisateur connecté, les valeurs du champ assigned_to pouvant correspondre à une liste séparée par des virgules de tous les personnes affectées possibles, comme George_Smith, Nick_Jones.

Filtre spatial

Dans la boîte de réception, le fait de sélectionner Refresh (Actualiser) permet de mettre à jour la liste des enquêtes dans l’onglet List (Liste). En règle générale, l’actualisation renvoie toutes les enquêtes qui satisfont à l’expression de requête de la boîte de réception (si elle est définie) et qui ne sont pas déjà enregistrées dans d’autres dossier sur l’appareil. Lorsque vous sélectionnez Refresh (Actualiser) dans l’onglet Map (Carte), un filtre spatial peut être appliqué pour mettre à jour la liste et ne présenter que les enquêtes se trouvant dans l’étendue actuelle de la carte.

Pour activer le filtre spatial, sélectionnez Apply spatial filter when the map tab is visible (Appliquer le filtre spatial lorsque l’onglet de carte est visible) dans l’onglet Options de Survey123 Connect. Dans l’exemple suivant, lorsque Refresh (Actualiser) est sélectionné, la liste des enquêtes est mise à jour pour n’afficher que les quatre réponses à l’enquête visibles dans l’étendue actuelle de la carte. Si un nom d’instance est défini dans votre enquête, chaque entité présente sur la carte est étiquetée avec son nom d’instance.

Répétitions

Survey123 autorise la mise à jour des entités qui ont des enregistrements associés à partir de Inbox (Boîte de réception) ou du dossier Sent (Éléments envoyés). De nouveaux enregistrements peuvent être ajoutés et des enregistrements existants peuvent être modifiés, même si la suppression d’enregistrements existants n’est pas prise en charge. Par défaut, la mise à jour des enregistrements existants est désactivée, sauf si allowUpdates=true est activé par un paramètre de requête.

La colonne bind::esri:parameters peut être utilisée pour fournir des paramètres facultatifs pour une répétition. Ces paramètres sont formatés comme paires de valeur clé, avec des valeurs dont les espaces figurent entre guillemets.

Par défaut, aucun enregistrement associé n’est disponible avec les réponses de l’enquête via Inbox (Boîte de réception) ou le dossier Sent (Éléments envoyés). Pour accéder aux enregistrements associés à une réponse, définissez une requête dans la colonne bind::esri:parameters pour le type de question begin repeat (commencer la répétition) . La propriété de la requête prend en charge les mêmes paramètres que les expressions WHERE ci-dessus, par exemple query="Editor='BKlauser'" pour télécharger uniquement les enregistrements associés dont le champ Editor (Éditeur) comporte « BKlauser ».

Pour télécharger tous les enregistrements dans un tableau associé, indiquez une requête sans paramètre (query).

Les paramètres pouvant être appliqués aux répétitions via la colonne bind::esri:parameters sur un type de question begin repeat (commencer la répétition) incluent les éléments suivants :

• query : Permet d’interroger les enregistrements et de les télécharger dans la table associée (query="severity='high'", par exemple).
• allowAdds : Permet d’ajouter de nouveaux enregistrements dans une répétition lors de la mise à jour. Par défaut, la valeur est définie sur true (vrai). Elle peut être définie sur false (faux) à l’aide de allowAdds=false.
• allowUpdates : Permet la mise à jour des enregistrements existants dans une répétition lors de la mise à jour. Par défaut, cette propriété est définie sur faux. Elle peut être définie sur true (vrai) à l’aide de allowUpdates=true.

Plusieurs paires clé-valeur peuvent être utilisées conjointement, séparées par des espaces (par exemple, allowUpdates=true query="Editor='BKlauser'"). Si ces valeurs comportent des espaces, elles peuvent être placées entre guillemets.

Images

Survey123 permet à l’utilisateur d’ajouter des images à des enregistrements d’enquête existants. Bien que la mise à jour des images existantes ne soit pas prise en charge, chaque question de type image propose un bouton Duplicate (Dupliquer) lors de la mise à jour d’une enquête afin de copier une image existante qui peut ensuite être mise à jour par rotation, modification de nom ou modification avec les apparences draw et annotate.

L’offre de nouvelles images est activée par défaut. Pour désactiver cette fonctionnalité, saisissez allowAdds=false dans la colonne bind::esri:parameters.

La mise à jour des images fait l’objet de certaines limitations connues :

• Les processus hors connexion ne sont pas pris en charge.
• L’apparence signature ne prend pas en charge la fonction Duplicate (Dupliquer).
• Les pièces jointes des images sont liées à la question pour laquelle l’image a été envoyée sur la base de propriétés de mots-clés. Les propriétés de mots-clés ne sont pas prises en charge par ArcGIS Enterprise avant la version 10.8.1. Ainsi, une image soumise pour une enquête publiée dans une version du portail ArcGIS Enterprise antérieure à 10.8.1 n’est pas associée à une question. De même, les images associées à une entité au moyen d’une méthode autre qu’une enquête (par exemple, dans ArcGIS Pro ou une carte Web ArcGIS Online) peuvent ne pas comporter de mots-clés.
• Lorsqu’une enquête existante est téléchargée sur un appareil pour être utilisée à partir de Inbox (Boîte de réception), les images existantes ne sont pas téléchargées. La fonction count-selected comptabilise uniquement les images qui se trouvent sur l’appareil et renvoie 0 à la première ouverture de l’enquête. Les nouvelles images capturées sont comptabilisées.