Variable d’entrée utilisateur de projet

Une variable d’entrée utilisateur de projet est spécifiée par l’utilisateur de l’application, et vous pouvez l’appliquer à un ou plusieurs boutons dans un projet. Même si l’utilisateur de l’application saisit la valeur, l’auteur du projet doit définir les boutons et les champs auxquels la variable s’applique.

Les conditions suivantes s’appliquent à une variable d’entrée utilisateur de projet :

• Il est possible de définir un maximum de 3 variables d’entrée utilisateur de projet par projet.
• Sa valeur est entrée par l’utilisateur avant d’appuyer sur un bouton. Si l’entrée utilisateur est définie comme il se doit, l’utilisateur est invité à saisir cette valeur lorsqu’il démarre le projet, mais il peut mettre à jour la valeur à tout moment.
• Vous pouvez appliquer la valeur à n’importe quel champ de texte d’un bouton.
• Vous pouvez appliquer la valeur à un champ de type texte ou entier configuré avec un domaine de valeurs précodées.
• Vous ne pouvez pas appliquer la valeur à un champ de type texte configuré avec un domaine par plage.

Les propriétés de la variable d’entrée utilisateur de projet sont les suivantes :

• Label (Étiquette) : texte qui apparaît en tant que titre de la page d’entrée utilisateur de projet dans l’application.
• Input type (Type en entrée) : il peut s’agit d’un texte sur une seule ligne ou sur plusieurs lignes, ou d’une liste de choix. Dans le cas des listes de choix, vous définissez les valeurs et pouvez autoriser la saisie de texte libre. Utilisez une liste de choix dynamique pour renseigner les valeurs à partir des champs dans une couche de requête ou une table que vous ajoutez au projet.
• Apply hint (Appliquer astuce) : afficher un texte d’astuce sur la page d’entrée utilisateur de projet dans l’application.
• Apply an input mask (Appliquer un masque de saisie) : définir le format de la saisie de données en utilisant des caractères et symboles pour définir un masque de saisie.
• Show barcode scanner (Afficher le scanner de codes-barres) : utilisez le scanner de codes-barres dans la boîte de dialogue de saisie pour l’entrée de champ de texte.

  Remarque :

  Les formats suivants sont pris en charge : QR CODE, UPC A, UPC E, EAN 8, EAN 13, CODE 39 et CODE 128.

• Obligatoire : indique si l’utilisateur de l’application mobile doit fournir la valeur d’entrée utilisateur pour pouvoir appuyer sur un bouton. Si cette valeur n’est pas obligatoire, l’utilisateur peut s’il le souhaite entrer une valeur d’entrée utilisateur en sélectionnant le bouton de modification (situé en regard de la valeur d’entrée utilisateur figurant en haut de l’écran) et en tapant une valeur.

  Remarque :

  Lorsque vous appliquez une valeur d’entrée utilisateur à une couche d’entités avec des champs requis, vérifiez que cette propriété Requis est définie sur True (Vrai) pour éviter les erreurs d’envoi.

Une variable d’entrée utilisateur de projet est créée et configurée par l’auteur du projet dans l’onglet Data (Données) pour chaque champ ou dans l’élément de menu Project user input (Entrée utilisateur de projet).

Pour attribuer une variable d’entrée utilisateur de projet à un champ de capture d’un bouton, sur l’onglet Data (Données), dans le menu déroulant du champ de capture, sélectionnez Project user input (Entrée utilisateur de projet).

Dans l’application mobile, l’utilisateur ne peut pas entrer de texte dépassant la longueur du champ de données.

Listes de choix dynamiques

Une entrée utilisateur de projet peut être renseignée par une liste de choix dynamique en l’associant à une couche d’entités ou une table existante. La table ou la couche d’entités peut être modifiable ou en lecture seule. L’auteur contrôle le contenu de la liste en configurant les propriétés de la liste.

Pour utiliser une liste de choix dynamique dans une entrée utilisateur de projet, elle doit d’abord être ajoutée au projet en tant que table ou couche de requête :

1. Dans le menu principal, cliquez sur Manage project layers (Gérer les couches du projet) .
2. Sélectionnez l’onglet Query (Requête) du volet Layers (Couches).
3. Cliquez sur Add (Ajouter).
4. Sélectionnez la couche qui renseigne votre liste de choix dynamique, puis cliquez sur Add (Ajouter).

Maintenant que la couche de requête existe, elle peut être ajoutée à un bouton :

1. Cliquez sur un bouton de projet pour afficher le volet Button (Bouton) et sélectionnez l’onglet Data (Données).
2. Sélectionnez Project user inputs (Entrées utilisateur de projet) pour le champ Capture qui stocke la valeur sélectionnée à partir de la liste de choix dynamique.
3. Dans la liste déroulante du champ Capture, sélectionnez Create New (Créer nouveau).
4. Saisissez une étiquette pour l’entrée utilisateur de projet. Cette étiquette apparaîtra au-dessus de la liste de choix dynamique.
5. Sous Input type (Type en entrée), sélectionnez Dynamic choice list (Liste de choix dynamique).
6. Sélectionnez la table ou la couche d’entités que vous avez créée aux étapes précédentes.

   La dernière couche de requête créée est sélectionnée par défaut.

7. Renseignez les propriétés restantes, puis cliquez sur Create (Créer).

   Cette nouvelle entrée utilisateur de projet créée est automatiquement définie pour le champ Capture.

Remarque :

Les couches de requête inutilisées sont supprimées du projet lors de l’enregistrement. Assurez-vous d’ajouter la couche de requête à au moins un bouton avant d’enregistrer le projet.

Les propriétés d’une liste de choix dynamique sont les suivantes :

• Champ d’affichage : la valeur s’affiche dans l’application mobile.
• Champ de valeur : valeur qui est stockée dans la couche.
• Champ de tri : champ utilisé pour trier la liste de choix dynamique.
• Ordre de tri : croissant ou décroissant.
• Mode de mise à jour : manuel ou automatique. En mode manuel, si l’entrée utilisateur est définie comme étant obligatoire, la liste est mise à jour uniquement à la première ouverture du projet. Les mises à jour suivantes ne se produiront que si l’utilisateur fait glisser la liste vers le bas. En mode automatique, si l’entrée utilisateur est définie comme étant obligatoire, la liste est mise à jour à l’ouverture du projet ou à la modification de l’entrée utilisateur.
• Filtre : requête permettant de limiter les valeurs affichées dans la liste de choix dynamique. Lors de la construction des conditions de la clause WHERE, vous pouvez utiliser les options afin de sélectionner une variable de l’appareil (username, fullName, firstName, lastName ou email) ou un champ de la couche sélectionnée. Par exemple, imaginons que le champ du démarcheur dans la couche sélectionnée comporte des noms d’utilisateur. Pour utiliser ce champ afin de filtrer la liste selon les seules valeurs correspondant au nom d’utilisateur du démarcheur actuellement connecté à l’application, saisissez la requête Canvasser='${username}'.

  

L’application mobile renvoie uniquement la première page des résultats d’une liste qui contient, par défaut, 2 000 enregistrements pour un service d’entités ArcGIS Online.

Une fois que la liste des choix dynamique a été visualisée une première fois sur l’application mobile, elle est disponible hors connexion. Pour obtenir les mises à jour de la liste, l’appareil doit être en ligne au moment où la liste est rechargée.