Différences

Ci-dessous, les différences entre deux révisions de la page.

--- boards:design:rendering [2019/12/08 08:48] – [Formats supportés] admin
+++ boards:design:rendering [2025/12/10 16:16] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 64: / Ligne 64: @@
 Le HtmlPanel assemble des Widgets et des Panels en une structure de panneaux imbriqués pour assembler les différentes vues d'indicateurs ensemble.
+==== Rendering ====
+Le widgets reçoivent des données à publier sous différents affichages, formats ou représentation. Le responsable de la transformation des données brutes en une représentation affichable dans le widget (ou la sortie) est un Renderer.
+Les Renderers seront en général responsables de la mobilisation de librairies spécifiques pour l'affichage sous les divers formats demandés comme des indicateurs graphiques, des graphes de données, des sorties XML ou Json.
+Ils reçoivent des données et ont une configuration d'instance permettant de modifier localement certains aspects du rendu (par exemple les listes de couleurs pour une représentation en camembert). Les instances de renderers sont donc stockées dans la base de données Boardz.
+Les données qui sont reçues doivent respecter une certaine construction selon leur structure, afin de faciliter le travail des développeurs de Renderers. le chapitre ci-après donne le détail de ces règles.
+==== Interface d'entrée de données ====
+Les données fournies aux Renderers doivent respecter certains formats de construction en fonction de l'arité des données. On parlera désormais de "Résultat".
+L'objectif de cette desctription est de pouvoir faire effectuer des contrôles de cohérence dans les assemblages et les formules d'indicateurs et prévenir l'administrateur de statistiques lorsqu'il essaie de combiner ou de calculer des éléments non compatibles, par exemple :
+   - des arités différences ou non combinables (par exemple, ajouter scalairement un entier et un tableau)
+   - des arités similaires mais aux dimensions ou unités différentes et non compatibles
+=== Résultat scalaire ===
+La donnée est une valeur scalaire numérique sans dimension (la dimension à afficher sera choisie comme option d'instance des Renderers associés. Elle peut également être associée comme métadonnée).
+Le type de donnée est en général un "numeric" décimal.
+Exemple de structure résultat :
+    $data = [
+        'data' => value,
+        'dimensions' => [
+            'users'
+        ]
+    ];
+Dénotera explicitement d'un comptage d'utilisateurs.
+=== Tableau indexé ===
+Un tableau indexé donne un ensemble de résultats scalaires dans un vecteur "indexé". Il est représenté par un
+tableau associatif :
+   <index> => <valeur>
+L'arité est de 1.
+Exemple de structure résultat :
+   $data = [
+       'data' => [
+=> 12,
+=> 22,
+=> 10
+=> 43
+       ],
+       'dimensions' => [
+           'courseid',
+           'users'
+       ],
+       'arity' => 1,
+       'aritycounts' => [
+       ]
+   ]
+Les dimensions basés sur des "id" (userid, courseid, coursecatid, cohortid, roleid, sectionid, etc.) doivent impérativement contenir des indices "locaux" au Boardz, et disposer d'une table de translation vers des noms lisibles.
+Cas particulier du tableau indexé : Données d'une courbe.
+Les données de courbe sont des résultats indéxés par une séquence continue non dimensionée (0, 1, 2, 3, etc) ou par des étiquettes temporelles pour les courbes temporelles (153421123, 153421134, 153421148 pour des timestamps unix, '2019/03/12', '2019/04/20', '2019/04/28' ou autre format pour des expressions de date).
+Des codes de dimension spécifiques pourront être utilisés :
+^ Code de dimension ^ Type d'index ^
+| seq | Index numérique séquentiel |
+| timestamp | Timestamp unix |
+| time | Expression de date interprétable |
+| time(yyyy/mm/dd) | Expression de date avec explicitation du format |
+=== Résultat matriciel ===
+Un tableau matriciel est in tableau indexé à 2, 3 ou N dimensions. Chaque niveau du tableau représente une dimension de la matrice.
+Exemple de matrice :
+    $data = [
+        'data' => [
+=> [
+=> 10,
+=> 0
+=> 12
+           ],
+=> [
+=> 2,
+=> 0
+=> 16
+           ],
+=> [
+=> 0,
+=> 0,
+=> 0
+           ],
+        'dimensions' => [
+            'courseid',
+            'userid',
+            'undef'
+        ],
+        'arity' => 2,
+        'aritycounts = [
+,
+        ],
+    ];
+Une matrice doit fournir toutes les valeurs d'indice dans chaque dimension (elle ne doit pas être dégradée vers un arbre).
+les matrices sont transposables et sont équivalentes lorsque les dimensions sont interchangées.
 ----
 [[:boardz:design|Revenir au sommaire de la conception]] - [[:start|Revenir au sommaire général]]