# Pré-filtre par widget (/docs/dashboards/pre-filtre-widget)



## Vue d'ensemble [#vue-densemble]

Les [filtres dynamiques du header](/docs/dashboards/filtres-dynamiques) s'appliquent à **tout le dashboard**. Le **pré-filtre**, lui, se règle **widget par widget** : il restreint les événements dont ce composant se nourrit, indépendamment des autres composants.

Cas typique : sur un même dashboard, un widget « Charge séances tactiques » (tag *tactique* uniquement) à côté d'un widget « Charge matchs » — sans dupliquer le dashboard ni toucher aux filtres globaux.

<VideoAVenir titre="Utiliser le pré-filtre par widget" />

## Où le trouver [#où-le-trouver]

Ouvre le **configurateur du composant*&#x2A; (clic sur le widget en mode édition) → onglet &#x2A;*« Pré-filtre »**.

Le pré-filtre s'ajoute **en intersection** avec les filtres globaux du header : un événement doit passer les deux niveaux pour alimenter le widget.

## Les réglages [#les-réglages]

### Types d'événements [#types-dévénements]

Coche les types à conserver : **Séance**, **Match**, **Réunion**, **RDV para-sportif**.

> *« Ne garder que les événements des types cochés. Aucune coche = tous les événements (comportement actuel). »*

### Tags à inclure / à exclure [#tags-à-inclure--à-exclure]

Deux listes de tags :

* **Tags à inclure** — l'événement doit porter **au moins un** des tags cochés (logique OU). Aucune coche = « Tous les tags ».
* **Tags à exclure** — **prioritaire** : un événement portant un tag exclu est retiré **même s'il porte aussi un tag inclus**. Aucune coche = « Aucune exclusion ».

Exemple : inclure *tactique* + exclure *réhab* → toutes les séances tactiques sauf celles aussi taguées réhab.

### Réinclure les données « hors analyse collective » [#réinclure-les-données--hors-analyse-collective-]

Par défaut, les **événements** marqués « Exclure des analyses collectives » et les **lignes** (GPS / réponses questionnaire) exclues individuellement ne comptent pas dans les analyses collectives.

La case &#x2A;*« Réinclure les données marquées "hors analyse collective" »** permet à **ce widget précis** de les réintégrer — par exemple pour un widget de suivi de réathlétisation qui doit justement voir les séances individuelles exclues du collectif.

→ Voir [Exclure un joueur des analyses collectives](/docs/statistiques/exclure-joueur-analyses-collectives) et [Séances individuelles et réhab](/docs/planification/seances-individuelles-rehab).

## Quelles sources sont concernées [#quelles-sources-sont-concernées]

Le pré-filtre s'applique aux sources **reliées aux événements** : **GPS**, **questionnaires**, **charge**, **mappers** (et les écarts aux normes, via le GPS).

Les sources datées mais non rattachées à un événement — **tests physiques**, **blessures** — ne sont **pas** affectées.

<Callout type="warn">
  Une **activité GPS non rattachée à un événement** est exclue dès qu'un
  filtre type ou tag est actif : sans événement, impossible de vérifier
  son type ou ses tags.
</Callout>

## Les trois niveaux de filtrage [#les-trois-niveaux-de-filtrage]

| Niveau                  | Où                            | Effet                                                                       |
| ----------------------- | ----------------------------- | --------------------------------------------------------------------------- |
| **Dashboard**           | Header dynamique              | *Qui / quand / quoi* — propagé à tous les widgets.                          |
| **Widget — événements** | Onglet **Pré-filtre**         | *Quels événements* alimentent CE widget (types, tags, données exclues).     |
| **Widget — traitement** | Onglets Traitement / Analyses | *Comment* la donnée est calculée (granularité, agrégation, Z-Score, ACWR…). |

## Erreurs à éviter [#erreurs-à-éviter]

* **Chercher le pré-filtre dans le header** : il est propre à chaque widget, dans son configurateur.
* **Un widget vide après ajout d'un filtre** : vérifie l'intersection avec les filtres du header — si le header est déjà sur « Matchs » et le pré-filtre sur « Séance », plus rien ne passe.
* **Oublier la priorité de l'exclusion** : un tag exclu l'emporte toujours sur un tag inclus.
* **S'étonner que les tests ne bougent pas** : les tests et blessures ne passent pas par les événements, le pré-filtre ne les touche pas.

## Aller plus loin [#aller-plus-loin]

<Cards>
  <Card title="Filtres dynamiques du header" href="/docs/dashboards/filtres-dynamiques" description="Le filtrage global du dashboard." />

  <Card title="Exclure un joueur des analyses collectives" href="/docs/statistiques/exclure-joueur-analyses-collectives" description="Exclure des lignes GPS ou des réponses questionnaire." />

  <Card title="Tags d'événements" href="/docs/planification/tags-evenements" description="Poser des tags exploitables dans les filtres." />
</Cards>