Sommaire >
Utilisation >
Analyse >
Rapports paramétrablesRapports paramétrables

L'utilisateur peut créer ses propres rapports ou utiliser des rapports prêts à l'emploi. Les données sont extraites avec le langage SQL et affichées avec des libellés, titres, etc au choix. Le rapport peut être exporté vers Excel ou OpenOffice Calc

.
Une formation sur les rapports paramétrables est disponible sur le site Santia, rubrique Formation.
Quelle différence avec le rapport d'activité ?
Le rapport d'activité est standard et figé, alors que les rapports paramétrables permettent de créer n'importe quel rapport sur l'activité ou les dossiers.
Quelle différence avec les requêtes sur les dossiers ?
Les requêtes sur les dossiers affichent une liste de dossiers avec des données en colonne (ex. les CD4 à M6, M12). Dans les rapports paramétrés, on peut afficher ensemble plusieurs calculs (ex. la répartition homme/femme de la file active) et plusieurs listes (ex. liste des dossiers ARV avec CD4 à M6, M12 en colonne), sur toutes les données de la base.

Utilisation
Plusieurs rapports sont prêts à l'emploi, dans la liste du bas. Cliquer sur l'un d'eux pour l'installer. La liste est tenue à jour car elle est connectée au site web Santia. Une date de version est mentionnée pour chaque rapport. Pour une description des rapports (colonnes, calculs), voir
Utilisation > Analyse > Rapports paramétrables prêts à l'emploi.
Un rapport paramétrable est composé d'un titre et d'un code de paramétrage sous forme de texte en langage SQL. La modification du paramétrage est réservée à l'administrateur et requiert un mot de passe. En effet, les requêtes SQL du paramétrage peuvent modifier les données de la base en cas de mauvaise manipulation

.
Si vous ne maîtrisez pas le langage SQL (voir
Utilisation > Paramètres > SQL), contactez-nous pour recevoir un rapport prêt à l'emploi, réalisé selon vos souhaits.
Si le rapport contient plus de 1000 lignes (ex: liste des dossiers), cocher la case Sortie fichier. Un nom de fichier sera demandé à la fin de l'extraction pour enregistrer le rapport au format CSV. Utiliser Excel ou OpenOffice Calc pour visualiser ce fichier (dans ce cas, le rapport ne sera pas affiché dans Santia).

Utilisation technique
Si vous connaissez le langage SQL et la structure de la base de données (voir
Annexes > Structure de la base de données), vous êtes à même de créer vos propres paramétrages:
Le paramétrage comporte 3 parties: saisie, sql et affichage. Cet ordre doit être respecté.

La partie saisie est facultative. Elle permet de demander à l'utilisateur d'entrer des informations pour l'exécution du rapport, par ex. la période sur laquelle le rapport doit être calculé. Elle commence par la ligne #### saisie ####. Chaque ligne suivante définit un champ de saisie. Ex. la ligne:
Début de la période|debut_periode|date|01/01/2009
affiche un champ de saisie intitulé Début de la période. La valeur saisie par l'utilisateur est placée dans la variable libre (sans espace) debut_periode pour être utilisée dans les requêtes SQL plus bas. Les types de variable possibles sont: date, nombre et texte. Enfin on peut paramétrer une valeur par défaut du champ de saisie. Ces informations sont séparées par le signe |. Exemple sans valeur de date par défaut: Début de la période|debut_periode|date|

La partie sql commence par la ligne #### sql ####. Cette partie est une suite non limitée de requêtes SQL (une seule requête par ligne). Lorsque qu'une requête SELECT renvoit une valeur (une valeur seule ou un tableau de valeurs), la valeur peut être récupérée dans une variable libre (sans espace), sous la forme suivante:
nombre_dossier<-SELECT COUNT(*) FROM Doss
liste_dossier<-SELECT Ref_ FROM Doss

Dans la partie affichage, on forme le rapport en saisisant des libellés, titres, etc. et les noms des variables. Dans le rapport, les noms des variables seront remplacés par leur valeur (valeur seule ou tableau de valeurs). On peut placer titres et variables en colonne en les séparant par |. Un grand nombre de lignes peuvent être créées.

Dans la partie sql, laisser un espace autour des variables (ex. "...WHERE OuvrDat_ > debut_periode" et non pas "...WHERE OuvrDat_ >debut_periode").
Dans la partie affichage, la ligne ou la colonne qui contient la variable ne doit pas contenir d'autre texte (ex. "Nombre de dossiers ouverts depuis le|debut_periode" et non pas "Nombre de dossiers ouverts depuis le debut_periode").
Enfin, ne pas créer des noms de variable qui entrainent la confusion avec d'autres mots de la partie sql (dont les mots réservés au SQL).
Un rapport multi-sites (c'est-à-dire un rapport lancé en sélectionnant Tous les sites sur le Menu général) fait la somme de ce rapport pour chaque site. Ne pas calculer de pourcentages car ils seront additionnés et donc incohérents (exporter le rapport vers Excel ou OpenOffice Calc et calculer les pourcentages dans le tableur).
Astuce pour un rapport multi-sites: utiliser DATABASE() pour afficher le nom du site, par exemple dans une liste de dossiers (voir la liste des dossiers dans les rapports prêts à l'emploi).
Exemple de paramétrage (la variable est affichée sous le titre/libellé):
#### sql ####
nb_doss<-SELECT COUNT(*) FROM Doss
#### affichage ####
Nombre de dossiers :
nb_doss
Variante de l'exemple (la variable est affichée à droite du titre/libellé, en colonne):
#### sql ####
nb_doss<-SELECT COUNT(*) FROM Doss
#### affichage ####
Nombre de dossiers|nb_doss
Exemple avec une partie saisie:
#### saisie ####
Début de la période|debut_periode|date|01/01/2009
#### sql ####
nb_doss<-SELECT COUNT(*) FROM Doss WHERE OuvrDat_ > debut_periode
#### affichage ####
Nb de dossiers ouverts depuis |debut_periode
nb_doss
Exemple pour une liste:
#### sql ####
list_doss<-SELECT Ref_ FROM Doss
#### affichage ####
Liste des dossiers :
list_doss
Vous pouvez aussi vous inspirer ou reprendre et modifier les rapports prêts à l'emploi:
Utilisation > Analyse > Rapports paramétrables prêts à l'emploi.
D'autres exemples de rapports sont fournis dans la rubrique formation du site santia.org.
L'affichage d'une valeur sous forme de liste nécessite la version Santia 01/09/2010 ou ultérieure.