Gestion des rapports

From Documentation de la solution web de gestion OpenFlyers
Revision as of 14:40, 12 April 2018 by imported>Claratte
Jump to navigation Jump to search

Présentation

L'objet de cette page est de présenter la gestion des rapports sur la version 4 d'OpenFlyers.

A chaque fois qu'OpenFlyers développe un nouveau rapport à la demande d'une structure, l'équipe rajoute ce rapport dans la Bibliothèque des rapports.

Nous recommandons aux clients d'éviter de développer leurs propres rapports et de faire appel à OpenFlyers afin de compléter cette liste en fonction de leurs besoins. En effet, seuls les rapports présents dans cette liste bénéficient de nos mises à jour lors d'un changement de version.

Pour les clients qui souhaiteraient développer eux-mêmes leur rapport, nous mettons à disposition la structure de la base de données.

Afficher un rapport favori

  • Aller dans Rapports ou Admin > Rapports
  • Aller dans une des catégories de rapport
  • Sélectionner un rapport à visualiser
  • Compléter le formulaire qui s'affiche
  • Appuyer sur le bouton Visualiser
  • Le contenu du rapport va s'afficher dans un nouvel onglet

Ajouter un rapport

Dans le cas où le rapport nécessite un ou plusieurs champs non présents dans la plateforme, il faut au préalable créer ce champ.

  • Côté admin, Rapports > Rapports personnalisés > Créer/Modifier
  • Tout en bas du tableau, cliquer sur le bouton Ajouter
  • Dans le champ Intitulé, saisir un texte libre permettant de décrire l'objet du rapport
  • Dans le champ Requête SQL, saisir une requête SQL permettant de générer le rapport
  • Cliquer sur le bouton Valider

Ajouter un rapport en favori

  • Côté admin, Rapports > Bibliothèque
  • Colonne "Favori"
  • Cocher les rapports à mettre en favori

Champ de saisie

Ajouter un champ dans le formulaire des rapports

Pour permettre de rajouter un paramètre pris en compte lors de la génération d'un rapport, il peut être nécessaire de rajouter un champ de saisie pour l'utilisateur lors d'une demande de rapport. Pour ce faire il faut effectuer les opérations suivantes :

  • Admin
  • Rapports > Rapports personnalisés > Champ(s) additionnel(s)
  • En bas du tableau :
    • Dans le champ vide de la colonne Nom de variable, saisir le nom de la variable sans espace et sans caractère particulier
    • Dans le champ Intitulé, saisir le nom en clair qui apparaitra dans le formulaire de saisie des rapports
    • Dans le champ Type de valeur, choisir le type en fonction du champ
    • Cocher ou non la case à cocher Remplissage obligatoire pour indiquer que le champ doit être systématiquement saisi lorsqu'il est mentionné dans la requête SQL
    • Dans le champ Valeur d'affichage maximum, si la saisie est possible, mettre la valeur maximum ou la valeur -1 s'il n'y a pas de valeur maximum
  • Cliquer sur le bouton Ajouter

Attention : cette étape doit être effectuée avant d'ajouter une requête SQL pour un rapport qui fait référence au nouveau champ.

Case à cocher Mémoriser ce choix

Cette fonctionnalité n'est présente que sur les rapports de la bibliothèque. Pour rendre visible la case à cocher Mémoriser ce choix au niveau de chaque champ du formulaire, il faut disposer du droit Gestion des rapports ou du droit Voir tous les rapports.

La case à cocher Mémoriser ce choix permet de mémoriser la sélection d'un champ dans le formulaire d'un rapport afin de simplifier une future exécution du rapport. Cette case à cocher est par défaut cochée. La mémorisation du choix n'est pas propre à un utilisateur mais à la plateforme.

Type de valeur

Configurer la mise en forme des rapports

Configurer les rapports visibles pour les utilisateurs

Pour rendre tous les rapports visibles à un profil d'utilisateurs, cela se paramètre en attribuant le droit Voir tous les rapports au profil souhaité. Les rapports seront alors visible côté admin.

Pour rendre uniquement certains rapports visibles à certains profils d'utilisateurs, il faut disposer du droit Gestion des rapports et effectuer les actions suivantes :

  • Rapports > Rapports personnalisés > Créer/Modifier ou Rapports > Bibliothèque
  • Sélectionner la check-box correspondant à l'intersection de la colonne du profil pour lequel le rapport doit être visible avec la ligne du rapport concerné

Les rapports rendus visibles pour les profils considérés sont consultables côté cahier dans le menu Données > Rapports.

Fonctionnement du moteur des rapports

Rendre des liens cliquables

Par défaut, si du contenu dans les rapports produit des liens, ceux-ci ne sont pas cliquables.

Pour que les liens le deviennent, ceux-ci doivent être sur la forme :

[LINK=lien_cliquable]Du texte[/LINK]

Par exemple :

[LINK=http://openflyers.com]Site OpenFlyers[/LINK]

Exemple de construction de lien permettant d'éditer les 50 derniers vols : <sql>SELECT CONCAT( '[LINK=index.php?menuAction=flight_record&menuParameter=', flight.id, ']Edit[/LINK]' ) AS Link, flight.* FROM flight WHERE flight.validated=0 ORDER BY flight.start_date DESC LIMIT 50</sql>