Des paramètres supplémentaires peuvent être utilisés pour certains types de question dans XLSForm afin de contrôler le style et le comportement des questions d’une enquête. Dans certains cas, ces paramètres complètent les apparences prises en charge par un type de question. Tous les paramètres ne sont pas pris en charge dans toutes les applications d’envoi (Survey123 Mobile, l’application de terrain Survey123 et l’application Web Survey123). Pour plus d’informations sur la prise en charge des applications, consultez les tables de paramètres ci-dessous, qui sont organisées par type de question, ainsi que la colonne XLSForm de la feuille de calcul de l’enquête qui accepte chaque paramètre.
Il est possible d’ajouter plusieurs paramètres pour une question à une même colonne en les séparant par des espaces. Par exemple, une question range (plage) peut posséder les paramètres startColor, endColor et color dans la colonne body::esri:style, comme suit :startColor=Orange endColor=White color=#FF6347
Généralités
Cette section décrit les paramètres que vous pouvez utiliser dans les colonnes XLSForm bind::esri:parameters et body::esri:style pour plusieurs types de question.
La table suivante décrit le paramètre que vous pouvez utiliser dans la colonne XLSForm bind::esri:parameters pour les types de question text (texte), integer (entier), decimal (décimal), note (remarque), date, time (heure), dateTime (Date/heure), select_one (sélection unique), select_multiple (sélection multiple), geopoint (géopoint), calculate (calculer) et hidden (masqué).
bind::esri:parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
| calculationMode | Contrôle quand est effectué le calcul dans une question. Valeurs : auto | manual | always | whenEmpty Exemples : | Application Web Application de terrain |
La table suivante décrit le paramètre que vous pouvez utiliser dans la colonne XLSForm body::esri:style pour les types de question text (texte), integer (entier), decimal (décimal), select_one (sélection unique) (avec l’apparence de renseignement automatique), select_multiple (sélection multiple) (avec l’apparence de renseignement automatique)* et barcode (code-barre).
body::esri:style
| Paramètre | Description | Application d’envoi |
|---|---|---|
| placeholderText | Spécifie le texte qui s’affiche dans la zone de saisie de la question lorsque la question est vide. Valeurs : @[hint] | @[guidance_hint] Exemples : | Survey123 Mobile Application de terrain |
*Prise en charge par Survey123 Mobile uniquement.
Sonore
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm bind::esri:parameters pour le type de question audio.
bind::esri:parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
| codec | Spécifie le codec préféré d’un enregistrement audio. Vous pouvez fournir plusieurs codecs en les séparant par des virgules. Le premier codec compatible avec l’appareil sera utilisé. Valeur : <codec name> Exemple : | Survey123 Mobile Application de terrain |
| fileName | Indique le nom de fichier. Valeurs : <expression> Exemples : | Application Web |
| Durée max | Spécifie la durée maximum en secondes d’un enregistrement audio. La durée par défaut dans l’application Web est 600 (10 minutes). Valeur : <seconds> Exemple : | Survey123 Mobile Application Web Application de terrain |
| max-size | Spécifie la taille de fichier maximale en mégaoctets d’un enregistrement audio. La taille par défaut dans l’application de terrain est 10 Mo. Valeur : <megabytes> Exemple : | Survey123 Mobile Application de terrain |
Code à barres
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm body::esri:style pour le type de question barcode (code-barre).
body::esri:style
| Paramètre | Description | Application d’envoi |
|---|---|---|
Indiquez les types de codes à barres numérisables par les utilisateurs. Vous pouvez fournir plusieurs types en les séparant par des virgules. Lorsque le paramètre barcodeType n’est pas défini, tous les types de codes à barres pris en charge peuvent être numérisés, sauf aztec, code39, datamatrix, maxicode et pdf417. Valeurs : all | 1d | 2d | <barcode types>
Types unidimensionnels : codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension Types bidimensionnels : aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded Exemples : | Application de terrain |
Fichier
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm bind::esri:parameters pour le type de question file (fichier).
bind::esri:parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
| fileName | Indique le nom de fichier. Valeurs : <expression> Exemples : | Application Web |
| max-size | Spécifie la taille maximum de fichier en mégaoctets. La taille par défaut est 10 Mo. Valeur : <megabytes> Exemple : | Application Web |
Groupes
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm body::esri:style pour le type de question begin group (début de groupe).
body::esri:style
| Paramètre | Description | Application d’envoi |
|---|---|---|
| backgroundColor borderColor | Définit les couleurs d’arrière-plan et de bordure pour un groupe ou une page. Pour plus d’informations, reportez-vous à la rubrique Couleurs des groupes, des pages et des répétitions. Valeurs : <HTML color name> | <hex color code> Exemples :
| Survey123 Mobile Application de terrain |
| Définit le style de mise en page de la grille pour un groupe. Valeurs : dynamic-grid | fixed-grid Exemple : | Application de terrain |
Images
Cette section décrit les paramètres que vous pouvez utiliser dans les colonnes XLSForm spécifiées pour le type de question image.
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm bind::esri:parameters.
bind::esri:parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
| allowAdds | Désactive l’ajout de nouvelles images lors de la modification d’enregistrements existants. Valeur : false Exemple : | Application de terrain |
| fileName | Indique le nom de fichier. Valeurs : <expression> Exemples : | Application Web Application de terrain |
| max-size | Spécifie la taille maximum de fichier en mégaoctets. La taille par défaut est 10 Mo. Valeur : <megabytes> Exemple : | Application Web |
Pour une question de type image avec l’apparence annotate, génère automatiquement les graphiques d’annotation des étiquettes et des emprises autour des objets détectés. Ajoutez ces propriétés pour définir le style et la mise en forme de l’annotation. Propriété obligatoire : <model_name> Propriétés facultatives : minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic Exemples : | Application de terrain | |
Exécute la classification d’images ou la détection d’objets, puis utilise les résultats EXIF dans l’enquête. Propriété obligatoire : <model_name> Propriétés facultatives : minScore | cameraPreview | label | class Exemples : | Application de terrain | |
Générez automatiquement ou ajoutez manuellement les emprises, puis appliquez des effets d’édition à la région cible. Propriété obligatoire : <model_name> | @faces | @manual Propriétés facultatives : minScore | cameraPreview | label | class | effect | symbol | fillColor | scale Exemples : | Application de terrain | |
watermark topLeftWatermark topCenterWatermark topRightWatermark leftCenterWatermark centerWatermark rightCenterWatermark bottomLeftWatermark bottomCenterWatermark bottomRightWatermark | Spécifie la position d’un filigrane d’image. Ajouter des propriétés pour définir le contenu et la mise en forme. Pour plus d’informations, consultez la rubrique Filigranes. Propriétés : text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize Exemples : | Application de terrain |
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm body::esri:style pour le type de question image.
body::esri:style
| Paramètre | Description | Application d’envoi |
|---|---|---|
| allowRename | Indique si les utilisateurs peuvent mettre à jour manuellement le nom de fichier. Valeurs : true | false Exemple : | Application de terrain |
| fileNameVisible | Indique si le nom de fichier est visible dans l’enquête. Valeurs : true | false Exemple : | Application de terrain |
| footerText | Pour une question image avec l’apparence signature, spécifiez le texte à afficher en bas de la fenêtre contextuelle de signature. Si aucune valeur n’est spécifiée, l’astuce de la question s’affichera en dessous de la signature. Ceci peut être changé en astuce de la question avec footerText=@[hint]. Valeurs : <none> | @[hint] Exemples : | Survey123 Mobile Application de terrain |
| méthode | Spécifie la méthode de capture pour une question image. La valeur map n’est prise en charge que pour les questions image avec l’apparence annoter. Valeurs : browse | camera | map Exemples : | Application Web Application de terrain |
| palette | Pour une question image avec apparence dessin ou annoter, spécifiez une palette d’outils de dessin personnalisée. Valeur : <palette name> Exemple : | Application de terrain |
| previewHeight | Définit la hauteur de l’aperçu de l’image une fois l’image sélectionnée. Utilisez previewHeight=0 si vous souhaitez que l’aperçu de votre image occupe la taille maximale sans espace vierge inutile. Valeurs : <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels Exemples : | Application de terrain |
La table suivante décrit le paramètre que vous pouvez utiliser dans la colonne XLSForm parameters pour le type de question image.
parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
| max-pixels | Pour une question image, définissez la taille maximum de l’image sur le bord le plus long, préservant les proportions d’origine. Pour une question image avec l’apparence signature, spécifiez la largeur maximum de la fenêtre contextuelle de signature. Pour une question image avec l’apparence dessin, définissez la zone d’affichage sur une image carrée (1:1). Valeur : <pixels> Exemples : | Application Web Application de terrain |
Questions de type carte
La table suivante décrit les paramètres que vous pouvez utiliser dans les colonnes XLSForm spécifiées pour les types de question geopoint (géopoint), geotrace (géotrace) et geoshape (géoforme).
La table suivante décrit le paramètre que vous pouvez utiliser dans la colonne XLSForm bind::esri:parameters.
bind::esri:parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
Définit le localisateur à partir duquel renvoyer les résultats géocodés. Valeur : <locator item ID> Exemple : | Application Web Application de terrain |
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm body::esri:style pour les types de question geopoint (géopoint), geotrace (géotrace) et geoshape (géoforme).
body::esri:style
| Paramètre | Description | Application d’envoi |
|---|---|---|
| height | Définit la hauteur de l’aperçu de la carte. Valeurs : <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels Exemples : | Application de terrain |
lineColor2 fillColor3 | Spécifie les couleurs de ligne et de remplissage pour l’entité linéaire ou surfacique. Ceci s’applique à l’aperçu de la carte dans Survey123 uniquement. Pour plus d’informations, reportez-vous à la rubrique Symbologie de géométrie. Valeurs : <HTML color name> | <hex color code> Exemple : | Survey123 Mobile Application de terrain |
| lineWidth2 | Spécifie la largeur de ligne en pixels pour l’entité linéaire ou surfacique. Ceci s’applique à l’aperçu de la carte dans Survey123 uniquement. Valeur : <pixels> Exemples : | Survey123 Mobile Application de terrain |
| map | Définit un fond de carte par défaut. Valeurs : <map name> | <map item ID> Exemples : | Application Web Application de terrain |
mapTools | Contrôle les outils cartographiques qui sont disponibles pour les questions de type géopoint, géotrace et géoforme. Valeurs : search | mapSwitcher | zoom | home | locate Exemples : | Application de terrain |
| method2 | Spécifie la méthode de capture. Si vous utilisez la méthode des sommets, vous pouvez configurer des paramètres supplémentaires. Valeurs : sketch | vertex Valeurs supplémentaires pour le sommet, applicables uniquement dans l'application de terrain : streaming | beep | haptic | edit Exemples : | Application Web Application de terrain |
| minCaptureZoomLevel | Spécifiez le niveau minimal auquel la géométrie peut être capturée. Valeur : <integer> Exemple : | Application Web |
| overlay | Afficher les emplacements des points à partir de la première question de type géopoint d’une répétition sur tout autre géopoint, géoforme ou géotrace dans votre enquête. Ajouter des propriétés pour définir le contenu et le style. Valeur : <repeat name> Propriétés : view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize Exemples : | Application de terrain |
precision | Spécifiez le nombre de décimales qui seront capturées dans la question de type carte et affichées dans le volet des réponses individuelles dans l’enquête. Si ce paramètre n’est pas défini, toutes les décimales disponibles sont capturées dans la question de type carte, mais seules six sont affichées dans le volet des réponses individuelles. Valeur : <integer> Exemple : | Application Web |
| snapMode | Spécifie le comportement de la capture. Les points peuvent être capturés sur d’autres entités, et les lignes et les polygones peuvent être capturés sur d’autres entités ou sur eux-mêmes. Uniquement disponible si method=vertex. Valeur : feature | self2 Exemple : | Application Web |
| symbol1 | Spécifie un fichier .png à utiliser comme symbole ponctuel sur la carte. Ajouter des propriétés pour définir la position et l’échelle. Valeur : <file name>.png Propriétés : x | y | scale Exemple : | Application de terrain |
1 : uniquement prise en charge par le type de question geopoint (géopoint).
2 : uniquement prise en charge par les types de question geoshape (géoforme) et geotrace (géotrace).
3 : uniquement prise en charge par le type de question geoshape (géoforme).
Questions à choix multiples
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm parameters pour les types de question select_one (sélection unique), select_multiple (sélection multiple) et rank (classement).
parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
| aléatoire | Rendre aléatoire l’ordre des choix dans une liste de choix Valeurs : true Exemple : | Application Web Application de terrain |
Plage
Cette section décrit les paramètres que vous pouvez utiliser dans les colonnes XLSForm spécifiées pour le type de question range (plage). Si vous combinez les paramètres, ils doivent être séparés par un espace.
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm body::esri:style. Pour plus d’informations, reportez-vous à la rubrique Options de style.
body::esri:style
| Paramètre | Description | Application d’envoi |
|---|---|---|
startColor endColor color | Spécifier les couleurs du curseur de plage :
Valeurs : <HTML color name> | <hex color code> Exemples : | Survey123 Mobile Application Web Application de terrain |
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm parameters pour le type de question range (plage). Pour plus d’informations, reportez-vous à la rubrique Paramètres du curseur de plage.
parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
start end step | Spécifiez les valeurs de départ, de fin et d’étapes du curseur de plage. Valeurs : <integer> | <decimal> Exemples : | Survey123 Mobile Application Web Application de terrain |
Répétitions
Cette section décrit les paramètres que vous pouvez utiliser dans les colonnes XLSForm spécifiées pour le type de question begin repeat (début de répétition).
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm bind::esri:parameters.
bind::esri:parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
| allowAdds | Permet l’ajout de nouveaux enregistrements de répétition. Valeurs : true | false Exemple : | Application de terrain |
| allowUpdates | Permet de modifier les enregistrements de répétition existants. Valeurs : true | false Exemple : | Application de terrain |
| query | Permet d’afficher dans le formulaire les enregistrements de répétition existants. Spécifie des paramètres de requête supplémentaires pour filtrer les enregistrements disponibles. Valeurs : <none> | "SQL statement" Exemples : | Application de terrain |
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm body::esri:style pour le type de question begin repeat (début de répétition).
body::esri:style
| Paramètre | Description | Application d’envoi |
|---|---|---|
| backgroundColor borderColor | Définit les couleurs d’arrière-plan et de bordure pour une répétition. Pour plus d’informations, reportez-vous à la rubrique Couleurs des groupes, des pages et des répétitions. Valeurs : <HTML color name> | <hex color code> Exemples :
| Survey123 Mobile Application de terrain |
Pour une répétition avec une apparence tabulaire, spécifiez le mode du bouton Add record (Ajouter un enregistrement) et de l’option Copy to new record (Copier dans un nouvel enregistrement) dans la vue tabulaire. La valeur par défaut est row. Lorsque la valeur est row, le nouvel enregistrement est ajouté à la vue tabulaire. Lorsque la valeur est form, le nouvel enregistrement est ouvert dans la vue du formulaire. Valeurs : row | form Exemple : | Survey123 Mobile | |
Pour une répétition avec une apparence tabulaire, affichez ou masquez l’option Edit in form view (Modifier dans la vue du formulaire) dans la vue tabulaire. La valeur par défaut est true. Remarque :Lorsque la répétition comporte des erreurs, l’option Edit in form view (Modifier dans la vue du formulaire) est activée même lorsque le paramètre editInFormView est défini sur false. Valeurs : true | false Exemple : | Survey123 Mobile | |
Pour une répétition avec une apparence tabulaire, affichez ou masquez l’option Copy to new record (Copier dans un nouvel enregistrement) dans la vue tabulaire. Cette option permet aux utilisateurs de dupliquer un enregistrement dans la répétition. La valeur par défaut est true. Le paramètre addRecordMode détermine le mode d’ajout de l’enregistrement dupliqué. Valeurs : true | false Exemple : | Survey123 Mobile | |
Pour une répétition avec une apparence tabulaire, activez ou désactivez la mise à jour dans la vue tabulaire. La valeur par défaut est true. Lorsque la valeur est false, toutes les cellules de la vue tabulaire sont en lecture seule. Valeurs : true | false Exemple : | Survey123 Mobile |
La table suivante décrit le paramètre que vous pouvez utiliser dans la colonne XLSForm body::esri:style pour les questions figurant dans les répétitions tabulaires.
body::esri:style
| Paramètre | Description | Application d’envoi |
|---|---|---|
Pour une répétition avec une apparence tabulaire, affichez la question sous forme de colonne dans la vue tabulaire. La valeur par défaut est false. Valeurs : true | false Exemple : | Survey123 Mobile |
Texte
Cette section décrit les paramètres que vous pouvez utiliser dans les colonnes XLSForm spécifiées pour le type de question text (texte).
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm bind::esri:parameters.
bind::esri:parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
| géocoder | Pour une question texte avec apparence géocode, définissez le localisateur à partir duquel renvoyer les résultats géocodés lorsque l’apparence géocode est utilisée. Valeur : <locator item ID> Exemple : | Application Web Application de terrain |
La table suivante décrit les paramètres que vous pouvez utiliser dans la colonne XLSForm body::esri:style pour le type de question text (texte).
body::esri:style
| Paramètre | Description | Application d’envoi |
|---|---|---|
| defaultHeight | Pour une question de type texte avec une apparence multiligne, définissez la hauteur initiale de la zone de texte. La hauteur de la zone de texte augmentera de façon à accueillir le texte de la réponse. Valeur : <number of lines> Exemple : | Application de terrain |
| indicator | Pour une question texte avec apparence géocode, autorise les résultats géocodés à indiquer la direction et la distance par rapport à l’emplacement actuel de l’appareil. Valeurs : direction | distance | none Exemples : | Application de terrain |
| maxResults | Pour une question texte avec apparence géocode, spécifie le nombre maximum de résultats pouvant être renvoyés. La valeur par défaut est 6. Valeur : <number of results> Exemple : | Application Web Application de terrain |
| proximité | Pour une question texte avec apparence géocode, spécifie si les résultats géocodés ne montrent que les résultats se trouvant dans un rayon défini par rapport à la position de l’appareil. Valeurs : <distance>m | km | ft | mi | yd Exemples : | Application de terrain |
| suggestions | Pour une question Texte avec apparence Géocode, modifie la manière dont les suggestions s’affichent. La valeur par défaut est yes (oui). Valeurs : yes | no Exemple : | Application de terrain |
Télémètre
La table suivante décrit le paramètre que vous pouvez utiliser dans la colonne XLSForm bind::esri:parameters pour les types de question text (texte), integer (entier) et decimal (décimal) pour extraire les valeurs d’un télémètre.
bind::esri:parameters
| Paramètre | Description | Application d’envoi |
|---|---|---|
mesure | Pour une question Texte, Décimal ou Entier avec l’apparence télémètre, définissez les mesures à stocker dans la question. Mettez la liste des valeurs entre guillemets si certaines valeurs contiennent des espaces. Valeurs : height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights Exemples : | Application de terrain |
Vous avez un commentaire à formuler concernant cette rubrique ?