Créer un rapport
La création d'un rapport se fait en 6 étapes guidées. Chaque étape vous permet de configurer un aspect précis de votre rapport. Vous pouvez revenir en arrière à tout moment avant de sauvegarder.
Introduction
Pour illustrer ce guide, nous allons créer ensemble un rapport de suivi des factures fournisseurs. L'objectif : lister toutes les factures réglées sur une période donnée, avec le fournisseur, le montant HT et la date de paiement.
Pour commencer, rendez-vous dans la section Rapports de votre module, puis cliquez sur Créer un rapport. L'assistant s'ouvre.
Les 6 étapes
- Informations — nommer et décrire le rapport
- Source de données — choisir le type d'objet analysé
- Filtres — limiter les données incluses
- Colonnes — choisir les informations affichées
- Transformations — restructurer les données (optionnel)
- Aperçu — vérifier et sauvegarder
Étape 1 — Informations
La première étape consiste à identifier votre rapport. Vous renseignez :
| Champ | Rôle | Obligatoire |
|---|---|---|
| Nom | Identifiant technique unique du rapport (sans espaces, sans accents). Utilisé dans les intégrations. | Oui |
| Titre | Nom affiché dans l'interface, lisible par les utilisateurs. Peut contenir des espaces et accents. | Oui |
| Description | Explication du contenu et de l'usage du rapport. Très utile pour les rapports à filtres dynamiques. | Non |
| Tags | Mots-clés pour organiser et retrouver vos rapports. | Non |
Notre exemple
Nom : facturesFournisseursReglees
Titre : Factures fournisseurs réglées
Description : Liste des factures fournisseurs réglées sur une période. La période est à saisir à chaque génération.
Nom vs Titre
Le nom est un identifiant technique : une fois créé, il est difficile à changer sans risquer des impacts. Le titre, lui, peut être modifié librement — c'est ce que voient vos utilisateurs. Choisissez un nom court et descriptif dès le départ.
Étape 2 — Source de données
La source de données est le type d'objet sur lequel porte votre rapport. C'est la matière première : Miel va récupérer tous les objets de ce type (selon les filtres de l'étape suivante) et en faire les lignes de votre tableau.
Vous choisissez dans la liste des types d'objets disponibles dans votre module : factures, projets, clients, notes de frais, bons de commande, etc.
Notre exemple
Nous choisissons Facture fournisseur. Chaque ligne du rapport correspondra à une facture fournisseur dans Miel.
Attention
La source de données ne peut pas être changée après la création du rapport. Si vous vous trompez de type d'objet, vous devrez créer un nouveau rapport.
Étape 3 — Filtres
Les filtres déterminent quels objets sont inclus dans le rapport. Sans filtre, le rapport affiche tous les objets du type choisi. Avec des filtres, vous pouvez restreindre aux objets qui vous intéressent vraiment.
Deux types de filtres
Filtre statique
La valeur est définie une fois à la création du rapport et ne change plus. Idéal pour des conditions permanentes : "toujours filtrer sur le statut Réglé", "uniquement les factures d'un fournisseur précis".
Filtre dynamique
La valeur est saisie par l'utilisateur à chaque génération du rapport. Idéal pour des paramètres variables : "la période à analyser","le fournisseur à isoler". Le rapport affiche un formulaire de saisie avant de générer le tableau.
Notre exemple
Nous ajoutons deux filtres :
- Statut = Réglé (statique) — seules les factures réglées apparaissent
- Date de paiement entre [début] et [fin] (dynamique) — l'utilisateur saisit la période à chaque génération
Pour le détail de tous les opérateurs disponibles (égal à, entre, dans la liste...) et les options avancées, consultez la page dédiée.
Documentation complète des filtres →Étape 4 — Colonnes
Les colonnes définissent ce qui s'affiche dans chaque colonnedu tableau final. Vous créez autant de colonnes que nécessaire et vous définissez pour chacune son libellé et sa source de données.
Trois façons de définir une colonne
Par champ direct
La colonne affiche directement la valeur d'un champ de l'objet : la date de création, le montant, le statut, l'utilisateur assigné... C'est le type de colonne le plus simple.
Par formule
La colonne affiche une valeur calculée par une expression MEL : accéder au nom d'un objet lié (ex : le nom du fournisseur depuis la facture), extraire le mois d'une date, concaténer plusieurs champs...
Par valeur calculée
La colonne n'a pas de source directe — elle est remplie par une transformation (ex : une colonne "Total" alimentée par la somme des montants d'un groupe). Ce type s'utilise avec les transformations.
Notre exemple
Nous créons quatre colonnes :
- Fournisseur — par formule : nom du fournisseur lié à la facture
- Date de paiement — par champ direct : date de paiement
- Montant HT — par champ direct : montant hors taxes
- N° facture — par champ direct : numéro de pièce
Pour le détail des types de colonnes, du formatage (devises, précision) et de l'ordre d'affichage, consultez la page dédiée.
Documentation complète des colonnes →Étape 5 — Transformations optionnel
Les transformations permettent de restructurer les lignes et les colonnesdu tableau après que les données ont été récupérées. Cette étape est entièrement optionnelle — un rapport simple n'en a pas besoin.
Parmi les transformations disponibles :
- Groupement : regrouper les lignes par valeur (ex : toutes les factures d'un même fournisseur ensemble)
- Scission : transformer une ligne en plusieurs (ex : une facture → trois écritures comptables)
- Résumé : ajouter des lignes de total (par groupe ou global)
- Tri : classer les lignes par une colonne
- Pivot : faire pivoter les données (les valeurs d'une colonne deviennent des en-têtes)
Notre exemple
Pour notre rapport de factures fournisseurs, nous n'ajoutons pas de transformation — le tableau brut est suffisant. Nous passons directement à l'étape suivante.
Pour le détail de toutes les transformations disponibles avec des exemples concrets avant/après, consultez les pages dédiées.
Étape 6 — Aperçu
La dernière étape vous présente un aperçu en temps réel de votre rapport avec les données actuelles de votre système. C'est l'occasion de vérifier que tout est correct avant de sauvegarder.
Ce que vous pouvez vérifier
Les colonnes
Les libellés sont-ils clairs ? Les bonnes informations apparaissent-elles dans les bonnes colonnes ? Les montants sont-ils correctement formatés ?
Les filtres
Le nombre de lignes est-il cohérent avec ce que vous attendez ? Si vous avez des filtres dynamiques, l'aperçu utilise les valeurs par défaut que vous avez configurées.
Les transformations
Si vous avez configuré des regroupements ou des totaux, vérifiez que la structure du tableau est bien celle que vous souhaitez.
Une fois satisfait, cliquez sur Sauvegarder pour enregistrer le rapport. Il apparaît ensuite dans la liste des rapports du module, prêt à être généré par vos utilisateurs.
Rapport avec filtres dynamiques
Si votre rapport contient des filtres dynamiques, testez l'aperçu en saisissant des valeurs représentatives. L'aperçu de la page 6 vous permet de simuler une génération réelle.
Prochaine étape
Votre rapport est créé. Approfondissez chaque concept pour tirer le meilleur parti des fonctionnalités avancées.