Colonnes personnalisées de Esri

Les colonnes personnalisées de Esri pour XLSForm fournissent une fonctionnalité supplémentaire aux utilisateurs de Survey123.

Type de champ

Utilisez la colonne personnalisée bind::esri:fieldType pour contrôler le type et la longueur du champ à créer dans ArcGIS pour les questions de l’enquête. Pour plus d’informations sur les types de champs pris en charge, reportez-vous à la rubrique Types de données des champs ArcGIS.

Pour certaines questions, vous pouvez modifier le type de champ que Survey123 attribue par défaut. Le tableau suivant répertorie quelques exemples :

Type de question	Type de champ par défaut	Commentaires
select_one	esriFieldTypeString	Pour garantir le stockage du choix sous forme d’entier, modifiez en esriFieldTypeInteger.
date	esriFieldTypeDate	esriFieldTypeDate inclut toujours un élément temporel. Pour stocker une date uniquement, modifiez en esriFieldTypeDateOnly.
dateTime	esriFieldTypeDate	esriFieldTypeDate ne donne aucune indication de fuseau horaire. Pour inclure le fuseau horaire dans le champ, modifiez en esriFieldTypeTimestampOffset. Si esriFieldTypeTimestampOffset est défini, un sélecteur de fuseau horaire s’affiche sous le formulaire pour les questions Date/heure. Le fuseau horaire actuel de l’appareil est appliqué par défaut.
time	esriFieldTypeString	Pour stocker l’heure uniquement, modifiez en esriFieldTypeTimeOnly.

Pour contrôler le type de champ, indiquez l’une des valeurs suivantes dans la colonne bind::esri:fieldType :

• esriFieldTypeString
• esriFieldTypeDate
• esriFieldTypeDateOnly
• esriFieldTypeTimeOnly
• esriFieldTypeTimestampOffset
• esriFieldTypeInteger
• esriFieldTypeBigInteger
• esriFieldTypeSingle
• esriFieldTypeDouble
• esriFieldTypeSmallInteger
• esriFieldTypePointZ
• esriFieldTypeGUID

À noter que la colonne bind::esri:fieldType permet uniquement de contrôler le type de champ créé dans la couche d’entités. Pour contrôler le type de champ d’une question dans une enquête, utilisez la colonne bind::type. Si, par exemple, vous saisissez la valeur int dans la colonne bind::type pour une question calculate, le champ est considéré comme un entier, et non pas comme une chaîne, qui est son type par défaut. Les valeurs acceptées par la colonne bind::type sont les suivantes :

• entier
• decimal
• chaîne
• date
• dateTime
• heure

La colonne bind::esri:fieldType accepte également la valeur null, qui entraîne l’omission de la question dans la couche d’entités créée. Même si la question reste présente dans l’enquête et se comporte normalement, la réponse n’est pas soumise à la couche d’entités et n’est pas présente lors de l’examen des réponses. C’est parfait pour les calculs, les contraintes ou toutes autres questions qui sont exigés à des fins de présentation, mais qui ne sont pas nécessaires dans les résultats.

Les types de question suivants ne prennent pas en charge un type de champ nul :

• select_one or other
• select_multiple or other
• hidden

Remarque :

Les questions de type géopoint, géotrace et géoforme prennent en charge un type de champ nul seulement si l’enquête comporte au moins une autre question de type géopoint, géotrace ou géoforme qui ne comporte pas de type de champ nul ou encore seulement si le géopoint, la géotrace ou la géoforme se trouve dans une répétition.

Longueur du champ

Utilisez la colonne personnalisée bind::esri:fieldLength pour contrôler la longueur des champs de type chaîne (texte) à créer dans ArcGIS pour les questions de l’enquête.

Remarque :

Vous ne pouvez cependant pas contrôler les questions question de type entier et décimal de cette manière. Les bases de données ne spécifient pas la longueur d’un champ numérique ; la plage de valeurs valides est régie par le type de champ numérique. Par exemple, un champ de type enter stocke n’importe quelle valeur entière comprise entre -2 147 483 648 et 2 147 483 647.

Alias de champ

Par défaut, l’alias d'un champ d’enquête hérite la même valeur que l’étiquette du champ, à laquelle il est fait référence principalement à l’ouverture de l’enquête dans ArcGIS. Vous pouvez modifier ce comportement en saisissant une valeur dans la colonne bind::esri:fieldAlias, qui devient ensuite le nouvel alias du champ.

Les questions masquées et à calcul n’étant pas affichées dans un formulaire, le contenu du champ d’étiquette n’est pas préservé. Cela signifie que, lorsque vous visualisez les enregistrements de l’enquête sur le site Web Survey123 ou dans ArcGIS, le nom de la question s’affiche dans l’en-tête de colonne pour ces types de questions. Pour forcer l’en-tête de colonne des questions masquées et de type calcul à afficher une étiquette, utilisez la colonne bind::esri:fieldAlias de la feuille de calcul pour spécifier une étiquette.

Masque de saisie

Les masques de saisie offrent un format défini pour les questions de type texte en utilisant des caractères et des symboles. Lorsque vous appliquez un masque de saisie à une question, toutes les réponses doivent respecter le modèle défini par le masque de saisie. Dans l’application Web et l'application de terrain Survey123, les réponses aux enquêtes ne peuvent pas être envoyées tant que tous les masques de saisie ne sont pas conformes.

Conseil :

Les masques de saisie peuvent uniquement s’appliquer au type de question text. Pour les types de question integer ou decimal, utilisez la colonne constraint pour limiter les réponses. Pour plus d’informations, reportez-vous à la rubrique Contraintes.

Pour appliquer un masque de saisie à la question, définissez le masque dans la colonne body::esri:inputMask. Le tableau suivant répertorie les caractères et les symboles que vous pouvez utiliser dans un masque de saisie :

Caractère	Signification
A	Caractère alphabétique ASCII obligatoire. Caractères de A à Z et de a à z.
a	Caractère alphabétique ASCII autorisé, mais non obligatoire.
N	Caractère alphanumérique ASCII obligatoire. Caractères de A à Z, de a à z et de 0 à 9.
n	Caractère alphabétique ASCII autorisé mais non obligatoire.
x	N’importe quel caractère non vierge obligatoire.
x	N'importe quel caractère non vierge autorisé mais non obligatoire.
9	Chiffre ASCII obligatoire. Chiffres de 0 à 9.
0	Chiffre ASCII autorisé mais non obligatoire. Chiffres de 0 à 9.
D	Chiffre ASCII obligatoire. Les chiffres peuvent être de 1 à 9.
j	Chiffre ASCII autorisé mais non obligatoire. Les chiffres peuvent être de 1 à 9.
#	Chiffre ASCII, ou signes plus ou moins, autorisé mais non obligatoire.
H	Caractère hexadécimal obligatoire. Caractères de A à F, de a à f et de 0 à 9.
h	N'importe quel caractère hexadécimal autorisé mais non obligatoire.
B	Caractère binaire obligatoire. Caractères de 0 à 1.
b	Caractère binaire autorisé mais non obligatoire.
>	Tous les caractères alphabétiques qui suivent sont en majuscules.
<	Tous les caractères alphabétiques qui suivent sont en minuscules.
!	Désactiver la conversion de la casse.
\	Échappe les caractères spéciaux répertoriés ci-dessus pour les utiliser en tant que séparateurs.

Le masque est composé d’une chaîne de caractères et de séparateurs, qui peut être suivie d’un point-virgule pour terminer le masque de saisie et d’un caractère à utiliser pour les espaces vides. Les caractères blancs sont supprimés du texte après édition. Le tableau suivant présente des exemples de masques :

Exemple de masque	Description
>A<xxxxxxxxxxxx	Texte qui commence par une lettre majuscule suivie de caractères en minuscules.
AAA-AAA-AAA;_	Identifiant unique qui utilise des tirets comme séparateurs, avec un pont-virgule à la fin du masque de saisie suivi par un trait de soulignement pour représenter chaque caractère à renseigner.
B9.99;-	Représente une valeur pH. Le nombre doit obligatoirement commencer par 0 ou 1 et ne peut inclure que deux décimales. Un point-virgule termine le masque de saisie, suivi par un tiret pour représenter chaque caractère à renseigner.
999-99-9999	Numéro de sécurité sociale américain.
[phone]	Numéro de téléphone américain.
900 kg	Poids en kilogrammes, entre 0 et 999.
99999	Code postal américain à 5 chiffres.
AAA	Code d’aéroport IATA.

Workflow

Utilisez la colonne personnalisée bind::esri:workflow pour indiquer que le champ peut être rempli à partir de la tuile Rangefinder lancée depuis la bibliothèque. Cette colonne est prise en charge uniquement par les questions de type texte. Les valeurs suivantes sont acceptées par la colonne bind::esri:workflow :

• rangefinderMode=height
• rangefinderMode=offset
• rangefinderMode=height,offset
• rangefinderHeight

Chacune des valeurs rangefinderMode procure une expérience utilisateur similaire à l’opérateur de terrain. Une fois que le processus de télémètre est sélectionné, l’utilisateur est invité à sélectionner une enquête et à prendre 1 à 3 clichés avec l’instrument. Ensuite, l’enquête est lancée automatiquement pour laisser le Field Worker répondre à toutes autres questions.

La valeur rangefinderHeight est unique en ce sens qu’elle permet à l’opérateur de terrain de parcourir chaque question de l’enquête qui est configurée pour recevoir une valeur de hauteur, à l’aide des flèches vers l’avant et de retour. Une fois que toutes les hauteurs sont mesurées, le Field Worker touche Done (Terminé) et passe à l’enquête pour répondre à toutes autres questions.

Remarque :

Pour en savoir plus, reportez-vous à la rubrique Préparer une collecte de données du télémètre.