# Une zone de recherche qui filtre le rapport : prise en main de Text Plume

> Prise en main de Text Plume : tapez quelques lettres pour filtrer le rapport, accents ignorés, suggestions surlignées, et choisissez la colonne cherchée avec des puces.

- Language: French
- Web page: https://plumevisuals.com/fr/tutoriels/text-plume-prise-en-main
- Published: 2026-10-20
- Visual: Text Plume, technical reference: https://plumevisuals.com/ai/visuals/text-slicer.md
- If an option name in this tutorial differs from the technical reference, the reference is right (it is generated from the visual's code).

## En bref

- **Ce que fait le visuel.** Text Plume est un segment en **zone de recherche** : vous tapez quelques lettres, et le rapport ne garde que les valeurs qui les contiennent. Pensez à la barre de recherche de votre messagerie : « dupre » retrouve « Boulangerie Dupré », sans se soucier des majuscules ni des accents. Avec deux colonnes, des **puces** sous la zone choisissent celle où chercher (Client ou Ville).
- **Quand l'utiliser.**
  - Quand la liste des valeurs est trop longue pour être cochée : des milliers de clients, de numéros de commande ou de références.
  - Pour retrouver une valeur dont on ne connaît qu'un morceau (« lyon » dans « Atelier Lyonnais » et « Café de Lyon »).
  - Pour chercher dans une colonne puis dans une autre, sans deux segments côte à côte.
- **Quand préférer autre chose.** Pour cocher des valeurs dans une liste ou un menu, prenez Basic Slicer Plume ; pour voir le poids de chaque valeur avec des barres, Bar Slicer Plume ; pour une plage de nombres ou de dates, Range Plume, Period Plume ou Date Picker Plume.
- **À la fin de ce tutoriel, vous saurez :**
  - filtrer le rapport en tapant dans la zone ;
  - utiliser les suggestions au clavier ;
  - chercher dans deux colonnes avec les puces ;
  - lire la ligne d'information et le décompte de l'en-tête ;
  - comprendre ce que le segment filtre, et quand.
- **Ce qu'il vous faut.** Power BI Desktop récent, le visuel Text Plume installé (voir [les bases communes](/fr/tutoriels/bien-demarrer-visuels-plume)), une ou deux colonnes de texte à chercher.

### Un segment, qu'est-ce que c'est ?

Un **segment** (*slicer* en anglais) est un visuel qui ne montre pas de chiffres : il sert à **filtrer** les autres visuels de la page. Un **filtre** (voir le [glossaire](/fr/tutoriels/bien-demarrer-visuels-plume#glossaire)) limite les données prises en compte : si vous tapez « cafe » dans la zone, chaque graphique de la page ne calcule plus que les commandes des clients dont le nom contient « café ». Zone vide, la page montre tout.

Ce qu'il faut retenir du comportement de Text Plume :

- **Il filtre les colonnes placées dans Champs à rechercher.** Le filtre garde les valeurs de la colonne qui correspondent au texte tapé ; les autres visuels se recalculent sur ces valeurs.
- **Il compare comme un humain.** Par défaut, la casse (majuscules et minuscules) et les accents sont ignorés : « Rosch » trouve « Rösch », « peri » trouve « Périgueux ».
- **Il choisit lui-même le filtre le plus solide.** Quand c'est possible, il envoie à Power BI une **condition** (« contient cafe »), valable sur toutes les lignes du modèle. Sinon (accents qui changent le résultat, « Finit par », plusieurs colonnes à la fois…), il envoie la **liste des valeurs trouvées** parmi les lignes chargées, jusqu'à 100 000. Vous n'avez rien à régler : le résultat est le même.
- **Les autres visuels le filtrent.** Si un autre segment choisit la ville « Paris », les suggestions ne proposent plus que des clients parisiens. C'est le **filtre croisé** (voir le [glossaire](/fr/tutoriels/bien-demarrer-visuels-plume#glossaire)).
- **Le texte tapé est gardé avec le filtre.** Un signet, un retour sur la page ou la réouverture du rapport rendent le texte tel que vous l'aviez tapé (voir les [cas pratiques](/fr/tutoriels/text-plume-cas-pratiques)).

## Les données à fournir

Le visuel a besoin d'**une colonne** (voir le [glossaire](/fr/tutoriels/bien-demarrer-visuels-plume#glossaire)), ou de **deux** pour choisir où chercher avec les puces. Ce doivent être de vraies colonnes de table, pas des mesures : c'est sur elles que porte le filtre. Les colonnes peuvent venir de la même table ou de tables reliées (une table Clients reliée à la table Commandes, par exemple). Les nombres et les dates sont acceptés : le visuel compare alors le texte à leur libellé.

Aucune mesure n'est nécessaire : Text Plume ne calcule rien, il cherche. Votre table peut compter une ligne par commande : le visuel regroupe lui-même les valeurs identiques.

Jeu de données d'exemple : les commandes d'un grossiste (données fictives), une ligne par commande.

| Commande | Client | Ville | Montant |
|---|---|---|---|
| FR-1042-2026 | Boulangerie Dupré | Périgueux | 420 |
| FR-1043-2026 | Café du Port | Nantes | 180 |
| FR-1051-2026 | Rösch et Fils | Strasbourg | 960 |
| FR-1052-2026 | Atelier Lyonnais | Lyon | 310 |
| BE-2001-2026 | Brasserie de Liège | Liège | 540 |
| FR-1060-2026 | Épicerie du Nord | Lille | 275 |
| FR-1061-2026 | Hôtel Saint-Front | Périgueux | 1200 |
| CH-3005-2026 | Fromagerie du Léman | Genève | 640 |
| FR-1070-2026 | Café de Lyon | Paris | 150 |
| FR-1071-2026 | Librairie Parisienne | Paris | 390 |

Le même jeu, prêt à coller : **Modélisation › Nouvelle table**, puis collez la formule.

```dax
Commandes =
DATATABLE (
    "Commande", STRING,
    "Client", STRING,
    "Ville", STRING,
    "Montant", INTEGER,
    {
        { "FR-1042-2026", "Boulangerie Dupré", "Périgueux", 420 },
        { "FR-1043-2026", "Café du Port", "Nantes", 180 },
        { "FR-1051-2026", "Rösch et Fils", "Strasbourg", 960 },
        { "FR-1052-2026", "Atelier Lyonnais", "Lyon", 310 },
        { "BE-2001-2026", "Brasserie de Liège", "Liège", 540 },
        { "FR-1060-2026", "Épicerie du Nord", "Lille", 275 },
        { "FR-1061-2026", "Hôtel Saint-Front", "Périgueux", 1200 },
        { "CH-3005-2026", "Fromagerie du Léman", "Genève", 640 },
        { "FR-1070-2026", "Café de Lyon", "Paris", 150 },
        { "FR-1071-2026", "Librairie Parisienne", "Paris", 390 }
    }
)
```

> **Warning:** **Attention** : si Power BI refuse les virgules de la formule, votre Desktop utilise les séparateurs DAX régionaux (`;` entre les arguments). Remplacez les virgules par des points-virgules, ou changez le réglage des séparateurs DAX dans les options de Power BI Desktop.

La mesure à créer pour voir l'effet du filtre (**Modélisation › Nouvelle mesure**, table `Commandes` sélectionnée) :

```dax
// CA : le chiffre d'affaires des commandes gardées par le filtre.
// SUM additionne la colonne Montant des lignes visibles :
// tapez « cafe » et il ne reste que Café du Port (180) et Café de Lyon (150), soit 330.
CA = SUM ( Commandes[Montant] )
```

Pièges de préparation :

- **Une mesure dans Champs à rechercher** : Power BI la refuse ; seules des colonnes y vont.
- **Colonne numérique ou de dates** : acceptée, mais le visuel compare le texte au libellé affiché (« 1200 », « 15/03/2026 ») et envoie toujours la liste des valeurs trouvées.
- **Beaucoup de lignes** : au-delà de 100 000 lignes chargées, une recherche qui doit passer par la liste des valeurs le signale (« Recherche sur les N premières lignes chargées »). Une recherche « contient » ou « commence par » simple, sur une seule colonne de texte, n'a pas cette limite.
- **Valeurs vides** : une cellule sans contenu s'affiche « (Vide) » dans les suggestions (libellé réglable dans **Format › Résultats**).
- **Deux colonnes qui ne sont pas reliées** : si `Client` et `Ville` viennent de deux tables sans relation, Power BI ne sait pas les croiser ; placez-les dans la même table ou reliez les tables.

## Pas à pas : votre premier Text Plume en 10 minutes

1. Dans le ruban, **Modélisation › Nouvelle table** : collez la formule `Commandes = DATATABLE(...)` de la partie [« Les données à fournir »](#les-donnees-a-fournir) et validez. La table `Commandes` apparaît dans le volet **Données**.
2. Sélectionnez la table `Commandes`, puis **Modélisation › Nouvelle mesure** : collez `CA = SUM ( Commandes[Montant] )` et validez.
3. Dans le volet **Visualisations**, insérez un **Tableau** natif et glissez-y `Commande`, `Client`, `Ville` et `Montant`. C'est le tableau témoin : il montre les dix commandes.
4. Cliquez sur une zone vide de la page, puis sur l'icône de **Text Plume**. Un cadre apparaît, avec une page d'accueil qui invite à glisser une ou plusieurs colonnes.
5. Glissez `Client` dans la zone **Champs à rechercher**. Le visuel affiche le titre « Client », le décompte « 10 valeurs » et une zone qui indique « Rechercher dans Client… ».
6. Cliquez dans la zone et tapez `cafe`. Le tableau témoin ne garde que **Café du Port** et **Café de Lyon** : les accents sont ignorés. Sous la zone, la ligne d'information indique « 2 valeur(s) trouvée(s) », et l'en-tête « 2 sur 10 ».
7. Cliquez sur la croix d'effacement de la zone. Le tableau témoin retrouve ses dix lignes.
8. Tapez `lyo`. Les **suggestions** s'ouvrent sous la zone, avec « lyo » surligné : Atelier Lyonnais et Café de Lyon. Appuyez sur ↓ jusqu'à **Café de Lyon**, puis sur **Entrée** (un clic sur la suggestion fait de même). La valeur remplace le texte tapé et le tableau témoin ne garde que cette commande.
9. Effacez la zone, puis glissez `Ville` dans **Champs à rechercher**, sous `Client`. Des **puces** apparaissent sous la zone : « Tous les champs », « Client » et « Ville » ; « Client » est choisie.
10. Tapez `lyon`. Le tableau garde Atelier Lyonnais et Café de Lyon (les clients dont le nom contient « lyon »).
11. Cliquez sur la puce **Ville**. Le même texte est appliqué à la colonne `Ville` : le tableau ne garde plus que la commande livrée à **Lyon**, chez Atelier Lyonnais. Le texte indicatif devient « Rechercher dans Ville… ».

Résultat : une zone de recherche qui filtre tout le rapport, sur la colonne de votre choix, avec des suggestions. Pour vider le filtre, cliquez sur la croix de la zone ou sur le bouton **Effacer** de l'en-tête.

> **Note:** **Bon à savoir** : la puce **Tous les champs** cherche dans `Client` **et** `Ville` à la fois ; c'est une fonction ★. Un clic dessus fonctionne sans licence, avec un filigrane. Pour la retirer, désactivez **Format › Champs › Puce « Tous les champs » ★**.

## En cas de problème

| Ce que vous voyez | Cause probable | Solution |
|---|---|---|
| Le tableau témoin est vide et la ligne indique « Aucune valeur ne correspond » | Aucune valeur de la colonne choisie ne contient le texte (puce sur la mauvaise colonne, faute de frappe). | Vérifiez la puce choisie et le texte. Pour ne pas filtrer quand rien ne correspond : **Format › Résultats › Si rien ne correspond** = *Ne pas filtrer*. |
| Rien ne se passe pendant la frappe ; « Entrée pour filtrer » s'affiche sous la zone | **Format › Saisie › Filtrer** est réglé sur *Avec Entrée ou le bouton*. | Appuyez sur **Entrée** ou cliquez sur **Filtrer**, ou revenez à *Au fil de la frappe*. |
| « Tapez au moins n caractères » sous la zone | **Format › Recherche › Caractères minimum** est supérieur au nombre de lettres tapées. | Tapez plus de lettres, appuyez sur **Entrée** (le minimum est alors ignoré), ou baissez le réglage. |
| « Rosch » ne trouve pas « Rösch » | **Ignorer les accents (é = e)** est désactivé dans **Format › Recherche**. | Réactivez-le. |
| Pas de puces sous la zone | Une seule colonne dans **Champs à rechercher**, ou **Format › Champs › Avec plusieurs champs** est réglé sur *Chercher dans tous les champs*. | Ajoutez une seconde colonne, ou revenez à *Choisir le champ (puces sous la zone)*. |
| « Recherche sur les N premières lignes chargées » sous la zone | La recherche passe par la liste des valeurs trouvées, et le modèle a plus de lignes que le visuel n'en charge. | Une recherche simple sur une seule colonne de texte (*Contient*, *Commence par* ou *Est égal à*) n'a pas cette limite ; sinon, filtrez d'abord la page avec un autre segment. |
| La synchronisation des segments n'agit pas | Le visuel a deux colonnes ou plus : Power BI désactive alors la synchronisation de ses segments. | Gardez une seule colonne dans le segment à synchroniser. |
| Le filigrane « Aperçu premium » apparaît | Une fonction ★ est utilisée sans clé valide : plusieurs termes séparés par `;`, un joker `*` ou `?`, une exclusion `-terme`, une expression régulière, la puce **Tous les champs**, ou 3 colonnes et plus. | Collez une clé dans **Licence Plume Studio › Clé de licence**, ou revenez à un seul terme, sans joker, sur 1 ou 2 colonnes. |

## À retenir

- Text Plume filtre le rapport avec le texte tapé ; casse et accents sont ignorés par défaut.
- Les suggestions se choisissent au clavier (↓ ↑ puis **Entrée**) ou à la souris.
- Avec deux colonnes, les puces choisissent où chercher ; le texte suit quand vous changez de puce.
- Le visuel envoie une condition Power BI quand elle donne exactement le même résultat, sinon la liste des valeurs trouvées.
- Le texte tapé revient avec les signets, au retour sur la page et à la réouverture du rapport.

## Pour aller plus loin

- [Text Plume : 9 cas pratiques (liste collée, jokers, signets…)](/fr/tutoriels/text-plume-cas-pratiques) : des recettes pour les besoins courants.
- [Text Plume : tous les champs et réglages expliqués](/fr/tutoriels/text-plume-champs-et-reglages) : chaque zone de champ et chaque réglage.
- [Bien démarrer avec les visuels Plume](/fr/tutoriels/bien-demarrer-visuels-plume) : installation, licence, styles et réglages communs à tous les visuels.
- La fiche du visuel : [Text Plume](/fr/visuels/text-slicer). Une question : [support](/fr/support).
