DIAPASON 05

Rattacher une/des bibliothèque(s) Elcia ONLINE


Pour pouvoir choisir sa menuiserie parmi les bibliothèques Elcia Online quand on crée une ligne de commande, il faut d’abord rattacher la/les bibliothèques Elcia Online dans DIAPASON !

1. Renseigner la “ Configuration Elcia Online ”

Les paramètres nécessaires au bon fonctionnement du configurateur Elcia Online dans Diapason doivent être renseignés dans la fiche “Configuration Elcia Online” accessible depuis l’explorateur applicatif “Exploitation”, dans la branche “Services Web Diapason” :

image-20260305-142350.png

SI VOUS SOUHAITEZ RATTACHER PLUSIEURS BIBLIOTHEQUES :

On a dû vous fournir plusieurs SupplierContextID, et vous ne savez donc pas lequel mettre ici 🧐 ! En fait, mettez au hasard un des Supplier Context ID que vous avez récupéré, ça n’a pas d’importance. En effet, en standard, DIAPASON ne peut se connecter qu'à une seule bibliothèque, et ce paramétrage permet de s’y rattacher. Comme vous avez plusieurs bibliothèques, vous allez mettre en place un paramétrage supplémentaire qui est expliqué plus bas dans cette fiche, et cette “Configuration Elcia Online” ne sera pas prise en compte. Cependant, si ce n’est pas rempli, DIAPASON vous mettra une erreur !

Comment remplir ?

Paramètres Défaut de Connexion :

  • Utilisateur : Utilisateur de connexion sur la plateforme Elcia Online ou Mypricer

  • Mot de Passe : Mot de passe de connexion

  • SupplierContextId : Identifiant du contexte de chiffrage (valeur fournie par Elcia)

  • SCC* : Code contexte de chiffrage (valeur fournie par Elcia)

  • Code fournisseur* : Identifiant fournisseur (valeur fournie par Elcia)

  • Mode d’Accès : Mode d’accès au configurateur. Deux choix possibles :

    • COMPLET : accès complet ( pour tous les articles, internes et négoce)

    • NEGOCE : accès pour le négoce uniquement ( dans ce cas, on aura pas besoin de remplir l’utilisateur et le mot de passe ci-dessous dans “Paramètres retour du Configurateur )

  • Version API CFG : Version de l’url de l’API du configurateur

Paramètres Retour du Configurateur 

  • Utilisateur : Identifiant de connexion au DIAPASON cible (doit être défini dans les utilisateurs de DIAPASON)

  • Mot de Passe : Mot de passe de connexion au DIAPASON cible


Comment tester ?

On peut ensuite tester la configuration à l’aide du bouton Test Conf. Cela permet de lancer un outil de diagnostic des différents échanges entre DIAPASON et le configurateur Elcia Online :

image-20260305-142758.png

Si cette action renvoie “Récupération de la clé secrète OK”, c’est que tout va bien !

La clé secrète est un paramètre récupéré à l’aide de l’identifiant et du mot de passe du client, et qui permet de faire les appels.

Si ce n'est pas le cas, que faut-il faire ?
  • Vérifier que DIAPASON a bien accès à Internet ou que les accès Internet ne sont pas trop restreints, car on a besoin d’Internet pour accéder à Elcia Online ! C’est la source d’erreur la plus commune 🙂


SI VOUS SOUHAITEZ RATTACHER PLUSIEURS BIBLIOTHEQUES :

Continuez sur les étapes suivantes :

  • Vous devez entrer les différents supplier Context ID que vous avez récupérés dans DIAPASON. Pour cela, vous avez le choix :

    • Mettre une variable spécifique supplier Context ID sur les articles, et pour les articles Elcia Online, on remplit cette variable avec le supplier context ID de la bibliothèque associée.

    • Créer une table de valeurs CdeCfgWeb ( c’est la solution utilisée dans DIAPASON START, et vous pouvez vérifier si la table existe déjà 🙂 ) dans laquelle on liste tous les articles qu’on a, et on met les supplier context ID des bibliothèques associées à chaque article. Les champs à remplir sont les même que dans la “Configuration Elcia Online” présentée précédemment !

On choisit la solution qu’on préfère ! 🙂


  • Ensuite, si ce n’est pas déjà fait dans votre DIAPASON, surchargez la GCA pour prendre en compte les différentes bibliothèques.

Dans la GCA, il y a une partie qui concerne le mode après Configuration au lancement pour les articles de type 31 ou 93 ( articles Elcia Online de négoce ou complets) : dans cet exemple, c’est au niveau de la procédure CdeLibWeb qui vient récupérer tous les prix, libellés et images pour les intégrer dans DIAPASON :

image-20260622-074329.png

Juste avant le lancement de cette procédure CdeLibWeb, il faut donc parcourir la TV/rechercher les variables spécifiques sur notre article pour en extraire le Supplier Context ID.

On vient ensuite le surcharger avec la fonction CFGWEBPAR comme ci-dessous :

image-20260622-074429.png

Et c’est tout bon ! 🙂

2. Créer les configurations

On va ensuite créer les configurations qu’on associera aux articles.

Ces “chemins” permettent de plus ou moins préremplir le questionnaire de configuration de l’article et ainsi de guider l’utilisateur. On a accès au contenu d’une bibliothèque.

Par exemple:

  • Quand je sélectionne tel article, je dois choisir parmi les bibliothèques de tel fournisseur et non pas de tous les fournisseurs..

  • Quand je sélectionne tel article, ça me sélectionne directement le bon fournisseur et je n’ai plus qu'à choisir parmi les menuiseries…

  • Je veux n’afficher que certains fournisseurs et un certain type de produit dans le questionnaire

  • …des exemples concrets plus bas 👇


On y accède par ici :

image-20260618-143418.png

Ensuite, selon les champs que vous avez ici ( qui dépendent de la version d’API ), vous n’allez pas remplir de la même façon !

Si on a les champs “Identifiant contexte” et “Identifiant bibliothèque” ( ça veut dire qu'on est en version 2.1 de l’API ), on remplit ainsi :

image-20260618-143732.png

Sinon ( on est avant la version 2.1 de l’API ) on remplit ainsi :

image-20260618-144209.png

On remplit les champs suivants :

  • On en met rien dans Marque et Bibliothèque !

  • Gamme: Code de la gamme de produit. Zone facultative. Doit être renseignée si le produit est renseigné. Saisie possible uniquement en création.

  • Produit: Code produit. Zone facultative. Saisie possible uniquement en création.

  • Identifiants contexte : A partir de la 2.1 identifiant du contexte du client revendeur (supplierContextId). Permet de filtrer les bibliothèques par fournisseur. Si on laisse vide, cela affichera les bibliothèques de tous les fournisseurs, et si on remplit, cela affichera uniquement les bibliothèques d’un seul fournisseur.

  • Identifiant bibliothèque : A partir de la 2.1 pricerID

  • Configuration: Référence de la configuration Web. Cette zone n’est pas saisie mais contient la concaténation de la marque, de la bibliothèque, de la gamme et du code produit séparés par un « / » + identifiants contexte et bibliothèque en 2.1

  • Désignation : Description de la configuration. Zone facultative.

On remplit les champs suivants :

  • Marque: uniquement avant la 2.1 Code de la marque du produit. Zone obligatoire. Saisie possible uniquement en création.

  • Bibliothèque: uniquement avant la 2.1 Code de la bibliothèque produit. Zone facultative. Doit être renseignée si la gamme et/ou le produit sont renseignés. Saisie possible uniquement en création.

  • Gamme: Code de la gamme de produit. Zone facultative. Doit être renseignée si le produit est renseigné. Saisie possible uniquement en création.

  • Produit: Code produit. Zone facultative. Saisie possible uniquement en création.

  • Configuration: Référence de la configuration Web. Cette zone n’est pas saisie mais contient la concaténation de la marque, de la bibliothèque, de la gamme et du code produit séparés par un « / » + identifiants contexte et bibliothèque en 2.1

  • Désignation : Description de la configuration. Zone facultative.

Sur les zones « Marque », « Bibliothèque », « Gamme » et « Produit », il n’est pas possible de saisir les caractères suivants :

" " (espace) / \ < > , ; # & ' " ~ $ ? * | . [ ] { } ( )

La référence de configuration de doit pas dépasser 160 caractères.

Exemples de configurations:

On remplit le paramètre “Identifiant Contexte” pour filtrer sur les bibliothèques d’un seul fournisseur
  • Gamme= “ “

  • Produit= “ “

  • Identifiants contexte= 7935 A partir de la 2.1

  • Identifiant bibliothèque= “ “ A partir de la 2.1

Soit:

image-20260311-133851.png

Cela va fitrer sur les bibliothèques d’un seul fournisseur :

image-20260311-151807.png
On remplir les paramètres Identifiant Contexte et Identifiant Bibliothèque
  • Gamme= “ “

  • Produit= “ “

  • Identifiants contexte= 7935 A partir de la 2.1

  • Identifiant bibliothèque= 1406 A partir de la 2.1

image-20260311-133930.png

On arrive directement sur le choix de la famille, la bibliothèque a déjà été sélectionnée automatiquement

image-20260311-133948.png
On remplit les paramètres Gamme, Identifiant contexte et bibliothèque
  • Gamme= SIMPLE

  • Produit= “ “

  • Identifiants contexte= 7935 A partir de la 2.1

  • Identifiant bibliothèque= 1406 A partir de la 2.1

image-20260311-134010.png

On tombe sur le choix du produit directement, la bibliothèque et la famille ont déjà été sélectionnées automatiquement

image-20260311-134031.png
On remplit tous les paramètres !
  • Gamme= SIMPLE

  • Produit= FX

  • Identifiants contexte= 7935 A partir de la 2.1

  • Identifiant bibliothèque= 1406 A partir de la 2.1

image-20260312-071400.png

On arrive directement sur la configuration du produit, tout le reste a été prédéfini en amont :

image-20260312-071703.png
On crée l'article sans même renseigner une configuration Web ( on laisse vide)

Au lancement de l’article, rien ne sera prédéfini, on affichera toutes les bibliothèques de tous les supplierContextId disponibles et on devra tout sélectionner sans aucun filtre :

image-20260311-150735.png

3. Créer les articles associés au scénario

Une fois les configurations crées, on va pouvoir créer les articles :

  • On sélectionne le type d’article dans le champ “Def.Com.Art” :

    • 31: si on est en mode négoce, l'article va être commandé chez un fournisseur qui va le fabriquer de son côté

    • 93: si on est en mode complet, l'article sera fabriqué en interne

  • On rentre la configuration ( qu’on vient de créer ) de l’article dans le champ “Config Web

image-20260618-145313.png

Quand on lance la configuration, et qu’on a une erreur de type “Aucune bibliothèque n’est accessible”, cela peut signifier que le chemin dans le champs Config Web ne fonctionne pas !