Cette fonctionnalité est disponible à partir de la révision V5.09.
BUT Cette fonction permet de réaliser des mises à jour de variables standards et spécifique sur les entités FACE (facture client) et O_ECTRF (facture fournisseur), en ayant initialisé auparavant une ou plusieurs listes standards permettant de décrire les mises à jour souhaitées.
TYPE CARACTERE (rubrique Fonction Gestion pour les requêtes REB, PSD et RCT, libellé : Enreg. Action sur Facture (FACE - ECTRF).
SYNTAXE Variable = MAJ-FACX ( )
PARAMETRES
Aucun.
Le comportement de la fonction dépend de l’initialisation des listes standards suivantes :
-
WfFacxAct : Elle décrit les actions de mise à jour à effectuer sur une facture.
|
Nom |
Type |
DĂ©signation |
Obligatoire (O) |
Commentaire |
|
ActNOr |
Caractère |
Ordre traitement des actions |
O |
Pris en compte |
|
Action |
Caractère |
Action à réaliser (MAJ). |
|
Doit contenir MAJ |
|
ActCle |
Caractère |
Clé de lien avec WfFacxVar |
O |
Elle doit être renseignée dans cette liste, ainsi que dans la liste WfFacxVar. Le lien entre les listes ne se fera que par cette clé ! |
|
ActErr |
Caractère |
Libellé d’erreur de l’action |
|
Retourne le libellé si erreur |
|
EntTEn |
Caractère |
Type Entité (FACE, O_ECTRF) |
O |
Doit contenir FACE ou O_ECTRF |
|
EntCl1 |
Caractère |
Clé 1 Entité |
O |
CdeFacRef pour entité FACE
|
|
EntCl2 |
Caractère |
Clé 2 Entité |
|
|
|
EntCl3 |
Caractère |
Clé 3 Entité |
|
|
-
WfFacxVar : Détail des variables à mettre à jour liées à la facture.
|
Nom |
T |
DĂ©signation |
Obligatoire (O) |
Commentaire |
|
ActCle |
Caractère |
Clé de lien avec WfFacxAct |
O |
Elle doit être renseignée dans cette liste, ainsi que dans la liste WfFacxAct. Le lien entre les listes ne se fera que par cette clé ! |
|
EntTVa |
Caractère |
Type de variable (SPE, VFA, STD, VOP) |
|
|
|
EntVar |
Caractère |
Référence de la variable |
O |
Liste des variables autorisées |
|
EntVaC |
Caractère |
Valeur variable caractère |
|
Pris en compte |
|
EntVaN |
DĂ©cimal |
Valeur variable numérique |
|
Pris en compte |
|
EntVaL |
Logique |
Valeur variable logique |
|
Pris en compte |
|
EntVaD |
Date |
Valeur variable date |
|
Pris en compte |
DIAPASON traite toutes les actions de la liste WfFacxAct dans l’ordre donné par le champ ActNOr (numéro d’ordre des actions).
Chaque action dispose d’un libellé d'erreur retour : WfFacxAct.ActErr.
L’action est composée d’un élément dans la liste WfFacAct et d’autant d’éléments correspondant aux différentes variable rattachées à une facture, définis dans WfFacxVar (au moins un élément (variable) doit être défini dans WfFacxVar).
MISES A JOUR POSSIBLES
|
Entité |
Type Variable |
Référence Variable |
|---|---|---|
|
FACE |
SPE |
Statut FACTUR-X : CdeFacXSta_IS - Caractère Statut Technique : CdeFacStaTec_IS - Caractère Date du statut : CdeFacDatMajSta_IS - Date Heure du statut : CdeFacHeuMajSta_IS - Entier ID FACTURX de soumission : CdeFacNumFacX_IS - Caractère Date de soumission PA : CdeFacDatEnvPA_IS - Date Heure de soumission PA : CdeFacHeuEnvPA_IS - Entier Erreur retournée par PA : CdeFacErrStaPa_IS - Caractère Reference PA : CdeFacPARef_IS - Caractère |
|
FACE |
VFA |
Variable typée VFA existante dans DTVaria |
|
O_ECTRF |
STD |
Statut FACTUR-X : ProFaEn.ProFacXSta_IS - Caractère |
|
O_ECTRF |
VOP |
Variable typée VOP existante dans DTVaria |
EXEMPLES
L’exemple ci-dessous contient 1 action sur FACE et 1 action sur O_ECTRF avec pour chaque action une mise à jour sur une variable standard :
CREATION Liste WfFacxAct :
PRENDRE WfFacxAct ActCle = CLO."CleLien1"
PRENDRE WfFacxAct EntTEn = CLO."FACE"
PRENDRE WfFacxAct ActCle = CLO."CleLien1"
PRENDRE WfFacxAct Action = CLO."MAJ"
PRENDRE WfFacxAct EntCl1 = CLO."GEN0000040"
FIN_BLOC
CREATION Liste WfFacxVar :
PRENDRE WfFacxVar ActCle = CLO."CleLien1"
PRENDRE WfFacxVar EntTVa = CLO."SPE"
PRENDRE WfFacxVar EntVar = CLO."CdeFacXSta_IS"
PRENDRE WfFacxVar EntVaC = CLO."OK"
FIN_BLOC
CREATION Liste WfFacxAct :
PRENDRE WfFacxAct ActCle = CLO."CleLien2"
PRENDRE WfFacxAct EntTEn = CLO."O_ECTRF"
PRENDRE WfFacxAct ActCle = CLO."CleLien1"
PRENDRE WfFacxAct Action = CLO."MAJ"
PRENDRE WfFacxAct EntCl1 = CLO."F0000194"
FIN_BLOC
CREATION Liste WfFacxVar :
PRENDRE WfFacxVar ActCle = CLO."CleLien2"
PRENDRE WfFacxVar EntTVa = CLO."STD"
PRENDRE WfFacxVar EntVar = CLO."ProFacXSta_IS"
PRENDRE WfFacxVar EntVaC = CLO."OK"
FIN_BLOC
VLO.Retour = MAJ-FACX( )