Nom de l'instance

ArcGIS Survey123 prend en charge le paramètre instance_name dans XLSForm. En utilisant le paramètre instance_name, le créateur de l’enquête peut contrôler les informations utilisées pour identifier de manière unique chaque réponse dans les dossiers Drafts (Brouillons), Outbox (Boîte d’envoi), Inbox (Boîte de réception) et Sent (Éléments envoyés) de l’application de terrain Survey123.

Le nom d’instance est utile pour examiner lʼhistorique des enquêtes envoyées dans la boîte Sent (Éléments envoyés) de l’application de terrain Survey123, ou pour identifier les enquêtes individuelles dans le dossier Inbox (Boîte de réception) de l’application de terrain.

Dans cet exemple, l’expression suivante a été appliquée au nom d’instance en réponse à deux questions de type texte séparées par un espace en tant qu’identifiant de chaque enregistrement d’enquête (dans ce cas, le nom complet d’une personne).

concat(${first_name}, ' ', ${last_name})

Le nom d’instance est défini dans la feuille de calcul settings de votre XLSForm. Lorsque la colonne instance_name est vide, un nom d’instance par défaut est appliqué. Ce dernier répertorie toutes les réponses aux questions de votre enquête. Saisissez une expression dans la colonne instance_name pour personnaliser le nom d’instance. Par exemple :

${site_name}

format-date(${date_time}, '%Y-%m-%d')

concat(${category}, ' Remarks: ', ${remarks})

concat(${street_number}, ' ', ${street_name}, ' ', ${suburb})

Vous pouvez utiliser des calculs pour créer le nom de l’instance, par exemple :

${first_number} + ${second_number}

Vous pouvez également appliquer la mise en forme HTML au nom de l’instance. Vous devez concaténer la syntaxe HTML comme faisant partie du nom de l’instance à l’aide de la fonction concat(). Dans l’exemple suivant, le nom de l’instance est mis en forme pour s’afficher en bleu, en italique, le nom de famille en gras.

concat('<font color="blue"><i><b>', ${last_name}, '</b>, ', ${first_name}, '</i></font>')

Conseil :

Si la syntaxe HTML inclut des guillemets, vous devez utilisez des guillemets simples pour encadrer une chaîne de texte contenant des guillemets doubles et inversement. Par exemple : '<font color="yellow">'.

Les noms d’instance affichent trois lignes de texte, au maximum.

L’exemple suivant utilise une instruction if() pour appliquer une mise en forme conditionnelle au nom d’instance : Si la réponse à la question approved est yes, le nom d’instance vire au vert ; sinon, il apparaît en rouge :

if(${approved}='yes', concat('<font color="green"><b>', ${last_name}, '</b>, ', ${first_name}, '</font>'), concat('<font color="red"><b>', ${last_name}, '</b>, ', ${first_name}, '</font>'))