Corporama
YellowBox Store
Objet
Le plugin Corporama permet à l’administrateur de la base YellowBox CRM d’intégrer au sein des écrans utilisateurs un composant permettant d’interroger directement la base de données Corporama. Le résultat d’une requête est visualisé de manière intégrée et les fiches sélectionnées générées en base de données via un simple clic.
Exemple de visuel
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.
Cliquer sur le bouton [Installer] pour le télécharger dans la liste des plugins paramétrables dans votre YellowBox CRM.
Ce plugin nécessite l’achat d’un pack de crédits via le YellowBox Store ou la détention d’un pack souscrit directement auprès de Corporama. Dans tous les cas, une activation est nécessaire. Un Token (une clé) est délivrée dans tous les cas par Corporama.
Paramétrage
Le plugin Corporama 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/Automatismes/Traitements/Traitements/Plugins.
Cliquer sur le bouton [+ Ajouter]
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 listes des plugins téléchargés
- Sélectionner l’instance désirée
- Entrer les différents paramètres demandés
Les instances disponibles
Une seule instance de type composant est disponible avec ce plugin.
SearchCorporama (composant)
Les paramètres mis à disposition permettent d’une part d’établir les correspondances entre les données de type société, contact et adresse mis à disposition par Corporama et les tables et champs disponibles dans la base YellowBox CRM. Ils permettent d’autre part de déterminer le comportement de l’intégration de données en cas de doublons.
Token Corporama : cette information est fournie avec l’activation du premier pack de crédits.
Paramètres
Ci-dessous un focus sur les points de paramétrage particuliers autres que les simples mises en correspondance des zones disponibles dans Corporama et des champs présents dans la base YellowBox CRM :
Table de stockage : table qui est alimentée par les données de type société de Corporama
SIRET : Siret de la société
Ce paramètre est obligatoire car utilisé pour le dédoublonnage.
Traitement du dédoublonnage : trois choix pour trois types de traitements possibles, si doublon :
- 0 : mise à jour de la totalité des informations reçues de Corporama
- 1 : création systématique d’une nouvelle fiche
- 2 : aucun traitement
[Traitement société-contact] Actif : active un dédoublonnage supplémentaire lors du traitement d’intégration d’une fiche de type société à partir des données de Corporama en vérifiant au préalable si le SIRET envoyé par Corporama est déjà présent en base sur une autre table que celle sur laquelle la fiche doit être effectivement intégrée. Il active également ce même type de dédoublonnage au niveau des contacts.
[Traitement société-contact] Table de correspondance societe : table sur laquelle le dédoublonnage préalable du SIRET de la société est pratiqué si le paramétre précédent est actif.
[Traitement société-contact] Table de correspondance contact : table sur laquelle le dédoublonnage préalable de la fiche du contact à intégrer est réalisé.
[Traitement société-contact] Référence du champ SIRET société : identifie dans la table sélectionnée en correspondance société, le champ contenant le SIRET sur lequel la vérification du doublon est réalisée.
Intégration du composant
En tant qu’administrateur il est possible d’ajouter un plugin paramétré directement via les écrans de type fiche des utilisateurs en cliquant sur le bouton central en bas d’écran [Mode éditeur]. Pour ajouter un composant Corporama préparamétré sur une table, 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 dans la liste déroulante [Composant]
- Sélectionner dans la seconde liste déroulante le plugin paramétré désiré
- Ajuster taille et position selon le résultat ciblé
Utilisation
Pour commencer, ouvrir une fiche contenant le composant Corporama.
Le composant se présente en trois parties :
- Partie entête : cette partie contient simplement le titre du composant ainsi qu’un bouton d’information permettant de connaitre en temps réel le nombre de crédits restants. Ce nombre de crédits apparait ainsi :
Les champs de filtrage : permettent de saisir les éléments recherchés dans Corporama. Le caractère * est utilisé comme joker pour tous les champs d type alpha-numérique.
La liste de résultats : à partir de cette liste il est possible de visualiser l’ensemble des sociétés correspondantes aux filtres validés. Dans le cas où un fiche est déjà en base, une flèche apparait sur la gauche de la ligne. Un clic sur cette flèche permet d’ouvrir dans un nouvel onglet la fiche société correspondante.
Dans le cas où la fiche doit être générée en base, il convient de cliquer sur le nom de la société mise en surbrillance : un message de confirmation de création sera alors présenté à l’utilisateur.