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

Note : Cette documentation est un draft. Les requêtes proposées en exemple ne sont pas encore vérifiées

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}

Nom des colonnes de sortie

Les colonnes de sortie peuvent etre “traduites” en libellés intelligibles pour l'affichage aux utilisateurs. Déifnissez une liste de labels utilisés sur les écrans. Vous donnerez autant de libellés que le paramètre primaire associé.

Paramètre primaire associé : Colonnes de sorties

Taille de pagination

Si la requête cible peut conduire à une sortie d'un très grand nombre de résultats, il peut être convenable, pour la performance des consultations de limiter le nombre de sorties. Si ce paramètre n'est pas défini, toutes les données seront affichées, sinon une pagination sera mise en place dans la requête.

Précaution : Cette limitation peut affecter la cohérence de résultats affichés sous forme de table croisée ou sous forme hiérarchique. Utilisez là avec prudence pour ces formes d'affichage.

La pagination des résultats peut être imposée par certains réglages globaux du bloc Dashboard.

Revenir à l'index du guide utilisateur

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