blockdashboardconfigoutputfields

This is an old revision of the document!


Bloc Dashboard : Element de tableau de bord - Configuration des données de sortie

Ce panneau de paramètres détermine les choix des sorties en mode “table de données”. Certains paramètres, comme par exemple les paramètres de cache, peuvent affecter d'autres formes de sorties.

La fonction première de ce panneau est de choisir les colonnes de sorties dans le résultat de la requête (colonnes nommées) et d'alimenter un affichage en table de données. Les tables de données peuvent être de trois format :

  • Pour des enregistements simples, fournissant des données “à plat” vous opterez pour la sortie “Linéaire”.
  • Pour des enregistrements présentant une donnée à deux dimensions, vous pouvez choisir la “Table croisée”. La table croisée utilise une dimension simple comme colonnes de la table de rendu, mais peut utiliser un enseble de dimensions de sorties pour créer les lignes de la matrice.
  • Pour des enregsitrements présentant une caractéristique arborescente reconnaissable* alors vous pouvez activer le rendu “hiérarchique”.

Paramètres

Dans toutes les entrées de type “liste”, le séparateur entre champ DOIT ETRE le point-virgule. Un certain nonmbre de paramètres secondaires admettent un nombre d'éléments de liste en fonction du nombre d'éléments d'un paramètre primaire. Vous trouverez ci-dessous les informations correspondantes.

Colonnes de sortie

Les colonnes de sortie permettent de choisir quelles colonnes de la requête seront utiisées pour l'affichage. Ce choix peut être différent suivant les différents modes de rendus. Certaines colonnes “techniques” n'ont pas à participer à l'affichage.

Les colonnes de sortie doivent être désignées par leur nom d'ALIAS. Par exemple, pour une requête :

SELECT
   id as id,
   shortname as sn,
   fullname as fn
FROM
   {course}

vous pourrez ne choisir “que” de ne sortir les colonnes sn et fn :

 sn;fn
 

Cas particulier : Colonnes sommatives

Vous pouvez avoir besoin, par exemple pour piloter des courbes cumulées, d'extraire une forme “sommative” d'une colonne à résultat numérique. Par exmemple si vous voulez compter le nombre de création de nouveaux cours de manière cumulée par mois sur toute l'année.

Pour cela vous pouvez utiliser la syntaxe suivante, en lieu et place du simple nom aliasé de colonne :

Soit la requête :

SELECT
   DATE_FORMAT('%Y_%m', FROM_UNIXTIME(timecreated)) as month,
   COUNT(*) as cccount
FROM
   {courses}
GROUP BY
   month

Vous pouvez invoquer la somme cumulative du nombre de créations par mois comme ceci :

 month;S(cccount)   

Format des données de sortie

Chaque colonne de sortie fournit une donnée qui peut être formattée avant affichage. Il est possible de spécifier des chaines de formattage sous le format de la fonction sprintf(). Certaines syntaxes additionnelles ont été ajoutée pour des effets non prévus par ces syntaxes standard.

Paramètre primaire associé : Colonnes de sorties

Exemple :

Soit la requête :

SELECT
   DATE_FORMAT('%Y_%m', FROM_UNIXTIME(timecreated)) as month,
   SUM(1) / 12 as meancreation
FROM
   {courses}

Revenir à l'index du guide utilisateur

blockdashboardconfigoutputfields.1448114690.txt.gz · Last modified: 2024/04/04 15:50 (external edit)