Le module de gestion de tableaux A5PMTAB a pour but de faciliter la mise en œuvre d'un tableau ou d'un arbre dans un masque écran Diva.
Il propose des fonctions qui permettent de gérer de manière transparente les principales actions réalisables sur un tableau en interrogation ou en modification. Ce module est une surcouche du module de gestion de tableau offert par Harmony.
Le module propose une fonction de consultation de tableau et une fonction de saisie de tableau. Ces fonctions doivent permettre au programme appelant de gérer un tableau sans utiliser les fonctions système de gestion de tableau. (XmeListConsult, XmeListDefProc, …)
Le module proposera une gestion par défaut des touches standard de l'ERP.
Le module donnera la main au programme appelant en offrant des ouvertures à chaque étape du processus de gestion du tableau en particulier à chaque événement utilisateur.
Le module proposera des fonctions de tris automatiques sur chaque colonne. Il sera possible de trier sur plusieurs colonnes en même temps. Le module proposera aussi un tri sur les arbres. Ce tri sur les arbres permettra d'avoir un critère de tri différent selon le niveau de l'arborescence.
Le module proposera par défaut la gestion des notes et des fichiers joints
Le module ne peut gérer que des tableaux entièrement chargés, ou utiliser un mode de chargement dynamique par pagination
Pour les arbres, le premier niveau doit être entièrement chargé. Les sous-niveaux peuvent être chargés à la volée.
Le principe est simple : plutôt que de coder l’affichage d’un tableau dans un masque écran, et de développer toutes les actions et interactions possibles (charger, scroller, sélectionner une ligne, raccourcis, export, copier, coller, drag&drop, filtres,…), A5PMTAB permet de regrouper dans une module standard toutes les principales actions qui peuvent être mutualisées, et en donnant la main au programme appelant uniquement pour chaque point d’entrée prévu dans le moteur a5pmtab.
Comme les actions sont nombreuses, il y a de nombreux points d’entrée possibles dans le programme appelant |
Un module compagnon existe : A5PMTAB000.dhop qui apporte des aides sur certains sujets hors de la gestion du tableau, mais parfois utile comme la colorisation, selection, pilotage de touches par liste, navigation arbre, saisie ligne,…
Voir plus de détails Compagnon A5PMTAB000
Le principe même d’A5PMTAB est de fonctionner comme un moteur qui traite des actions en boucle, et qui se débranche vers des fonctions ou procédures sur des actions spécifiquement prévues pour permettre au programme déclarant le module de traiter ces actions.
Pour obtenir la liste des fonctions/ procédures, les module a5pmtab.dhop comporte une auto-documentation |
Pour obtenir cette liste des prototypes des fonctions et procédures utilisables, il suffit d’appeler le module a5pmtab.dhop comme si c'était un programme, donc en ligne de commande Harmony ou depuis un sous-projet XWIN.
soit le fichier “Proto_A5pmtab.dhsp” existe dans les implicites, et sera écrasé par la liste des prototypes
soit ce fichier n’existe pas, et il est crée dans le premier chemin trouvé dans les implicites courants
Dans les deux cas, le fichier “Proto_A5pmtab.dhsp” est garni avec la liste des prototypes des fonctions et procédures appelées dans le programme utilisant a5pmtab
Ces fonctions et procédures sont bien à placer dans le programme principal utilisant le module, donc de type xxPPyyy |
Il existe également 4 ouvertures (donc à placer dans le traitement de type xxTTyyy) : DefProcSaisie_Defaut_Ap, DefProcSaisie_Apres_Ap, DefProcInterro_Defaut_Ap, DefProcInterro_Apres_Ap
mais ce n’est pas l’usage naturel d’a5pmtab qui fait appel à des fonctions/procédure du programme principal. Charge a ce programme principal xxPPyyy de faire un A5_xml_call selon les besoins pour appeler une ouverture dans xxTTyyy