La gestion de tables SQL supplémentaires

On donne et on décrit un script qui affiche automatiquement un formulaire de saisie à partir de la description des tables SQL.

Cette contribution, originellement dédiée à SPIP 1.8, est pourvue d’un Post-Scriptum et d’une nouvelle pièce jointe la faisant fonctionner sous Spip 1.9 en utilisant ses nouvelles fonctionnalités qui simplifient son utilisation.

La version de Spip disponible depuis l’été 2004 donne la possibilité d’adresser
n’importe quelle table SQL, pas seulement celles créées par défaut lors de l’installation de Spip.
Cette nouveauté repose sur une
description des tables SQL par des tableaux PHP selon un format précis utilisé dans
le fichier ecrire/inc_serialbase.php3.
Ces tableaux sont eux-mêmes des éléments du tableau global $tables_principales, qui est utilisé par l’installateur pour la création de ces tables, et par le compilateur de squelettes pour produire des pages HTML de lecture de ces tables. Mais à l’inverse on peut les utiliser pour produire des formulaires Web d’écriture de nouvelles entrées.

Cette contribution se présente donc sous la forme d’un fichier
insere_en_table.php, à installer dans ecrire/.
On lui donne en arguments d’URL le nom de la table et un fichier
dont le chargement provoque la création dans $tables_principales
d’un élément portant le nom de cette table. En particulier, la désignation du fichier
standard ecrire/inc_serialbase.php3
et d’une table standard, comme dans :

insere_en_table.php?table=breves&file=inc_serialbase

provoquera la construction d’un formulaire de saisie fonctionnellement proche de ecrire/breve_edit. Selon le type SQL des différents champs,
le script produira une balise de saisie différente (input, select, textarea) préalablement remplie si le type SQL précise une valeur par défaut.

Lorsqu’on cliquera sur le bouton de validation, le retour sera de même fonctionnellement proche de ce que fait ecrire/breve.
Toutefois, un tel automatisme exclut tout comportement nuancé quant
aux relations entre les champs et les droits de l’émetteur vis-à-vis de sa
demande d’insertion d’une nouvelle entrée, ce que fait ecrire/breve.
Ici, le formulaire demande immédiatement une insertion au serveur SQL.

Malgré ces limitations, ce script donne donc un aperçu de ce qu’il est possible de
faire en Spip à présent. Précisons que la présentation du formulaire repose sur l’appel
des fonctions d’habillage de l’espace privé (pour s’approcher de ce qu’on a d’habitude
pour les brèves ou les articles) mais qu’il est possible de le neutraliser (pour obtenir une présentation plus austère, à l’image des messages de forums) en mettant dans l’URL un troisième argument, mode, affecté à une valeur quelconque.

Ce script est issu de discussions sur les forums de mes précédentes contributions,
dont je remercie beaucoup les intervenants qui m’ont permis de grandement amélioré
mon premier jet. A noter que l’ancien script, nommé tablextra, n’est PAS compatible avec les spécifications finalement retenues pour la version officielle sur le site CVS-SPIP.


En Spip 1.9, il n’est plus nécessaire de décrire les tables dans un tableau PHP, Spip effectuant une requête SHOW au serveur SQL pour obtenir cette description. Il suffit donc de donner seulement le nom de la table à ce script pour obtenir le formulaire d’insertion. On peut aussi donner le nom d’un serveur en cas de Spip étendu à plusieurs bases de données. Ce nouveau script se nomme

inserer.php

et s’appelle avec les conventions de Spip 1.9, soit :

spip/ecrire/?exec=inserer&table=matable

Discussion

10 discussions

  • 2

    L’exemple :

    insere_en_table.php ?table=breves&file=inc_serialbase

    il faut écrire ceci pour que ça marche :

    insere_en_table.php ?table=spip_breves&file=inc_serialbase

    Testé sous spip 1.8.2 pr2

    • oui, en fait ce script remonte à une version alpha de la 1.8 et on a changé la gestion des préfixes de table pour la sortie de la 1.8 officielle.

    • mendesrocc

      En version 1.8.2 d il faut exécuter l’url suivante :

      ecrire/insere_en_table.php ?table=spip_ma_table&file=inc_serialbase

      et modifier le fichier inc_serialbase.php3 pour enlever la gestion du préfixe lrs de l’insert.

      Bon le résultat est intéressant mais pas ouf !!!

      Connaissez-vous un script pour une gestion complète de formulaire ? Je dois réaliser une application pour enquête de satisfaction.

      merci d’avance.

    Répondre à ce message

  • 3

    Bonjour Emmanuel,

    Magnifique !
    Juste une chose : quelle modif faire pour pouvoir aussi éditer des données déjà saisies ?

    Pour le moment ce script permet d’entrer toutes les infos qu’on veut, mais pour le cas où on souhaite modifier des données déjà entrées et présentes en base ... ?

    • Bonsoir,

      J’ai beaucoup apprécié cette contrib. Mais j’ai eu la même réaction que toi, alors j’ai cherché et j’ai finalement dû me jeter à l’eau :
      Je me suis donc inspiré de cette contrib pour créer un module de gestion : lister, ajouter, modifier les enregistrements.

      J’ai proposé ce module pour approbation, j’espère qu’il sera bientôt publié : article 1604, intitulé ’Tables SQL supplémentaires - TableDATA -’
      C’est mon premier post, j’espère vite le voir en ligne.

      En attendant, il est téléchargeable sur : http://colliervoye.free.fr/spip/TableDATA.zip

      Bien à vous,

      Christophe

    • Bonsoir,

      Avec l’aide des articles de Spip-Contrib, j’ai même réussi à le transformer en Plugin.
      Il y a donc également un bouton pour le lancer dans la zone privée.
      Et j’ai ajouté une liste de choix pour la table sur laquelle on veut travailler.

      J’aimerai beaucoup que l’un d’entre vous puisse l’essayer et me dire ce qu’il en pense, cela m’encouragerait très certainement à faire mieux...

      Merci encore à ce site, dans lequel j’apprends beaucoup de chose !

      J’ai donc modifié l’article 1604 proposé en validation. Et il est possible de pré-télécharger le plugin sur : http://colliervoye.free.fr/spip/

      Christophe (mon mél est dans le fichier en téléchargement @+)

    • Voir le Plugin dont cette contrib est à l’origine : Gestion des données SQL avec TableDATA

      Bien à vous,

      Christophe

    Répondre à ce message

  • 2

    Merci pour cet article très intéressant, qui entraîne deux questions :

    1) y a-t-il moyen de donner des noms intelligibles pour les champs dans le formulaire qui s’affiche ?

    2) comment ajouter un lien dans l’admin pointant sur cette page ?

    • 1) en l’état, non. Mais on peut faire que, pour chaque table T, il existe un tableau $T_nom indexé par les noms des champs et ayant pour valeurs les « noms intelligibles » de ces champs. Il suffira alors de modifier un seul endroit dans le script. Ce tableau pourrait etre dans mes_fonctions.php, ou, mieux, dans un fichier T.php qui serait chargé lorsqu’on invoque ce script.

      2) je ne comprends pas la question.

    • 1) Merci

      2) Dans votre article, vous dite que l’on accède au script ainsi :

      spip/ecrire/ ?exec=inserer&table=matable

      Y a-t-il moyen d’ajouter, dans l’écran d’administration de SPIP un tel lien ou est-on obligé de le saisir à la main à chaque fois (on peut en faire un favori dans son navigateur, bien sûr, mais c’est moins convivial) ?

    Répondre à ce message

  • 1

    Salut Emmanuel,

    Je viens de tester ton script inserer.php, et je n’ai pas réussi à le faire fonctionner.

    J’ai obtenu l’erreur suivante :

     Warning: join() [function.join]: Bad arguments. in D:\www\lpasteur\ecrire\exec\inserer.php on line 100
    
    Warning: join() [function.join]: Bad arguments. in D:\www\lpasteur\ecrire\exec\inserer.php on line 101
    Insertion dans la table spip_breves sous le numero: 7

    J’ai les différentes URLs suivantes :

     
    http://cmaths.info/ecrire/?exec=inserer&table=breves
    http://cmaths.info/ecrire/?exec=inserer&table=spip_breves

    J’ai testé sur « brèves » avant de me lancer dans la création d’une nouvelle table, et comme depuis le 30/04/2006 de nombreux fichiers ont été renommés et/ou déplacé, je me demande si un lien n’est pas brisé.

    J’avais placé le script renommé en .php dans le répertoire exec de ecrire.

    • Pour les warnings, je viens de poster une version qui les élimine, mais à part ça chez moi ça marche avec la 1.9b3.

    Répondre à ce message

  • 2

    Bonjour,
    c’est bien beau d’ajouter des tables, mais comment fait-on pour qu’elles soient sauvegardées/restaurées depuis la partie privée du site ?

    • On charge la 1.9 beta qui, depuis qq jours a une nouvelle version des outils d’import/export tenant compte de ces tables.

    • Merci pour la réponse.
      Où peut-on trouver la 1.9 ?

    Répondre à ce message

  • 1

    Bonjour,
    j’ai été très intéressé par votre contribution sur les tables supplémentaires, mécanisme que je recherchais pour compléter les fonctionnalités du site que je gère.
    -  En ce qui concerne le nom à donner à la table, dans le fichier inc_serialbase, il doit tenir compte du fait que le système génère un préfixe spip_ à la fin de la saisie des données dans le formulaire. Ainsi une nouvelle base nommée « matable » dans inc_serialbase sera mise à jour sur le serveur sous le nom « spip_matable ». Il faut donc au préalable créer sur le serveur par Mysql une base ayant le nom « spip_matable ». En pratiquant ainsi, ça marche.
    -  La fonction insere_en_table.php que vous avez conçue permet de créer de nouveaux enregistrements dans cette table supplémentaire. Quelle méthode utiliser pour modifier des enregistrements existants de cette table supplémentaire, dans l’interface /ecrire ?

    J’ai bâti un gros site avec SPIP (http://www.paysdematha.com), mais je n’avais jusqu’à présent modifié aucun des fichiers du répertoire /ecrire/ , ne connaissant rien au php. Mais il va bien falloir que je mette un peu les mains dans le cambouis.
    Cordialement

    • il n’y a théoriquement pas à modifier les fichiers de /ecrire pour faire marcher cette contrib. Elle se repose sur les capacités de SPIP de voir les nouvelles tables déclarées dans votre fichier mes_fonctions.php3 ou mes_options.php3

      Voir la page sur le wiki :
      http://www.spip-contrib.net/spikini...

    Répondre à ce message

  • 1

    super ça marche mais comment intégrer le formulaire dans l’espace privé pour que les rédacteurs puissent entrer les données ?

    • Il suffit de le mettre dans le répertoire ecrire/ : le include('inc.php") déclenchera l’authentification.

    Répondre à ce message

  • 1
    yorghos

    Désolé pour le message anonyme de tout à l’heure.
    Deux remarques :

    1) Il existe une incompatibilité entre la déclaration dans l’url et la commande INSERT qui redéclare la variable globale prefix.

    2) Comme dit dans le précédent message, les tables additionnelles sont dans mes_fonctions.

    Solution qui marche très bien : Il faut ajouter include (« ../mes_fonctions.php3 ») ; juste après l’include de inc.php3 et déclarer les tables dans l’url sans le prefixe, comme dans le fichier mes_fonctions.php3.

    • 1. pourrais-tu expliciter le problème ? s’il s’agit de déclarer le prefixe de table dans l’URL, effectivement c’est impossible, car sinon plusieurs sites Spip utilisant un meme compte SQL pourraient se modifier mutuellement

      2. a signaler qu’on peut aussi mettre les tables dans mes_options.

    Répondre à ce message

  • 1

    Salut,
    Attendue avec impatience ta contribution. Je n’arrive pourtant pas à lui faire utiliser une table additionnelle déclarée dans mes_fonctions. C’est pourtant là que ce trouvent les tables additionnelles. Je présume que la raison provient de la localisation du fichier mes_fonctions qui n’est pas dans ecrire/. Comment faire ?

    • Le include doit tenir compte de l’endroit où il est appelé.

    Répondre à ce message

  • 1

    Hello, cette contribution m’a l’air intéressante mais :
    -  Peux tu faire des copies d’écran d’un rendu ?
    -  Est ce que cela veux dire qu’on peut ajouter des nouveaux champs de saisie dans un article (comme les anciens champs extra) et les appeller ensuite depuis le squelette ? Si oui avec quelle syntaxe ?
    Merci

    • Pas de copie d’écran puisque l’important est une action sur la base de données, pas un rendu html.

      Pour les champs nouveaux, c’est comme les autres ; un dièse suivi du nom du champ en majuscules.

    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