Expressions de rapport

La réponse à une question peut s’afficher dans un modèle de rapport en plaçant son nom entre accolades, {}, précédé du symbole dollar. Toute valeur de chaîne incluse dans une expression doit être mise entre guillemets doubles.

L’exemple suivant affiche la réponse à une question Texte intitulée firstname.

${firstname}

En plus d’afficher la réponse à une question dans un rapport, les mots-clés permettent aussi d’afficher d’autres informations utiles. L’expression suivante affiche la date et l’heure actuelles lors de l’impression d’un rapport :

${$date}

Si le résultat est un tableau, ce dernier peut faire l’objet d’une itération en ajoutant # comme balise de début et / comme balise de fin à l’intérieur des accolades. L’expression suivante imprime tous les fichiers image sur des lignes distinctes :

${#image1}
${$file}
${/}

Vous pouvez également utiliser des expressions pour affiner le mode d’affichage des réponses. Une expression peut être un nom de question unique ou un mot-clé (comme ci-dessus), un calcul impliquant une ou plusieurs questions ou mots-clés, ou encore un nom de question ou un mot-clé avec des méthodes et des paramètres afin de contraindre ou d’appliquer un style à la réponse. Une expression utilise la notation suivante :

${questionname or keyword | method:parameter}

Une expression peut inclure plusieurs méthodes et paramètres ou aucun de ces éléments. Les paramètres peuvent être des valeurs provenant d’autres questions ou une valeur fixe.

L’expression suivante affiche le calcul d’une question numérique appelée floweringtrees divisée par une question numérique appelée totaltrees. Lorsque vous faites référence à plusieurs questions dans la même expression, le nom de chaque question doit seulement être mentionné directement, sans être mis entre accolades :

${floweringtrees / totaltrees}

L’expression suivante affiche la valeur de la coordonnée x issue de la question relative à la position dans laquelle getValue désigne la méthode et x le paramètre.

${location | getValue:"x"}

L’expression suivante est considérée comme vraie si la réponse à une question appelée fruitcolor est différente de red :

${if fruitcolor!="red"}The fruit is not red.${/}

Les chaînes peuvent être concaténées dans une expression en les joignant avec un signe plus. L’expression suivante utilise cette concaténation pour transmettre le contenu d’une question nommée field_0 à un service de génération de QR Code, créant ainsi un QR Code pour la réponse à la question :

${$image | src:"https://barcode.tec-it.com/barcode.ashx?code=QRCode&data="+field_0}

Vous trouverez des exemples d’expression pour chaque type de question dans les rubriques suivantes :

• Expressions de texte
• Expressions numériques
• Expressions avec des images et d’autres pièces jointes
• Expressions cartographiques (types géopoint, géotrace ou géoforme inclus)
• Expressions de date, heure et date-heure
• Expressions portant sur un choix
• Expressions de répétition

Méthodes concernant les expressions

Certains types de question ne prennent pas en charge les expressions et les méthodes. Le tableau suivant dresse la liste des méthodes et des paramètres compatibles avec les différents types de question.

Méthode	Paramètre	Type de question Connect	Type de question du concepteur Web	Description
getValue	-	Tout type de question	Tout type de question	Extrait la valeur des données brutes de la couche d’entités ou l’image brute d’une pièce jointe.
getValue	x, y, z, wkid	geopoint	Carte	Extrait les coordonnées x, y, z de manière individuelle dans une référence spatiale spécifiée. Le paramètre wkid est facultatif et sa valeur correspond à la référence spatiale de la couche d’entités s’il est omis.
getValue	length, area, unit, measurement type	geotrace, geoshape	Carte	Renvoie la longueur d’une polyligne ou le périmètre/la surface d’un polygone, dans les unités spécifiées et indique si les mesures sont géodésiques ou planaires. Le type de mesure par défaut est géodésique.
getValue	name, size	image, audio, file	Image (Image), Signature (Signature), Audio (Audio), File (Fichier)	Renvoie le nom de fichier ou la taille d’une pièce jointe.
getValue	width, height, x, y, date, time, direction	image	Image, signature	La largeur et la hauteur renvoient la valeur entière de la largeur et de la hauteur de l’image en nombre de pixels et les valeurs x, y, de date, d’heure et de direction renvoient les valeurs lues à partir de l’image EXIF si cette dernière est présente.
getValue	total	begin repeat, image, audio, file	Repeat (Répéter), Image (Image), Signature (Signature), Audio (Audio), File (Fichier)	Renvoie le nombre total de répétitions ou de pièces jointes.
getValue	position	begin repeat, image, audio, file	Repeat (Répéter), Image (Image), Signature (Signature), Audio (Audio), File (Fichier)	Renvoie un entier égal à la position d’index 1 dans le tableau.
getValue	duration	audio, file	Audio (Audio), File (Fichier)	Renvoie la durée des enregistrements audio en secondes. Attention : La durée n’est pas renvoyée dans les réponses collectées dans l’application Web si Safari est utilisé.
appearance	multiline	Texte	Texte multiligne	Conserve les sauts de ligne dans la chaîne. Si aucune valeur d’apparence n’est spécifiée, la réponse renvoie une chaîne d’une seule ligne.
appearance	puces	select_multiple	Sélection multiple	Renvoie la réponse sous la forme d’une puce.
checked	choice name	select_one, select_multiple	Multiple select (Sélection multiple), Single select (Sélection unique), Single select grid (Grille à sélection unique), Dropdown (Menu déroulant), Likert scale (Échelle de Likert), Rating (Évaluation)	Renvoie une case cochée si la valeur de champ est égale à celle de choice name ; sinon, renvoie une case non cochée.
Sélectionné(s)	choice name	select_one, select_multiple	Multiple select (Sélection multiple), Single select (Sélection unique), Single select grid (Grille à sélection unique), Dropdown (Menu déroulant), Likert scale (Échelle de Likert), Rating (Évaluation)	S’il existe un domaine de valeurs précodées, renvoie true si la valeur de champ est égale à celle de choice name ; sinon, renvoie false.
countSelected	-	select_one, select_multiple	Multiple select (Sélection multiple), Single select (Sélection unique), Single select grid (Grille à sélection unique), Dropdown (Menu déroulant), Likert scale (Échelle de Likert), Rating (Évaluation)	Renvoie le nombre de choix sélectionnés.
selectedAt	index	select_one, select_multiple	Multiple select (Sélection multiple), Single select (Sélection unique), Single select grid (Grille à sélection unique), Dropdown (Menu déroulant), Likert scale (Échelle de Likert), Rating (Évaluation)	Renvoie la chaîne à la position de l’index dans la liste de choix. L’index commence à zéro.
locale	language code	date, dateTime, start, end, decimal	Date (Date), Date and time (Date et heure), Number (Nombre)	Renvoie la date, l’heure et le nombre au format local.
format	format string	date, dateTime, integer, decimal, start, end	Date (Date), Date and time (Date et heure)	Renvoie une chaîne de date mise en forme.
utcOffset	offset value	date, dateTime, start, end	Date (Date), Date and time (Date et heure)	Renvoie une valeur de type date ou date-heure qui est décalée de la valeur de décalage UTC.
mapSettings	web map item ID, map scale	geopoint, geotrace, geoshape	Carte	Spécifie le fond de carte et l’échelle lors de l’impression de l’image de la carte. Héritage : Cette méthode a été remplacée par map et mapScale.
mapExtent	xmin, ymin, xmax, ymax, wkid	geopoint, geotrace, geoshape	Carte	Spécifie l’étendue de la carte fixe lors de l’impression de l’image de la carte. Le paramètre wkid est facultatif. Il est défini sur 4326 (WGS84) s’il n’est pas spécifié.
carte	ID d’élément de la carte Web	geopoint, geotrace, geoshape	Carte	Spécifie le fond de carte lors de l’impression de l’image de la carte.
mapScale	échelle de la carte	geopoint, geotrace, geoshape	Carte	Spécifie l’échelle de la carte lors de l’impression de l’image de la carte.
mapFilters	ID de couche dans le JSON de carte Web, paramètres de requête	geopoint, geotrace, geoshape	Carte	Spécifie un ou plusieurs filtres de couches d’entités dans une carte Web lors de l’impression de l’image de la carte.
rotation	degrés	geopoint, geotrace, geoshape, image	Carte, image	Spécifie l’angle de rotation de l’image ou de la carte.
drawingInfo	currentLayer, URL de la couche d’entités	geopoint, geotrace, geoshape	Carte	Spécifie les informations de dessin lors de l’impression de l’image de la carte, notamment le symbole, l’étiquette et la transparence.
src	URL de l’image	-	-	Spécifiee l’URL source d’un élément d’image dynamique.
taille	width, height, max width, max height	image	Image	Spécifie la taille de l’image imprimée.
arrondi	lieux	decimal, geopoint, geoshape, geotrace	Nombre	Arrondit un nombre décimal au nombre de décimales indiqué.
useGrouping	boolean	decimal	Nombre	Si la condition est vraie, renvoie un nombre avec des séparateurs de groupement déterminés par les paramètres locaux ; si la condition est fausse, aucun séparateur n’est utilisé.
toFixed	lieux	decimal, geopoint, geoshape, geotrace	Nombre	Spécifie un nombre fixe de chiffres après le séparateur décimal. Il se remplit avec des zéros si un nombre fixe de chiffres est requis.
attachmentsDefExp	expression SQL	image, audio, file	Image (Image), Signature (Signature), Audio (Audio), File (Fichier)	Identifie les pièces jointes pour une question ou l’entité actuelle à l’aide du mot-clé $attachment.

Mots-clés utilisés dans les expressions

Le tableau suivant répertorie tous les mots-clés qui peuvent être utilisés dans une expression :

Mot-clé	Description
$date	Insère la date et l’heure actuelles lors de l’impression du rapport. Par défaut, le mot-clé génère la date actuelle en utilisant le format régional actuel. Exemples : ${$date | format:"MM/DD/YYYY"} $($date | utcOffset:"+08:00"} $($date | locale:"zh-cn"}
$image	Insère un élément image dans le rapport. Utilisez la méthode src pour spécifier l’URL de l’image. Exemple : ${$image | src:"https://upload.wikimedia.org/wikipedia/commons/1/13/Esri_Headquarters%2C_Building_Q.jpg"}
$map	Insère un élément cartographique dans le rapport sans faire référence à une question de l’enquête. Exemple : ${$map | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}
$shape	Imprime la géométrie (point, polyligne ou polygone) de l’entité actuelle sur une carte. Exemples : ${$shape} ${$shape | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}
$attachment	Représente la première pièce jointe ou toutes les pièces jointes de l’entité actuelle. Exemples : ${$attachment | getValue:"name"} ${$attachment | getValue:"size"} ${$attachment | size:200:300} Pour itérer toutes les pièces jointes, ajoutez des balises de début et de fin. ${#$attachment} ${$file} ${/}
$file	Représente le fichier actuel lors de l’itération de plusieurs fichiers d’une question d’enquête de type pièce jointe ou de pièces jointes d’une entité. Exemples : ${#image1} ${$file | size:460:0} {/} ${#$attachment} ${$file | getValue:"position"}. ${$file | getValue:"name"} ${/}
$feature	Représente l’entité actuelle dans un tableau d’entités. Exemple : {#repeat1} {$feature | getValue: "position"} {/}
$layers["<layername>"] ou $layers[<layerId>]	Fait référence à une couche par son nom ou ID figurant dans le même service d’entités que la couche de l’enquête. Exemples : ${$layers["cities"] | where:”1=1 !important” | stats:”count,objectid”} ${#$layers["states"]}...${/}