Configurer le formulaire

Sur le terrain, les opérateurs lisent, remplissent et mettent à jour des formulaires. Dans Collector, le formulaire repose sur la fenêtre contextuelle de l’entité ou de la table et les entrées sont liées à la façon dont vous avez préparé la couche. Pour configurer à la fois la vue de formulaire lisible et le formulaire modifiable, configurez la fenêtre contextuelle pendant que vous créez la carte. Même si le contenu de la fenêtre contextuelle en lecture seule peut utiliser différents modes d’affichage (tels que l’affichage personnalisé), la fenêtre contextuelle modifiable utilise toujours une liste d’attributs et de valeurs, comme un formulaire papier. Grâce à la liste, l’opérateur de terrain utilise un format connu et n’a aucun doute sur le fait qu’il met à jour la partie appropriée du formulaire.

Astuce :

Les responsables SIG considèrent les informations sur les entités (et les tables) comme des champs et leurs valeurs comme des attributs. Ils voient également l’affichage comme une fenêtre contextuelle. Cependant, les opérateurs de terrain pensent en termes de ressources et d’observations, et conceptualisent les informations sous forme de formulaire papier avec des entrées. Pour encourager les responsables SIG à communiquer de façon à être mieux compris des opérateurs de terrain, cette rubrique recourt à la terminologie utilisée par les opérateurs de terrain. Les responsables SIG pourront ainsi se familiariser avec leur mode de pensée. La seule exception concerne les termes liés à la création.

Même si vous pouvez utiliser la fenêtre contextuelle par défaut (avec la majorité du formulaire visible et modifiable), il sera plus facile pour vos opérateurs de terrain de fournir les informations appropriées si vous prenez le temps de configurer le formulaire. Vous pouvez configurer les éléments suivants :

• Titre
• Affichage en lecture seule
• Ordre
• Les entrées qui s’affichent et qui sont modifiables
• Étiquettes (alias)
• Astuce textuelle
• Formats des nombres et des dates
• Calculer un titre ou des entrées avec des expressions Arcade
• Entrées renseignées par codes à barres et codes QR
• Affichage de pièces jointes
• Affichage de métadonnées haute précision
• Affichage d’informations associées
• Valeur valides
• Valeurs par défaut
• Entrées obligatoires

Pour savoir comment configurer des formulaires, reportez-vous à la rubrique Configurer des fenêtres contextuelles dans ArcGIS Online ou Configurer des fenêtres contextuelles dans ArcGIS Enterprise.

Commencer à configurer le formulaire

Dans Map Viewer, configurez la fenêtre contextuelle pour configurer le formulaire.

1. Dans le navigateur, ouvrez la carte dans Map Viewer, cliquez sur Details (Détails), puis sur Content (Contenu).

   Remarque :

   Si vous n’avez pas encore créé votre carte, reportez-vous à la rubrique Créer une carte.

2. Accédez à la couche ou table pour laquelle vous créez un formulaire, cliquez sur More Options (Autres options) , puis sur Configure Pop-up (Configurer la fenêtre contextuelle).

Titre

Il est important d’inclure les informations d’identification appropriées dans le titre afin que les opérateurs de terrain puissent choisir facilement le formulaire qu’ils doivent lire ou mettre à jour. Le titre de la fenêtre contextuelle permet d’afficher votre formulaire dans des listes (par exemple, lorsque plusieurs éléments de la carte sont activés ou lorsque plusieurs résultats de recherche sont renvoyés). Dans le titre, utilisez des expressions attributaires Arcade pour que vos opérateurs de terrain profitent des informations dont ils ont besoin, sous un format pratique et facile d’utilisation. Reportez-vous à la rubrique Utiliser des expressions attributaires dans ArcGIS Online ou Utiliser des expressions attributaires dans ArcGIS Enterprise.

Affichage du formulaire en lecture seule

Lorsqu’un opérateur de terrain consulte un formulaire, il apparaît conformément aux paramètres d’affichage du contenu de la fenêtre contextuelle. Si vous créez la carte avec une seule entrée, c’est tout ce que voit l’opérateur de terrain lorsqu’il consulte le formulaire. Si vous utilisez en revanche un affichage personnalisé, il voit le contenu que vous avez inséré dans votre fenêtre contextuelle personnalisée. Tenez compte des informations que l’opérateur de terrain risque de rechercher lorsque vous créez le formulaire en lecture seule :

• Plusieurs entrées doivent être analysées et rapidement identifiées : utilisez A list of field attributes (La liste des valeurs de champ), avec une configuration qui met en avant les informations clés.

  Remarque :

  Même si vous pouvez faire en sorte qu’une entrée soit visible dans le formulaire en lecture seule et non dans le formulaire modifiable, toutes les autres configurations s’appliquent à la fois aux formulaires en lecture seule et modifiables lorsque vous utilisez une liste pour l’affichage en lecture seule. Cela inclut l’ordre, les alias et les formats.

• Une entrée unique est requise : utilisez A description from one field (Description provenant d’un champ) pour mettre en valeur ces informations.
• L’opérateur de terrain connaît bien un mode d’affichage différent, par exemple une expression qui permet de communiquer les informations clés : utilisez A custom attribute display (Un affichage de champ personnalisé) et créez l’expression à l’aide de différentes entrées.
• Le titre comporte toutes les informations requises et rien d’autre n’a besoin d’être lu : utilisez No attribute information (Aucune information attributaire) pour éviter d’encombrer l’application avec des informations inutiles.

Ordre

Vous devez ordonner votre formulaire afin que l’opérateur de terrain puisse intégrer les informations dans le champ plus facilement. Si votre formulaire est long, mais que seules certaines parties sont requises, vous pouvez positionner ces parties en premier afin que l’opérateur de terrain n’ait pas à rechercher les éléments clés. Si le formulaire contient des informations associées, elles doivent être regroupées, comme dans les sections d’un formulaire papier. Si vous utilisez une liste pour votre affichage en lecture seule, le même ordre est utilisé pour la mise à jour.

1. Sous These field attributes will display (Ces attributs de champs s’afficheront), cliquez sur l’entrée dont vous voulez modifier l’ordre.
2. Utilisez les touches de direction en regard de la liste pour déplacer l’entrée vers le haut ou le bas dans la liste.

   

Affichage et mise à jour des entrées

Un bon formulaire contient les entrées dont les opérateurs de terrain ont besoin. Il ne doit pas inclure d’informations superflues qui l’encombrent et distraient les opérateurs de terrain. Par exemple, si vos données incluent des informations sur les récepteurs GPS, l’opérateur de terrain ne doit pas être en mesure de les mettre à jour. Il est également probable qu’il n’ait pas du tout besoin de les voir.

Lorsque vous créez la carte, configurez le formulaire en précisant ce que contient la vue en lecture seule, ainsi que les entrées qui sont modifiables et incluses lors de la mise à jour.

1. Pendant la configuration de la fenêtre contextuelle, cliquez sur Configure Attributes (Configurer les attributs).
2. Cochez la case Display (Affichage) pour les entrées que les opérateurs de terrain doivent voir dans la fenêtre contextuelle en lecture seule.
3. Cochez la case Edit (Mise à jour) pour les entrées que les opérateurs de terrain doivent renseigner ou mettre à jour.

   Astuce :

   Vous pouvez décocher la case Display (Afficher) et cocher la case Edit (Mise à jour) si l’entrée est uniquement utile pour la mise à jour.

Étiquettes (alias)

Collector utilise le texte Field Alias (Alias de champ) comme étiquette de l’entrée dans le formulaire. Fournissez un nom ou une question courte que vos opérateurs de terrain connaissent.

Astuce :

Utilisez des étiquettes courtes et concises. Même si vous pouvez utiliser une question, Collector met le texte à l’échelle pour qu’il tienne sur une seule ligne du formulaire. Les étiquettes longues utilisent par conséquent une petite police qui peut être plus difficile à lire.

1. Pendant la configuration de la fenêtre contextuelle, cliquez sur Configure Attributes (Configurer les attributs).
2. Cliquez sur le texte d’alias actuel que vous voulez modifier dans Field Alias (Alias de champ).
3. Saisissez le nouvel alias et appuyez sur Retour.

Astuces

Collector utilise le texte Hint (Astuce) lors de la mise à jour pour afficher le texte d’informations d’une entrée sans valeur. Vous pouvez par exemple fournir des informations sur l’endroit où l’opérateur de terrain peut obtenir les données ou des détails sur le format à suivre pour la saisie.

1. Pendant la configuration de la fenêtre contextuelle, cliquez sur Configure Attributes (Configurer les attributs).
2. Cliquez sur le nom de champ de l’entrée où vous voulez proposer une astuce.
3. Dans la zone de texte Hint (Astuce), saisissez les informations que les opérateurs de terrain doivent voir avant de renseigner l’entrée.

Format des zones de texte

Pour les entrées textuelles, vous pouvez configurer l’utilisation des lignes uniques, de plusieurs lignes et du texte enrichi. Cette configuration est utilisée lors de la consultation du formulaire, mais Collector utilise toujours une ligne de texte unique pour la mise à jour.

1. Pendant la configuration de la fenêtre contextuelle, cliquez sur Configure Attributes (Configurer les attributs).
2. Cliquez sur le nom de champ de l’entrée textuelle à mettre en forme.
3. Sous TextBox Type (Type TextBox), choisissez le format de votre zone de texte : Single Line (Ligne unique), Multiple Line (Plusieurs lignes) ou Rich Text (Texte enrichi).

   Le format s’affiche dans le formulaire en lecture seule.

Format numérique

Lorsque vous configurez des entrées numériques, vous pouvez spécifier un nombre spécifique de décimales et un séparateur des milliers. Tenez compte de la taille des nombres que vos opérateurs de terrain doivent fournir.

1. Pendant la configuration de la fenêtre contextuelle, cliquez sur Configure Attributes (Configurer les attributs).
2. Cliquez sur le nom de champ de l’entrée numérique à mettre en forme.
3. Sous Format, choisissez le nombre de décimales que vos données doivent afficher, de 0 à 8.
4. Si vos données doivent inclure un séparateur des milliers, cochez la case Use 1000 Separator (Utiliser le séparateur des milliers).

Configuration des dates

Les dates peuvent s’afficher dans différents formats. Si l’heure est importante pour vos données, choisissez un format de date qui inclut l’heure et configurez le format horaire. Si l’heure n’est pas importante, vous pouvez la masquer.

1. Pendant la configuration de la fenêtre contextuelle, cliquez sur Configure Attributes (Configurer les attributs).
2. Cliquez sur le nom de champ de l’entrée de date à mettre en forme.
3. Sous Format, choisissez le format d’affichage de la date, par exemple, 12/21/1997 ou Sunday, December 21, 1997 (Dimanche 21 décembre 1997).

   Collector utilise le paramètre régionale de votre appareil pour afficher la date. Le format que vous choisissez dans la configuration de la fenêtre contextuelle détermine les informations incluses dans la date, et non l’affichage exact. Choisir 12/21/1997 ou 21/12/1997 dans la configuration de la fenêtre contextuelle génère le même affichage dans Collector, le paramètre régional de l’appareil déterminant le résultat final.

4. Si votre format prend en charge l’heure et que vous souhaitez l’afficher ou la mettre à jour, cochez la case Show time (Afficher l’heure) et choisissez le format horaire, par exemple, 6:00 PM ou 18:00:00.

   Collector utilise l’heure locale pour afficher et mettre à jour des données.

Calculer un titre ou des entrées avec des expressions Arcade

Vous pouvez calculer des entrées en fonction de formules et d’autres parties du formulaire. Vous pouvez par exemple effectuer une conversion d’unités et inclure un texte de fin pour afficher des unités, combiner plusieurs entrées pour rendre la lecture plus intuitive ou spécifier un format personnalisé. Pour calculer des entrées, ajoutez une expression attributaire Arcade qui réalise le calcul. L’entrée calculée est incluse sous Pop-up contents (Contenu de la fenêtre contextuelle) comme n’importe quel autre champ et peut servir à la conception du formulaire en lecture seule. Comme il s’agit d’une valeur calculée dynamiquement et qu’elle est créée en fonction d’autres entrées, elle n’est pas modifiable ni visible au cours de la mise à jour, mais le formulaire en lecture seule prend en compte les modifications apportées une fois actualisé. Reportez-vous à la rubrique Utiliser des expressions attributaires dans ArcGIS Online ou Utiliser des expressions attributaires dans ArcGIS Enterprise.

Les étapes ci-dessous montrent par exemple comment réaliser une entrée calculée indiquant si une ressource doit être inspectée. Si aucune inspection n’a eu lieu au cours de l’année passée, le titre du formulaire devient Inspection Required (Inspection requise). Sinon, le titre présente la date de la dernière inspection dans un format spécifique.

1. Pendant la configuration de la fenêtre contextuelle, cliquez sur Add (Ajouter) sous Attribute Expressions (Expressions attributaires).
2. Dans la zone de texte Expression, indiquez le code Arcade qui génère l’entrée calculée, comme suit :

   if (DateDiff(Date(), $feature.InspectionDate, 'years') > 1)
     'Inspection Required'
   else  'Inspected ' + Text(ToLocal($feature.InspectionDate), 'M/D/YY')

   Remarque :

   Ce code requiert une couche dont une entrée InspectionDate indique la date de la dernière inspection.

3. Cliquez sur Edit (Mise à jour) en regard de Custom (Personnalisé) pour donner un nom à l’entrée calculée.
4. Cliquez sur OK pour générer l’entrée calculée.
5. Supprimez la valeur Pop-up Title (Titre de la fenêtre contextuelle) et cliquez sur le bouton [+] situé en regard. Sélectionnez la nouvelle entrée calculée.
6. Cliquez sur OK pour enregistrer les modifications apportées à l’élément contextuel.
7. Consultez la fenêtre contextuelle sur la carte.

   Le titre reflète votre entrée calculée. Lorsque vous consultez la fenêtre contextuelle dans Collector, le même titre apparaît.

Pour obtenir de l’aide sur Arcade, reportez-vous à ArcGIS Arcade. Pour consulter des exemples d’expressions supplémentaires, reportez-vous au référentiels d’expressions Arcade sur GitHub.

Remarque :

Les expressions Arcade sont limitées aux informations d’un formulaire unique et ne peuvent pas accéder aux informations d’autres formulaires (par exemple, de deux ressources différentes).

Codes à barres et codes QR

Si vos ressources possèdent des codes à barres ou des codes QR, numérisez le code à barres ou le code QR avec Collector et renseignez une ou plusieurs entrées en fonction de la numérisation. Dans Collector, toutes les entrées textuelles et numériques contiennent une option permettant de numériser un code à barres ou un code QR. Lorsque votre opérateur de terrain sélectionne Scan barcode or QR code (Numériser un code à barres ou un code QR) , l’application de la caméra de l’appareil s’ouvre et lit le code à barres ou le code QR. Les informations qu’il contient permettent de renseigner l’entrée sélectionnée lorsque la numérisation est réalisée.

Remarque :

Collector prend en charge les formats de code à barres et de code QR pris en charge par le système d’exploitation. Pour la prise en charge sur Android, reportez-vous à la rubrique Barcode API Overview. Pour la prise en charge sur iOS, reportez-vous à la rubrique Machine Readable Object Types.

Affichage de pièces jointes

Si vos données prennent en charge les pièces jointes, vos opérateurs de terrain peuvent être amenés à les consulter. Cochez la case Show feature attachments as links (Afficher les entités jointes sous forme de liens) pour que les pièces jointes soient visibles lorsque les opérateurs de terrain consultent les formulaires. Ceci n’affecte pas leur capacité à ajouter des pièces jointes, mais sans cette option, ils peuvent uniquement consulter les pièces jointes pendant la mise à jour.

Affichage de métadonnées haute précision

Si vos données incluent des métadonnées haute précision, vos opérateurs de terrain ne doivent pas être en mesure de les mettre à jour. Vous devez vous demander si vos opérateurs de terrain ont même besoin de les lire. Veillez à définir toutes les entrées des métadonnées haute précision en lecture seule (désactivez leur mise à jour). Vous pouvez même les rendre invisibles. Vous pouvez les définir de la même manière que les autres entrées incluses et modifiables. Si vous affichez les métadonnées haute précision, vous devez également mettre en forme les nombres en utilisant un nombre approprié de décimales. Si vous affichez l’heure de résolution, mettez en forme la date.

Affichage d’informations associées

Si vos données incluent des ressources, observations ou rapports (inspections) associés, vos opérateurs de terrain peuvent avoir besoin d’y accéder. Ils doivent accéder aux rapports associés via la ressource ou l’observation à laquelle ils sont associés (les tables ne sont pas directement accessibles). Les ressources ou observations associées sont accessibles directement via la carte ou via la ressource ou l’observation à laquelle elles sont associées. Pour optimiser les formulaires à l’attention de vos opérateurs de terrain, configurez-les pour les informations associées et pour l’entité à laquelle elles sont associées, en spécifiant que les informations associées sont incluses.

Configurez le formulaire pour les informations associées en suivant les instructions utilisées pour n’importe quel formulaire. Tous les paramètres et recommandations de cette rubrique s’appliquent. Soyez particulièrement attentif au titre du formulaire pour les informations associées : si l’entité ou la table à laquelle elles sont associées comporte plusieurs formulaires associés, l’opérateur de terrain voit une liste des titres lorsqu’il sélectionne un formulaire associé. Il est plus facile pour l’opérateur de terrain de sélectionner le bon formulaire associé si le titre inclut des informations caractéristiques.

Pour autoriser les opérateurs de terrain à accéder aux informations associées lorsqu’ils consultent la ressource ou l’observation à laquelle elles sont associées, cochez la case Show related data (Afficher les données associées) lorsque vous configurez le formulaire de la ressource ou de l’observation à laquelle elles sont associées. Si cette case n’est pas cochée, les opérateurs de terrain ne pourront pas ajouter ou mettre à jour les formulaires des informations associées via la ressource ou l’observation. Si la case est cochée, cliquez sur Sort Options (Options de tri) et indiquez le champ et l’ordre de présentation des informations associées. Il est par exemple courant de trier des inspections en fonction du champ de date de l’inspection et d’utiliser l’ordre croissant, afin d’afficher les inspections les plus récentes en premier.

Valeur valides

Vous pouvez être amené à limiter les informations que les utilisateurs saisissent dans le formulaire. Vous pouvez avoir un ensemble de choix à respecter ou une plage de valeurs valides pour l’entrée. Ces limites sont prises en charge par Collector, mais configurées via vos données.

Pour fournir un ensemble de choix pour un champ, créez une liste de valeurs (si vous utilisez ArcGIS Online ou ArcGIS Enterprise) ou un domaine de valeurs précodées (si vous utilisez ArcGIS Pro). Dans Collector, les opérateurs de terrain voient une liste de valeurs qu’ils peuvent sélectionner pour le champ.

Pour définir une plage de valeurs numériques valides, indiquez une valeur minimale et maximale. Avec ArcGIS Pro, utilisez un domaine par plage. Dans Collector, les opérateurs de terrain saisissent une valeur qui est signalée si elle n’est pas comprise dans la plage valide.

Lorsque le formulaire contient des valeurs non valides, les opérateurs de terrain ne peuvent pas l’envoyer. Pour en savoir plus sur la configuration des données afin de limiter les valeurs saisies dans le formulaire, reportez-vous à la rubrique Définir des plages et listes d’attributs dans ArcGIS Online, Définir des plages et listes d’attributs dans ArcGIS Enterprise, ou Vue des domaines dans ArcGIS Pro.

Remarque :

L’utilisation de ArcGIS Enterprise pour ajouter et mettre à jour des champs, notamment créer des listes et leur attribuer des valeurs minimale et maximale, requiert ArcGIS Enterprise 10.7 ou version ultérieure.

Valeurs par défaut

Il est possible de définir une valeur par défaut dans le formulaire. Le formulaire est prérenseigné avec des valeurs par défaut dans Collector. Il est possible de fournir les valeurs par défaut de deux manières : spécifier une valeur par défaut pour un champ dans le cadre de la conception de votre couche et spécifier un modèle d’entités pour commencer la collecte des données.

Les valeurs par défaut spécifiées lors de la conception de votre couche sont inhérentes à vos données. La valeur par défaut est appliquée à ce champ dès qu’une entité est créée. Pour fournir des valeurs par défaut dans le cadre de la conception de votre couche, reportez-vous à la rubrique Ajouter ou supprimer un champ dans ArcGIS Online, Ajouter ou supprimer un champ dans ArcGIS Enterprise, ou Vue des champs dans ArcGIS Pro.

Remarque :

L’utilisation de ArcGIS Enterprise pour ajouter des champs, notamment leur attribuer des valeurs par défaut, requiert ArcGIS Enterprise 10.7 ou version ultérieure.

Les valeurs par défaut spécifiées dans un modèle d’entités sont appliquées au champ lorsque le modèle d’entités spécifié pour créer l’entité est utilisé. Cela vous permet d’avoir des valeurs par défaut différentes pour un champ unique selon le type d’entité à créer. Si une valeur par défaut est définie sur le champ, la valeur par défaut d’un modèle d’entités la remplace et est appliquée. Pour fournir des valeurs par défaut pour un modèle d’entités, reportez-vous à la rubrique Créer des modèles d’entités dans Map Viewer dans ArcGIS Online, Créer des modèles d’entités dans Map Viewer dans ArcGIS Enterprise ou Créer des modèles d’entités dans ArcGIS Pro.

Entrées obligatoires

Vos données peuvent comporter des entrées que vos opérateurs de terrain doivent fournir. Si, par exemple, toutes les inspections nécessitent une date d’inspection, rendez-la obligatoire afin que les opérateurs de terrain doivent l’indiquer avant de valider leur inspection. Les entrées obligatoires sont prises en charge par Collector et apparaissent avec un astérisque en regard de l’étiquette. Elles empêchent l’envoi du formulaire d’inspection tant qu’une valeur n’est pas fournie. Indiquez qu’une entrée est obligatoire dans le cadre de la configuration des données en l’empêchant d’être nulle.

Remarque :

Si vous utilisez ArcGIS Pro, la version 2.1 ou ultérieure est requise. Si vous utilisez ArcGIS Enterprise, la version 10.7 ou ultérieure est requise. Si vous utilisez une version antérieure de ArcGIS Pro ou de ArcGIS Enterprise, vous devez exécuter un script (Réinitialiser les champs obligatoires) sur votre couche d’entités hébergée. Consultez le billet de blog Require the information you need from the field.