ProxyEPN

Modifications publiées sur le svn (r378) :

Mise en place du nouveau module de stats des EPN¶

Le module est ajouté et propose plusieurs pages de statisques par le menu contextuel. Pour le moment, les premières stats disponibles sont :

• Sur les usagers : tableaux de répartition par tranches d'ages et par sexe, par niveau d'usage et par usage informatique
• Sur les formations : tableaux avec nombre de sessions, nombre d'heures, nombre d'usagers uniques, répartition H/F et répartition par age (<=25 ou non), présentés par types, organismes, financeurs ou statut des usagers.

Pour chaque page de statistique, un filtre est disponible pour choisir l'intervalle de dates et un GEPN ou un EPN.

Modifications publiées sur le svn (r379) :

Deux templates (partials) ont été élaborés pour l'affichages des tableaux de stats :

• _stats_double : Il affiche les données dans un tableau à double entrée classique. Les totaux par lignes et/ou colonnes peuvent être calculés automatiquement. Ainsi que les valeurs en pourcentage (possibilité de définir sur quel total).
• _stats_triple : Il affiche un tableau à triple entrée, les différentes lignes pouvant ainsi être regroupées en sections (les données sont un hachage à 3 niveaux). Tous les totaux et sous-totaux peuvent encore être calculés, y compris les totaux par sections, ou les totaux par colonnes et par type de lignes.

La page de statistiques sur les Ateliers est en place, avec des stats selon les thèmes et catégories d'ateliers : nombre de sessions, d'heures, d'inscrits et d'usagers

Les stats d'évolutions mensuelles font aussi leur apparition, avec pour chaque mois de la période interrogée le détail sur chaque type de sessions : nombre de session, d'heures et d'inscrits.

Les stats sur les nouveaux usagers chaque mois est quant à elle ajoutée sur la page des stats usagers.

Modifications publiées sur le svn (r380) :

Ajout de quelques stats sur la page d'accueil des statistiques : détails par EPN et GEPN sur la liste actuelle des usagers (nombres d'actifs, expirés et anonymisés).

+ correction du menu qui masquait encore l'accès aux stats.

Modifications publiées sur le svn (r394) :

Système d'export CSV des données statistiques¶

Réorganisation des données¶

La récupération des statistiques est réorganisée entre l'action et la vue :

• Les multiples tableaux d'une page sont regroupés dans un hachage unique (pouvant contenir pour chaque tableau "data", "rows", "cols" et éventuellement "grps").
• La définition de formats spécifiques pour l'affichage des cellules n'est plus faite dans l'action mais dans les templates.
• Les partials pour l'affichage des tableaux "double" ou "triple" entrée acceptent en paramètre le hachage stats pouvant fournir à la fois "data", "rows", "cols" et "grps" (l'ancien paramètre stats étant renommé data).

Intégration des exports CSV¶

La génération des CSV se fait ainsi :

• Un lien vers l'action normale, avec un paramètre supplémentaire "csv" indiquant la référence du tableau à exporter
• Dans les actions le paramètre "csv" est traité en preExecute (commun à toutes les actions)
• La valeur de "csv" peut être utilisée pour ne récupérer que les stats qui seront utilisées
• Les actions se terminent par un appel à processExport() qui regarde si un export CSV est demandé
• Si c'est le cas, cette méthode initialise l'objet CSV et change le template vers export
• Le nouveau template export s'occupe d'alimenter l'objet CSV à partir des données présentes dans le hachage
• Le template se termine en demandant l'envoi des données CSV

L'un des objectifs a été de conserver les actions d'origine et de ne pas avoir à dupliquer de code pour la partie CSV : la récupération des stats ne se fait toujours qu'à un seul endroit dans les actions concernées

L'alimentation des données CSV à partir des résultats de stats tient compte des lignes, colonnes indiquées.
Les tableaux à triple entrée sont aussi géré en transformant les groupements en colonnes supplémentaires.
Les libellés des colonnes et des lignes sont appliqués et traduits.
Une fonction picto_csv() est ajourée au helper ProxyEPN pour simplifier l'affichage du lien d'export.

Export commun pour plusieurs tableaux¶

Une page peut contenir différents tableaux, issus de différentes sources. Mais généralement la structure des colonnes est communes à ces différents résultats. Ainsi il est sensé de permettre d'exporter l'ensemble des tableaux en une seule opération, dans un unique fichier CSV.

Le paramètre "csv" peut ainsi accepter plusieurs références de tableaux, séparées par des virgules.
Chaque résultats de statistiques correspondant sera parcouru pour alimenter l'export CSV.

Nombres et localisation¶

La prise en compte de la locale pour les valeurs numérique a été ajoutée globalement au projet.
Ainsi de manière générale, les nombres décimaux sont présentés avec une virgule en séparateur (cf #71 qui soulevait le problème auparavant puis la mise en place du validator qui résoud la conversion virgule->point).

Suite à celà, une amélioration de l'objet d'export CSV lui permet de formatter les nombres décimaux :

• le booléen fFloats est activé par défaut, l'option 'rawf' permet de la désactiver si nécessaire
• il teste si les valeurs sont numériques et décimales pour les formatter avec un sprintf('%f')
• la locale s'applique et les données CSV utilisent le séparateur décimal approprié

Le nouveau module de statistiques est en place pour la version 2.0.

Son fonctionnement est validé, mais son développement continue pour compléter ou ajuster les tableaux de stats fournis.