4. Afficher les tables

Il est décrit dans ce paragraphe, l’utilisation et la configuration des tableaux d’enregistrements issus de la base de données.

../_images/tab_1.png

La gestion des tableaux se base sur le fichier core/om_table.class.php (classe table)

Pour chaque affichage de tableau, le script sql/DBTYPE/[objet].inc.php correspondant est appelé. Il permet de stocker le détail des requêtes nécessaires à l’affichage du contenu.

Les tableaux sont construits lors de l’appel aux scripts scr/tab.php et scr/soustab.php.

4.1. Les script scr/tab.php et scr/soustab.php

L’appel à ces scripts permet d’afficher un tableau d’enregistrements de l’objet passé en paramètre.

Liste des paramètres passés à l’url :

  • obj : nom de l’objet pour lequel on souhaite afficher le tableau
  • premier : numéro de la première ligne affichée dans le tableau
  • recherche : chaîne de caractères recherchée depuis le modules de recherche
  • selectioncol : numéro de la colonne sélectionnée dans le module de recherche
  • tricol : numéro de colonne et orientation (+/-) du tri du tableau
  • valide : (true/false) affiche ou non les enregistrements non valide

L’appel à scr/soustab.php est fait en javascript depuis un formulaire afin d’afficher les informations liées à l’enregistrement en cours d’édition.

4.2. La requête SQL d’affichage

Elle se trouve dans sql/DBTYPE/[objet].inc.php

Les paramètres sont les suivants pour om_parametre.inc.php

<?php
//Nombre d'enregistrements par page
$serie=15;
//Icone affiché (XXX à voir deprecated)
$ico="../img/ico_application.png";
//Titre du tableau
$ent = _("option")." -> "._("om_parametre");
//Table de référence (il peut y avoir une ou plusieurs jointure)
$table=DB_PREFIXE."om_parametre";
//Liste des champs du tableau
$champAffiche=array('om_parametre',
                    'libelle',
                    'valeur',
                    'om_collectivite');
//Champs pour la recherche
$champRecherche=array('libelle','valeur');
//Critère de tri par défaut
$tri="";
//édition PDF
$edition="om_parametre";
//sous formulaire(s) associé(s)
$sousformulaire= array()

//autre exemple de sous-formulaire avec om_collectivite.inc.php
$sousformulaire=array('om_etat',
                'om_lettretype',
                'om_parametre',
                'om_sousetat',
                'om_utilisateur');
?>

Il est possible de surcharger les liens du tableau (voir la configuration des actions)

4.3. Le composant openMairie

tab.php utilise les méthodes d’om_table.class.php qui est une classe d’openMairie

core/om_table.class.php

Les méthodes de ce composant peuvent être surchargées dans obj/om_table.class.php