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 d’une enquête (Outbox (Boîte d’envoi) ou Sent (Éléments envoyés)) avec Survey123 Mobile ou l’application de terrain Survey123.

Le nom d’instance est utile pour examiner lʼhistorique des enquêtes envoyées dans le dossier Sent (Éléments envoyés) ou pour identifier les enquêtes individuelles, comme dans l’exemple Survey123 Mobile ci-dessous concernant le dossier Outbox (Boîte d’envoi).

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. En voici un 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 utiliser 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>'))