YellowBox Kanban
YellowBox Store
Objet
YellowBox Kanban permet de représenter des fiches sélectionnées sous forme d’étiquettes au contenu paramétrable. Cette visualisation facilite le pilotage de l’activité en permettant le déplacement des étiquettes par simple glisser/déposer. Ce plugin est utilisable sur tout type de fiches permettant ainsi la gestion des portefeuilles, des tickets clients, …
Si le paramétrage le permet, l’utilisateur pourra déplacer les étiquettes d’une colonne vers une autre colonne selon les droits qu’il a sur les fiches et les règles paramétrées sur le composant.
Le composant peut être alimenté via une recherche prédéfinie ou refléter le contenu d’une liste (ou d’une sous-liste) de données sur laquelle des filtres et des recherches sont appliquées en temps réel.
Exemple de visuel
Kanban paramétré sur la table Offres avec la recherche ‘Mes offres en-cours’ et la rupture sur le champ ‘Cycle’ limitée aux valeurs sélectionnées.

Installation
Le plugin est téléchargeable par l’administrateur depuis le YellowBox Store accessible via le bouton
de la barre de notification.


Cliquer sur le pavé du plugin pour voir le descriptif et accéder aux fonctions d’installation et de mise à jour.
Cliquer sur le bouton [Installer] pour l’ajouter à la liste des plugins paramétrables dans votre YellowBox CRM.
Ce plugin ne nécessite pas d’activation car non soumis à abonnement.
Pré requis : YellowBox CRM Version 7.2.4 ou supérieure
Paramétrage
Le plugin peut faire l’objet de plusieurs utilisations dans la base YellowBox CRM. Pour chaque cas d’usage, il convient d’ajouter un paramétrage particulier.
Pour ce faire :
- Aller dans le menu Paramétrage/Interfaces/Plugin

- Ajouter un nouveau plugin paramétré en cliquant sur le bouton [+ Ajouter] du bandeau en entête

Le paramétrage d’un plugin nécessite la réalisation des opérations suivantes :
- Donner un nom unique qui vous permettra de le repérer facilement par la suite
- Sélectionner le plugin désiré dans la liste des plugins téléchargés
- Sélectionner l’instance [yb kanban (composant liste)]
- Renseigner les différents paramètres demandés
La description générale des éléments nécessaires au bon fonctionnement du plugin est accessible via le bouton
présent dans le paramétrage du plugin.
Les instances disponibles
Deux instances sont disponibles avec ce plugin.
yb kanban (obsolète) (composant) : Conservé pour des raisons de compatibilité avec les paramétrages en versions inférieures
yb kanban (composant liste) : Permet d’utiliser le plugin via une liste ou une recherche associée
Le type d’instance [Composant liste] permet de visualiser et/ou modifier des fiches sous une forme autre que celle des listes classiques.```
Choix du type d’utilisation du plugin
Les données représentées dans le composant peuvent s’appuyer sur :
- Le résultat d’une recherche (Cas #1)
- Une liste ou une sous-liste (Cas #2)
La case ‘en tant que présentation dans une liste’ permet de basculer d’une source d’alimentation du composant à l’autre.
Cas #1 :

La case ‘en tant que présentation dans une liste’ est décochée. La recherche sur laquelle s’appuie l’alimentation des données du tableau doit être renseignée.
L’utilisateur a une vue des fiches correspondantes à la recherche associée sous forme d’étiquettes disposées en colonne. Cette sélection est figée.
Cas #2 :

La case ‘en tant que présentation dans une liste’ est cochée. La table contenant les fiches que vous souhaitez visualiser dans le composant via des listes et/ou des sous-listes doit être renseignée.
Le composant paramétré peut être utilisé comme présentation :
- d’une liste
- d’une sous-liste
L’utilisateur visualise sous forme d’étiquettes disposées en colonnes, les fiches correspondantes au résultat d’un filtre, d’une recherche, et/ou d’une recherche fulltexte sur la liste.
Paramètres communs
Outre les paramètres particuliers décrits ci-dessus, les paramètres suivants sont nécessaires :
Titre du composant (Paramètre non obligatoire) : texte qui apparait en entête du composant.
Référence du champ de rupture (Paramètre obligatoire) : champ qui détermine via la liste qui lui est associée, les colonnes qui sont affichées.
Ce champ peut être de type alphanumérique ou numérique avec choix obligatoire dans une énumération ou dans une table ou sur les gestionnaires.
Valeurs de rupture (Paramètre non obligatoire) : permet de limiter les colonnes à afficher aux valeurs sélectionnées.
Si aucune valeur n’est sélectionnée, toutes seront utilisées.
Champs à afficher (Paramètre obligatoire)
Les valeurs seront affichées l’une en dessous de l’autre, dans l’ordre indiqué, sans libellé de champ.
Leur ordre peut être modifié par drag and drop dans le paramétrage.
Il est possible d’insérer des champs type ‘couleur’ permettant ainsi d’afficher des informations sous les formes rond/carré/triangle/croix colorés et apparaissant dans cet ordre
.
Champ pour le calcul (Paramètre non obligatoire) : champ sur lequel est basé le calcul dont le résultat est affiché sous l’entête de chaque colonne.
Type de calcul (Paramètre non obligatoire)
Si un champ est défini pour le calcul le type de calcul par défaut est la somme.
Drag and drop (Paramètre non obligatoire) : permet de définir les options de glisser/déposer et de sens de déplacement.
Actif dans les deux sens si aucun choix n’est effectué.
Le drag and drop tient compte des droits d’accès en modification sur la table. L’utilisateur connecté pourra donc déplacer une étiquette uniquement si ses accès sur la fiche représentée par l’étiquette lui permettent la modification de la fiche concernée. Les règles à validation de fiches sont exécutées.
Intégration du composant
Comme vu au niveau du paramétrage, le plugin YellowBox Kanban peut être utilisé en tant que composant alimenté par une recherche (Cas #1) ou mettre à disposition de l’utilisateur une nouvelle présentation sur les listes ou sous-listes d’une table (Cas #2).
Cas #1
Dans le cas où le plugin s’appuie sur une recherche, le composant peut être inséré dans :
- Un accueil
- Une fiche
En tant qu’administrateur il est possible d’ajouter un plugin paramétré directement via les écrans des utilisateurs en cliquant sur le bouton central en bas d’écran [Mode éditeur]. Pour ajouter un composant Kanban pré paramétré sur un design sélectionné, il convient de réaliser les opérations suivantes :
- Passer en mode éditeur
- Sélectionner l’objet qui doit accueillir le composant
- Cliquer dans la barre de propriétés apparaissant au bas de l’écran sur [Ajouter]
- Sélectionner [Composant] dans la liste déroulante
- Sélectionner dans la seconde liste déroulante le nom du plugin paramétré désiré
- Ajuster la taille et la position du composant selon le résultat ciblé
Cas #2 :
Dans le cas où le plugin est alimenté des données d’une liste, il apparaît automatiquement dans la liste des présentations disponibles. Aucun paramétrage complémentaire n’est nécessaire pour la mise à disposition des utilisateurs.
Utilisation
Visualisation des données au travers du plugin YellowBox Kanban
Le plugin YellowBox Kanban est disponible dans YellowBox CRM soit directement dans un écran de type accueil ou fiche, soit sous la forme d’une présentation disponible dans les listes ou sous-listes.
Les modifications apportées au composant par les utilisateurs ne sont conservées que le temps de la session.
Visualiser les données d’une liste via le plugin YellowBox Kanban

Pour afficher la liste des offres (dans notre exemple) sous forme de kanban :
- Cliquer sur le bouton
pour accéder à la gestion des présentations, - Cliquer sur ‘Changer de présentation’ pour accéder à la liste des présentations disponibles,
- Cliquer sur la présentation voulue dans la colonne ‘Autre’ (‘Kanban – Liste des offres’ dans notre exemple).
Dans notre exemple, l’affichage classique sera alors remplacé par celui-ci:

Principes de fonctionnement
Le survol d’une étiquette affiche l’intégralité des données. Un clic sur une étiquette ouvre la fiche correspondante. Si le paramétrage permet l’interaction, le clic prolongé sur une étiquette permet de la déplacer par drag and drop dans la colonne souhaitée et de fait de réaliser les opérations suivantes :
- L’étiquette apparait en première position de la nouvelle colonne
- Le champ de rupture de la fiche prend la valeur de la nouvelle colonne (dans notre exemple il s’agit du cycle de l’offre)
- Les règles et évènements automatiques sont exécutés le cas échéant
- Les valeurs de l’étiquette et les nombres affichés en haut de chaque colonne sont actualisés
.