Gestion de données SQL avec TableDATA

Présentation

Dans SPIP, on peut ajouter une table ("matable" par ex.) et utiliser des boucles pour la parcourir : {BOUCLE_a(matable)} et extraire ses champs avec des balises {#CHAMP1}, {#CHAMP2}, etc.

L’objet de cette contrib est de visualiser, ajouter et modifier le contenu de ces tables.

-  Nom  : TableDATA
-  Version : 0.40
-  Auteur : Christophe Boutin
-  Licence : GPL
-  Compatibilite SPIP : testé sur SPIP 1.9.1 & 1.9.2PR2
-  Site(s) exemple : www.studiofoveau.com , mais dans la partie privée :-)

(Existe un portage en version SPIP 2.0 également)

-  Testé sur ces navigateurs [1]

Petit rappel sur SPIP

À partir de la version 1.9, on trouve une fonction très intéressante : Un extrait de la page des nouveautés de SPIP 1.9

Detection automatique de tables SQL et de jointures

Dans un squelette comportant BOUCLE_a(xxx), la table xxx peut être n’importe quelle table SQL connue du serveur SQL. SPIP demandera alors au serveur SQL de décrire cette table, ce qui lui permettra de compiler le squelette en interprétant toute balise #NOM comme un accès au champ xxx.nom s’il existe. Ces champs sont également repérés dans les critères des boucles.

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.

C’est très simple à mettre en oeuvre et très pratique. Par exemple, j’utilise cela pour modifier facilement un tarif d’une galerie de vente. Cela peut également permettre de faire, en douceur, la bascule entre vos anciens scripts (back office) et une refonte du site (front office) avec SPIP.

À lire également : implémenter une nouvelle boucle (déplacé depuis dans NouvelleBoucle).

Installation

Installer le fichier joint, après l’avoir dézippé, comme tous les autres plugins, cf. http://www.spip.net/fr_article3396.html

Utilisation

Lancement du script :

Pointez l’icône « configuration » puis cliquez sur l’icone « gestion table SQL ».

Une liste des tables supplémentaires (n’ayant pas le préfixe des tables spip) est affichée, choisissez la table sur laquelle vous souhaitez travailler.

L’administrateur dispose d’un bouton permettant d’afficher également les tables internes de SPIP.

Le script retourne une nouvelle page avec :
-  la liste des enregistrements (par groupe s’ils sont nombreux)
-  avec au dessous un formulaire d’ajout. (reprise de celui de Déesse A.)

En cliquant dans le titre du champ, il est possible de trier par ordre croissant ou décroissant sur ces valeurs.

Modification des valeurs des champs

Pour modifier les valeurs d’un enregistrement, double-cliquez dessus, alors un formulaire d’édition s’affiche avec les valeurs actuelles. Pour que cette fonction soit active une clé primaire doit être définie. Elle peut être dans le format « numérique » ou « texte ». Dans la version actuelle, cette clé primaire doit être sur un champ unique.

Au retour, un message d’information affiche les conclusions de la commande. (Ok ou erreur).
Il est affiché tout en haut de la page.

On peut également le lancer en ligne de commande :
Pour gérer le contenu d’une table « magasin », il suffit de taper l’url suivante :

url = .../spip/ecrire/?exec=tabledata&table=magasin

Verrou de protection

Ce plugin est dynamique, il s’adapte à la structure de la table que vous avez créée.

La clé primaire de la table est utilisée pour pointer l’enregistrement à modifier. Le plugin ne permet pas de modifier sa valeur. (Modifier cette valeur pourrait être dangereux pour l’intégrité des données de votre application. Imaginez si cette valeur est déjà utilisée pour faire une jointure sur un autre élément de la base.)

En fonction de la clé primaire choisie, le script détermine les limitations nécessaires pour éviter les fausses manipulations. L’utilisateur en est informé.

Dernières mises à jour :

NOUVEAU : À partir de la version 2.0.5 pour SPIP 2.0, une nouvelle fonction apparaît : il est possible d’effacer un enregistrement.

-  Le 15 avril 2009 (v2.00) :

• Portage sous SPIP 2.0
• Correctif pour l’affichage des caractères accentués.
• Voir l’article spécifique dédié à la version pour SPIP2. (TableData pour Spip 2)

-  Le 19 février 2007 (v0.40) :

• Voir ou masquer les tables de spip pour les administrateurs.
• Correctif liée à l’ajout du tri sur champ.

-  Le 18 février 2007 (v0.33) :

• Ajout du tri sur chaque champ.
• Correctif sur l’ajout pour reprendre les valeurs par défaut.

-  Le 16 février 2007 (v0.32) :

• Ajout d’un ascenceur sur la liste des enregistrements dans le cas d’un nombre important de champs dans la table.
• Correction d’affichage si la table est vide.

-  Le 12 février 2007 (v0.3) :

• Les fonctions sont activées suivant le paramétrage de la clé primaire et information de l’utilisateur.
• La modification des enregistrements ayant une clé primaire au format texte est prise en compte.

-  Le 7 février 2007 (v0.22) : Correction des url des icones.

-  Le 6 février 2007 :

• Packagé en Plugin,
• Ajout d’un bouton dans config,
• Affichage de la liste des tables pour le choix initial

-  Le 21 octobre 2007 :

• Mise en ligne d’un correctif de Marc VALLETEAU de MOULLIAC (merci de son retour)

La suite

Je me demande par exemple si :
-  j’ajoute la possibilité d’effacer un enregistrement ?
-  ou j’ajoute la recherche automatique d’un champ spécifique, genre « effacer » ENUM oui/non pour masquer les enregistrements devenus inutiles dans l’appli (effacer réellement s’est toujours délicat dans une base...)

Pour les experts, ou les curieux

Quelques commentaires faisant référence aux bases de données :

Nota : Que cela ne fasse pas peur aux débutants, il n’est pas nécessaire de tout comprendre pour que ça fonctionne

Ce plugin s’adapte à la structure de la table. Les fonctions sont activées suivant le choix de la clé primaire.
-  S’il n’y a pas de clé primaire : La modification n’est pas autorisée.

• Il n’est pas sûr que l’on pointe de façon unique un enregistrement. Plusieurs enregistrements pourraient être touchés par la modification.

-  S’il y a plus d’un champ dans la clé primaire : La modification et l’ajout ne sont pas autorisées

• Simplement parce que le code n’est pas encore adapté à ce cas. Alors pour éviter un bug ..

-  S’il y a une clé primaire sans auto-incrément : La modification est autorisée mais pas l’ajout

• La clé permettra de pointer de façon unique l’enregistrement à modifier.
• Mais lors de l’ajout, si l’on n’est pas vigilant, il pourrait y avoir une erreur de duplication de clé.

-  S’il y a une clé primaire avec auto-incrément : La modification et l’ajout sont autorisées

• C’est le cas idéal. RAS

Comment distinguer les tables ?

Il faut faire un test du nom de la table. Elle ne doit pas débuter par le préfixe utilisé par SPIP. ( voir la variable $table_prefix description, par défaut « spip_ »).

Voir aussi
La Contrib PhpMyAdmin-PhpInfo