Vous pouvez inclure des questions de type texte, entier et décimal dans les enquêtes pour permettre aux utilisateurs de saisir du texte et des réponses numériques.
Les questions de type texte autorisent la saisie de texte libre dans les réponses à l’enquête. Par défaut, le formulaire affiche une zone de texte avec une ligne unique en entrée. Si le texte dépasse la taille de la zone de texte, il conserve sa taille et défile à l’horizontale, sans sauts de ligne. Cette option est idéale pour les réponses courtes. Pour forcer la saisie de texte à adhérer à un certain format, vous pouvez appliquer un masque de saisie. Vous pouvez également appliquer une expression régulière en vue de limiter le champ de texte et rejeter automatiquement les réponses qui ne figurent pas dans le format donné, par exemple une adresse e-mail ou l’URL d’un site Web.
Les questions de type entier et décimal limitent les saisies utilisateur aux valeurs numériques applicables. Dans la colonne constraint (contrainte) de ces types de question, vous pouvez spécifier les valeurs minimale et maximale pour empêcher l’utilisateur d’envoyer l’enquête si la réponse ne se situe pas dans la plage donnée.
Vous pouvez changer le comportement de ces types de question et leur mode de présentation en définissant l’apparence. Pour savoir avec certitude quelles applications d’envoi prennent en charge une apparence en particulier, reportez-vous à la rubrique Apparences.
Apparence du texte
Remarque :
Dans Survey123 Mobile, seule l’apparence multiline (multiligne) est prise en charge pour les questions de type texte.
Dans l’application Web Survey123, les apparences predictivetext et nopredictivetext ne sont pas prises en charge.
Lorsque la colonne appearance (apparence) est définie sur multiline (multiligne), une question de type texte est présentée sous la forme d’une zone de texte multiligne. Cette zone de texte agrandie est idéale pour les réponses longues. Elle renvoie le texte à la ligne à mesure qu’il est saisi et accepte les retours chariot.
Remarque :
Pour les formulaires utilisés dans l’application de terrain Survey123, vous pouvez spécifier la hauteur par défaut de la zone de texte multiligne en définissant le paramètre defaultHeight dans la colonne body::esri:style. Par exemple, saisissez defaultHeight=5 dans la colonne body::esri:style pour afficher cinq lignes dans une zone de texte multiligne à l’ouverture de l’enquête. Si ce paramètre n’est pas défini, la zone de texte multiligne affichage trois lignes à l’ouverture de l’enquête.
Lorsque l’apparence est définie sur predictivetext ou sur nopredictivetext, une question de texte prend en charge l’activation ou la désactivation, respectivement, de la saisie intuitive sur les appareils mobiles. Par défaut, Android désactive la saisie intuitive pour les questions de type texte, ce qui peut désactiver la fonction de synthèse vocale sur certains claviers. Appliquez l’apparence predictivetext (saisie intuitive) à une question de type texte afin d’activer la synthèse vocale pour cette question. Le texte prédictif est activé par défaut sur iOS.
Lorsque l’apparence est définie sur geocode (géocode), une question de type texte est utilisée pour rechercher et envoyer une adresse géocodée.
Les apparences sont également disponibles pour obtenir un ID de balise InfraMarker et obtenir une valeur d’un télémètre.
Rechercher et envoyer une adresse géocodée
Remarque :
Cette section décrit les fonctions qui sont uniquement disponibles dans l’application de terrain Survey123. Ces fonctions ne sont pas disponibles dans Survey123 Mobile.
Lorsque la colonne appearance (apparence) est définie sur geocode (géocode), une question de type texte est utilisée pour rechercher et envoyer une adresse géocodée. Lorsque les utilisateurs commencent à saisir une adresse, une série d’options de renseignement automatique apparaît. Celles-ci suggèrent des localisations basées sur les localisateurs disponibles par défaut pour leur organisation. Si l’utilisateur n’est pas connecté, ArcGIS World Geocoder est utilisé. L’apparence geocode nécessite une connexion Internet et ne fonctionne pas dans un environnement non connecté.
L’adresse finale sélectionnée sera transmise à la couche d’entités sous forme d’une chaîne. Cependant, les données géocodées complètes sont provisoirement stockées sous forme d’un objet JSON avant d’être envoyées, ce qui permet l’extraction de propriétés individuelles dans d’autres champs.
Pour extraire des propriétés spécifiques de l’objet JSON, utilisez la fonction pulldata("@json") dans la colonne calculation d’une autre question.
pulldata("@json", ${address}, "location.x")
pulldata("@json", ${address}, "searchCandidate")
L’ensemble de l’objet JSON peut être renvoyé sous forme d’une zone de texte si vous ne définissez aucune propriété individuelle.
pulldata("@json", ${address})
Pour plus d’informations sur la fonction pulldata("@json"), consultez Extraire une valeur d’un objet JSON.
Remarque :
Le géocodage à l’aide de ArcGIS World Geocoding Service consomme des crédits. Pour plus d’informations, reportez-vous à la rubrique Présentation des crédits.Pour définir le localisateur chargé de renvoyer les résultats, indiquez l’ID d’élément du localisateur dans la colonne bind::esri:parameters, par exemple, geocode=36ff9e8c13e042a58cfce4ad87f55d19. Un localisateur utilisé dans une enquête ArcGIS Online doit correspondre à un élément dans ArcGIS Online. Un localisateur utilisé dans une enquête ArcGIS Enterprise doit correspondre à un élément du même portail que l’enquête.
Les propriétés disponibles varient selon le localisateur utilisé. Seule exception, la propriété searchText reste disponible quel que soit le localisateur employé. Elle renvoie la chaîne exacte utilisée pour rechercher l’adresse ou l’option sélectionnée dans la liste des résultats.
Vous pouvez contrôler davantage la présentation d’une question dont l’apparence est geocode en définissant l’un des paramètres suivants dans la colonne body::esri:style :
Remarque :
Les paramètres indicator, proximity, maxResults et suggestions ne sont pas pris en charge dans l’application Web Survey123.
- indicator — Autorise les résultats géocodés à afficher la direction et la distance par rapport à la position actuelle de l’appareil. Ce paramètre peut être défini sur distance, direction, les deux valeurs étant séparées par une virgule ou none. Par défaut, ce paramètre est défini pour n’afficher que la distance.
- proximity — Contrôle si les résultats géocodés ne montrent que les résultats dans un certain rayon de la position de l’appareil. Ce paramètre accepte un nombre suivi de l’une des unités standard suivantes : m (mètres), km (kilomètres), ft (pieds), mi (milles) ou yd (yards). Si aucune unité n’est spécifiée, les mètres sont utilisés par défaut. Si le paramètre est défini sur 0, la proximité ne sera pas prise en compte dans les résultats de la recherche. Par défaut, ce paramètre est défini sur on, ce qui permet de classer les suggestions selon leur proximité sans exclure aucun emplacement du fait de son éloignement.
- maxResults : détermine le nombre maximal de résultats fournis. Par exemple, maxResults=10 renvoie un maximum de 10 résultats possibles. Par défaut, ce paramètre est défini pour afficher un maximum de 6 résultats.
- suggestions – Ce paramètre joue le rôle d’interface pour l’opération suggest dans ArcGIS REST API. Lorsque ce paramètre est défini sur yes, la liste déroulante des localisations potentielles est renseignée par l’opération suggest. Lorsque ce paramètre est défini sur no ou si le service de géocodage ne prend pas en charge l’opération suggest, la liste des localisations potentielles est renseignée par l’opération findAddressCandidates. Par défaut, ce paramètre est défini sur yes.
Obtenir un ID de balise InfraMarker
Remarque :
Cette section décrit les fonctions qui sont uniquement disponibles dans l’application de terrain Survey123. Ces fonctions ne sont pas disponibles dans Survey123 Mobile.
Utilisez les apparences décrites ci-dessous pour lire les données d’une balise RFID InfraMarker ou écrire des données dans une telle balise.
En définissant la colonne appearance (apparence) d’une question de type texte sur inframarker, vous pouvez définir les informations à écrire dans une balise. Ces informations peuvent inclure assetOwner, assetName, latitude et longitude, et les valeurs peuvent être dérivées d’autres questions de l’enquête. Par exemple, l’expression suivante dans la colonne calculation (calcul) écrit les réponses aux questions de type asset_name, asset_owner, lat et long dans la balise :
concat("assetName=", ${asset_name}, "&assetOwner=", ${asset_owner}, "&latitude=", ${lat}, "&longitude=", ${long})
Si l’apparence d’une autre question de type texte de la même enquête est définie sur getinframarkerid, l’ID de balise InfraMarker unique de 24 caractères est récupéré et stocké dans l’enquête.
Pour plus d’informations, consultez la documentation InfraMarker.
Obtenir une valeur d’un télémètre
Remarque :
Cette section décrit les fonctions qui sont uniquement disponibles dans l’application de terrain Survey123. Ces fonctions ne sont pas disponibles dans Survey123 Mobile.
Lorsque la colonne appearance (apparence) est définie sur rangefinder (télémètre), une question de type texte peut accepter l’objet JSON entier ou une valeur spécifique qui est renvoyée par un télémètre. Dans le cas où cette question accepte l’objet JSON entier, il convient de définir bind::esri:fieldLength sur 1000 pour faire tenir entièrement la valeur.
Lorsque vous définissez l’apparence rangefinder (télémètre) pour une question de type entier ou décimal, elle peut accepter une valeur spécifique qui est renvoyée par un télémètre. Dans la colonne bind::esri:parameters, indiquez la mesure à stocker à l’aide de l’une des valeurs suivantes : height, azimuth, horizontalDistance, slopeDistance ou inclination. Par exemple, measurement=height stocke uniquement la valeur de hauteur qui est renvoyée par le télémètre.
Apparence d’entier
Remarque :
Dans Survey123 Mobile, seule l’apparence spinner (bouton fléché) est prise en charge pour les questions de type entier.
Dans l’application Web Survey123, aucune des apparences d’entier n’est prise en charge.
Lorsque la colonne appearance (apparence) est définie sur spinner (bouton fléché), une question de type entier est affichée avec des boutons permettant d’augmenter ou de diminuer la valeur d’une unité. Pour répéter l’opération, continuez d’appuyer sur le bouton et relâchez-le une fois la valeur voulue atteinte.
Lorsque la colonne appearance (apparence) est définie sur numbers, une question de type entier mise en surbrillance est accompagnée d’un clavier numérique personnalisé permettant de saisir une valeur. Le clavier comprend un bouton permettant de rendre la valeur positive ou négative.
Lorsque la colonne appearance (apparence) est définie sur calculator, une question de type entier mise en surbrillance est accompagnée d’un clavier de calculatrice personnalisé permettant de saisir et de modifier une valeur.
Lorsque la colonne appearance (apparence) est définie sur distress, une question de type entier est présentée sous la forme d’une échelle de détresse. Une échelle de détresse est une échelle à dix points servant à mesurer des sentiments tels que le stress, la douleur et la joie.
Apparence de décimale
Remarque :
Dans Survey123 Mobile, seule l’apparence spinner (bouton fléché) est prise en charge pour les questions de type décimal.
Dans l’application Web Survey123, aucune des apparences de décimal n’est prise en charge.
Lorsque la colonne appearance (apparence) est définie sur spinner (bouton fléché), une question de type décimal est affichée avec des boutons permettant d’augmenter ou de diminuer la valeur d’une unité. Pour répéter l’opération, continuez d’appuyer sur le bouton et relâchez-le une fois la valeur voulue atteinte.
Lorsque vous utilisez une valeur par défaut pour définir le nombre de décimales pour une question, le bouton fléché l’utilise. Les exemples suivants montrent de quelle façon le bouton fléché gère différentes valeurs décimales :
- 1.0 passe à 1.1, 1.2, 1.3, 1.4
- 3.07 passe à 3.08, 3.09, 3.10, 3.11
- 2.000000 passe à 2.000001, 2.000002, 2.000003
Lorsque la colonne appearance (apparence) est définie sur numbers, une question de type décimal est accompagnée d’un clavier numérique personnalisé permettant de saisir une valeur. Le clavier comprend un bouton permettant de rendre la valeur positive ou négative.
Lorsque la colonne appearance (apparence) est définie sur calculator (calculatrice), une question de type décimal mise en surbrillance est accompagnée d’un clavier de calculatrice personnalisé permettant de saisir et de modifier une valeur.
Lorsque la colonne appearance (apparence) est définie sur thousands-sep, la réponse à une question de type décimal apparaît avec des séparateurs de milliers. Cela n’affecte pas la valeur envoyée dans le cadre de la réponse à l’enquête, mais uniquement l’affichage dans l’application. Les séparateurs sont définis par le paramètre régional de l’appareil et sont uniquement appliqués à l’ouverture d’une enquête depuis les dossiers Drafts (Brouillons), Outbox (Boîte d’envoi), Inbox (Boîte de réception) ou Sent (Éléments envoyés) ou lorsque la réponse est renseignée par une valeur par défaut ou un calcul. Les séparateurs de milliers n’apparaissent pas lorsque vous saisissez une valeur manuellement.
Vous avez un commentaire à formuler concernant cette rubrique ?