Prérenseigner les réponses

Vous pouvez prérenseigner les réponses dans Survey123 de plusieurs manières.

Réponses par défaut

Vous pouvez définir les réponses par défaut aux questions d’enquête dans la colonne default de votre feuille de calcul lorsque vous concevez votre enquête. Cela a pour effet de prérenseigner la question avec la même réponse chaque fois que vous commencez une enquête ou lorsqu’une question devient pertinente. Cette fonction est particulièrement utile lorsque la réponse à la question de votre enquête est la même la plupart du temps. Vous pouvez toujours mettre à jour la réponse par défaut le cas échéant, mais la définition de la réponse par défaut permet de gagner du temps lors du remplissage de vos enquêtes. Les réponses par défaut peuvent contenir des constantes telles que des chaînes et des nombres.

Les réponses aux questions à choix multiple fonctionnent différemment des autres, les réponses vérifiées étant saisies dans l’ordre de sélection, séparées par des virgules. Pour définir plusieurs valeurs en tant que valeurs par défaut dans un champ select_multiple, séparez-les par des virgules, par exemple : élément1,élément2,élément3.

Les questions de type géopoint, géotrace et géoforme prennent en charge les réponses par défaut. Pour plus d’informations sur la définition d’une valeur par défaut, reportez-vous aux rubriques Géopoints et Géotrace et géoforme.

Calculs

Les calculs sont similaires aux valeurs par défaut, mais il existe des différences. À la différence de la colonne default (par défaut), dont la valeur est calculée à l’ouverture de l’enquête ou lorsqu’une question devient pertinente, les calculs sont effectués chaque fois que les réponses de l’enquête qu’ils utilisent en entrée changent ou deviennent pertinentes. Les calculs peuvent utiliser des réponses existantes dans votre formulaire. Ainsi, l’expression 100 - (${integer1} + ${integer2}) saisie dans la colonne de calcul d’une question additionne les valeurs des questions integer1 et integer2, soustrait cette valeur de 100, puis définit cette valeur comme étant votre réponse. L’utilisateur peut remplacer cette valeur, mais le calcul peut constituer une réponse de départ pour le guider.

Conseil :

Si le résultat d’un calcul est mis à jour manuellement, vous pouvez utiliser le bouton qui apparaît pour effacer la valeur mise à jour et relancer le calcul.

Mode de calcul

Le paramètre calculationMode saisi dans la colonne bind::esri:parameters détermine à quel moment les calculs dans les questions sont relancés (par exemple, calculationMode=manual). Quatre valeurs sont prises en charge :

• auto : calcule à quel moment la question est vide ou n’a pas été précédemment modifiée par l’utilisateur. Si aucune valeur n’est fournie, il s’agit du comportement de calcul par défaut.
• manual : la question n’est calculée que lorsque l’utilisateur clique sur le bouton Calculate (Calculer).
• always : calcule à quel moment une valeur référencée dans l’expression de calcul change. Inclut les fonctions dynamiques telles que now().
• whenEmpty : le calcul est effectué jusqu’à ce qu’une valeur non vide soit renvoyée. Lorsqu’une valeur non vide est renvoyée, la question se comporte de la même manière qu’en mode manual. Les calculs qui contiennent des fonctions dynamiques, comme now(), ne sont pas recalculés, sauf si l’utilisateur clique sur le bouton Calculate (Calculer). Le mode whenEmpty est utile si vous ne souhaitez pas qu’une question qui a déjà été calculée avec une valeur non vide soit mise à jour lorsque le formulaire est rechargé, par exemple lorsqu’il est ouvert à partir de Inbox (Boîte de réception).

Les types de question suivants prennent en charge le paramètre calculationMode :

• Texte
• decimal
• entier
• note
• date
• heure
• dateTime
• select_one
• select_multiple
• geopoint
• calculate
• masqué

Remarque :

Le paramètre calculationMode n’est pas pris en charge par l’application Web Survey123.

Propriétés concernant l’appareil et l’utilisateur

La fonction pulldata("@property") permet d’extraire des informations sur les appareils à partir desquels les réponses aux enquêtes sont envoyées, ainsi que sur les utilisateurs connectés qui envoient ces réponses. Cette fonction est utile pour enregistrer des détails techniques et des informations sur le contexte dans lequel l’enquête a été réalisée.

Elle renvoie une propriété d’appareil ou d’utilisateur au format pulldata("@property", '<property name>'). L’exemple suivant renvoie le décalage horaire par rapport au temps universel (UTC) de l’appareil pour aider les utilisateurs à enregistrer le fuseau horaire dans lequel l’enquête a été réalisée :

pulldata("@property", 'utcOffset')

La fonction pulldata("@property") permet de détecter le mode d’interaction actuel de l’utilisateur ainsi que sa réponse à l’enquête en utilisant ce qui suit :

pulldata("@property", 'mode')

Trois valeurs sont possibles pour la propriété mode. La valeur new est renvoyée si l’utilisateur produit une nouvelle réponse à l’enquête (y compris une réponse copiée depuis une enquête existante), la valeur edit est renvoyée si l’utilisateur met à jour une réponse existante et la valeur view est renvoyée si l’utilisateur consulte une réponse existante en mode de lecture seule. L’exemple suivant, lorsqu’il est inséré dans la colonne readonly (lecture seule), détecte si l’utilisateur met à jour une réponse existante et l’empêche de mettre à jour la question choisie :

pulldata("@property", 'mode') = 'edit'

La fonction pulldata("@property") permet également de voir où une enquête a été ouverte. L’exemple suivant détermine si l’enquête a été ouverte depuis la boîte de réception :

pulldata("@property", 'status') = 'inbox'

Attention :

Il est conseillé de ne pas stocker les résultats des propriétés mode ou status dans une question masquée ou de calcul et de ne pas activer ou désactiver des questions avec ces propriétés dans la colonne relevant (pertinent). Sinon, le contenu de ces champs risque d’être supprimé ou les valeurs risquent de ne pas s’actualiser comme prévu.

La fonction pulldata("@property") prend en charge les propriétés suivantes :

Propriété	Description
pulldata("@property", 'portalUrl')	URL du portail auquel l’enquête est envoyée.
pulldata("@property", 'token')	Jeton transmis à la couche d’entités.
pulldata("@property", 'portalInfo')	Ensemble des informations sur le portail, sous la forme d’un objet JSON.
pulldata("@property", 'online')	Valeur booléenne. La valeur est True (Vrai) s’il existe une activité réseau sur l’appareil ; sinon, la valeur est False (Faux).
pulldata("@property", 'utcOffset')	Décalage, en heures, par rapport au temps universel coordonné (UTC) pour le fuseau horaire local.
pulldata("@property", 'language')	Langue utilisée dans l’enquête en cours.
pulldata("@property", 'locale')¹	Objet Locale (Paramètre régional) utilisé dans l’enquête en cours.
pulldata("@property", 'localeInfo')¹	Objet LocaleInfo de AppStudio utilisé dans l’enquête en cours et qui contient le code de langue dans différentes notations.
pulldata("@property", 'timeZone')	Code du fuseau horaire.
pulldata("@property", 'username')	Nom d’utilisateur du compte d’organisation de l’utilisateur actuellement connecté.
pulldata("@property", 'email')	Adresse e-mail du compte d’organisation de l’utilisateur actuellement connecté.
pulldata("@property", 'userFullName')	Nom et prénom de l’utilisateur actuellement connecté.
pulldata("@property", 'userFirstName')²	Prénom de l’utilisateur actuellement connecté.
pulldata("@property", 'userLastName')²	Nom de l’utilisateur actuellement connecté.
pulldata("@property", 'deviceId')³	ID unique généré par Survey123 représentant l’appareil spécifique sur lequel l’enquête a été exécutée. Cet ID est différent de l’IMEI (identité internationale d’équipement mobile) d’un appareil mobile car Survey123 s’exécute sur des appareils susceptibles de ne pas avoir d’IMEI.
pulldata("@property", 'deviceModel')³	Nom de modèle de l'appareil de l'utilisateur.
pulldata("@property", 'OS')³	Nom du système d'exploitation de l'appareil de l'utilisateur.
pulldata("@property", 'appVersion')	Numéro de version de l'application de terrain ou de l'application Web.
pulldata("@property", 'surveyName')	Nom de l'enquête.
pulldata("@property", 'userAgent')	Chaîne de l'agent de l’utilisateur pour l'appareil de l'utilisateur.
pulldata("@property", 'mode')	Renvoie new si l’utilisateur crée une réponse à l’enquête, edit si l’utilisateur met à jour une réponse existante ou view si l’utilisateur consulte une réponse en lecture seule.
pulldata("@property", 'status')	Renvoie draft, submitted, sent ou inbox si l’enquête a été ouverte depuis Drafts (Brouillons), Outbox (Boîte d’envoi), Sent (Envoyés) ou Inbox (Boîte de réception), respectivement. Une chaîne vide est renvoyée si la réponse est nouvelle.

¹À utiliser uniquement avec la fonction pulldata("@javascript").

² Ces paramètres dépendent de ce qui est présent dans la configuration du fournisseur d'identités et risquent de ne pas être disponibles dans les organisations qui utilisent une authentification autre que celle intégrée.

³ Application de terrain Survey123 uniquement.

Réponses préférées

Une fois que vous avez saisi des réponses dans l’application de terrain Survey123, vous pouvez les enregistrer pour les utiliser dans des enquêtes ultérieures en définissant vos réponses préférées. Dans le menu dans l’angle supérieur droit, vous pouvez utiliser l’état actuel de votre enquête pour définir vos réponses préférées.

Une fois vos réponses préférées définies, vous pouvez les insérer dans de nouvelles enquêtes en ouvrant le menu et en cliquant sur Paste answers from favorite (Coller des réponses depuis les réponses préférées).

Si vous avez besoin à un moment quelconque de modifier vos réponses préférées, saisissez-les dans votre enquête actuelle, puis cliquez sur Définir en tant que réponses préférées. Si vous saisissez des informations répétitives dans un champ, vous pouvez utiliser vos réponses actuelles pour prérenseigner les enquêtes ultérieures. L’enquête que vous utilisez pour définir vos réponses préférées est signalée par une étoile.

Remarque :

Si le dossier Sent (Éléments envoyés) a été désactivé, vous ne pouvez pas utiliser une enquête envoyée pour les réponses préférées. Dans ce cas, le fait d’enregistrer votre enquête avec vos réponses préférées en mode Brouillon permet d’activer l’option Past answers from favorite (Coller des réponses depuis les réponses préférées).

Données CSV

Alimenter les réponses grâce à des informations que vous avez stockées sur votre appareil permet de réduire le temps nécessaire pour renseigner votre enquête. Ces informations peuvent être des données recueillies d’une enquête précédente ou elles peuvent offrir plusieurs réponses d’après la saisie par l’utilisateur d’une réponse unique.

Le renseignement préalable des réponses est utile dans les enquêtes d’inspection des ressources. En saisissant le numéro d’identification d’une ressource (en le tapant ou en numérisant un code à barres), vous pouvez récupérer les données de cette ressource à partir du fichier .csv et les utiliser pour répondre à d’autres questions concernant notamment la localisation, la dernière date d’inspection et l’état lors de la dernière inspection.

Pour plus de détails sur la façon d’alimenter des questions de cette façon, voir Extraire une valeur d’un fichier CSV.

Remarque :

S’il manque un en-tête de colonne dans votre fichier .csv ou si une virgule se trouve à la fin des lignes du fichier, il est impossible d’importer le fichier .csv dans l’enquête.