# Générateur PDF

> Générez et personnalisez dynamiquement un fichier PDF depuis votre application avec le composant Générateur PDF.

https://docs.pandasuite.com/fr/essentials/components/pdf-generator/

**Le composant Générateur PDF vous permet de générer dynamiquement un fichier PDF depuis votre application. Que ce soit à partir d’un modèle vierge ou d’un fichier PDF existant (interactif ou non), vous pouvez personnaliser et enrichir votre PDF à la volée : ajouter du texte, des images, des formes ou encore des champs dynamiques renseignés par l’utilisateur.**

[Vidéo : Un questionnaire client est rempli et validé dans l'application, puis le PDF généré est enregistré et ouvert avec les réponses]

## Cas d'utilisation

Voici quelques exemples concrets d’utilisation du Générateur PDF :

- **Application de formation** : créer une attestation personnalisée à la fin d’un parcours e-learning.
- **Catalogue interactif** : permettre à l’utilisateur de télécharger une fiche produit personnalisée avec les éléments consultés.
- **Outil de configuration ou devis** : générer un récapitulatif PDF selon les choix de l’utilisateur.
- **Visite guidée ou audioguide** : créer un carnet de visite PDF que l’utilisateur peut conserver à la fin du parcours.
- **App de terrain** : remplir un formulaire d’intervention ou un compte-rendu de visite généré au format PDF.

## Mise en place du composant

### Insertion dans le projet

1. Ouvrez votre projet dans PandaSuite Studio.
2. Dans l’onglet **Composants**, recherchez **Générateur PDF**.
3. Cliquez dessus pour l'ajouter à votre écran. Pour y accéder depuis plusieurs écrans, placez-vous d'abord au niveau du **Projet**.

> **Info**
>
> Le composant **Générateur PDF** est un composant non graphique : vous pouvez
> l'éditer visuellement depuis PandaSuite Studio, mais il n'apparaîtra pas dans
> l'interface de votre application. Pour afficher un PDF, consultez la page
> [PDF](https://docs.pandasuite.com/fr/essentials/multimedia/pdf/).

### Choix du document

Une fois le composant ajouté, vous pouvez le configurer depuis les Propriétés :

- **Nouveau document** (Oui/Non) : choisissez si vous partez d’un document vierge ou d’un fichier PDF existant (à importer).

  [Image : Propriétés du Générateur PDF : Nouveau document sur Oui, avec la Largeur et la Hauteur de la page du document vierge]

### Option 1 : document vierge

- **Largeur / Hauteur** : définissez le format de la page (A4, portrait/paysage, etc.) dans le cas d'un document vierge.

Le document démarre sans contenu, vous y ajoutez ensuite dynamiquement les éléments (textes, images, formes, etc.).

### Option 2 : à partir d'un PDF existant

Le fichier peut contenir un gabarit visuel sur lequel vous venez superposer des champs dynamiques.

- Importez le document
- Indiquez le **Nom du fichier**, de type Customer Feedback Form.pdf

Cliquez sur le composant pour l'afficher.

### Ajout de contenu dynamique

Pour ajouter du contenu dynamique (texte, image, etc.) à votre PDF, vous devez créer des [marqueurs](https://docs.pandasuite.com/fr/essentials/interactions/markers/).

#### Création de marqueurs

1. Cliquez sur le composant **Générateur PDF** dans la liste des Objets.
2. En mode édition, dessinez une zone sur le PDF à l’aide de la souris.
3. Un marqueur est automatiquement généré.

#### Personnalisation des marqueurs

- Dans les propriétés du marqueur, ajoutez un [data binding](https://docs.pandasuite.com/fr/essentials/data/data-binding/) sur le champ **Contenu** pour lier une variable dynamique (nom de l’utilisateur, date, résultat, etc.).

> **Info**
>
> Astuce : Les données utilisées dans les marqueurs peuvent provenir de
> composant [Saisie de texte](https://docs.pandasuite.com/fr/essentials/components/text-input/), [Éditeur
> de texte](https://docs.pandasuite.com/fr/essentials/components/text-editor/), de composants média
> ([Caméra](https://docs.pandasuite.com/fr/essentials/components/camera/)...), ou de variables système.

[Image : Générateur PDF en mode édition : le marqueur Name dessiné sur le formulaire, son champ Contenu lié à une valeur saisie]

## Caractérisiques du composant

### Evénements déclencheurs

- **PDF Généré** : se déclenche lorsque le PDF est prêt, et peut être utilisé pour lancer le téléchargement ou l’envoi.

### Actions interactives

- **Générer**
- **Télécharger**

## Bonnes pratiques et astuces

- Prévisualisez régulièrement : testez les positions et rendus en mode test pour vous assurer du bon placement des éléments.
- Ajoutez une action d’attente ou un message de chargement pendant la génération si elle est susceptible de prendre du temps.
- Travaillez avec des [variables](https://docs.pandasuite.com/fr/essentials/data/variables/) : centralisez vos données pour les insérer facilement dans plusieurs marqueurs.
- Le positionnement se fait manuellement : pas encore de grille ou d’alignement automatique.

## Ressources supplémentaires

[Modèle : Questionnaire client avec Générateur PDF](https://pandasuite.com/dashboard/use-template/ctyF1pUBaHn0WhDCT3OR)
