Créer / Modifier une liste
Définir le titre de l’item
Créer une liste standard
Il existe 5 modèles de liste standard :
Lieu (id. de liste : lieu)
Produit (id. de liste : unité de stockage (SKU))
Asset (id. de liste : asset)
Vendeur (id. de liste : vendor
L'utilisation d'une liste prédéfinie facilite la création de tableaux de bord.
Lorsque vous créez une liste modèle, les étiquettes des attributs seront dans la même langue que celle dans laquelle vous utilisez actuellement la web app. Ainsi, si vous souhaitez que les attributs de la liste apparaissent en français, vous devez sélectionner le français comme langue de l'application Web dans la sélection de langue supérieure.
Lorsque vous créez une liste modèle, vous ne pouvez pas supprimer un attribut standard, vous pouvez seulement le masquer si vous ne voulez pas que l'utilisateur mobile le voie.
Créer une liste personnalisée
Vous pouvez aussi bien partir de zéro pour définir une liste. Cliquez sur le bouton + pour commencer. Une fois qu'une liste est créée, tous les paramètres peuvent être modifiés à l'aide de l'icône d'édition.
Chaque liste est définie par :
un identifiant de liste (généré par le système)
un nom
une description
Définir la portée de la liste
Le paramètre scope est utilisé pour déterminer qui peut visualiser et effectuer les actions suivantes sur un élément de liste :
créer
modifier
archiver
voir
La portée peut prendre 5 options, chaque valeur de portée restreint qui peut accéder à l'élément :
Global - tous les utilisateurs du client
Équipes multiples - tous les utilisateurs des équipes multiples auxquelles l'élément a été attribué.
Équipe unique - tous les utilisateurs de l'équipe unique à laquelle l'élément a été attribué.
Utilisateurs mobiles multiples : tous les utilisateurs auxquels l'élément a été attribué.
Utilisateur mobile unique - un utilisateur unique auquel l'équipe a été assignée.
Très important à définir, car il a une incidence sur les indicateurs clés de performance qui peuvent être calculés.
Une modification du champ d'application supprimera tous les droits de propriété existants. Si vous devez procéder à une modification du champ d'application, veuillez télécharger la liste et réattribuer les éléments en conséquence.
Définir les droits d'accès
Les droits d'accès pour les utilisateurs mobiles ou web peuvent être soit :
Accès complet - les utilisateurs peuvent ajouter, modifier et supprimer des éléments de la liste.
Accès en lecture seule : les utilisateurs peuvent uniquement visualiser les éléments de la liste.
Définir le titre de l'article
Il s'agit de déterminer comment l'élément apparaîtra sur l'application mobile. Utilisez un $ entre chaque balise pour définir les titres.
Définir les attributs de la liste
Les attributs de la liste sont les champs qui vont la structurer. Chaque attribut a :
Une clé. Une balise unique, minuscule, tout attaché
Un nom qui sera affiché sur l'application mobile/web
Un type, parmi les options suivantes :
Integer - nombres entiers
Décimal - nombres entiers avec décimales, par exemple prix des produits (cents)- 457,89
Texte - Caractères alphanumériques
Choix unique - Sélectionnez un choix parmi une série d'options.
Choix multiple - Sélectionnez plusieurs choix parmi une série d'options.
Pour les attributs à choix unique ou multiple, les différentes options peuvent être téléchargées en masse à l'aide du bouton de masse. Il vous suffit alors de télécharger un fichier CSV comportant deux colonnes, l'étiquette et le libellé de chaque option, ce qui vous fait gagner du temps.
Vous pouvez également télécharger la liste des tags et étiquettes d'options en utilisant l'icône de téléchargement.
Photo - Prendre une photo à l'intérieur de la liste
GPS - Capture le GPS sur la liste
Booléen - Une question avec un résultat binaire (Oui / Non)
Date - Capture les dates dans la liste
Signature - Capture les signatures
Numéro de téléphone - Capturez le numéro de téléphone
Scanner de code-barres - Scanner un code-barres
Choix unique sur liste - attribut qui choisit dans une liste existante. Utilisé principalement pour les attributs à choix unique avec beaucoup d'options, par exemple les territoires. Les utilisateurs peuvent y appliquer des filtres et rechercher facilement une option/un élément.
Les attributs peuvent être réorganisés à l'aide d'une fonctionnalité de glisser-déposer, tant sur le web que sur l'application mobile.

Les attributs de sélection sur liste sont créés de la même manière que les autres attributs, sauf que pour la sélection sur liste, vous devez d'abord créer une liste différente, puis l'attacher à l'attribut. Avant d'ajouter l'attribut, veuillez créer une liste sur le même client.
Une fois que vous avez créé une liste, allez sur la liste à laquelle vous voulez ajouter l'attribut "select on list", puis cliquez sur l'icône/le stylo de modification. Une fois sur la page de modification de la liste, cliquez sur l'icône + pour ajouter un nouvel attribut, saisissez la clé (tag) et le nom de l'attribut, puis sélectionnez "choix unique sur la liste" comme type d'attribut et joignez la liste que vous venez de créer.
Cliquez ensuite sur AJOUTER et enregistrez la liste.

Comment utiliser l'attribut à choix multiple pour la gestion des routes ?
Utilisez l'attribut à choix multiple appelé "_route" dans la liste des lieux par défaut.
Pour chaque lieu, attribuez-lui les routes auxquelles il appartient. Disons qu'un lieu doit être visité le lundi et le mercredi, vous lui attribuez les deux valeurs.
Vous devrez peut-être ajouter d'autres champs :
Si la liste est dans la portée de plus d'un utilisateur, un attribut de choix unique pour que l'utilisateur sélectionne sa zone.
un champ de texte ouvert contenant l'ordre dans lequel le lieu doit être visité.
Options pour les attributs
Règle de validation utilisant la syntaxe regex. Cette règle définit ou limite ce qu'un utilisateur peut saisir/renseigner sur les questions de saisie (texte de saisie, nombre entier, décimal, etc.). Référez-vous à cet article pour plus de détails.
Message d'erreur de validation si la syntaxe n'est pas respectée
Requête SQL définissant la valeur de l'attribut
Comment utiliser une requête SQL pour définir les valeurs d'un attribut
Vous pouvez définir un attribut dans une liste sur la base d'une requête SQL. C'est très utile car vous pouvez utiliser les données du workflow pour définir les attributs dans les listes.
Par exemple, vous pouvez définir le statut du client en fonction de l'activité du workflow. Le statut du client devient actif lorsque le client a effectué une commande/vente et son statut devient inactif s'il n'a pas effectué de commande pendant une longue période.
Attribut obligatoire - si l'utilisateur doit le remplir ou non
Si une liste de lieux est déjà créée et qu'un nouvel attribut obligatoire est ajouté, les utilisateurs mobiles seront obligés de le remplir la prochaine fois qu'ils enregistreront un lieu. Un message disant "Mettre à jour tous les champs" s'affichera, comme ci-dessous

Attribut pas visible pour l'utilisateur mobile - si l'utilisateur n'a pas besoin de le voir.
Valeur unique - En activant cette option, vous vous assurez qu'il n'y a qu'une seule valeur pour cet attribut dans la liste parmi tous les éléments. Cela peut être utile si vous voulez vous assurer qu'il n'y a pas de doublon, comme pour un code de sortie servant de clé primaire.
Valeur verrouillée - Utilisé pour rendre les attributs de la liste en lecture seule pour les utilisateurs mobiles. S'accompagne souvent d'une requête SQL définie.
Conditions. Tout comme les conditions des workflows, il est possible de définir des conditions pour les attributs des listes, afin de s'assurer qu'un attribut est affiché en fonction de la valeur d'un autre attribut. Par exemple, pour demander des informations supplémentaires en fonction du type de lieu. Pour ajouter une condition, il suffit de cliquer sur l'icône d'ajout située dans l'onglet des conditions.
Vous pouvez définir un attribut qui dépend d'une condition pour qu'il soit affiché comme obligatoire. L'utilisateur mobile ne devra le remplir que si la condition est active.
Définir les attributs importants
Les attributs importants sont ceux qui apparaîtront dans la fiche de l’item sur l'application mobile. Ils sont définis dans le schéma de la liste dans cette section. Ajoutez de nouveaux attributs en cliquant sur le bouton +.

Dans la fiche de l'article, seuls les attributs importants seront affichés dans la liste. Pour afficher tous les attributs, cliquez sur plus.
.png?inst-v=3b1e1750-ab7a-4f64-8621-994553856b4e)
La recherche sur l'application mobile s'applique à tous les attributs importants, il est donc essentiel que ceux qui sont utilisés pour trouver un article soient ajoutés.
Comprendre le schéma de la liste
En visualisant la liste des attributs, nous avons mis quelques indications visuelles pour comprendre quels paramètres ont été appliqués à l'attribut :
Attribut en gras : l'attribut est obligatoire
icône de l'œil : l'attribut est caché
icône graphique : l'attribut est un attribut calculé
* l'attribut est assorti d'une condition
icône de clé : l'attribut sert de clé primaire, il a été défini comme unique.
Réorganisation de l'ordre des attributs (schéma de liste)
Il est possible de glisser-déposer chaque attribut pour modifier l'ordre dans lequel il apparaît sur le mobile et le web.
Il suffit de cliquer sur un attribut et de le déposer où vous voulez dans la liste par rapport aux autres attributs.
Définir les attributs du filtre
Attributs à utiliser comme filtres dans l'application mobile. Seuls ces attributs peuvent être ajoutés :
choix unique
choix multiple
attribut basé sur une requête
Autres paramètres
Rubrique d'image à utiliser pour le profil de l'article
Attributs à choix unique à utiliser comme catégories. Ceci est utile pour une matrice permettant de naviguer entre les éléments. Les catégories servent d'en-têtes.

Questionnaires liés à cette liste
Cette section vous montrera les questionnaires auxquels la liste est attachée.
Si une liste n'est pas attachée à un questionnaire, elle ne sera pas accessible aux utilisateurs mobiles.
Chargement et téléchargement d'une liste au format JSON
Une liste peut être téléchargée et chargée au format JSON à l'aide du bouton situé au bas de la modale.

Archiver une liste
Une liste peut être archivée à l'aide de l'icône 'archive'. Les listes archivées peuvent être affichées en utilisant l'option "Afficher la liste archivée" dans le menu.