# Exporter un dashboard en PDF (/docs/dashboards/exporter-en-pdf)



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

Un dashboard peut être exporté en **PDF** de deux façons :

* **Export rapide (capture d'écran)** — une capture du dashboard tel qu'il est affiché, sans réglage. Idéal pour un envoi immédiat.
* **Export personnalisé** — un vrai document mis en page dans un **éditeur PDF** : tu choisis quels widgets apparaissent, sur quelle page, avec quel thème, quel en-tête et quels blocs additionnels (texte, image, fiche joueur…). Cette mise en page s'enregistre comme **modèle d'impression**, que tu rejoues ensuite en un clic pour n'importe quel joueur ou équipe.

<VideoAVenir titre="Exporter un dashboard en PDF" />

## Prérequis [#prérequis]

* Le dashboard doit être **sauvegardé*&#x2A; : sans cela, l'éditeur fonctionne mais affiche &#x2A;« Enregistrez le dashboard pour conserver un modèle »* et aucun modèle ne peut être conservé.
* Les **données doivent être chargées** (un joueur ou une équipe sélectionné, une période définie) : le PDF reprend exactement les filtres en cours.

## Où trouver l'export [#où-trouver-lexport]

En **consultation** d'un dashboard, clique sur le bouton rond **Paramètres** en bas à droite de l'écran. La section **Export** propose trois entrées :

| **Entrée**                          | Description                                                                                                                                                                                                                                       |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Personnaliser**                   | Ouvre l'éditeur PDF pour composer ou modifier un modèle d'impression.                                                                                                                                                                             |
| **Export personnalisé**             | Exporte directement avec le **modèle par défaut** du dashboard (son nom et sa version sont rappelés sous l'entrée). L'icône **œil** (**Prévisualiser**) ouvre l'aperçu dans un nouvel onglet. Grisé tant qu'aucun modèle par défaut n'est défini. |
| **Export rapide (capture d'écran)** | Capture le dashboard affiché et génère le PDF immédiatement.                                                                                                                                                                                      |

<Callout type="info">
  Change le joueur ou l'équipe dans la barre latérale de consultation
  avant d'exporter : le PDF est généré pour la sélection en cours. Avec un
  modèle par défaut, un rapport individuel par joueur se produit en
  quelques clics.
</Callout>

## Étapes [#étapes]

### 1. Ouvrir l'éditeur [#1-ouvrir-léditeur]

**Paramètres** → **Personnaliser**. L'éditeur s'ouvre en grand panneau, organisé en **trois colonnes** redimensionnables, sous une barre **Modèle d'impression** :

| **Colonne**                   | Rôle                                                                                                                          |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Personnalisation** (gauche) | Deux onglets : **Document** (réglages globaux) et **Bloc sélectionné** (réglages du bloc cliqué).                             |
| **Structure** (centre)        | Les pages du PDF et leurs blocs, plus la **Bibliothèque** de blocs à ajouter.                                                 |
| **Aperçu du PDF** (droite)    | Le rendu réel, mis à jour au fil des modifications : **Page courante** ou **Toutes les pages**, zoom, navigation entre pages. |

À la première ouverture, les widgets du dashboard sont **répartis automatiquement** sur les pages en respectant leur ordre à l'écran.

### 2. Organiser les pages et les blocs [#2-organiser-les-pages-et-les-blocs]

Dans la colonne **Structure** :

* **déplace** et **redimensionne** chaque bloc sur la page,
* utilise les flèches d'un bloc pour l'**envoyer à la page précédente** ou **à la page suivante**,
* **Retirer du PDF** exclut un widget du document (il rejoint la liste des widgets non placés, d'où tu peux le reglisser sur une page),
* chaque page se **monte**, se **descend**, se **duplique** ou se **supprime** ; **Ajouter une page** en crée une nouvelle,
* **Repaginer automatiquement** redistribue tous les widgets placés depuis zéro.

La **Bibliothèque** propose des blocs à glisser sur une page :

| **Bloc**                   | Description                                                                                                                                                                                    |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Texte libre**            | Texte mis en forme (titres, gras, listes). Styles **Simple**, **Encadré** ou **Encadré à coches**. Variables disponibles : `{{prenom_joueur}}`, `{{nom_joueur}}`, `{{equipe}}`, `{{periode}}`. |
| **Image**                  | Image importée (350 Ko max après réduction) ou adresse https, avec légende et ajustement **Contenir** / **Couvrir**.                                                                           |
| **Séparateur**             | **Trait**, **Espace** ou **Titre de section**.                                                                                                                                                 |
| **Fiche sportif / équipe** | Carte d'identité : photo, nom, poste, période, club / équipe, avec disposition et couleurs réglables.                                                                                          |

### 3. Régler le document (onglet Document) [#3-régler-le-document-onglet-document]

| **Section**                      | Ce que tu règles                                                                                                                                                                                                                                                                                                              |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Thème et couleurs**            | Thème **Clair rapport**, **Sombre club** ou **Minimal**, compositions prêtes à l'emploi (**Rapport classique**, **Club sombre**, **Fiche joueur**, **Épuré**), couleurs primaire / secondaire, fond de page, fond des blocs, couleur du texte.                                                                                |
| **Blocs**                        | Fond, transparence, bordure, arrondi des angles et marge intérieure de tous les blocs.                                                                                                                                                                                                                                        |
| **Page**                         | Orientation **Portrait** / **Paysage** et marges.                                                                                                                                                                                                                                                                             |
| **Fonds illustrés**              | Une illustration pleine page sous le contenu (Flux dégradé, Lignes topographiques, Grille d'hexagones…), dont les couleurs d'accent, de trait et de fond sont remplaçables — ou reprises du thème.                                                                                                                            |
| **Fond décoratif**               | Une forme (coin diagonal, vague, terrain en perspective…), un motif (points, hachures, lignes de terrain…) et le logo du club, de l'équipe ou la photo du joueur en filigrane, en coin ou en motif répété.                                                                                                                    |
| **En-tête**                      | Style **Bandeau**, **Titre à filets** ou **Discret** ; titre et sous-titre du document, logo du club, médaillon, période, tags, type d'événement, joueur / équipe sélectionné(e). Fond **Couleur unie** ou **Dégradé**, &#x2A;*Bannière (image de fond)** avec son opacité, hauteur, arrondi et couleurs élément par élément. |
| **Typographie**                  | Taille du texte courant et du texte des tableaux, interligne.                                                                                                                                                                                                                                                                 |
| **Tableaux**                     | Style de tableau (**Rapport**, &#x2A;*Fiche (aéré)**, **Épuré**, **Compact**, **Alterné**, **Cartes**, **En-têtes groupés**), couleurs des en-têtes, lignes alternées, largeur de la première colonne.                                                                                                                        |
| **Mise en forme conditionnelle** | Rendu des couleurs de règles : **Pastille avec libellé**, **Fond de cellule** ou **Point de couleur**. → [Mise en forme conditionnelle](/docs/dashboards/mise-en-forme-conditionnelle)                                                                                                                                        |
| **Pied de page**                 | Numérotation, sources, **Clé de lecture** (ex. « 10 = benchmark équipe »), mention « Créé avec FormaPulse ».                                                                                                                                                                                                                  |

<Callout type="info">
  L'option **Ajouter une fiche en haut de la page 1** (section En-tête)
  insère une **Fiche sportif / équipe** comme un bloc ordinaire : tu peux
  ensuite la déplacer, la redimensionner et choisir sa source.
</Callout>

### 4. Régler un bloc (onglet Bloc sélectionné) [#4-régler-un-bloc-onglet-bloc-sélectionné]

Clique sur un bloc dans la Structure. Pour un widget, selon son type :

* **Style du titre** (**Bandeau**, **Icône**, **Discret**, **Aucun**), texte du titre, couleur du titre et fond du bloc,
* **Décimales**, **Unité** (KPI, jauge), **Afficher la légende**,
* pour un **tableau** : **Colonnes visibles**, **Trier par** et **Sens du tri**, affichage des **Normes** (**Comme le dashboard**, **En colonnes**, **Dans la case de l'indicateur**, **Masquées**), zones et écart de sollicitation, date de la dernière valeur, &#x2A;*Colonne « Conclusion »** (libellés des règles de mise en forme conditionnelle), légende des zones,
* pour un widget **Fréquence** : rendu et unité propres au PDF.

### 5. Enregistrer le modèle [#5-enregistrer-le-modèle]

Dans la barre **Modèle d'impression** :

| **Élément**                   | Description                                                                                                                                                           |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sélecteur de modèle**       | **Nouveau modèle** ou un modèle existant de ce dashboard (le modèle par défaut est précédé d'une ★). Chaque modèle affiche sa **version** et sa date de modification. |
| **Nom du modèle**             | Obligatoire pour enregistrer.                                                                                                                                         |
| **Partage du modèle**         | Pour les comptes club : **Privé**, **Équipes** ou **Club**.                                                                                                           |
| **Étoile**                    | **Définir comme modèle par défaut** (ou le retirer). C'est ce modèle qu'utilise **Export personnalisé**.                                                              |
| **Dupliquer** / **Supprimer** | Dupliquer pour créer une variante sans toucher l'original.                                                                                                            |
| **Enregistrer**               | Sauvegarde le modèle ; le badge **Non enregistré** signale des modifications en attente.                                                                              |
| **Exporter**                  | Génère et télécharge le PDF.                                                                                                                                          |

Les modèles sont **liés au dashboard** : chaque dashboard a sa propre liste de modèles et son propre modèle par défaut.

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

* **Exporter avant de sauvegarder le dashboard** : le PDF se génère, mais la mise en page sera perdue. Sauvegarde le dashboard, puis enregistre un modèle.
* **Un grand tableau coupé*&#x2A; : un bloc tableau n'affiche que les lignes qui tiennent dans sa hauteur ; les autres sont signalées par &#x2A;« X lignes masquées (bloc trop petit) »*. Agrandis le bloc, donne-lui une page entière, réduis la taille du texte des tableaux ou choisis le style **Compact**.
* **« Export personnalisé » grisé** : aucun modèle par défaut n'est défini. Ouvre **Personnaliser**, enregistre un modèle puis clique sur l'**étoile**.
* **Changer de modèle sans enregistrer** : l'éditeur te demande confirmation, les modifications non enregistrées sont perdues si tu continues.
* **Un widget supprimé du dashboard** : s'il figurait dans un modèle, il n'apparaît plus dans le PDF ; l'éditeur te signale les widgets du modèle qui n'existent plus.

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

<Cards>
  <Card title="Constructeur de dashboard" href="/docs/dashboards/construire-dashboard" description="Construire et partager le dashboard à exporter." />

  <Card title="Filtres dynamiques" href="/docs/dashboards/filtres-dynamiques" description="Choisir le joueur, l'équipe et la période avant l'export." />

  <Card title="Mise en forme conditionnelle" href="/docs/dashboards/mise-en-forme-conditionnelle" description="Des règles de couleur reprises dans le PDF avec leur libellé." />
</Cards>
