Articles sur : Application Web

Gérer les éléments de liste

Articles sur : Listes et éléments

Les Listes font référence à un ensemble d'éléments regroupés, c'est-à-dire des clients, des produits/SKU, de matériel, etc.
Dans la section liste, vous pouvez visualiser toutes les listes présentes dans l'environnement, par exemple la liste des produits, la liste des clients, la liste du matériel/PLV, etc. Nous vous proposons un modèle de listes. Nous pouvons personnaliser la liste selon les besoins de vos utilisateurs.
Une liste est structurée avec des attributs, qui sont les dimensions de la liste. La structure de la liste est appelée schéma de liste. Chaque liste est composée de plusieurs éléments.

Ci-dessous vous trouverez comment naviguer et les différentes actions sur les listes.

Créer un élément
Créer une liste standard
Créer une liste personnalisée
Définir l'assignation de la liste
Définir les droits d'accès
Définir le titre de l'élément
Définition les attributs de la liste
L'attribut choix unique dans une liste
Paramètres d'attribut
Définir les attributs importants
Comprendre le schéma de liste
Réorganiser l'ordre des attributs (schéma de liste)
Définir les attributs du filtre
Autres paramètres
Workflows liés à cette liste
Télécharger une liste au format JSON
Afficher un élément
Afficher les éléments archivés
Restaurer un élément
Supprimer un élément
Rechercher des doublons dans une liste
Filtrer les éléments
Créer des éléments en Bulk
Modifier les éléments en Bulk
Assigner des droits d'accès aux utilisateurs mobiles aux éléments de la liste
Assigner des éléments en Bulk
Effacer les données d'un champ en Bulk
Comment modifier les attributs à choix unique
Modifier les attributs à choix unique dans une liste
Archiver les éléments en Bulk
Supprimer des éléments en Bulk
Télécharger la liste des éléments
Afficher et filtrer la liste en fonction de l'attribut calculé

Créer un élément



Cliquez sur le signe (+) et remplissez tous les attributs qui ont été définis dans la structure de la liste.

Pour les éléments de type « Image », vous disposez de 2 options pour remplir les données :
ajouter une image

ajouter directement l'url de l'image

Si l'attribut est du type « choix unique sur la liste », saisissez l'identifiant de l'élément lié.

Pour l'attribut GPS, vous pouvez soit placer le point GPS, soit remplir l'adresse, soit saisir les coordonnées GPS.

Créer une liste standard



Il existe 2 principaux modèles de liste standard :

Client (identifiant de liste : Client)
Produit (identifiant de liste : Produit)

L'utilisation d'une liste prédéfinie facilite la création de tableaux de bord.

Lors de la création d'une liste de modèles, les labels d'attributs seront dans la même langue que celle dans laquelle vous utilisez l'application Web. 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. Vous ne pouvez pas supprimer un attribut standard ; vous ne pouvez que le masquer si vous ne souhaitez pas que l’utilisateur mobile le voie.

Créer une liste personnalisée



Vous pouvez également repartir de zéro pour définir une liste. Cliquez sur le bouton (+ Créer) pour commencer. Une fois la liste créée, tous les paramètres peuvent être modifiés à l'aide de l'icône d'édition.
Chaque liste est définie par :
ID de liste (généré par le système)
Le nom de la liste
La description de la liste


Définir l'assignation de la liste



Le paramètre d'assignation est utilisé pour déterminer qui peut afficher et effectuer les actions suivantes sur un élément de liste :
Créer
Modifier
Archiver
Voir

L'assignation peut prendre 5 options, chaque valeur d'assignation restreint qui peut accéder à l'élément :
Global - tous les utilisateurs du client
Équipes multiples - tous les utilisateurs des multiples équipes auxquelles l'élément a été attribué
Équipe unique - tous les utilisateurs de l'équipe unique à laquelle l'élément a été attribué
Plusieurs tilisateurs mobiles - tous les utilisateurs auxquels l'élément a été attribué
Un seul utilisateur mobile - un utilisateur unique auquel l'élément a été affectée

Un changement d'assignation supprimera toutes les propriétés existantes. Si vous devez procéder à un changement de périmètre, 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 :
Accès complet - les utilisateurs peuvent ajouter, modifier et supprimer des éléments de la liste
Lecture seule : les utilisateurs peuvent uniquement afficher les éléments de la liste
Modification uniquement : les utilisateurs peuvent uniquement afficher et modifier les éléments.
Masqué - Les utilisateurs n'auront pas accès aux éléments de la liste

Définir le titre de l'élément



Il s'agit de déterminer comment l'élément apparaîtra sur l'application mobile. utilisez un signe $ entre chaque tag pour définir les titres.

Définition des attributs de la liste



Les attributs de la liste sont les champs qui structurent la liste. Chaque attribut possède :
Une clé, un tag unique, en minuscule, le tout attaché
Un nom qui sera affiché sur l'application mobile/web
Un type, parmi les options suivantes :

a. Nombre entier - Nombre entier
b. Décimal - Nombres entiers avec décimales, par exemple prix des produits (cents) - 457,89
c. Texte - Caractères alphanumériques
d. Choix unique - Sélectionnez un choix parmi une liste d'options
e. Choix multiple - Sélectionnez plusieurs choix parmi une liste d'options

1. Pour les attributs à choix unique et multiple, les différentes options peuvent être téléchargées en bulk à l'aide du bouton bulk. Il vous suffit ensuite de télécharger un fichier CSV comportant deux colonnes, le tag et le label de chaque option, ce qui vous fait gagner du temps.
2. Vous pouvez également télécharger la liste des tags et des labels d'options à l'aide de l'icône de téléchargement.

f. Photo - Prendre une photo dans la liste
g. Coordonnées GPS - Capturez le GPS sur la liste
h. Boolean - Une question avec un résultat binaire (Oui / Non)
je. Date - Capturer les dates sur la liste
j. Signature - Capturer les signatures
k. Numéro de téléphone - Capturer le numéro de téléphone
l. Scanner de codes-barres - scannez un code-barres
m. Choix unique sur la liste- attribut qui sélectionne dans une liste existante. Utilisé principalement pour les attributs à choix unique avec de nombreuses options, par exemple les territoires. Les utilisateurs peuvent y appliquer des filtres et rechercher facilement une option/un élément.

Les attributs peuvent être organisés dans n'importe quel ordre grâce à une fonctionnalité glisser-déposer, à la fois sur le Web et sur l'application mobile.

L'attribut choix unique dans une liste



Ces attributs sont créés de la même manière que les autres attributs, sauf que pour « Sélectionner sur la 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 pour le même environnement.

Une fois que vous avez créé une liste, accédez à la liste à laquelle vous souhaitez ajouter un attribut « sélectionner sur la liste », puis cliquez sur l'icône/stylo d'édition. Une fois sur la page d'édition de la liste, cliquez sur l'icône (+) pour ajouter un nouvel attribut, saisissez la clé d'attribut (tag) et le nom, puis sélectionnez « choix unique dans une liste » comme type d'attribut et joignez la liste que vous venez de créer.
Ensuite, cliquez sur AJOUTER puis enregistrez la liste.

Comment utiliser l'attribut à choix multiples pour la gestion des itinéraires

Utilisez l'attribut à choix multiples appelé "_route" dans la liste Clients par défaut
Pour chaque client, attribuez lui les itinéraires auxquels il appartient. Supposons qu'un client doive être visité lundi et mercredi, vous attribuez les deux valeurs
Vous devrez peut-être ajouter d'autres champs :

- Si l'assignation de la liste a plus d'un utilisateur, un attribut de choix unique est préféré afin que l'utilisateur sélectionne uniquement sa zone
- Un champ de texte ouvert avec l'ordre dans lequel le client doit être visité

Paramètres des attributs



* Règle de validation (Regex) - Règle de validation utilisant la syntaxe regex. Cette règle définit ou restreint ce qu'un utilisateur saisit/remplit dans les questions de saisie (texte de saisie, nombre entier, décimal, etc.). Reportez vous à cet article pour plus de détails.
Message d'erreur de validation - Message affiché si une entrée ne réussit pas la règle de validation
Requête SQL - Vous pouvez définir un attribut dans une liste basée sur une requête SQL. C'est très utile car vous pouvez utiliser les données du workflow pour définir des 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 passe à Actif une fois que le client a passé une commande/vente et son statut passe à Inactif s'il n'a passé aucune commande depuis longtemps.

Masquer l'attribut de l'utilisateur de l'application mobile - Utilisé pour masquer les éléments/attributs des utilisateurs mobiles
Attribut obligatoire - Définit si un attribut doit être renseigné ou non par l'utilisateur Mobile.

Si une liste de clients 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 client et cliqueront sur l'icône de modification.

Valeur unique - L'activation de cette option garantira 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 souhaitez 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 liste en lecture seule pour les utilisateurs mobiles. Souvent livré avec une requête SQL définie.
Méta-expressions. Tout comme les méta-expressions du workflow, il est possible de définir des méta-expressions pour lister les attributs, afin de garantir qu'un attribut est affiché en fonction de la valeur d'un autre attribut. Par exemple pour demander des informations complémentaires en fonction du type de client. Pour ajouter une méta-expression, cliquez simplement sur l'icône d'ajout située dans l'onglet méta-expressions.

Vous pouvez définir un attribut dépendant d'une méta expression à afficher comme obligatoire, l'utilisateur mobile ne devra le renseigner que si la méta expression est active

Définir les attributs importants



Les attributs importants sont ceux qui apparaîtront dans l'application mobile. Ils sont définis dans le schéma de liste de cette section. Ajoutez de nouveaux attributs en sélectionnant les petites cases à gauche.




Dans la fiche de l'élément, seuls les attributs importants seront affichés dans la liste. Cliquez sur les 3 points et sélectionnez l'icône Afficher l'activité

Comprendre le schéma de liste



Un schéma de liste est simplement une collection d'attributs créés pour une liste. En affichant un schéma de liste, vous pouvez connaître le type d'attribut, s'il est obligatoire, masqué, partageable ou s'il est associé à une méta-expression.

Pour afficher un schéma de liste, accédez à la section liste du tableau de bord et cliquez dessus. Identifiez ensuite votre liste d'intérêt et cliquez sur l'icône modifier à l'extrême droite. Une page avec le schéma de liste sera affichée.




Pour afficher plus de détails sur un attribut spécifique sur le schéma de liste, cliquez sur l'icône Modifier à l'extrême droite de l'attribut cible. Vous pouvez également dupliquer les attributs en accédant à l'icône Dupliquer, ce qui facilite le travail si vous avez les mêmes types de questions répétitives.

En visualisant la liste des attributs, nous avons mis quelques indications visuelles pour comprendre quels paramètres ont été appliqués à l'attribut :

Pour le schéma de Liste :
Les attributs marqués en gras sont obligatoires
Les attributs marqués d' une petite étoile sont marqués comme importants
Les attributs marqués d'une icône en forme d'œil sont masqués pour l'utilisateur mobile
Les attributs marqués d'un un cadenas sont verrouillés et ne peuvent pas être modifiés par un utilisateur.
Les attributs marqués d'un un graphique sont associés à une requête SQL.



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 ils apparaissent sur le mobile et le web. Cliquez simplement sur un attribut et déposez-le où vous le souhaitez dans la liste par rapport aux autres attributs.

Définir les attributs du filtre



Attributs à utiliser comme filtres sur l'application mobile. Seuls ces attributs peuvent être ajoutés :
Choix unique
Choix multiple
Attribut basé sur une requête

Autres paramètres



Champ d'image à utiliser pour le profil de l'élément

Attributs à choix unique à utiliser comme catégories. Ceci est utile pour se déplacer parmi les éléments de la matrice. Les catégories servent d'en-têtes.

Workflows liés à cette liste



Cette section vous montrera les workflows auxquels la liste est rattachée.

Si une liste n’est pas rattachée à un workflow, elle ne sera pas accessible aux utilisateurs mobiles.

Télécharger une liste au format JSON



Une liste peut être téléchargée au format JSON en utilisant le bouton en bas du menu.

Afficher un élément



Il existe deux vues pour un élément : -

1. Vue compacte.

Cela est composé de:
Nom de l'élément, tel que défini dans le titre du schéma de liste



Colonnes avec les attributs importants


Date de dernière visite de la liste Clients


Bouton Afficher plus - cliquez sur l'icône en forme d'œil pour voir la vue développée de l'élément.
Icône d'archive - Pour archiver un seul élément
Modifier (le stylo) - pour une modification unique d'éléments


2. Vue étendue.

Cela est composé de:
Section photo montrant toutes les photos de l'élément
Tous les attributs de l'élément, tels que définis dans le schéma de liste
Du responsable de l'élément si l'assignation n'est pas globale
Métadonnées sur l'élément lors de la création, de la dernière édition et de la dernière visite
Tout tableau de bord lié à cet élément. Même tableau de bord que pour la vue mobile

Pour les clients, vous pouvez également consulter deux onglets supplémentaires
Les notes prises depuis l'application mobile
Les rapports d'activité remplis pour ce client

Pour afficher la vue développée, cliquez sur l'icône en forme d'œil à l'extrême droite.
La modification ou l'archivage d'un élément n'est possible qu'une fois la vue développée affichée.

Afficher les éléments archivés


Dans le menu d'action, cliquez sur l'option « Ajouter un filtre », puis sélectionnez « Archive » où il vous sera proposé de sélectionner l'option True pour afficher/visualiser tous les éléments archivés.
Un élément archivé apparaîtra pâle (gris clair)

Restaurer un élément


Un élément archivé peut être restauré en cliquant sur l'icône de restauration.

Supprimer un élément


Un élément peut être supprimé en cliquant sur l'icône de la corbeille (rouge). Une fois supprimé, il ne peut plus être restauré. Seuls les éléments archivés peuvent être restaurés.

Rechercher des doublons dans une liste


Pour trouver facilement les doublons, ouvrez la liste, cliquez sur le menu de droite et sélectionnez « Rechercher les doublons ».
Puis dans la liste déroulante, choisissez l'attribut sur lequel les doublons doivent être trouvés et cliquez sur créer. N’importe quel attribut peut être sélectionné.
Tous les éléments avec des doublons apparaîtront sur le tableau, cliquer sur le bouton de téléchargement en haut à droite téléchargera/exportera uniquement les éléments dupliqués.

Vous pouvez également empêcher les utilisateurs mobiles de créer ou de modifier un élément avec une valeur qui existe déjà pour un autre élément. Pour activer cette option, activez le bouton Valeur unique.

Rechercher des éléments


Grâce au champ de recherche, il est possible de rechercher sur tous les attributs marqués comme importants. Ces attributs peuvent être du texte ouvert ou des nombres ouverts.


Filtrer les éléments


Les éléments peuvent être filtrés sur :
tous leurs attributs
leurs responsables, ou leurs équipes de responsables, ou les niveaux/labels des équipes responsables
identifiant de l'élément, etc.



Le comportement des filtres dépend du type d'attributs :
Ouvrir le texte/entier/décimal/numéro de téléphone. Saisissez la valeur puis cliquez sur appliquer le filtre. Le filtre n'est pas sensible à la casse et fonctionne même si vous saisissez le début de la valeur à rechercher, comme « voiture » pour « cargo ».
Choix simple/multiple. Sélectionnez l'option parmi la liste de choix.

Il est possible de filtrer un attribut avec une valeur vide en ne sélectionnant rien ou en tapant _ pour ouvrir le texte/numéro. Pour ce faire, cliquez simplement sur ajouter un filtre

Filtrer des éléments de liste sur les métadonnées



Il est possible de filtrer les éléments de la liste sur les champs de métadonnées suivants en utilisant le même bouton « Ajouter un filtre » :

Créé à : Date de création
Source création : Source de création, peut être web ou mobile
Créé par : personne qui a créé l'élément, afficher le nom d'utilisateur et le numéro de téléphone ou l'adresse e-mail
Mis à jour à : Date de la dernière mise à jour
Source mise à jour : source de la dernière mise à jour, peut être Web ou mobile
Mis à jour par

Filtrer des éléments de liste avec des valeurs vides



Pour afficher les éléments de la liste sans valeur :
Pour ouvrir un texte/un numéro, saisissez _ et validez
Pour un choix simple/multiple, sélectionnez «NOTHING»

Pour plus d'informations sur ce qui précède, veuillez regarder ceci




Créer des éléments en Bulk


Des opérations groupées peuvent également être effectuées sur les éléments de la liste. Cliquez sur créer puis choisissez Plusieurs éléments
Sélectionnez l'option dans le menu d'action, remplissez le modèle fourni.



Vous n'avez pas besoin de remplir des valeurs pour toutes les colonnes

Toutes les options à choix unique doivent avoir des clés d'attribut et non des noms d'attribut. Les clés d'attribut doivent correspondre à ce qui est fourni dans les options de l'application Web.

Localisation - Si vous souhaitez télécharger la localisation GPS des éléments, assurez-vous de fournir la latitude, la longitude et la précision GPS. (Séparé par une virgule, soit -0,2827345,36,0889535,10).

Sur le fichier de téléchargement, assurez-vous que le GPS est renseigné en commençant par Latitude, Longitude, précison (l'ordre compte)

Pour les attributs à choix multiples, séparez chaque tag d'option par une virgule ( , ), donc si les attributs peuvent prendre 2 valeurs, option1 et option2, ils doivent être écrits comme « option1,option2 »

Pour les images, vous pouvez ajouter des URL d'images directement dans les colonnes pertinentes du fichier, pour le téléchargement.


Les opérations en bulk déclencheront une notification sur l'application Web, indiquant qu'elles seront exécutées en arrière-plan. Un email est envoyé une fois terminé.




Modifier des éléments en bulk



Sélectionnez l'option dans le menu d'action, remplissez le modèle fourni.




Dans le fichier de modification en bulk, pas besoin de remplir toutes les colonnes, même si elles sont définies comme obligatoires. Seule la colonne qui contient des données sera mise à jour

Attribuez des droits d'accès aux utilisateurs mobiles aux éléments de liste



Accédez à la liste et cliquez sur l'icône de modification qui apparaît à l'extrême droite. Accédez au schéma de liste puis cliquez sur l'icône de l'onglet Paramètres. Accédez au champ Droits d'accès des utilisateurs mobiles. Ajoutez votre droit puis confirmez et enregistrez. Les droits d'accès de l'utilisateur mobile ont été clairement définis sous son nom.




Attribuer des éléments en bulk



Sélectionnez l'option dans le menu d'action, remplissez le modèle fourni.




Les propriétés existantes seront supprimées lors du téléchargement des assignations.
Si le fichier contient les éléments A, B et C, les propriétaires actuels de ces éléments seront supprimés et ils seront réaffectés en fonction des informations stockées dans le fichier d'attribution groupée.

Si la liste n’est pas en assignation unique (unique équipe ou un seul utilisateur mobile), plusieurs équipes ou plusieurs utilisateurs mobiles peuvent avoir le même élément. Dans le fichier d'attribution groupée, 1 ligne = 1 élément, 1 propriétaire.
S'il y a plusieurs propriétaires pour un même élément, le fichier contiendra plusieurs lignes, 1 par propriétaire.
Par exemple, si l'élément A appartient à OwnerA et OwnerB, le fichier contiendra les lignes suivantes :

ID de l'élément, ID d'équipe

ElémentA, PropriétaireA

ElémentA, PropriétaireB


Valeurs des champs vides en bulk



Si vous souhaitez supprimer les valeurs qui existent pour un élément d'un attribut , mettez CLEAR dans le champ du fichier groupé, à la place de la valeur de l'attribut. De ce fait il va « nettoyer » la valeur de cet attribut et le remettre à zéro.

Cela ne fonctionne pas pour ces types d'attribut :
Choix multiple
Un seul choix sur liste


Comment modifier les attributs à choix unique



Les attributs à choix unique comportent des options et chaque option possède une clé d'attribut et une réponse d'attribut.
Lors de la modification d'un attribut à choix unique, vous remplissez la colonne avec la clé d'attribut et non la réponse d'attribut. Toutes les clés doivent être en minuscules et correspondre exactement à ce qui se trouve sur WebApp.

Modifier les attributs choix unique dans une liste



Un choix unique dans une liste est une liste à l'intérieur d'une liste, ces listes sont créées pour accueillir un grand nombre d'options pour des attributs tels que les itinéraires.
Un seul choix sur la liste permet aux utilisateurs d'ajouter, de filtrer et de modifier facilement les options qui n'auraient pas été possibles avec un seul attribut de choix. Il existe deux manières de modifier un seul choix sur l'attribut de liste;

i) Modification unique sur l'application Web
ii) Modification en bulk à l'aide d'un fichier CSV

i) Modification en Bulk sur l'application Web

Ouvrez la liste que vous souhaitez modifier

Recherchez l'élément que vous souhaitez modifier dans la liste principale

Cliquez sur le stylo à l'extrême droite de l'élément

Après avoir cliqué sur le stylo, recherchez le choix unique dans l'attribut de liste que vous souhaitez modifier, c'est-à-dire l'itinéraire.

Choisissez l'option que vous souhaitez ajouter sur l'élément à choix unique sur l'attribut de liste.

Après avoir sélectionné la bonne option, veuillez cliquer sur ENREGISTRER en bas à droite pour enregistrer vos modifications/modifications.


ii) Modification groupée à l'aide d'un fichier CSV

Sélectionnez l'option de modification en bulk dans le menu de la liste principale et téléchargez le modèle

Sur le choix unique dans le liste, ajoutez l'identifiant de l'élément dans la liste liée. Vous pouvez télécharger des éléments de la liste afin d'obtenir les identifiants des éléments.

Une fois que vous avez rempli le choix unique dans la liste avec les bons ID d'élément, exportez-le au format CSV et téléchargez-le fichier.


Archiver des éléments en bulk



Sélectionnez l'option dans le menu d'action, remplissez le modèle fourni.



Supprimer des éléments en bulk



Sélectionnez l'option dans le menu d'action, remplissez le modèle fourni.



Téléchargez la liste des éléments



Pour télécharger tous les éléments de la liste, cliquez sur la flèche de téléchargement. L'option/icône de téléchargement n'est disponible que si vous avez donné accès aux éléments de téléchargement.




Si la liste contient moins de 5 000 éléments non archivés, la liste sera téléchargée sur le navigateur web
si la liste contient plus de 5 000 éléments, un lien vers la liste téléchargée sera envoyé par email avec tous les attributs.

Si vous appliquez des filtres à la liste, seule la liste filtrée sera téléchargée.

Afficher et filtrer la liste en fonction des attributs calculés



Les attributs calculés de liste sont des attributs automatiquement mis à jour en fonction de l'activité du client. Ils sont mis à jour dans la liste en fonction des requêtes SQL. Par exemple, le statut d'un client peut passer d'inactif à actif une fois qu'une visite a été effectuée ou sans dette une fois qu'il a réglé ses dettes ou passif à diriger une fois qu'il a passé une commande ou la date de visite mise à jour une fois que le client a été visité.

Pour plus d'informations, veuillez visionner la vidéo ci-dessous

Mis à jour le : 14/02/2024

Cet article a-t-il répondu à vos questions ?

Partagez vos commentaires

Annuler

Merci !