MAJ-FACX
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( )