Correspondances Articles Standards
Possibilité de retrouver un ou des articles standard en fonction de leurs caractéristiques de définition (variables VBA).
Définition des Règles de Correspondances
Cette application, sous la forme d’une gestion de fiche graphique (GFG), se trouve dans l’explorateur applicatif des articles standards dans Paramétrage des articles, après « Liste d’Articles ».
Onglet « Définition »
Correspondance
Référence de la règle de correspondance.
Désignation
Désignation de la règle de correspondance.
Commentaire
Commentaire de la règle de correspondance.
Type Correspondance
Type de la règle de correspondance :
Référence | Désignation |
1 | Liste de Variables |
2 | Liste de Variables avec Détail Contexte |
5 | Grille de Valeurs Numériques |
6 | Grille de Valeurs Numériques avec Détail par Contexte |
9 | Règle DIALOG |
Type Retour
Type de retour de la règle de correspondance (provision technique) :
Référence | Désignation |
S | Simple : la règle de correspondance renvoie le premier article standard répondant à la correspondance recherchée. Fonctionnement par défaut. |
L | Liste : la règle de correspondance renvoie une liste d’articles standards répondant à la correspondance recherchée. Non disponible pour l’instant. |
Onglet « Définition Clés »
Clé Indexée
Sélection des variables VBA composant la clé indexée. La longueur de cette clé est limitée à 100 caractères.
Détail Clé Indexée
Affichage des variables VBA composant la clé indexée.
Clé Grille
Sélection des variables VBA composant la clé grille. Uniquement des variables numériques, limitée à 5 variables.
Opérateur
Référence | Désignation |
E | = (égal) |
I | <= (inférieur ou égal) |
IE | <= (inférieur ou égal) |
S | >= (supérieur ou égal) |
SE | >= (supérieur ou égal) |
Clé Complémentaire
Sélection des variables VBA composant la clé complémentaire.
Détail Clé Comp.
Affichage des variables VBA composant la clé complémentaire.
Onglet « Sélection Articles »
Article Début
Article de départ à traiter.
Article Fin
Article de départ à traiter.
Liste d’Articles
Liste d’Articles à traiter.
Critère Articles
Critère sur entité Articles.
Règle Extraction
Règle REB d’extraction des Articles.
Crit. Règle Ext.
Critères de la règle REB d’extraction des Articles.
Onglet « Définition par DIALOG »
Règle Génération
Règle de génération des clés de correspondance.
Crit. Règle Gen.
Critères de la règle de génération des clés de correspondance.
Règle Recherche
Règle de recherche des entités à proposer (en fonction des clés déterminées par règle ci-dessus).
Crit. Règle Rec.
Critères de la règle de recherche des entités.
Règle Contrôle
Règle de contrôle des entités proposées.
Crit. Règle Ctr.
Critères de la règle de contrôle.
Depuis cette application, 2 actions sont possibles :
Génération
Lance le traitement « DTD-COR » décrit ci-dessous pour la correspondance courante.
Détail Contextes
Pour les correspondances avec détail contextes, permet de définir les variables à comparer pour chaque modèle de contexte :
Correspondance
Référence de la règle de correspondance.
Modèle Contexte
Modèle de Contexte. Doit exister pour un Scénario de Configuration.
Clé Contexte
Sélection des variables VBA composant la clé pour les contextes du modèle.
Détail Clé Contexte
Affichage des variables VBA composant la clé pour les contextes du modèle.
Traitement de génération des Correspondances (DTD-COR)
Ce traitement, de référence « DTD-COR » permet de générer chaque correspondance sélectionnée selon plusieurs étapes :
1. Mise à jour date et heure de début génération.
2. Sélection des articles selon définition sur entête correspondance
Si type « par DIALOG » exécution règle REB,
Sinon exécution règle REB si définie,
Sinon choix dans Liste d’Articles si définie,
Sinon exécution critère sur entité Articles si défini,
Sinon choix des articles entre « Article Début » et « Article Fin ».
3. Pour chaque article construction des clés, puis enregistrement de celles-ci.
4. Mise à jour date et heure de fin génération.
Le contexte de la règle REB de sélection des Articles est le suivant :
SCR.LEN_Mode : G
SCR.LEN_LisRef : référence correspondance
SCR.LEN_EntRef : GAD
SCR.LEN_Action : GEN
La règle REB de sélection doit renvoyer la liste standard WfEntSel sous la forme suivante :
WfEntSel.EntTEn = « GAD »
WfEntSel.EntCl1 = « R »
WfEntSel.EntCl2 = référence article standard
WfEntSel.MDi = clé indexée
WfEntSel.EntVa1 = clé complémentaire
Remarque : la clé indexée ne doit pas être vide pour générer correctement l’article.
REC-COR : Fonction DIALOG de Correspondance
BUT
Permet de rechercher une entité de correspondance (généralement une correspondance à un article standard) en fonction du contexte courant.
Cette fonction est disponible dans les requêtes de type GCQ, RN5 et REB. En fonction du type, le contexte d’entrée et de sortie diffère légèrement : dans le cas des requêtes de type GCQ et RN5, la correspondance est recherchée par rapport à la situation des contextes au moment de l’exécution, tandis que dans le cas des REB, il est nécessaire d’avoir initialisé auparavant les listes standards de description de contexte (voir fonction INIT-CTX).
TYPE
Caractère
SYNTAXE
Requêtes GCQ et RN5 :
Variable = REC-COR( REG-CORR= Règle , S:TYPE= Type_Entité, S:CLE1 ENTITE= Clé1_Entité , S:CLE2 ENTITE= Clé2_Entité, S:CLE3 ENTITE= Clé3_Entité)
Requêtes REB :
Variable = REC-COR( REG-CORR= Règle , TYPE=Type_Entité, CLE1 ENTITE = Clé1_Entité , CLE2 ENTITE = Clé2_Entité, CLE3 ENTITE = Clé1_Entité, S:TYPE= Type_Entité, S:CLE1 ENTITE= Clé1_Entité , S:CLE2 ENTITE= Clé2_Entité, S:CLE3 ENTITE= Clé3_Entité)
PARAMETRES
Paramètre | E/S | O | Type | Description |
Règle | E | Oui | Caractère | Référence règle de correspondance à utiliser (définie dans la bibliothèque des règles de correspondances). Cette référence peut être donnée par une variable locale, une constante globale ou une constante locale. |
Type_Entité | E | Oui /reb | Caractère | Uniquement pour les REB : Type entité de recherche. Cette référence peut être donnée par une variable locale, une constante globale, une constante locale ou bien par la sélection d’une entité pré-définie, article standard ou ligne de commande commerciale. La combinaison Type entité avec les 3 clés suivantes doit correspondre à une clé de définition des contextes dans les listes standards WfCfgRecCtx et WfCfgRecVal ou bien une clé d’un scénario enregistré (article standard configuré ou ligne de commande). |
Clé 1 Entité | E | Oui /reb | Caractère | Uniquement pour les REB : Référence clé 1 de l’entité. Cette référence peut être donnée par une variable locale, une constante globale ou une constante locale ; dans le cas d’un article standard, il s’agit de la valeur « R » ; dans le cas d’une ligne de commande commerciale, il s’agit du numéro de commande. La combinaison Type entité avec les 3 clés suivantes doit correspondre à une clé de définition des contextes dans les listes standards WfCfgRecCtx et WfCfgRecVal ou bien une clé d’un scénario enregistré (article standard configuré ou ligne de commande). |
Clé 2 Entité | E | Oui /reb | Caractère | Uniquement pour les REB : Référence clé 2 de l’entité. Cette référence peut être donnée par une variable locale, une constante globale ou une constante locale ; dans le cas d’un article standard, il s’agit de la référence article standard ; dans le cas d’une ligne de commande commerciale, il s’agit du numéro de ligne de commande. La combinaison Type entité avec les 3 clés suivantes doit correspondre à une clé de définition des contextes dans les listes standards WfCfgRecCtx et WfCfgRecVal ou bien une clé d’un scénario enregistré (article standard configuré ou ligne de commande). |
Clé 3 Entité | E | Oui /reb | Caractère | Uniquement pour les REB : Référence clé 3 de l’entité. Cette référence peut être donnée par une variable locale, une constante globale ou une constante locale ; dans le cas d’un article standard ou d’une ligne de commande commerciale, cette clé n’est pas utilisée. La combinaison Type entité avec les 3 clés suivantes doit correspondre à une clé de définition des contextes dans les listes standards WfCfgRecCtx et WfCfgRecVal ou bien une clé d’un scénario enregistré (article standard configuré ou ligne de commande). |
Type_Entité | S | Oui | Caractère | Type entité de correspondance trouvé. Cette référence est donnée par une variable locale retournée par la fonction et peut correspondre à un article standard (valeur GAD). |
Clé 1 Entité | S | Oui | Caractère | Référence clé 1 de l’entité trouvé. Cette référence est donnée par une variable locale; dans le cas d’un article standard, il s’agit de la valeur « R ». |
Clé 2 Entité | S | Oui | Caractère | Référence clé 2 de l’entité trouvé. Cette référence est donnée par une variable locale; dans le cas d’un article standard, il s’agit de la référence article. |
Clé 3 Entité | S | Oui | Caractère | Référence clé 3 de l’entité trouvé. Cette référence est donnée par une variable locale; dans le cas d’un article standard, cette clé n’est pas utilisée. |
Cette fonction peut recevoir deux listes standards :
La liste WfCfgRecCtx : un élément de cette liste correspond à un contexte ; cette liste est ordonnée dans l’ordre récursif des contextes et dispose de toutes les informations rattachées au contexte : désignation, modèles, ….
La liste WfCfgRecVal : un élément de cette liste correspond à une valeur d’une variable contextuelle VBA pour chaque contexte.
EXECUTION
Si la correspondance est de type « REB », 2 règles REB sont exécutées :
1. Règle de recherche correspondances (construction des clés)
Cette règle est exécutée avec le contexte suivant :
SCR.LEN_Mode : E
SCR.LEN_LisRef : référence correspondance
SCR.LEN_EntRef : GAD
SCR.LEN_Action : CLE
Et doit renvoyer 2 variables :
SCR.LEN_MDi1 : clé indexée
SCR.LEN_MDi2 : clé complémentaire
2. Règle de contrôle entité.
Cette règle est exécutée avec le contexte suivant :
SCR.LEN_Mode : E
SCR.LEN_LisRef : référence correspondance
SCR.LEN_EntRef : GAD
SCR.LEN_Action : CTR
SCR.LEN_MDi1 : clé 1 candidat à contrôler (type article pour les articles)
SCR.LEN_MDi2 : clé 2 candidat à contrôler (référence article pour les articles)
SCR.LEN_MDi3 : clé 3 candidat à contrôler (vide pour les articles)
Et doit renvoyer 2 variables :
SCR.LEN_OK : doit être à la valeur OUI pour indiquer que l’entité correspond aux clés
EXEMPLE
Dans une RN5 :
VLO.VarRésultat = REC-COR( REG-COR=CLO.’Rec.Art.Std’, S :TYPE= VLO.TypeEnt, S :CLE1 ENTITE = VLO.Type, S :CLE2 ENTITE = VLO.Reference , CLE3 ENTITE = VLO.RAF).
Cette instruction permet de retourner dans la variable VLO.Reference une référence article standard si DIAPASON a pu faire correspondre toutes les VBAs de l’article standard avec les VBAs au moment de l’exécution de la règle dans la requête RN5, en suivant les règles de correspondances définies sur la règle « Rec.Art.Std ».
NOTES
La variable retour est vide si l’exécution de la fonction s’est correctement déroulée ; sinon, elle contient le code erreur DIAPASON et le libellé associé à l’erreur.