Bloc Tableau de bord

Configurer les données de sortie

Type de table

les données peuvent être présentée sous 3 formes :

Table linéaire : Les données sont présentées par ligne de résultat

Tableau croisé : Les données sont présentées sous forme d'un tableau à deux dimensions. La description de la table doit préciser:

La colonne portant la dimension horizontale (un seul choix)

La ou les colonnes portant la dimension verticale.

La composition de la cellule contenu

Table hiérarchique : si les données extraites présentent un principe hiérarchique (id,parent) il est possible de les afficher dans une représentation arborescente.

Colonne de sortie

Ce paramètre détermine quels champs du résultat de requête seront affichés dans la table résultat (affichage des données). Les champs doivent être nommés selon les noms de sortie des colonnes (nom de champ ou nom d'alias) et ne peuvent être des expressions SQL. Les noms des champs sont séparés par des points-virgule (;).

Exemple, si la requête est :

SELECT
YEAR(FROM_UNIXTIME(time)) as year,
count(*) access
FROM
mdl_log
GROUP BY
year

Alors les colonnes de sorties peuvent être :

year;access

Nom des colonnes de sortie

Le nom des colonne de sortie peut-être précisé en séparant les noms par des ;

Exemple : Catégorie;Sous-catégorie

Format des données de sortie

Ces champs permettent de reformater les données en sorties, selon des masques compatibles avec la fonction “sprintf” qui retourne une chaîne formatée.

Pour une liste de champs de référence, la liste de format doit présenter un nombre identique de formule de formatage séparées par des points-virgules. La formule vide vaut pour “aucun formatage”.

Exemple : Pour retourner deux champs de type string :

%s;%s

Exemple : Pour une requête définissant un taux de fréquentation, on peut vouloir formater la division (flottant) en nombre à un chiffre après la virgule. Les champs “sortie de données” et “format des sorties”, par exemple, seraient exprimés ainsi :

mois;ratio
;%.1f

En savoir plus sur les chaînes formatées

Sortie avec html : Il est possible de formater une donnée de sortie en la couplant avec du language html, ainsi pour générer un lien sur une donnée affichant un nom abrégé de cours (shortname), on écrira la chaine de caractère de la façon suivante :

<a href="/course/view.php?id=%{cid}">%s</a>

Taille de pagination

Ce champs correspond à la taille de page de résultat en cas de sortie de données très conséquentes : Lorsque mentionné (non nul), il force la pagination des résultats de table.

Désactiver la sécurité

Ce choix concerne la protection contre les résultats massifs : Les requêtes d'extraction peuvent avoir des conséquences dramatiques sur les performances, et notamment au moment de la mise au point des jointures. Pour éviter que l'interface ne se retrouve dans une situation irrécupérable, une sécurité ajoute une pagination forcée sur les résultats en mode édition. Cette protection peut par contre poser des problèmes dans certains cas, par exemple lors de la production de courbes graphiques qui nécessitent beaucoup de données. Lorsqu'elle est désactivée, des résultats massifs sont effectivement produits et remontés dans le bloc pour rendu.

:!:Il est fortement conseillé d'utiliser les caches de résultats pour ce type de requête.

Activation du cache de résultat

Oui/non : Activer le cache permet au dasboard de placer les précalculs de données en cache, afin de minimiser les accès à la base de donnée, ce qui s'avère particulièrement pertinent en cas de requêtes statistiques qui nécessitent de multiples enregistrements pour produire un nombre plus restreint de données de sortie.

Le cron permet la programmation temporelle adéquate du rafraichissement du cache, combinée à la valeur TTL de ce dernier. (Time To Live). Le TTL du cache en minutes peut-être précisé.

Nettoyer la table

Oui/non : Cette option permet de choisir les colonnes résultantes à afficher en précisant le point d'arrêt dans l'option “Ne pas nettoyer après la colonne n° : ”

Table triable

Oui/Non

Colonne de séparation de sous-totaux

Saisir la valeur

Crédits

Valéry Frémaux (valery@activeprolearn.com)- Développements et documentation

Florence Labord (florence@activeprolearn.com) - documentation

Revenir à l'index du guide de configuration - Retour à l'index du composant - Aller au catalogue de requêtes génériques - Revenir à l'index des plugins - Revenir au catalogue