Apparence

Vous pouvez changer la façon dont les questions sont présentées en définissant l’apparence de chaque type de question. Ajoutez une colonne appearance (apparence) à votre feuille de calcul pour modifier l’apparence et la fonctionnalité des questions de votre enquête.

Ces apparence ne sont pas toutes prises en charge à la fois dans l’application Web et dans l’application de terrain Survey123. Reportez-vous à la rubrique Référence rapide, qui présente un tableau répertoriant les apparences qui fonctionnent dans chaque environnement. Ce tableau figure également sur la feuille Appearances (Apparences) du modèle de formulaire XLSForm avancé Survey123.

Conseil :

Pour voir comment les questions seront présentées dans une enquête, consultez l’exemple Apparences dans Survey123 Connect. En publiant l’exemple avec votre compte ArcGIS, vous pouvez également voir comment les questions seront présentées dans l’application Web Survey123.

Apparences multiples

Vous pouvez ajouter plusieurs apparences à la colonne appearance (apparence) d’une question en séparant ces apparences par des espaces. Les apparences peuvent être affichées dans n’importe quel ordre. Par exemple, pour une question de type image, les trois apparences suivantes peuvent être spécifiées dans la colonne appearance (apparence) :

annotate new-front multiline

Vous pouvez spécifier des apparences de largeur pour les questions des enquêtes qui utilisent une mise en page de grille. Les largeurs peuvent être spécifiées avec toute combinaison d’apparences prises en charge pour le type de question. Par exemple, pour une question à choix unique dans une mise en page de grille, la colonne appearance (apparence) peut contenir :

w3 likert

Masquer les questions

Si la valeur d’apparence est définie sur hidden (masqué), tous les types de questions, y compris les groupes et les répétitions, peuvent être masqués de la vue lors du remplissage de l’enquête, mais ils acceptent et envoient les valeurs et calculs par défaut. Cela est plus poyvalent que le type de question hidden (masqué), car il peut être appliqué à tous les types de questions.

Texte

Lorsque la valeur d’apparence est définie sur multiline, une question de texte est présentée sous la forme d’une zone de texte multiligne. Vous pouvez spécifier la hauteur par défaut de cette zone de texte 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. La saisie intuitive est désactivée par défaut sur Android pour les questions de type texte, alors qu’elle est activée par défaut sur iOS.

Remarque :

Le contrôle de la hauteur des questions n’est pas pris en charge dans l’application Web Survey123.

Les apparences predictivetext et nopredictivetext ne sont pas prises en charge dans l’application Web Survey123.

La saisie intuitive est désactivée par défaut pour les questions de type texte sous Android, 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.

Texte InfraMarker

Utilisez les apparences ci-après pour lire les données d’une balise RFID InfraMarker ou écrire des données dans une telle balise.

En définissant l’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.

Géocodage

Lorsque l’apparence est définie sur geocode, une question de type texte est utilisée pour rechercher et envoyer une adresse géocodée. Commencez par saisir une adresse. Une série d’options destinées au renseignement automatique apparaît. Celles-ci suggèrent des localisations basées sur les localisateurs disponibles par défaut pour votre organisation. Si l’utilisateur n’est pas connecté, ArcGIS World Geocoder est utilisé. 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 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 :

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

L’apparence geocode nécessite une connexion Internet et ne fonctionne pas dans un environnement non connecté.

Remarque :

Les paramètres indicator, proximity, maxResults et suggestions ne sont pas pris en charge dans l’application Web Survey123.

Télémètre

Lorsque l’apparence est définie sur rangefinder, 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 1 000 pour faire tenir entièrement la valeur.

Si l’apparence est définie sur rangefinder, une question de type entier ou décimal 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, inclination. Par exemple, measurement=height stocke uniquement la valeur de hauteur qui est renvoyée par le télémètre.

Date

Lorsque l’apparence est définie sur year, une question de type date est présentée comme un bouton d’année uniquement, avec des flèches pour augmenter ou diminuer la valeur de l’année.

Lorsque l’apparence est définie sur month-year, une question de date est présentée sous la forme d’une paire de boutons, un pour le mois et un pour l’année. Chacun est doté de flèches permettant d’augmenter ou de réduire la valeur.

Remarque :

Les apparences year et month-year apparaissent lorsque l’enquête se charge avec les valeurs pour le mois et l’année en cours. Cependant, ils ne contiennent pas déjà ces valeurs et envoient une valeur vide, sauf si une mise à jour manuelle, une valeur par défaut ou un calcul a été appliqué.

Lorsque l’apparence est définie sur week-number, une question de date reste présentée avec un calendrier pour choisir la date mais, une fois la date sélectionnée, le numéro de semaine correspondant s’affiche. Par exemple, si vous choisissez la date du mercredi 27 avril 2016, le résultat affiché est Semaine 17.

Remarque :

L’apparence week-number n’est pas pris en charge dans l’application Web Survey123Survey123.

Choix unique

Lorsque l’apparence est définie sur minimal, une question à choix unique est présentée sous la forme d’un menu déroulant.

Lorsque l’apparence est définie sur horizontal, les choix d’une question à choix unique sont présentés horizontalement dans des colonnes de largeur égale.

L’apparence de type compact est similaire à l’apparence de type horizontal, mais elle utilise une méthode différente pour déterminer les largeurs de colonne obtenues si les choix prennent moins de place.

Vous pouvez spécifier un nombre maximal de colonnes pour l’apparence de type compact en indiquant un nombre séparé par un tiret. Par exemple, compact-3 limite la question à un maximum de trois colonnes.

Les apparences de type compact et horizontal-compact sont identiques. Dans l’application Web Survey123, au lieu d’utiliser des colonnes, ces apparences s’adaptent aux étiquettes de choix d’une question à choix unique avec une présentation côte à côte dans les lignes, sans espacement supplémentaire.

Lorsque l’apparence est définie sur likert, une question à choix unique est présentée comme échelle de Likert. Une échelle de Likert est une échelle de notation qui permet aux sondés de préciser leur niveau d’accord sur une échelle d’accord-désaccord symétrique par rapport à une affirmation.

Lorsque l’apparence est définie sur autocomplete, une question à choix unique est présentée sous la forme d’une zone de texte et d’un menu déroulant. La saisie de texte dans le champ restreint l’affichage du menu déroulant aux seules réponses qui contiennent du texte. Cette option est utile en cas de listes de choix très longues.

Lorsque l’apparence est définie sur image-map, une question à choix unique se présente sous la forme de l’image référencée dans la colonne media::image, dont les régions sélectionnables font office de choix. Pour fonctionner, cette apparence nécessite un fichier SVG dans le dossier media de l’enquête, les valeurs de noms de la liste des choix devant correspondre aux identifiants de chemin des régions du fichier SVG. Pour plus d’informations, reportez-vous à la rubrique Utiliser des fichiers SVG.

Remarque :

L’apparence image-map n’est pas prise en charge dans l’application Web Survey123.

Questions à choix multiples

Lorsque l’apparence est définie sur minimal, une question à choix multiples est présentée sous la forme d’un menu déroulant.

Lorsque l’apparence est définie sur horizontal, les choix d’une question à choix multiples sont présentés horizontalement dans des colonnes de largeur égale.

L’apparence de type compact est similaire à l’apparence de type horizontal, mais elle utilise une méthode différente pour déterminer les largeurs de colonne obtenues si les choix prennent moins de place.

Vous pouvez spécifier un nombre maximal de colonnes pour l’apparence de type compact en indiquant un nombre séparé par un tiret. Par exemple, compact-3 limite la question à un maximum de trois colonnes.

Les apparences de type compact et horizontal-compact sont identiques. Dans l’application Web Survey123, au lieu d’utiliser des colonnes, ces apparences s’adaptent aux étiquettes de choix d’une question à choix multiples avec une présentation côte à côte dans les lignes, sans espacement supplémentaire.

Lorsque l’apparence est définie sur image-map, une question à choix multiples se présente sous la forme de l’image référencée dans la colonne media::image, dont les régions sélectionnables font office de choix. Pour fonctionner, cette apparence nécessite un fichier SVG dans le dossier media de l’enquête, les valeurs de noms de la liste des choix devant correspondre aux identifiants de chemin des régions du fichier SVG. Pour plus d’informations, reportez-vous à la rubrique Utiliser des fichiers SVG.

Remarque :

L’apparence image-map n’est pas prise en charge dans l’application Web Survey123.

Rechercher

Les questions à choix unique ou à choix multiples prennent également en charge l’apparence search qui permet de remplir la liste de choix avec les valeurs d’une table CSV figurant dans le dossier media de l’enquête ou encore d’une table ou couche d’entités existante. Lors de l’utilisation de l’apparence search, vous devez toujours inclure une entrée dans la feuille de calcul de choix, mais au lieu d’énumérer chaque choix, vous référencerez le nom du champ de la table ou de la couche d’entités existante.

Dans l’exemple suivant, une liste de choix nommée us_states est définie dans la feuille de calcul de choix et utilisera le champ STATE_NAME comme nom du choix et comme libellé.

Dans l’exemple suivant, cette liste de choix est ensuite référencée sur la feuille de calcul d’enquête de la même manière que les autres listes de choix, mais elle inclut l’expression d’apparence search qui désigne la couche d’entités existante à partir de laquelle les choix sont extraits.

L’expression d’apparence search doit se présenter de la manière suivante, les variables étant séparées par des virgules :

search(tableName, searchType, searchColumn, searchText, filterColumn, filterText)

Le paramètre tableName accepte soit le nom du fichier CSV dans le dossier media de l’enquête (par exemple, airports), soit l’URL d’une couche d’entités ou d’une couche de service de carte, précédée par un nom dans Survey123 permettant de désigner la table en interne. Ce nom de table ne doit pas forcément correspondre au nom de la couche hébergée, mais comme il s’agit de la façon dont Survey123 fait référence en interne à votre recherche, il doit être différent de tous les autres noms de table et fichiers CSV utilisés dans l’enquête. Vous pouvez également ajouter des paramètres de demandes de requête au point de terminaison REST de votre couche d’entités ou de vos couches de services de carte pour configurer le comportement de la recherche. Dans l’exemple suivant, une URL de couche d’entités est ajoutée au paramètre resultRecordCount pour alimenter la liste de choix avec les 10 premiers résultats de la requête, la recherche étant stockée en interne sous le nom de airports :

"airports?url=https://services1.arcgis.com/e7dVfn25KpfE6dDd/arcgis/rest/services/Airports2/FeatureServer/0&resultRecordCount=10"

Les paramètres supplémentaires sont facultatifs, mais permettent d’affiner les résultats de la recherche.

Paramètre	Description
searchType	Contrôle le type de recherche réalisée et accepte différentes valeurs selon que la table compulsée est un table spatiale figurant dans une couche d’entités ou une table non spatiale dans une table d’entités ou une table CSV. Dans le cas de tables spatiales, les types de recherche acceptés sont intersects, contains, crosses, envelope_intersects, index_intercepts, overlaps, touches et within. Pour en savoir plus, reportez-vous à Relations spatiales. Dans le cas d’une table non spatiale, les types de recherche pris en charge sont contains, startswith, endswith et matches.
searchColumn	Détermine la colonne dans laquelle le texte défini pour le paramètre searchText sera recherché. Ces colonnes proviennent de la table elle-même. De plus, une table spatiale figurant dans une couche d’entités peut faire une recherche sur les colonnes @geopoint, @geotrace et @geoshape.
searchText	Contient le texte à rechercher et renvoyé dans le paramètre searchColumn.

Par ailleurs, des paramètres de filtre peuvent être ajoutés à l’expression search pour réduire les valeurs de la liste de choix.

Paramètre	Description
filterColumn	Définit une colonne dans laquelle des correspondances par rapport au texte fourni dans le paramètre filterText sont recherchées. La requête de recherche ne renvoie que les résultats contenant ce texte. Les paramètres filterColumn et filterText doivent être utilisés ensemble.
filterText	Texte recherché dans la colonne indiquée par le paramètre filterColumn. Les paramètres filterColumn et filterText doivent être utilisés ensemble.

Voici un exemple d’expression de recherche comportant certains paramètres facultatifs dans l’apparence search. Elle alimente la liste de choix avec le contenu d’un fichier CSV qui utilise une question précédente comme texte de recherche.

search('csvName', 'matches', 'breed', ${DogQuestion})

Remarque :

Les questions à l’apparence search sont présentées dans l’application Web Survey123 de la même manière que les questions select_one à l’apparence autocomplete.

Questions de type carte

Si l’apparence est définie sur press-to-locate, une question de type géopoint n’accepte une valeur d’emplacement que lorsque l’utilisateur interagit avec la question, à la place du comportement par défaut consistant à capturer immédiatement l’emplacement au chargement du formulaire. Une question de type géotrace ou géoforme se focalise sur l’emplacement de l’utilisateur sans capturer de point à la première interaction avec la carte.

Remarque :

L’apparence press-to-locate n’est pas prise en charge pour les questions relatives à Geotrace et Geoshape dans l’application de terrain Survey123.

Géopoint

Lorsque l’apparence est définie sur hide-input, une question de type géopoint affichée dans l’application Web Survey123 apparaît avec une valeur de coordonnée en lecture seule, plutôt qu’une zone de saisie de coordonnées par défaut.

Remarque :

L’apparence hide-input n’est pas prise en charge dans l’application de terrain Survey123.

Image

Lorsque l’apparence est définie sur signature, une question de type image présente une fenêtre contextuelle permettant de capturer une signature.

Une signature est enregistrée en tant que pièce jointe de type image .jpg dont les dimensions sont celles de la fenêtre contextuelle. Par défaut, la largeur de la fenêtre contextuelle correspond à la largeur de l’écran de l’appareil, avec une hauteur fixe de 200 pixels. Vous pouvez définir la largeur maximale de cette fenêtre contextuelle en définissant une valeur max-pixels dans la colonne parameters (paramètres), par exemple max-pixels=400.

Vous pouvez également fournir une image dans la colonne default (par défaut) afin de définir un arrière-plan personnalisé pour la signature. Les dimensions de l’image par défaut déterminent les proportions de la fenêtre contextuelle.

La largeur de la fenêtre contextuelle sera la plus petite parmi les valeurs suivantes :

• La valeur max-pixels
• La largeur de l’image par défaut
• La largeur de l’écran de l’appareil

La hauteur est de 200 pixels, sauf si une image par défaut est fournie.

Lors de la conception d’une enquête avec l’apparence signature, veillez à prendre en compte la taille d’écran de tous les appareils cibles.

Le texte du pied de page peut être fourni pour la fenêtre contextuelle d’une question Signature à l’aide du paramètre footerText figurant dans la colonne body::esri:style. En utilisant uniquement le paramètre footerText sans valeur, le conseil de la question apparaît sous la signature. Ceci peut être changé en astuce de la question avec footerText=@[hint]. L’astuce ou le conseil utilisé pour le texte du pied de page n’apparaît pas à la localisation par défaut sous le nom de la question. Pour plus d’informations sur les astuces, consultez Astuces.

Lorsque l’apparence est définie sur multiline, une question de type image peut contenir plusieurs images. Cette apparence peut être associée à toute autre apparence d’image en indiquant les deux apparences séparées par un espace, par exemple multiline annotate.

Vous pouvez contrôler le nombre d’images pouvant être envoyées grâce à la fonction count-selected dans la colonne constraint (contrainte). Par exemple, count-selected(${image_question}) <= 5 limitera le nombre d’images qu’il est possible d’envoyer à un maximum de cinq.

Si vous définissez l’apparence sur new-front ou new-rear, une question de type image est limitée, par défaut, à l’utilisation du capteur avant ou arrière, respectivement, de l’appareil. Ces apparences peuvent être associées à annotate en indiquant les deux apparences séparées par un espace (par exemple, new-front annotate).

Remarque :

L’application Web Survey123 ne prend pas en charge le type multiligne, le paramètre max-pixels ou les paramètres par défaut avec l’apparence signature.

Les apparences new-front et new-rear ne sont pas prises en charge dans l’application Web Survey123.

La fonction pulldata("@exif") ne fonctionnera pas pour les questions de type image multilignes. Si vous devez extraire des données EXIF (format de fichier d’image échangeable) de plusieurs images soumises pour la même question, envisagez d’utiliser une répétition.

Dessiner et annoter

Lorsque l’apparence est définie sur draw, une question de type image affiche un bouton pour charger une toile sur laquelle vous pourrez dessiner. Dans la palette des outils de dessin, vous pouvez changer d’outil de dessin et contrôler les paramètres de chaque outil tels que la taille du texte, la largeur du trait, la couleur, etc. Pour plus d’informations sur l’interface de la zone d’affichage, reportez-vous à Dessiner et annoter. Vous pouvez créer des palettes personnalisées en vue de configurer les outils de dessin et d’annotation qui répondent à vos besoins. Pour plus d’informations, consultez Palettes Dessiner et annoter.

Lorsque l’apparence est définie sur annotate, une question de type image affiche un bouton qui permet d’ouvrir la caméra de l’appareil et de prendre une photo que vous pouvez ensuite annoter de graphiques et de texte. Dans la palette des outils de dessin, vous pouvez changer d’outil de dessin et contrôler les paramètres de chaque outil tels que la taille du texte, la largeur du trait, la couleur, etc. Pour plus d’informations sur l’interface de la zone d’affichage, reportez-vous à Dessiner et annoter. Vous pouvez créer des palettes personnalisées en vue de configurer les outils de dessin et d’annotation qui répondent à vos besoins. Pour plus d’informations, consultez Palettes Dessiner et annoter.

Conseil :

À compter de Survey123 3.13, les données EXIF sont copiées de l’image source vers l’image annotée.

Vous pouvez également autoriser l’utilisateur à annoter une image stockée dans la mémoire de l’appareil ou l’instantané d’une carte. Pour ce faire, définissez body::esri:style de cette question sur method=browse, method=camera ou method=map. Le comportement par défaut de l’apparence annotate (annoter) revient à fournir method=camera. Vous pouvez faire en sortie que la question propose plusieurs possibilités pour l’image source en fournissant différentes options séparées par une virgule, par exemple method=camera,browse.

Attention :

Quelle que soit la méthode définie, l’application Web Survey123 affiche uniquement une option de recherche de fichier.

Les défauts et les calculs se comportent différemment avec les questions image utilisant les options draw (dessiner) et annotate (annoter). Si le nom du fichier d’une image dans le dossier média de l’enquête est utilisé comme valeur par défaut ou le résultat d’un calcul, l’image est utilisée comme arrière-plan initial pour la toile. Avec annotate (annoter), cette image est remplacée par une image fournie et s’affiche uniquement si l’utilisateur refuse explicitement de fournir une image ou s’il rétablit l’image déjà fournie.

Remarque :

Vous pouvez régler la résolution d’image en définissant une valeur max-pixels dans la colonne parameters. Pour une question draw, la définition de max-pixels=1000 délimite la zone d’affichage à une image carrée de 1 000 x 1 000 pixels. Pour une question annotate, la définition de max-pixels=1000 fixe le plus long côté de l’image à 1 000 pixels tout en préservant les proportions de l’image fournie. Si max-pixels n’est pas défini, le format de l’image sera défini par le paramètre de taille de l’image spécifié dans les paramètres Options de votre enquête dans Survey123 Connect.

Ces deux formes de définition de la résolution d’image sont remplacées si vous fournissez une image pat défaut en réponse à la question. Dans ce cas, la résolution de l’image par défaut s’applique. Cela permet de garantir une résolution standard pour toutes les images soumises. La prise de l’instantané d’une carte pour l’annotation remplace également tout autre paramètre de résolution d’image, l’image étant réglée à la taille de la zone d’affichage visible.

Images Spike

Les questions image prennent également en charge les apparences pour intégrer Survey123 avec Spike, une solution de mesure par laser conçue par ikeGPS qui permet d’obtenir les mesures et l’emplacement d’un objet à partir d’une photo. Lorsque l’apparence est définie sur spike, spike-full-measure ou spike-point-to-point, une question de type image affiche un bouton permettant d’ouvrir l’application mobile Spike sur des appareils iOS et Android.

Une photo prise avec l’application Spike et l’appareil laser vous permet d’enregistrer les coordonnées et la distance par rapport à l’objet, ainsi que de mesurer les dimensions des objets dans la photo grâce aux lignes et surfaces de dessin. La photo avec les notes de carte des mesures est ensuite jointe à votre enquête et les métadonnées de la photo, telles que les coordonnées et les mesures, sont rendues disponibles pour être enregistrées. Les métadonnées Spike et de mesure associées sont enregistrées dans le fichier image à l’aide de balises Exchangeable Image File (EXIF) standards. L’information EXIF peut ensuite être extraite et utilisée pour renseigner d’autres champs.

La différence entre les apparences Spike réside dans l’étendue des valeurs stockées dans l’image. L’apparence spike ne mesure que la distance et l’emplacement, tandis que l’apparence spike-full-measure mesure la distance, l’emplacement, la surface et la longueur. L’apparence spike-point-to-point capture une série de valeurs exclusives, indiquées par les noms de propriété commençant par P2P.

Pour plus d’informations sur ces balises EXIF, reportez-vous à la rubrique Intégration Spike. Pour plus d’informations sur Spike, accédez au site Web Spike.

Remarque :

L’intégration Spike n’est pas prise en charge dans l’application Web Survey123.

Entier

Lorsque l’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.

Lorsque l’apparence est définie sur spinner, 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 l’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 l’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.

Remarque :

Les apparences distress, spinner, numbers et calculator ne sont pas prises en charge dans l’application Web Survey123.

Décimal

Lorsque l’apparence est définie sur spinner, 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.

Utilisez une valeur par défaut pour définir le nombre de décimales pour une question, et le bouton fléché l’utilisera. 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 l’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 l’apparence est définie sur calculator, 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 l’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.

Remarque :

Les apparences spinner, numbers, calculator et thousands-sep ne sont pas pris en charge dans l’application Web Survey123.

Plage

Lorsque l’apparence est définie sur no-ticks, une question de type plage s’affiche sans les lignes indiquant les positions sur le curseur de la plage, ni les valeurs minimum et maximum. Cela n’a pas d’effet sur le comportement de la question, mais seulement sur l’affichage. Pour plus d’informations sur le type de question range (plage), reportez-vous à la rubrique Plage.

Code à barres

Lorsque l’apparence est définie sur minimal, une question de type code à barres est affichée avec un seul bouton pour lancer le scanner. La zone de texte qui contient la valeur pour la question de type code à barres n’est pas visible. Pour plus d’informations sur le type de question barcode (code à barres), reportez-vous à la rubrique Codes à barres.

Groupe

Lorsque l’apparence d’une question de type début de groupe est définie sur compact, un groupe de questions apparaît réduit au démarrage et peut être développé par l’utilisateur. Cela peut s’avérer utile pour les longues enquêtes, que l’utilisateur peut éprouver des difficultés à lire et à parcourir. Cette apparence est définie par l’option Commence un groupe de questions.

L’apparence minimal n’a aucun effet sur les questions de groupe.

Lorsque l’apparence d’une question de type début de groupe est définie sur table-list, les questions à choix unique du groupe avec une liste de choix communs apparaissent sous forme de tableau, la rangée supérieure affichant les libellés de la liste de choix et la colonne de gauche affichant les libellés des questions.

Lorsque la colonne style de la feuille settings (paramètres) est définie sur pages et que l’apparence de chaque question de type début de groupe est définie sur field-list, chaque groupe s’affiche sur une page distincte de l’enquête. Vous pouvez parcourir les pages à l’aide des boutons Retour et Suivant situés en bas de l’application. Vous pouvez appuyer longuement sur ces boutons pour revenir au début ou passer directement à la fin de l’enquête. Vous pouvez également sélectionner le numéro de page pour le convertir en un champ accessible en écriture et saisir un nouveau numéro de page. Cela est utile pour décomposer l’affichage de l’enquête, l’organiser, et réduire les temps de chargement.

Attention :

Lorsque vous utilisez le style pages, chaque question de l’enquête doit se trouver dans un groupe utilisant l’apparence field-list.

Si vous définissez la colonne style de la feuille settings (paramètres) sur fixed-grid ou dynamic-grid, les groupes d’une enquête peuvent être paramétrés pour afficher les questions correspondantes dans une grille.

Le style de grille fixe crée un espace réservé pour chaque question, y compris pour celles dont l’apparence est masquée. Une question apparaît si les conditions pertinentes sont remplies ; autrement, un espace vierge occupe cet emplacement dans le formulaire.

Le style de grille dynamique permet de déplacer les questions et les groupes sur le formulaire, en fonction des conditions pertinentes, pour optimiser l’espace sur l’écran de l’appareil.

Le style de mise en page sous forme de grille dans la feuille de calcul settings (paramètres) est un paramètre global qui s’applique à l’ensemble de l’enquête. Il est également possible d’appliquer ce style à des répétitions ou des groupes individuels, ce qui permet d’utiliser différents styles pour différentes parties de l’enquête. Vous pouvez remplacer le paramètre global en entrant l’une des chaînes suivantes dans la colonne body::esri:style de la question de type groupe ou répétée :

• layout=dynamic-grid
• layout=fixed-grid

Définissez l’apparence de largeur d’un groupe sur w, suivi du nombre de colonnes utilisées pour diviser la grille. Par exemple, w4 divise chaque ligne de la grille en quatre colonnes. Le paramètre de largeur est également appliqué à une question dans un groupe ou une répétition pour contrôler le nombre de colonnes du groupe ou de la répétition parent que la question doit couvrir. Lorsque les largeurs stipulées pour les questions atteignent le nombre de colonnes défini pour le groupe, les questions suivantes apparaissent sur une nouvelle ligne. Ces largeurs peuvent être définies en même temps que la plupart des autres apparences.

Dans l’exemple suivant, les apparences de largueur pour la température de l’eau, l’oxygène dissous, le pH et la conductivité ont chacune pour valeur w1, et l’apparence de largeur pour l’emplacement d’échantillonnage de l’eau a pour valeur w2.

Dans l’exemple suivant, le groupe possède une largeur de trois colonnes (w3). Dans la première répétition, deux colonnes sont définies et couvrent deux des colonnes parent (w2:2). Dans la deuxième répétition, deux colonnes sont définies et couvrent l’une des colonnes parent (w2:1).

L’image ci-après montre comment ces répétitions imbriquées apparaissent dans le groupe sur le formulaire.

SI le formulaire est destiné à être affiché dans l’application web, ajoutez la largeur URL parameter for launching the web app (Paramètres d’URL permettant de lancer l’application web) pour vous assurer que la largeur du plein écran est utilisée. Dans l’image suivante, le groupe présente une largeur de 8 colonnes (w8), les questions dans le groupe ont une largeur de w2, w3 ou w5 pour remplir la page correctement, et ?width=1 a été ajouté à l’URL de l’enquête pour utiliser toute la largeur du navigateur.

Remarque :

L’apparence table-list ne prend pas en charge les questions à choix multiples, ni le contenu multimédia dans les listes de choix.

L’apparence table-list ne fonctionne pas si elle est placée à l’intérieur d’un groupe theme-grid (grille thématique).

Auparavant, le style dynamic-grid (grille dynamique) s’appelait theme-grid (grille thématique). Le style theme-grid (grille thématique) est toujours pris en charge à des fins de rétrocompatibilité. Toutefois, pour les nouvelles enquêtes, il est recommandé d’utiliser le style dynamic-grid (grille dynamique) ou fixed-grid (grille fixe).

Les groupes de style de mise en page sous forme de grille ne prennent pas en charge borderColor.

Fichier

Lorsque l’apparence est définie sur multiline, une question de type fichier peut contenir plusieurs fichiers. Vous pouvez contrôler le nombre de fichiers pouvant être envoyés grâce à la fonction count-selected dans la colonne constraint. Par exemple, count-selected(${file_question}) <= 5 limitera le nombre de fichiers qu’il est possible d’envoyer à un maximum de cinq.

Répéter

Lorsque l’apparence d’une question de type début de répétition est définie sur minimal, un ensemble reproductible de questions n’est pas visible au démarrage. L’utilisateur doit cliquer sur le bouton du signe plus pour voir les questions répétées. Cette option est utile si les questions répétées n’appellent pas une réponse dans l’enquête. Cette apparence est définie dans l’option de début de question répétée.

Si une répétition, dont le nombre de répétitions est égal à zéro, est définie sur minimal, les contrôles de la répétition et leurs étiquettes ne sont pas visibles.

Lorsque l’apparence d’une question de type début de répétition est définie sur compact, un ensemble reproductible de questions apparaît réduit au démarrage et peut être développé par l’utilisateur. Cela peut s’avérer utile pour les enquêtes longues que l’utilisateur peut trouver difficiles à lire et à parcourir. Cette apparence est définie dans l’option de début de question répétée.

Contrairement à d’autres apparences, les répétitions peuvent utiliser simultanément les options minimal et compact en définissant l’apparence sur minimal compact. Les questions d’une répétition sont présentées de manière à la fois réduite (compact) et masquée (minimal).

Lorsque la colonne style de la feuille settings (paramètres) est définie sur pages et que l’apparence de chaque question de type début de répétition est définie sur field-list, chaque ensemble reproductible de questions s’affiche sur une page distincte de l’enquête. Ce comportement est le même que pour un groupe.

Si vous définissez la colonne style de la feuille settings (paramètres) sur fixed-grid ou dynamic-grid, les répétitions de votre enquête peuvent être paramétrées pour afficher les questions correspondantes dans une mise en page sous forme de grille. Ce comportement est le même que pour un groupe.