Documentation

Cookies & confidentialité

Nous utilisons des cookies pour vous garantir la meilleure expérience sur notre site. Vous pouvez modifier vos préférences à tout moment depuis le pied de page.

Les filtres

Les filtres déterminent quelles données sont incluses dans votre rapport. Ils s'appliquent avant tout le reste : seuls les objets qui passent les filtres apparaissent dans le tableau final.

Introduction

Un filtre est une condition que chaque objet doit respecterpour être inclus dans le rapport. Si l'objet ne satisfait pas la condition, il est simplement exclu — il n'apparaît pas dans le tableau.

Les filtres portent sur les données des objets, pas sur les colonnes. Filtrer sur "statut = Réglé" ne masque pas une colonne — cela exclut du rapport toutes les factures qui ne sont pas au statut Réglé.

Analogie

Pensez aux filtres comme au tamis d'une passoire : vous versez toutes vos données dedans, et seules celles qui correspondent à vos critères passent au travers pour alimenter le tableau.

Statique vs dynamique

Il existe deux modes pour un filtre, selon le moment où la valeur est fournie :

Filtre statique

La valeur est définie une fois pour toutes lors de la création du rapport. Elle ne change jamais, quelle que soit la personne qui génère le rapport ou le moment de la génération.

Quand l'utiliser : Pour des conditions permanentes qui font partie de la définition même du rapport.

Exemples :
  • Statut = "Réglé" → le rapport ne montrera jamais que les factures réglées
  • Module = "Achats" → uniquement les objets du module Achats
  • Archivé = Non → exclure tous les éléments archivés

Filtre dynamique

La valeur est saisie par l'utilisateur à chaque génération. Avant d'afficher le tableau, Miel affiche un formulaire avec les filtres dynamiques à renseigner.

Quand l'utiliser : Pour des paramètres qui varient selon les besoins du moment.

Exemples :
  • Période entre [date de début] et [date de fin]
  • Fournisseur = [à saisir]
  • Commercial = [à sélectionner]
StatiqueDynamique
Valeur définieÀ la création du rapportÀ chaque génération
Saisie utilisateurNonOui
Valeur par défautPossible (pré-rempli)
Cas d'usageConditions permanentesParamètres variables

Les opérateurs

L'opérateur définit la nature de la comparaison entre le champ de l'objet et la valeur du filtre. Voici les opérateurs disponibles :

OpérateurSignificationExemple concret
Est égal àLa valeur du champ correspond exactementStatut est égal à "Réglé"
Est inférieur àLa valeur est strictement inférieureMontant inférieur à 1 000 €
Est inférieur ou égal àLa valeur est inférieure ou égaleMontant inférieur ou égal à 1 000 €
Est supérieur àLa valeur est strictement supérieureMontant supérieur à 10 000 €
Est supérieur ou égal àLa valeur est supérieure ou égaleMontant supérieur ou égal à 10 000 €
Est entreLa valeur est comprise dans un intervalle (bornes incluses)Date entre le 01/01/2025 et le 31/12/2025
Est dans la listeLa valeur fait partie d'une liste de valeurs autoriséesStatut est dans ["En cours", "En attente"]
N'est pas dans la listeLa valeur ne fait partie d'aucune valeur de la listeStatut n'est pas dans ["Archivé", "Annulé"]
ExisteLe champ est renseigné (non vide)Responsable existe (factures avec un responsable assigné)

Requis vs optionnel

Pour les filtres dynamiques, vous pouvez indiquer si le filtre est requis ou optionnel.

Filtre requis

L'utilisateur doit renseigner ce filtre avant que la génération ne puisse démarrer. Si la valeur n'est pas fournie, le bouton "Générer" reste désactivé.

Exemple : Un rapport de chiffre d'affaires annuel avec un filtre dynamique "Année" requis — impossible de générer sans indiquer l'année souhaitée.

Filtre optionnel

L'utilisateur peut laisser le filtre vide. Dans ce cas, le filtre est ignoré et toutes les valeurs sont incluses pour ce critère. Vous pouvez définir une valeur par défaut qui pré-remplit le champ.

Exemple : Un filtre "Fournisseur" optionnel avec valeur par défaut vide — si l'utilisateur ne choisit pas de fournisseur, toutes les factures apparaissent.

Combiner plusieurs filtres

Quand vous ajoutez plusieurs filtres à un rapport, ils se combinent selon des règles simples :

Filtres sur des champs différents → ET

Si vous filtrez sur le statut ET sur la date, un objet doit satisfaire les deux conditions pour être inclus.

Statut = "Réglé" ET Date de paiement entre le 01/01 et le 31/12
→ Seules les factures réglées dans la période apparaissent.

Filtres sur le même champ → OU

Si vous définissez deux filtres sur le même champ, un objet suffit de satisfaire l'un ou l'autre.

Statut = "Réglé" OU Statut = "Partiellement réglé"
→ Les factures dans l'un ou l'autre statut sont incluses.
(Équivalent à utiliser l'opérateur "Est dans la liste" avec les deux valeurs)

Champs particuliers

Certains types de champs ont des comportements spécifiques lors du filtrage :

Type de champParticularité
DateVous pouvez préciser la granularité : jour exact (01/01/2025) ou année (2025). L'opérateur "Est entre" est particulièrement utile pour les plages temporelles.
Référence vers un autre objetLe filtre porte sur l'identifiant de l'objet référencé. Par exemple, filtrer les factures d'un fournisseur précis revient à filtrer sur l'ID du fournisseur.
UtilisateurFiltrage sur un ou plusieurs utilisateurs du système. Utile pour "uniquement mes factures" ou "les dossiers de l'équipe X".
Champ de l'objet parentPour certains objets liés (ex : lignes d'une note de frais), vous pouvez filtrer sur un champ de l'objet parent. Exemple : lignes de NDF dont la NDF parente est au statut "Validé".

Bonnes pratiques

Documentez vos filtres dynamiques

Renseignez la description du rapport pour expliquer quels filtres dynamiques l'utilisateur devra renseigner et ce qu'ils représentent. Évitez les surprises au moment de la génération.

Définissez des valeurs par défaut pertinentes

Pour les filtres dynamiques, proposez une valeur par défaut réaliste (ex : l'année courante pour un filtre d'année). Cela accélère la génération pour les cas les plus fréquents.

Préférez "Est dans la liste" aux filtres multiples

Pour filtrer sur plusieurs valeurs d'un même champ, utilisez l'opérateur "Est dans la liste" plutôt que d'ajouter plusieurs filtres. Le résultat est identique mais la configuration est plus lisible.

Prochaine étape

Maintenant que vous maîtrisez les filtres, découvrez comment configurer les colonnes de votre rapport.