Utiliser les tables complémentaires (dites aussi tables extra)

Comment les créer et les utiliser dans vos squelettes...

Quelques explications simples et rapides :
-  pour créer vos tables complémentaires (ou EXTRA)
-  et pour les utiliser dans vos squelettes.

« la possibilité de SPIP de traiter simplement des tables externes est trop méconnue, mal documentée et pourtant un point fort très important. »

Ce commentaire de Nicolas concernant mon article sur le Plugin TableDATA m’a interpelé et m’a donné l’idée d’aller plus loin dans les explications.

Ton commentaire, avis : « la possibilité de SPIP de traiter simplement des tables externes est trop méconnue, mal documentée et pourtant un point fort très important. » m’a donné une idée...

Un exemple d’utilisation

CHAMPS EXTRA ou TABLE EXTRA

Sur mon site, j’ai des images qui représentent des graphes, on me demande d’afficher des valeurs pour chaque document.

1. Une idée pourrait être d’utiliser les Champs EXTRA, et d’ajouter des champs à la table document, pourquoi pas...

Mais cette application ne concerne qu’un secteur du site. Il est donc dommage d’alourdir tout le site pour cela.

2. Dans ce cas, je place toutes les valeurs dans un nouvelle table mesure et je crée un champ pour faire le lien avec l’id_document. Ainsi je ne fais pas peser cette structure sur tout le site.

Pour utiliser cette table mesures :

Il me suffira dans ce secteur de créer des squelettes particuliers avec des boucles MESURES. Spip ne connaissant pas cet élément, recherchera automatiquement la table mesure.

— -

Comment réaliser cela

Dans la suite : Nous prendrons comme exemple 2 tables.

Table MACHINES
Descriptif de la table
Nom ChampContenu
NUMMACHINE identification de la machine
NART Numéro de l’article spip relatif à cette machine

Clé primaire sur le champ “NUMMACHINE”

Table MESURES
Descriptif de la table
Nom ChampContenu
IDMACHINE identification de la machine de mesure
NANNEE année de la mesure
NSEMAINE Numéro de la semaine
VALMESURE valeur mesurée pour cette semaine

Clé primaire sur les champs “IDMACHINE”,“NANNES” et “NSEMAINE”

La jointure se fera par MACHINES.NUMMACHINE=MESURES.IDMACHINE

A - Créer les tables

Pour créer une nouvelle table : il vous suffit d’utiliser un programme comme PhpMyAdmin.

La base de données doit être capable de pointer de manière unique, l’enregistrement sur lequel vous voudrez travailler (suppression, modification de valeur). Alors il est conseillé de créer une clé primaire avec un autoincrément. Ainsi lors de l’ajout d’un nouvelle enregistrement, MySql ajoutera automatiquement celui-ci avec un numéro (clé) unique.
Ce champ sera pointé avec l’opton NOT NULL.

Ensuite pour les autres champs, c’est en fonction du besoin.

Quelques précautions :
-  Ne pas mettre de caractères “.” ou “-” dans les noms de champs.
-  Placer une clé primaire sur la table cela permet d’identifier de façon unique chaque enregistrement.

B - Ajouter et gérer les données

Pour ajouter des enregistrements et gérer le contenu : modification et effacement d’enregistrement, vous pouvez utiliser le plugin TableDATA

C - Les boucles dans les squelettes

Comment afficher toutes les mesures de toutes les machines :

<BOUCLE_bouclemachine(MACHINES)>
  <B_bouclemesure>
     Pour la machine #NUMMACHINE<br/>
  <BOUCLE_bouclemesure(MESURES){idmachine=#NUMMACHINE}{}>
     #NANNEE/#NSEMAINE, mesure =  #VALMESURE unités.<br/>
  </BOUCLE_bouclemesure>
     <hr/>
  </B_bouclemesure>
</BOUCLE_bouclemachine>

Pour faire mieux, en filtrant suivant le numéro de l’article par exemple :
Il suffit d’ajouter à la première boucle un critère :

<BOUCLE_bouclemachine(MACHINES){nart=#IDARTICLE}>

Ici on voit la mise en œuvre de 2 boucles imbriquées en spécifiant le critère de la jointure entre les 2 tables.

C’est finalement très simple !

Voir un exemple  : Site de présentation de mesures puis cliquer sur “voir les mesures”

Voir aussi : Accés SPIP aux tables externes et jointures

Vos questions, permettront d’enrichir le contenu de cet article par des explications plus détaillées qui correspondront à vos besoins.

Discussion

4 discussions

  • Bonjour,

    je viens de migrer un site sous SPIP3 (www.comite-terrasse.org).
    Naturellement je sauvegarde la base réelle pour la restaurer en local sur un site lui aussi migré en SPIP3.
    Je découvre que les tables externes sont bien sauvegardées mais ne sont pas restaurées.
    Comme dans les versions précédentes ces tables externes sont bien décrites dans le fichier mes_options.php du répertoire config.

    Y a-t-il un changement concernant la restauration des tables externes ?

    Cordialement
    Alain

    Répondre à ce message

  • Bonjour,
    J’ai un site qui était déjà existant chez Online.net. J’ai souhaité refaire le site avec spip en utilisant la base de données existante chez cet hébergeur, mais dont les tables n’ avaient pas été crees avec spip. En general lorsque les tables de ma base MYSQL sont crées avec spip, aussitot que j’indique la base de données vers laquelle doit pointer mon site, sur la page d’accueil apparaissent exactement le nombre d’articles stockés dans ladite base, que je souhaite voir afficher en page d’accueil et tous les répertoires existants avec leurs articles.
    Comment obtenir dans le cas d’un site que je fais avec spip et dont les tables de la base utilisée n’étaient pas faites avec spip, mes dits articles et répertoires stockées dans la base existante ?
    Le but est de pouvoir conserver les articles existants.Le site a de tonnes d’articles que je ne veux pas reprendre un apres l’autre. Il y a surement qq chose que je ne fais pas bien.
    Toute aide sera grandement appréciée.

    Répondre à ce message

  • Bonjour,
    Comment peut t-on simplement remplir une table extra à partir des informations d’un formulaire saisie par un visiteur identifié ?

    y a t-il des commandes SPIP ou doit t-on utiliser php/sql..

    merci

    Répondre à ce message

  • 2

    Hello,

    est-ce qu’il n’y a pas une jointure automatique si les 2 tables ont un champ de même nom ?

    La doc http://www.spip.net/fr_article3368.html indique :

    Dans un squelette comportant BOUCLE_a(table table1 ... tablen), les
    tables supplémentaires seront vues comme des candidates à une
    jointure, à travers les champs homonymes. Des exemples plus concrets
    seront donnés dans la documentation

    Auquel cas ce serait bien plus simple d’appeler ’id_machine’ les champs ’NUMACHINE’ et ’IDMACHINE’ (ou au moins avec le même nom...) et la jointure se ferait toute seule dans la boucle sans avoir besoin de spécifier idmachine=#NUMACHINE.

    • Bonsoir Jean-Luc,

      C’est très juste.

      Je propose une modif :

      1) Lister toutes les valeurs : On décrit cette méthode.
      <BOUCLE... (CAPTEURS MESURES)> avec une jointure automatique sur un même nom de champ.

      2) Lister toutes les valeurs avec une rupture sur chaque capteur : On reprend les 2 boucles imbriquées avec la jointure explicite.

      Qu’en penses-tu ?

      Merci pour ton message, ça permet d’enrichir le contenu.

      Christophe

    • Oui, ce serait bien, ça permettrait de bien comprendre et d’aller un peu plus loin. ( Faudrait vérifier les exemples aussi !)

      Je recommande le nom de champ « id_machine » car ainsi ce serait le même formalisme pour la dénominations des références que les objets standards de spip (id_article, etc) mais comme ces tables justement externe existent peut être indépendamment de spip, elles ne respectent pas forcément son formalisme...

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom