Une condition est un filtre interactif.
Eléments clés :
Sauvegarde des valeurs sélectionnées :
- Lors de la première ouverture du tableau de bord dans Center, les conditions sont chargées avec leurs valeurs par défaut.
- Lors des prochaines ouvertures, les conditions sont chargées avec leurs dernières valeurs sélectionnées.
- Si la valeur par défaut est dynamique (formule MyReport), elle est recalculée à chaque ouverture, sauf si une autre valeur est sélectionnée.
- Il est possible de réinitialiser une condition (ou toutes les conditions) à sa valeur par défaut.
- Une condition avec la valeur "(Tout)" ne sera pas prise en compte pour le calcul d'un rapport.
- Si un rapport utilise plusieurs conditions, il sera filtré en tenant compte de chaque condition (opérateur "ET")
Il est possible de lier une condition à une autre
- Dans ce cas, il peux être intéressant de rendre le rafraichissement du tableau bord manuel, pour ne pas recalculer tout le tableau de bord avec des conditions qui ne sont pas encore synchronisées.
Cette condition propose à l'utilisateur une liste contenant les valeurs de ce champ.
Les deux types de sélections sont :
- Sélection multiple : permet la sélection de plusieurs valeurs (Opérateur "OU" entre chaque valeur)
Sélection unique :· permet la sélection d'un seul élément de la liste, cette sélection nécessite de choisir une valeur par défaut pour l'initialisation
- Avec "(tout)" : la valeur (tout) est aussi présente dans la liste des filtres et permet de ne pas filtrer sur la condition
Par défaut, les listes permettent d'afficher 50 valeurs distinctes simultanément. Cette limite du nombre d'occurrences visibles est éditable dans les paramètres avancés des conditions.
A l'initialisation, les valeurs par défaut (ou les valeurs précédemment sélectionnées) sont affichées, et enfin, complétées par une requête du champ pour afficher les 50 premières valeurs.
Lors d'une recherche, une nouvelle requête est effectuée. Cette dernière ne peut renvoyer que les 50 premières valeurs correspondant à la recherche.
Lorsque la requête génère plus de 100 éléments, un pictogramme apparaît. Le nombre total de données est affiché au survol de la liste.
Nombre d'occurrences visibles· :
- Cette option permet d'afficher à l'ouverture de la fenêtre des conditions le nombre de valeurs choisies.
- Il est possible de forcer l'utilisateur à choisir une valeur, dans ce cas, une valeur par défaut est obligatoire.
La valeur "Tout" applique les filtres de la condition
- Par défaut, la valeur (Tout) d'une condition applique tous les filtres de la condition aux rapports.
- Il est possible de désactiver ce comportement en décochant la propriété "La valeur (Tout) applique les filtres de la condition".
Les valeurs par défaut peuvent être sélectionnés à partir d'une liste de valeurs du champs choisi en condition ou par formule MyReport. Le type de valeur par défaut dans la liste varie en fonction du type de champ (date, date et heure, valeur)
Cette fenêtre permet de :
- Sélectionner une valeur parmi la liste complète des valeurs du champ qui sera appliquée par défaut au chargement du tableau de bord.
Cette option spécifie si les valeurs sur les tableaux de bord seront mises à jour de manière automatique ou manuelle à chaque validation d'une condition dans MyReport Center.
Le calcul automatique est activé par défaut.
En cas de d'activation:
- Lorsque l'utilisateur clique sur le bouton Valider de sa condition tous les tableaux de bords sont rafraichis.
En cas de désactivation :
La mise à jour des rapports ne s'effectue que lorsque l'utilisateur clic sur le bouton "Appliquer" dans les conditions.
Astuce
Le bouton "Appliquer" dans les conditions dans MyReport Center ne s'affiche que si le tableau de bord contient au minimum deux conditions.
Il est possible de paramétrer les conditions d'un tableau de bord en ajoutant un paramètre "conditions" ayant pour valeur un objet JSON constitué de couples "nom de la condition": ["valeurs"].
Le tableau doit être encodé en base 64.
Si des conditions sont passées via URL, elles s'appliquent en priorité aux dernières valeurs choisies par l'utilisateur ou aux valeurs par défaut de la condition.
Exemple :
Si l'on veut affecter la condition "Année" à 2019 et 2020 et la condition "Client" à "MyReport", il faut créer le tableau suivant :
{ "Année": ["2019", "2020"], "Client": ["MyRrapport] }
Encoder le tout en base 64 et l'ajouter à l'URL:
http://localhost:8080/project/{projectName}/dashboard/{dashboardId}/view?conditions=eyAiQW5uw6llIjogWyIyMDE5IiwgIjIwMjAiXSwgIkNsaWVudCI6IFsiUmVwb3J0IE9uZSJdIH0Important
Règles à respecter
- Le dernier couple "nom de la condition": ["valeurs"] ne doit pas avoir de virgule à la fin
- Il ne doit pas y avoir de retour chariot dans le JSON pour l'encoder
Exemple de site pour encoder : https://www.base64encode.org/ (il faut cocher la case "Perform URL-safe encoding (uses Base64URL format).")
Une condition peut être affectée à un ou plusieurs rapports directement depuis l'interface principale de MyReport Page.
Pour cela, il faut sélectionner une condition, puis cocher les rapports qui doivent en tenir compte. Pour les rapports de type Multi-rapport (comme les KPI), il est possible de choisir sur quel sous-rapport la condition s'applique.
La liste des conditions appliquées à un rapport est visible dans un onglet "Filtres du tableau de bord" au niveau des filtres quand le rapport est en édition.
Attention
Ce système possède plusieurs limitations :
- Le modèle utilisé dans la condition doit être le même que le modèle du rapport à conditionner.
- Le champ utilisé dans la condition est aussi le champ filtré dans le rapport.
- Le filtre définit est du type "Égal à".
Astuce
Pour utiliser un autre type de filtre ("Supérieur à", "Commence par", "Compris entre", …), ou sur un autre champ, il faut définir un filtre dynamique classique en éditant le rapport.
Le glossaire permet de renseigner une définition pour un mot.
Il est possible de spécifier sur quelle page le mot sera affiché.
