Configurateur Technico-Commercial Externe

Le but est de pouvoir disposer de typologies d’articles commerciaux qui permettent de dérouler un scénario similaire à un article de type configurateur DIAPASON en faisant appel à une application externe qui déroule le questionnaire du configurateur. La communication entre DIAPASON et l’outil de configuration est effectuée par message XML.

Contexte de démarrage

Le contexte de démarrage est défini par un message XML (sous forme de fichier ascii) qui dispose des informations structurées suivantes :

Mise en forme

Mise en forme du message XML d’entrée (les valeurs en gras sont figées) :

<CFGISIA>

<CtxDemIni>

<CfgExtCtx>C</CtxExtCtx>

<CfgExtAct>CRE</CfgExtAct>

<EntCtxLisCtx>DORMANT,OUV1,OUV2</ EntCtxLisCtx >

<EntCtxLisNiv>0,1,1</ EntCtxLisNiv >

<SDL.CdeNumCom>0511000064</SDL.CdeNumCom>

<SDL.CdeNumLig>001</SDL.CdeNumLig>

<SDL.CdeLigRefArt>FEN_10</SDL.CdeLigRefArt>

<SDL.CliResRef>0</SDL.CliResRef>

<SDL.CliGenRef>CLI0054</SDL.CliGenRef>

<SDL.CdeLigTarRef>STD</SDL.CdeLigTarRef>

<SDL.CdeLigQteCde>4</SDL.CdeLigQteCde>

<SDL.CdeLigQteCom>4</SDL.CdeLigQteCom>

<SDL.CdeLigDevPrix>€</SDL.CdeLigDevPrix>

<SDL.CdeLigUnMeQte>UN</SDL.CdeLigUnMeQte>

<SDL.CdeLigUnMeQteCom>UN</SDL.CdeLigUnMeQteCom>

<SDL.CdeLigDateLiv>02/12/2005</SDL.CdeLigDateLiv>

</CtxDemIni>

<CtxDemCom>

<SDE.CdeComEnt>Commentaire Commande</SDE.CdeComEnt>

<VDE.SpecEnt>Spécifique Commande</SDE.SpecEnt>

……..

<SDL.CdeComLig>Commentaire Ligne</SDL.CdeComLig>

<VDL.SpecLig>Spécifique Ligne</VDL.SpecLig>

……..

<SCL.CliGenCom>Commentaire Client</SCL.CliGenCom>

<VCL.SpecCli>Spécifique Client</VCL.SpecCli>

……..

<SCA.CliAffDes>Désignation Affaire</SCA.CliAffDes>

<VCA.SpecAff>Spécifique Affaire</VCA.SpecAff>

……..

<SCO.CliComNom>Nom Commercial</SAS.CliComNom>

<VCO.SpecCom>Spécifique Commercial</VAS.SpecCom>

……..

<SAS.GenDesArt>Désignation Article</SAS.GenDesArt>

<VAS.SpecArt>Spécifique Article</VAS.SpecArt>

……..

</CtxDemCom>

<CtxDemVar>

<CtxDemDia>

……..

<Ctx> DORMANT </Ctx>

……..

</CTXDEF>

……..

</CTXDEF>

……..

</CtxDemDia>

<CtxDemAut>

……..

<CtxDemAut>

</CtxDemVar>

</CFGISIA>

Balise CtxDemIni

Le contexte de démarrage :

➡️ CfgExtCtx : Type de contexte transmis au configurateur externe :

C : pour ligne de commande commerciale.
D : pour ligne de devis commercial.
T : pour déroulement d’un scénario en test.

➡️ CfgExtAct : Action effectuée :

CRE : création.
MOD : modification.

➡️ EntCtxLisCtx : pour une configuration en multi-contexte, liste des contextes commerciaux dans l’ordre récursif (commence par le contexte principal). Balise inutile pour une définition mono-contexte.

➡️ EntCtxLisNiv : pour une configuration en multi-contexte, liste des niveaux correspondants aux contextes commerciaux (dans l’ordre récursif, commence par « 0 »). Balise inutile pour une définition mono-contexte.

➡️ SDL.CdeNumCom : Numéro de Commande commerciale.

➡️ SDL.CdeNumLig : Numéro de Ligne de Commande commerciale.

➡️ SDL.CdeLigRefArt : Référence Article.

➡️ SDL.CliResRef : Référence Réseau Commercial.

➡️ SDL.CliGenRef : Référence Client.

➡️ SDL.CdeLigTarRef : Référence Tarif Commercial.

➡️ SDL.CdeLigQteCde : Quantité commandée.

➡️ SDL.CdeLigQteCom : Quantité commandée commercialement.

➡️ SDL.CdeLigDevPrix : Devise Tarif.

➡️ SDL.CdeLigUnMeQte : Unité de Mesure Quantité commandée.

➡️ SDL.CdeLigUnMeQteCom : Unité de Mesure Quantité commandée commercialement.

➡️ SDL.CdeLigDateLiv : Date de Livraison prévue.

Balise CtxDemCom

Un contexte spécifique de déroulement de scénario : il s’agit de transmettre des informations du contexte de départ (informations de la ligne de commande commerciale et/ou de l’entête et/ou du client et/ou de l’affaire et/ou du commercial et/ou de l’article) contextuelles au configurateur externe, sous la forme <balise>valeur</balise> où la référence balise correspond au nom de la variable DIAPASON de l’entité liée (variables de type SDE, VDE, SDL, VDL, SCL, VCL, SCO, VCO, SCA, VCA, SAS ou VAS). La liste des variables souhaitées est donnée dans le paramètre « DEM-CDC ».

Balise CtxDemVar

Un contexte initial du produit configuré : il s’agit de transmettre toutes les variantes du produit configuré ; dans le cadre de la création, il peut s’agir de variantes pré-initialisées, dans le cadre de la modification, il s’agit du contexte de sortie de la précédente saisie ; ce contexte présenté sous la forme d’une liste de balises :

Balise CtxDemDia (en mono-contexte)

Liste des variables VBA de DIAPASON (stockées sur la ligne de commande et donc visibles comme les VBA issues du CFG DIAPASON). Le contenu de la balise CtxDemDia est sous la forme :

Ref : référence variante.
Val : valeur variante.

Balise CtxDemDia (en multi-contexte)

Liste des variables VBA de DIAPASON classées par contexte. Le contenu de la balise CtxDemDia est sous la forme :

<CTXDEF> : indique le départ d’une définition de contexte.
<Ctx> …. </Ctx> : indique la référence contexte.
<VBA Ref= Val= > : définition de la variante et de sa valeur.

Balise CtxDemAut

Liste des variables autres (communiquées à la GCA avant CFG et après CFG par 3 variables VBP définies dans le paramètre « DEMRET-VVA »). Ces données n’étant pas enregistrées par DIAPASON, il faut les restituer dans les variables VBP lors de l’exécution de la requête GCA-I en mode « *INI ». Le contenu de la balise CtxDemAut est sous la forme :

Ref : référence variable.
Val : valeur variable.
Ctx : référence contexte variable (peut être vide, non géré par DIAPASON).

Exemple : Dans le message décrit ci-dessus, les variables VBP contiendront respectivement :

InfoPerso,InfoPerso2,InfoPerso2 (première VBP, liste des références)
TEST,TEST1 ,TEST2 (deuxième VBP, liste des valeurs)
,1,2 (troisième VBP, liste des contextes : facultatif)

Contexte de retour

Le contexte de démarrage est défini par un message XML (sous forme de fichier ascii) qui va disposer des informations structurées suivantes :

Mise en forme

Mise en forme du message XML de retour (les valeurs en gras sont figées) :

<CFGEXT>

<CtxRetGen>

<CfgExtAct>VALIDATION</CfgExtAct>

<EntCtxLisCtx>DORMANT,OUV1,OUV2</ EntCtxLisCtx >

<EntCtxLisNiv>0,1,1</ EntCtxLisNiv >

<SDL.CdeLigDesArt>Fenêtre 3 vantaux</SDL.CdeLigDesArt>

……..

<VDL.SpecLig>Spécifique Ligne</VDL.SpecLig>

……..

</CtxRetGen>

<CtxRetCom>

<VBP.VarPartage>Test</VBP.VarPartage>

……..

</CtxRetCom>

<CtxRetVar>

<CtxRetDia>

……..

<Ctx> DORMANT </Ctx>

</CTXDEF>

</CTXDEF>

……..

</CtxRetDia>

<CtxRetAut>

……..

<CtxRetAut>

</CtxRetVar>

</CFGEXT>

Balise CtxRetGen

Le contexte général de retour :

CfgExtAct : code retour du configurateur externe :

VALIDATION : la sortie du configurateur externe est validée.

ABANDON : la sortie du configurateur a été abandonnée.

EntCtxLisCtx : pour une configuration en multi-contexte, liste des contextes commerciaux dans l’ordre récursif (commence par le contexte principal). Balise inutile pour une définition mono-contexte.
EntCtxLisNiv : pour une configuration en multi-contexte, liste des niveaux correspondants aux contextes commerciaux (dans l’ordre récursif, commence par « 0 »). Balise inutile pour une définition mono-contexte.
Variables standard de la ligne de commande (de type SDL).
Variables spécifiques de la ligne de commande (de type VDL).

Balise CtxRetCom (balise optionnelle)

Un contexte spécifique de retour de scénario : il s’agit de transmettre des informations (informations sous la forme de variables contextuelles de saisies DIAPASON (VBP)), sous la forme <balise>valeur</balise> où la référence balise correspond au nom de la variable contextuelle de saisie (VBP) DIAPASON.

Balise CtxRetVar

Un contexte descriptif du produit configuré : il s’agit de transmettre toutes les variantes du produit configuré ; ce contexte se présente sous la forme d’une liste de balises :

Balise CtxRetDia (en mono-contexte)

Liste des variables VBA de DIAPASON (stockées sur la ligne de commande et donc visibles comme les VBA issues du CFG DIAPASON). Le contenu de la balise CtxDemDia est sous la forme :

Ref : référence variante.
Val : valeur variante.

Balise CtxRetDia (en multi-contexte)

Liste des variables VBA de DIAPASON classées par contexte. Le contenu de la balise CtxDemDia est sous la forme :

<CTXDEF> : indique le départ d’une définition de contexte.
<Ctx> …. </Ctx> : indique la référence contexte.
<VBA Ref= Val= > : définition de la variante et de sa valeur.

Balise CtxRetAut (balise optionnelle)

Liste des Variables autres (communiquées à la GCA avant CFG et après CFG par 3 variables VBP définies dans le paramètre « DEMRET-VVA »). Ces données ne sont pas enregistrées par DIAPASON mais servent uniquement au transport de données annexes entre DIAPASON et l’application externe : il faut les enregistrer dans une structure annexe lors de l’exécution de la requête GCL ou GCC. Le contenu de la balise CtxRetAut est sous la forme :

Ref : référence variable.
Val : valeur variable.
Ctx : référence contexte variable (peut être vide, non géré par DIAPASON).

Exemple : Dans le message décrit ci-dessus, les variables VBP contiendront respectivement :

InfoPerso,InfoPerso2,InfoPerso2 (première VBP, liste des références)
TESTR,TEST1R,TEST2R (deuxième VBP, liste des valeurs)
,1,2 (troisième VBP, liste des contextes : facultatif)

Paramétrage nécessaire

Paramétrage Article

Ce comportement de saisie de ligne de commande commerciale est paramétré sur l’article commercial. Dans l’onglet destination vente, les caractéristiques suivantes doivent être renseignées :

La définition commerciale : « 7 » Article défini par configurateur externe ; DT DIAPASON. Ce type d’article bénéficie d’un traitement identique aux articles de définition commerciale « 9 » (DIAPASON) mais avec une saisie des caractéristiques dans un outil de configuration externe.

La définition commerciale : « 8 » Article défini par configurateur externe ; DT désynchronisées. Ce type d’article bénéficie d’un traitement identique aux articles de définition commerciale « 4 » (DT désynchronisées) mais avec une saisie des caractéristiques dans un outil de configuration externe.

Paramètres Généraux Divers

Parmi les paramètres, ceux commençant par « CFE- » référencent tout le paramétrage nécessaire à l’interface entre DIAPASON et un configurateur externe.

CFE-CDESYS : Commande système

La désignation contient la commande système à exécuter pour lancer le CFG externe sous la forme d’une référence commande ou d’un nom de variable. Doit être une commande système Windows à exécuter ; cette commande système dispose en paramètre :

Paramètre 1 : nom du fichier ascii contenant les caractéristiques de démarrage de l’application extérieure (contexte de démarrage)
Paramètre 2 : nom du fichier ascii contenant les caractéristiques de retour de l’application extérieure (contexte de retour).

Remarque : la commande système est référencée dans DIAPASON (Explorateur « Exploitation », branche « Traitements, Commandes Systèmes ») et doit correspondre à un script windows (vbs) dont le contexte de lancement doit bloquer la session complète DIAPASON le temps de la saisie sur le configurateur externe.

CFE-DEM-CDC : balise <CtxDemCom>

Contient la liste des variables (informations de la ligne de commande commerciale et/ou de l’entête et/ou du client et/ou de l’article) à transmettre au CFG externe lors de son lancement. Sous la forme : SDE.CdeSemLiv,VDE.Poids,SAS.CarPrix,SDL.CdeComLig.

Remarque : la valeur vide signifie « aucune variable supplémentaire ».

CFE-DEM-CDV : balise <CtxDemDia> dans <CtxDemVar>

Contient la liste des variables (VBA) à transmettre au CFG externe lors de son lancement dans la balise <CtxDemDia>. Sous la forme : VBA.Hauteur,VBA.Largeur.

Remarque : ce paramètre agissant comme un filtre, la valeur vide signifie « toutes les variables VBA enregistrées ».

CFE-DEM-CTX : référence du contexte de départ

Contient la référence du contexte de départ dans un environnement multi-contextes (les réponses au cofigurateur externe étant enregistrées comme celle d’un configurateur DIAPASON). La valeur par défaut est « CFG-EXT ».

CFE-DEM-FIC : Fichier de démarrage

La désignation contient le fichier en entrée du CFG externe sous la forme d’un nom complet (C:\Windows\Temp\FicEntree.xml) ou d’un nom de variable (VDL.FicEntree, VBP.FicEntree, etc.).

CFE-DEMRET-REQ : Règle DIALOG de type REB

La désignation contient le nom d’une règle DIALOG de type REB à exécuter pour mettre en forme le fichier XML contenu dans WfEIAXmlMes avant et au retour du configurateur externe. Avant le configurateur la variable SCR.CdeSCDEvt contient « AVT-CFG » et WfEIAXmlMes.MesIde = « AVT-CFG », il faut remplir WfEIAXmlMes.MesIde = « MES-CFG ». Au retour du configurateur la variable SCR.CdeSCDEvt contient « APR-CFG » et WfEIAXmlMes.MesIde = « MES-CFG », il faut remplir WfEIAXmlMes.MesIde = « APR-CFG ».

CFE-DEMRET-VVA : Variables « autres »

La désignation contient le nom des 3 variables VBP contenant respectivement la liste des variables (balise <CtxDemAut> dans <CtxDemVar> et balise <CtxRetAut> dans <CtxRetVar>) à transmettre au CFG, la liste des valeurs, et la liste des contextes.

CFE-RET-FIC : Fichier de retour

La désignation contient le fichier de sortie du CFG externe sous la forme d’un nom complet (C:\Windows\Temp\FicSortie.xml) ou d’un nom de variable (VDL.FicSortie).

Utilisation : Saisie Ligne de Commande

La saisie d’une ligne de commande via un CFG Externe se déroule comme une saisie de ligne de commande pour un article de définition commerciale CFG DIAPASON :

La saisie de l’article déclenche le lancement du configurateur. Pour le configurateur externe, c’est la commande système (définie dans le paramètre CFE-CDESYS) qui est exécutée : ce doit être une commande système de type « commande libre » qui exécute un script « vbs ». La requête REB optionnelle de la commande système n’est pas exécutée dans ce cas (il faut utiliser la REB contenue dans le paramètre général DEMRET-REQ).
Le déroulement de l’application externe bloque l’exécution du script. DIAPASON n’est pas accessible pendant ce temps (le sablier est actif).
La fermeture de l’application de configuration externe reprend le déroulement du script. A la fin de celui-ci, la lecture du fichier de retour donne le comportement de DIAPASON. Si la balise <CfgExtAct> a pour valeur « Validation », DIAPASON interprète le contenu du message et :
- Remet à jour les variables de la ligne de commande (SDL et VDL), les variables VBA, les variables VBP.
- Exécute les requêtes GCA de saisie de ligne en mode « retour configurateur »
- Quitte la zone article pour aller en saisie sur la zone suivante. Pour les autres valeurs, DIAPASON reste en saisie sur la zone article.

Exemple avec l’application « XML Notepad » :

Validation article : ouverture « XML Notepad » avec fichier contenant l’export des informations de DIAPASON :

Mise en forme du fichier XML en fichier de retour, enregistrement du fichier avec le nom du fichier de sortie, puis fermeture « XML Notepad » : retour à la GFD sur la zone suivante (passage dans la requête GCA-I avec contexte = LC-SCD) :

Utilisation : Test Scénario

Le test scénario n’est accessible pour le CFG Externe que depuis la gestion des articles.

La saisie des caractéristiques de simulation d’une saisie déclenche le lancement du configurateur. Pour le configurateur externe, c’est la commande système (définie dans le paramètre CFE-CDESYS) qui est exécutée : ce doit être une commande système de type « commande libre » qui exécute un script « vbs ». La requête REB optionnelle est exécutée dans ce cas (et dans ce cas seulement) pour pouvoir initialiser toutes les variables souhaitées.

Le déroulement de l’application externe bloque l’exécution du script. DIAPASON n’est pas accessible pendant ce temps (le sablier est actif).

La fermeture de l’application de configuration externe reprend le déroulement du script. A la fin de celui-ci, la lecture du fichier de retour affiche la trace habituelle du résultat de la saisie, indiquant également les données « externes » et les données « autres ».