Paramétrage d'un rapport

Introduction

Les rapports dans Atimeüs sont entièrement paramétrés.

Les rapports par défaut ne sont pas modifiables, mais vous pouvez les dupliquer pour ensuite les modifier.

On commence par définir la mise en page générale du rapport, puis on ajoute des blocs d'affichage pour chaque indicateur souhaité.

La liste des indicateurs disponibles n'est pas paramétrable, il faut passer par le support pour en ajouter un nouveau. Pour la consulter, ouvrez l'adresse https://mon_instance.atimeus.app/admin/indicators (en remplaçant mon_instance par le nom de votre espace).

La liste des rapports se configure dans le menu Configuration > Avancée > Rapports.

Vous pouvez notamment :

• Gérer les catégories de rapports
• Renommer les rapports
• Ordonner les rapports
• Gérer l'affichage d'un rapport : masquer, afficher pour tous, restreindre à un groupe d'utilisateurs

Ce que chaque utilisateur voit dans un rapport dépend aussi de ses droits sur les indicateurs : voir Restreindre l'accès aux rapports par catégorie et par périmètre.

Mise en page

Un rapport est affiché comme une grille CSS :

• columnConfig définit les colonnes et leurs largeurs (`grid-template-columns`)
• rowConfig définit les lignes et leurs hauteurs (`grid-template-rows`)

Et chaque indicateur est positionné dans la grille avec columnStart | columnEnd | rowStart | rowEnd.

Comment lire les positions ?
Les valeurs Start et End représentent des lignes de grille CSS.

Avec columnStart = 1 et columnEnd = 2, l'indicateur occupe 1 colonne.

Avec columnStart = 1 et columnEnd = 4, l'indicateur occupe 3 colonnes.

Exemple :

• columnConfig = "1fr 1fr 1fr"
• rowConfig = "120px 250px 250px 250px"
• Dans ce cas, on a une grille de 3 colonnes et 4 lignes :
  • un KPI en rowStart=1, rowEnd=2, columnStart=1, columnEnd=2 est placé dans la cellule en haut à gauche
  • un graphique en rowStart=2, rowEnd=3, columnStart=1, columnEnd=4 prend toute la largeur de la ligne 2
  • ...

KPI (bloc « Indicateur »)

Affiche une valeur synthétique (taux, montant, nombre...).

Graphique

Affiche une ou plusieurs séries de valeurs en graphique (barres, lignes, camembert...).

On commence par ajouter un indicateur Graphique à la grille CSS.

Puis on lui ajoute des indicateurs.

La représentation s'adapte au type de donnée : série ou non.

Tableau

Affiche un tableau de données.

Le contenu du tableau est défini dans un tableau JSON avec une entrée par colonne :

Exemple :

[
{
    "prop":"Project",
    "label":"Projet",
    "sortable":true,
    "internalLink":"/admin/projects/{0}",
    "internalLinkParameters":["ProjectId"]
},
{
    "prop":"Division",
    "label":"Division",
    "sortable":true,
    "width":"100"
},
{
    "prop":"InvoiceTotal",
    "label":"Fact. Total",
    "sortable":true,
    "valueType":"currencyFull",
    "width":"min-content",
    "summaryType":"sum"
}
]

// affiche la valeur en color (vert) si elle est entre min et max
"ranges":[{"min": -0.01,"max": 0.01, "color": "#0f0"}]

// affiche la valeur en color (rouge) si elle est négative
"ranges": [{"max": 0, "color": "#f00"}]

// affiche la valeur en rouge/vert selon la valeur du champ Target, en dessous/au dessus
"customEditorOptions": {"type": "p-threshold", "target": "Target"}

// affiche la valeur en rouge/orange/vert si elle est en dessous de target1, entre target1 et target2, au dessus de target2
"customEditorOptions": {"type": "p-threshold-2", "target1": "0.9", "target2": "1"}        

Tableau avec séries

Affiche un tableau avec plusieurs séries de données (par mois, par catégorie).

On commence par ajouter un indicateur Tableau avec séries à la grille CSS.

Puis on lui ajoute une ou plusieurs séries de données (« Ajout d'une source de données »), avec les mêmes propriétés que les indicateurs d'un graphique : title, valueType, order…