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é recueillies il y a quelque temps, ou par d’autres utilisateurs de l’enquête.

Activer la mise à jour

Les réponses à l’enquête peuvent être mises à jour 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 votre enquête, elle doit également l’être pour la couche d’entités sous-jacente.

Vous pouvez mettre à jour toutes 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 couches d’entités de l’enquête (les données collectées par un autre utilisateur, par exemple), vous devez activer Inbox (Boîte de réception).

Attention :

Si vous activez Inbox (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 de protection de vos données, consultez Partager votre 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.

Mise à jour d’enquête activée dans

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 choisir d’appliquer un filtre spécial.

Conseil :

À compter de la version 3.13 de Survey123, la boîte de réception est utilisable dans les enquêtes publiques.

Attention :

Si le dossier Sent (Éléments envoyés) et la boîte de réception sont activés pour une enquête, l’actualisation de la boîte de réception ne télécharge pas les réponses qui se trouvent actuellement dans le dossier Sent (Éléments envoyés). Ainsi, si une réponse qui se trouve dans le dossier Sent (Éléments envoyés) a été mise à jour par un autre utilisateur, la réponse mise à jour n’est pas téléchargée.

Pour cette raison, il est recommandé de ne pas activer les dossiers Sent (Éléments envoyés) et la 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 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'

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é.

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.

Onglet de carte pour le filtrage spatial

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 ont des espaces entre elles, elles peuvent être placées entre guillemets.

Images

Survey123 3.13 et les versions ultérieures permettent à 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é, entrez 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.