Source de données et requêtes

Les fonctionnalités décrites dans cette page font partie du Plugin Insertion de données (installé par défaut dans l'application de démonstration Ametys).

  1. Présentation
  2. Outil "Sources de données"
    1. Connexion LDAP
    2. Connexion SQL
    3. Requête LDAP
    4. Requête SQL

Présentation

L'outil Sources de données permet aux utilisateurs possédant 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.

Mise en garde
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

Cette page décrit comment créer et paramétrer des sources de données. Pour savoir comment utiliser ces requêtes dans les champs de type texte riche des contenu, rendez-vous sur la page dédiée

Outil "Sources de données"

Le plugin fournit un outil back-office Sources de données pour vous permettre de définir des connexions et des requêtes vers des sources de données LDAP ou SQL.

Cliquez sur le bouton Sources de données de l'onglet Accueil pour ouvrir l'outil.

L'outil se présente sous forme d'un arbre avec les connexions et requêtes existantes.

Depuis cet outil, vous pouvez créer, modifier ou supprimer des connexions (LDAP ou SQL) et des 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 de 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

Requête 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 boîte 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ête 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 boîte 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}