Data sources and queries


  1. Presentation
  2. Data sources" tool
    1. Request LDAP
    2. Request SQL

 

Presentation

L'outil Sources de données du CMS permet aux utilisateurs possédant les droits adéquats (généralement un webmaster ou un administrateur) de définir des requêtes associées à des sources de données existantes 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.

Examples of feasible queries:

  • Get a list of teachers and their contacts
  • Obtain a list of personnel in service
  • Get the secretariat's telephone number

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

Data sources" tool

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

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

L'outil se présente sous forme d'un arbre avec les connexions et requêtes existantes. On retrouve les sources de données définies dans l'espace d'admin du CMS.

Depuis cet outil, vous pouvez créer, modifier ou supprimer des requêtes (LDAP ou SQL).

Request LDAP

To add a query LDAP, select a data source LDAP then click on the'New query' button.

In the dialog box, select :

  • Query name (unique)
  • A description detailed enough for contributors to use it easily.
  • Visit type of result :
    • simple, if the query only returns a simple value to be inserted into a text (a person's name, for example)
    • multiple, if the query returns a list of results, which can be displayed in tabular form.
  • Le DN de recherche : Nom du contexte de l'objet à rechercher (ex : ou=people)
  • Visit type de recherche, défini le type de recherche possible dans le LDAP parmi :
    • Object
    • One level
    • Subtree
  • Returned attributes: The list of returned LDAP attributes and their labels, separated by commas (for example: sn[lastname], givenName[firstname], mail)
  • Visit constraints search criteria (which can be parameterized). Parameters are entered when the query is inserted into the content.
    • Non-configurable constraint: (mail=*.com)
    • Contrainte configurable, les paramètres commencent par le signe '$' suivi d'un jeu d'accolades : (uid = ${uid})

Request SQL

To add a query SQL, select a data source SQL then click on the'New query' button.

In the dialog box, select :

  • Query name (unique)
  • A description detailed enough for contributors to use it easily.
  • Visit type of result :
    • simple, if the query only returns a simple value to be inserted into a text (a person's name, for example)
    • multiple, if the query returns a list of results, which can be displayed in tabular form.
  • Visit request SQL (can be parameterized). Parameters are entered when the query is inserted into the content.
    • Non-configurable constraint: 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}

 

Back to top

External Data