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.
Créer et utiliser une liste de choix dynamique
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 créer et utiliser une liste de choix dynamiques dans une entrée utilisateur de projet, procédez comme suit :
- Cliquez sur un bouton de projet pour afficher le volet Button (Bouton) et sélectionnez l’onglet Data (Données).
- 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.
- Dans le menu déroulant du champ Capture, sélectionnez Create New (Créer nouveau).
- Saisissez une étiquette pour la liste de choix dynamique. Cette étiquette apparaît au-dessus de la liste ci-avant.
- Sous Input type (Type en entrée), sélectionnez Dynamic choice list (Liste de choix dynamique).
- Cliquez sur Add (Ajouter), puis sur Browse all layers (Parcourir toutes les couches).
- Sélectionner une table ou une couche d’entités interrogée pour remplir la liste.
Remarque :
Les couches de requête inutilisées sont supprimées du projet lors de l’enregistrement. Si vous ajoutez plusieurs couches de requêtes ici ou que vous utilisez le panneau Manage project layers (Gérer les couches du projet), veillez à ajouter la couche de requête à au moins un bouton avant d’enregistrer le projet.
- Renseignez les propriétés restantes, comme suit :
Conseil :
Lorsque vous renseignez ces propriétés, vous pouvez examiner des exemples de résultat dans le panneau latéral Choice list preview (Aperçu de la liste de choix).
- 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 : critères permettant de limiter les valeurs affichées dans la liste de choix dynamique. Cliquez sur le bouton Add filter (Ajouter un filtre) pour créer un filtre.
- Cliquez sur Create (Créer).
Cette entrée utilisateur de projet créée est automatiquement définie pour le champ Capture sélectionné.
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.
Créer un filtre
Un filtre permet de limiter les entités ou valeurs affichées dans une liste de choix dynamique d’entrées utilisateur de projet. Vous pouvez spécifier une ou plusieurs conditions pour limiter ce qui apparaît dans la liste.
Pour créer un filtre, procédez comme suit :
- Dans la fenêtre Filter (Filtre), cliquez sur le sélecteur de champ, puis sélectionnez le champ à utiliser pour l’expression.
- Cliquez sur le sélecteur d’opérateur et sélectionnez un opérateur, tel que between (entre), equals (égal à) ou includes (inclut).
Si vous sélectionnez un champ de date, d’autres opérateurs sont affichés. Vous pouvez utiliser l’opérateur is within the last (est compris dans le dernier) pour appliquer un filtre dynamique à date relative qui permet d’afficher les évènements qui se sont produits par rapport au jour actuel (par exemple, tous les enregistrements créés au cours des cinq derniers jours), sans mettre à jour manuellement le filtre chaque jour.
- Dans la zone de saisie de la valeur, entrez une valeur à utiliser dans l'expression. Vous pouvez apercevoir la liste résultante sur le côté du générateur de requêtes.
La zone de saisie varie selon le type de champ et l'opérateur. Si, par exemple, vous avez sélectionné l’opérateur includes (inclut) ou excludes (exclut), vous sélectionnez une valeur dans une liste de valeurs de données pour le champ spécifié.
Si vous avez spécifié un champ de date, selon l’opérateur sélectionné, vous pouvez spécifier une période ou une date unique du calendrier, ou saisir une date.
- Ajoutez éventuellement une autre expression au filtre en sélectionnant And (Et) (pour indiquer que tous les critères de filtre doivent être vérifiés) ou Or (Ou) (pour indiquer que n’importe quel critère de filtre peut être vérifié).
- Cliquez sur Create (Créer) pour enregistrer et utiliser votre filtre. Si vous mettez à jour une liste de choix existante, cliquez sur Done (Terminé).
Vous pouvez également utiliser l’option Advanced formatting (Mise en forme avancée) pour créer ou mettre à jour un filtre. Dans cette vue, vous construisez ou modifiez les conditions de la clause WHERE directement dans l’expression. 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 l’expression Canvasser='${username}'.
Remarque :
Lorsque vous cliquez sur Advanced formatting (Mise en forme avancée), le filtre est affiché comme expression. Vous pouvez mettre à jour l’expression, mais vous ne pouvez pas retourner au générateur de filtre. Pour afficher le générateur de filtre, fermez la boîte de dialogue d’entrée utilisateur, puis ouvrez-la de nouveau. Le filtre est enregistré et vous pouvez le mettre à jour à l’aide des sélecteurs de champ, d’opérateur et de valeur.
Vous avez un commentaire à formuler concernant cette rubrique ?