Insertion de données

PDF

Envoyer par mail

Envoyer par mail


Séparés par des virgules
Vous êtes ici :

Source de données et requêtes

L'outil Sources de données permet aux utilisateurs possédants les droits adéquats (généralement un webmaster ou un administrateur) de gérer des connexion vers des bases de données SQL ou des répertoires LDAP.

Par la suite, ces utilisateurs peuvent définir des requêtes associées à une des sources pour obtenir des informations spécifiques que les contributeurs pourront insérer dans les champs texte riche des contenus.

Les requêtes doivent être écrites d'après la syntaxe SQL ou LDAP (en fonction de la source de données associée), des connaissances dans ces domaines sont nécessaires pour être en mesure de créer des requêtes.

 

Exemples de requêtes réalisables:

  • Obtenir la liste des enseignants et leurs contacts
  • Obtenir la liste du personnel en service
  • Obtenir le numéro de téléphone du secrétariat

 

Exemple de requête insérée dans un contenu

 

NOMPRÉNOMTÉLÉPHONESERVICE
MARTINPaul01 00 11 22 33Secretariat
DUMONTSeverine01 85 44 11 65Secretariat
AGADATJuliette01 12 45 74 45Secretariat
DUPONTPierre01 95 65 98 74Direction de la recherche
ROUGIERJean01 14 10 44 78Enseignement
SOULORDJacques01 77 10 00 96Enseignement
ALBERTFabienne01 30 10 80 47Enseignement
LARSACDominique01 87 10 46 52Enseignement

Configurer une source de données (admin)

Pour définir une nouvelle source de données ou en modifier une déjà existante, ouvrez l'outil en cliquant sur le bouton Sources de données dans la zoneOutils Avancés du ruban (onglet Accueil).

L'outil propose une vue arborescente des connexions et requêtes déjà existantes:

Sur l'illustration ci-dessus, on note qu'il y a :

  • Aucune source de données LDAP
  • Une source de donnée SQL définie (Local) contenant deux requêtes : PersonnelStaff

A partir du ruban, vous pouvez créer, modifier ou supprimer des sources de données (connexions) ou requêtes :

Connexion LDAP

Pour ajouter une source de données LDAP, veuillez renseigner les paramètres suivants :

  • Le nom de la source de données
  • Une description optionnelle
  • L'adresse du serveur LDAP (pouvant contenir le DN de la branche de base de la recherche)
  • Le filtre global de recherche (ex: objectClass=person)
  • Le type de recherche (objet, un niveau ou sous-niveau)
  • Le DN de l'administrateur
  • Le mot de passe administrateur
  • La méthode d'authentification (Simple ou Anonyme)
  • L'utilisation du connexion sécurisée (protocole SSL)

Connexion SQL

Pour ajouter une source de données SQL, veuillez renseigner les paramètres suivants :

  • Le nom de la source de données
  • Une description optionnelle
  • Le pilote JDBC utilisé pour la connexion (ex: com.mysql.jdbc.Driver for MySQL, org.apache.derby.jbc.EmbeddedDriver )
  • L'adresse du serveur SQL
  • Le nom d'utilisateur pour se connecter à la base de données SQL
  • Le mot de passe pour se connecter à la base de données SQL

Gestion des requêtes (admin)

Requêtes LDAP

Pour ajouter une requête LDAP, sélectionnez une source de données LDAP puis cliquez sur le bouton 'Nouvelle requête'.

Dans la boite de dialogue, choisissez :

  • Le nom de la requête (unique)
  • Une description assez détaillée pour que les contributeurs puissent l'utiliser facilement.
  • Le type de résultat : 
    • simple, si la requête ne renvoie qu'une valeur simple devant s'insérer dans un texte (le nom d'une personne par exemple)
    • multiple, si la requête renvoie une liste de résultats, pouvant s'afficher sous forme de tableau.
  • Les attributs retournés : La liste des attributs LDAP retournés et leurs labels, séparés par des virgules (par exemple: sn[nom], givenName[prenom], mail)
  • Les contraintesde la recherche (pouvant être paramétrées). Les paramètres seront à saisir lors de l'insertion de la requête dans le contenu.
    • Contrainte non configurable : (mail=*.com)
    • Contrainte configurable, les paramètres commencent par le signe '$' suivi d'un jeu d'accolades : (uid = ${uid})

Requêtes SQL

Pour ajouter une requête SQL, sélectionnez une source de données SQL puis cliquez sur le bouton 'Nouvelle requête'.

Dans la boite de dialogue, choisissez :

  • Le nom de la requête (unique)
  • Une description assez détaillée pour que les contributeurs puissent l'utiliser facilement.
  • Le type de résultat : 
    • simple, si la requête ne renvoie qu'une valeur simple devant s'insérer dans un texte (le nom d'une personne par exemple)
    • multiple, si la requête renvoie une liste de résultats, pouvant s'afficher sous forme de tableau.
  • La requête SQL (pouvant être paramétrée). Les paramètres seront à saisir lors de l'insertion de la requête dans le contenu.
    • Contrainte non configurable : SELECT firstname AS 'Firstname', lastname AS 'LastName', mail AS 'E-Mail address', service FROM Staff
    • Contrainte configurable, les paramètres commencent par le signe '$' suivi d'un jeu d'accolades : SELECT firstname AS 'Firstname', lastname AS 'LastName', mail AS 'E-Mail address' FROM Staff WHERE service=${service}