A5TM000 - Substitution de mot clés diva

Owned by Bertrand Littel
20/06/2023
2 min read

Le module A5TM000 est depuis la version 10.3 au cœur du mécanisme de substitution des mots clés diva.

Ce mécanisme permet, par l’utilisation des crochets ouvrant et fermant autour de mots clés, à certains endroits choisis, de substituer le mot clé par une valeur contextuelle liée à la programmation du traitement en cours ou d’exécuter un traitement diva.

 

Pour connaître de manière sûre les entités de données disponibles, ouvrez le source A5TM000. Les entités sont celle déclarées en EXTERN RECORD KEEPDATANAMES xxx xxx

 

Ce mécanisme est notamment très utilisé dans les code chemins, afin de permettre l’utilisation de chemin génériques.

Exemple : le code chemin JOINT_DAV_ART concerne /divalto/fichiers/ficjoints/[ART.REF]

 

On voit ici l’utilisation de la substitution de mot clé diva : ART.REF est situé entre [ et ]

ART est bien déclaré en EXTERN RECORD KEEPDATANAMES, l’entité ART correspondant à l’article peut donc être manipulée en indiquant les champs qui la composent, ici REF pour la référence article.

Lors de l’exécution, on obtiendra par exemple un chemin dynamique /divalto/fichiers/ficjoints/ALB0001/

 

C’est la fonction A5_Datacompute_substitution_chaine du module a5tm000 qui effectue les traitements en faisant appel au Datacompute et à des ouvertures spécifiques

Tous les détails techniques sur les possibilités de substitution sont indiquées dans l’aide en ligne XWIN pour le chapitre DataCompute. Notamment le fait que des instructions diva sont utilisables directement

 

Autre exemple : le code chemin JOINT_ENT_F_FACTURE concerne

/divalto/fichiers/DAV/[ENT.DOS]/ENT_F_FACTURE/[left(ENT.PIDT4]/[right(ENT.PIDT4]/

On voit ici l’utilisation de la substitution de mot clé diva : ENT.DOS est situé entre [ et ], mais également l’utilisation directe d’instruction diva, ici left et right.

ENTest bien déclaré en EXTERN RECORD KEEPDATANAMES, l’entité ENTcorrespondant à l’entête de pièce peut donc être manipulée en indiquant les champs qui la composent, ici DOS pour le dossier et PIDT pour la date.

Lors de l’exécution, on obtiendra par exemple un chemin dynamique /divalto/fichiers/DAV/998/ENT_F_FACTURE/2023/0602

 

De nombreux exemples figurent dans la visite guidée, par exemple avec utilisation de données du tiers ou la date courante