==== Bloc Tableau de Bord ====
===== Filtres et sommateurs =====


Les filtres et les sommateurs sont des fonctionnalités liées au résultat de la requête. Les données utiles pour l'affichage des tables et des graphes peuvent être filtrées selon certaines colonnes.

==== Les filtres ====

Les filtres permettent de proposer à l'exploitant du tableau de bord une façon d'extraire un résultat partiel de la requête complète, à partir de colonnes désignées comme dimensions de filtrage.

Une valeur particulière d'un filtre est appelé "modalité" du filtre.

Comme ils sont basés sur les résultats effectifs de la requête non filtrée, les filtres ne peuvent proposer que des modalités qui existent dans les données.

Il est possible de définir plusieurs filtres qui se combineront dans une opération "ET". <nowiki>(*)</nowiki>.

Chaque définition de filtre se traduit par l'ajout d'un champ de formulaire de filtrage au dessus de la table de données (ou du graphe).

{{ :blocks:dashboard:filtres.png?nolink |}}

=== Définitions des filtres ===

Ce champ doit être renseigné avec une liste de définitions de champs de la requête de départ. Ce champ accepte une liste à points-virgules pour définir successivement plusieurs filtres à présenter dans l'interface.

**La définition d'un filtre :** 

  * Modifie dynamiquement la requête au moment de la production du bloc.
  * Ajoute automatiquement les listes déroulantes de critères qui permettent à l'utilisateur d'opérer le filtre.

:!: Attention, la définition doit être complète, avec la mention de l'alias de colonne. Ainsi pour une requête :

   SELECT
      username as un,
      firstname as fn,
      lastname as ln,
      country as cn
  FROM
      {user}

Alors les expressions de filtre admissible sont : 

    username as un

ou

    country as cn

Plusieurs filtres peuvent être définis en séparant leur définition par des point-virgules.

=== Défaut pour les filtres ===

Dans certaines modalités de fonctionnement, il est nécessaire d'indiquer une valeur par défaut pour le filtre. Cette valeur peut être l'une des valeurs normalement attendue, ou l'un des métamarqueurs suivants : 

   * FIRST : Prendra comme défaut la première valeur disponible des modalités du filtre
   * LAST : Prendra comme défaut la dernière valeur disponible des modalités du filtre

=== Options pour les filtres ===

Certaines options peuvent influer fortement sur la présentation et le fonctionnement du filtre.

== Sélection unique (s) ==

Si cette option est activée, le filtre ne peut pas fonctionner sur l'ensemble des résultats. Une modalité s'appliquera obligatoirement au filtre. Si cette modalité ne peut être déterminée, alors c'est la modalité FIRST qui sera appliquée.

Ce réglage est nécessaire lorsque le résultat est potentiellement de très grande taille et conduirait à une
requête et un affichage très coûteux.

== Sélection multiple (m) ==

Si cette option est utilisée, alors il sera possible d'activer plusieurs modalités du filtre simultanément (liste à sélection multiple). Cette option est incompatible avec la précédente.

== Filtre global (g) ==

si cette options est activée, alors le filtre est marqué comme global. si plusieurs éléments de tableau de bord sont présents dans la même page d'affichage, alors tous les filtres globaux calés sur la même définition de champ seront synchronisés sur la même modalité.

== Désactivation du post-formatage (x) ==

Certaines écritures de requête <nowiki>(**)</nowiki> peuvent poser un problème pour le travail du post-formateur des requêtes de filtrage. si c'est le cas, utiliser cette option peut aider à résoudre le problème.  

==== Les sommateurs ====

Les sommateurs permettent d'exprimer directement sur l'affichage du tableau de bord des agrégations de valeurs (sommes) issues des données du résultat.

{{ :blocks:dashboard:sommateurs.png?nolink |}}

=== Champs sommateurs ===

Définit les colonnes de sortie de rquête pour lesquelles les sommes de valeur seront données.

=== Format des sommes ===

Ces champs permettent de reformater les données en sorties, selon des masques compatibles avec la fonction "sprintf".

<html><!-- nomoodle --></html>
[[http://php.net/manual/fr/function.sprintf.php|En savoir plus sur les chaînes formatées]]
<html><!-- /nomoodle --></html>

=== Titre des sommes ===

Ce champ permet de renommer les libellés affichés pour introduire les valeurs des sommateurs.


<html><!-- nomoodle --></html>
==== Notes ====

Une entrée de roadmap de développement pour proposer la combinaison "OU" est envisageable.
Il s'agit notamment des requêtes contenant des agrégats de type COUNT(*) ou similaires.

-----

====Crédits====

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



[[:blocks:dashboard:userguide|Revenir à l'index du guide de configuration]] - [[:Blocks:Dashboard|Retour à l'index du composant]] - [[:Blocks:Dashboard:QueryCatalogue|Aller au catalogue de requêtes génériques]] - [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]]

<html><!-- /nomoodle --></html>