> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.organilog.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Personnaliser et dépanner un rapport PDF personnalisé

Les rapports PDF personnalisés peuvent être adaptés au-delà des sections standards : champs personnalisés, textes dynamiques, mise en page, image de fond, marges, pages complémentaires ou présentation spécifique.
| Certaines personnalisations avancées peuvent toutefois rendre le document plus difficile à maintenir. Il est recommandé de commencer par les options proposées nativement dans les sections avant d'utiliser une mise en forme personnalisée.
## Afficher uniquement les informations nécessaires
Avant de modifier la mise en page, ouvrir les paramètres des différentes sections du rapport.
De nombreuses informations peuvent directement être affichées ou masquées depuis ces options.
![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/pdf-personnalise-modale-ajout-_trh10o.png =400x402)
Cette méthode doit être privilégiée lorsqu'une donnée existe déjà dans une section : elle permet de conserver un rapport plus simple et plus facile à maintenir.
## Ajouter des champs personnalisés
Les champs personnalisés permettent d'intégrer au PDF des informations propres à l'activité de l'entreprise.
Plusieurs possibilités peuvent être proposées selon le rapport :
* afficher tous les champs personnalisés concernés ;
* choisir certains champs personnalisés ;
* insérer individuellement une valeur dans une section **Texte personnalisé**.
Lorsqu'un champ personnalisé n'est pas proposé dans le rapport, vérifier en priorité qu'il est bien associé au module correspondant au document.
Par exemple, un champ destiné uniquement aux équipements ne sera pas nécessairement disponible dans une section utilisant les données d'une intervention.
## Créer une zone de texte entièrement personnalisée
La section **Texte personnalisé** contient un éditeur permettant de saisir et mettre en forme du contenu libre.
![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/pdf-personnalise-section-texte_1d7c5o9.png =500x355)
Elle peut notamment servir à créer un encart, des mentions particulières ou une disposition qui n'existe pas dans les autres sections.
Une mise en forme simple peut être réalisée directement depuis l'éditeur : texte, taille, gras, alignement, tableaux ou autres éléments proposés.
Il est également possible d'accéder au code HTML lorsque des ajustements plus précis sont nécessaires.
Cette possibilité reste destinée aux besoins avancés. Une structure HTML complexe peut produire un résultat différent une fois convertie en PDF.
## Utiliser des valeurs dynamiques
La section **Texte personnalisé** permet d'insérer des valeurs dynamiques.
![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/pdf-personnalise-section-texte_1ezqzsx.png =400x284)
Les choix disponibles sont disponibles via le bouton "i" en bas du champ d'édition.
Ces valeurs dynamiques sont remplacées automatiquement lors de la génération du document.
Elles peuvent correspondre à des informations natives d'Organilog ou à des champs personnalisés.
Cette fonctionnalité permet par exemple de construire une phrase comme :
**Intervention réalisée pour \[nom du client] le \[date de l'intervention].**
Le même modèle reste alors utilisable pour tous les clients et toutes les interventions.
## Ajouter une image de fond
Les paramètres du rapport permettent de définir une **image de fond**.
![](https://storage.crisp.chat/users/helpdesk/website/-/c/8/3/5/c835e09870d5c800/pdf-personnalise-modele-de-fon_1r4n4av.png =400x328)
Depuis l'édition d'un rapport PDF personnalisé, les modèles de fond déjà existants sont disponibles dans les paramètres du rapport. Il est également possible d'envoyer une image personnalisée.
Cette possibilité peut notamment servir à utiliser un papier à en-tête ou une identité graphique déjà préparée.
Après l'ajout du fond, contrôler le document avec **Visualiser** afin de vérifier que les informations du rapport restent correctement positionnées et lisibles.
## Ajuster les marges du document
Les paramètres du rapport permettent également d'ajuster l'espace entre le contenu et les différents bords de la page A4.
Les marges peuvent être modifiées en haut, en bas, à gauche et à droite.
Cette configuration est utile lorsqu'un papier à en-tête ou pied de page occupe une partie de la page ou lorsque le contenu paraît trop éloigné des bords.
> Astuce : éviter de réduire excessivement les marges : certains contenus peuvent alors se retrouver trop proches du bord du PDF ou entrer en conflit avec l'entête et le pied de page.

## Ajouter un PDF avant ou après le rapport
Un ou plusieurs fichiers PDF peuvent être intégrés au document généré.
Ils peuvent être positionnés au **début** ou à la **fin** du rapport.
Cette fonctionnalité convient notamment pour :
* ajouter une page de garde ;
* ajouter des conditions générales de vente ;
* joindre des informations réglementaires ;
* ajouter une annexe identique à tous les documents utilisant ce modèle.
Le fichier est fusionné avec le rapport lors de la génération du PDF.
## Usage avancé : personnaliser la présentation avec du CSS
Les paramètres du modèle permettent également d'ajouter des règles CSS afin de modifier plus profondément la présentation du rapport.
Cette possibilité nécessite de bonnes connaissances en HTML et CSS.
Elle doit être réservée aux besoins qui ne peuvent pas être couverts par les paramètres des sections, les marges ou le **Texte personnalisé**.
## Contrôler le rendu réel du PDF
L'affichage dans l'éditeur ne correspond pas nécessairement exactement au document PDF final.
Le contenu est transformé en PDF lors de la génération, ce qui peut notamment avoir un effet sur :
* les sauts de page ;
* la taille ou la position de certaines images ;
* les tableaux ;
* les textes longs ;
* certains styles HTML ou CSS.
Utiliser **Visualiser** après chaque modification importante.
## Une information n'apparaît pas dans le PDF
Commencer par vérifier les points suivants :
1. la section contenant l'information est bien présente dans le rapport ;
2. l'information n'est pas masquée dans les options de la section ;
3. la donnée est réellement renseignée sur l'élément utilisé pour tester le PDF ;
4. le champ personnalisé est associé au bon module ;
5. la bonne valeur dynamique est utilisée dans un **Texte personnalisé** ;
6. les dernières modifications du rapport ont bien été enregistrées.
Certaines sections sont propres à un module. Une information disponible dans un rapport de contrat ou de chantier n'est donc pas nécessairement proposée dans un rapport d'intervention ou de facture.
## Le PDF ne se génère plus après une modification
Lorsque la génération fonctionnait auparavant, revenir en priorité sur les dernières modifications effectuées.
Supprimer ou simplifier temporairement l'élément concerné, enregistrer, puis tester à nouveau avec **Visualiser**.
Pour un **Texte personnalisé**, vérifier particulièrement :
* un contenu copié depuis un autre logiciel ou une page Internet ;
* du code HTML incomplet ;
* une mise en forme très complexe ;
* une image ajoutée manuellement ;
* du CSS récemment ajouté.
||| Un copier-coller peut transporter du code invisible qui n'est pas correctement interprété lors de la génération du PDF. En cas de doute, repartir d'un texte sans mise en forme puis reconstruire progressivement la présentation.
## Identifier rapidement la modification qui pose problème
Lors d'une personnalisation importante, effectuer les changements progressivement.
Après l'ajout d'une section ou d'une mise en forme importante, enregistrer puis utiliser **Visualiser**.
|| Si le PDF cesse de fonctionner, la dernière modification réalisée constitue alors la première piste à vérifier.
Cette méthode est beaucoup plus efficace que de modifier simultanément plusieurs textes, images et styles avant d'effectuer un premier test.
## Un document complexe nécessite plusieurs modèles
Un seul rapport n'a pas nécessairement besoin de couvrir tous les usages.
Lorsque les informations ou la présentation diffèrent fortement selon les situations, il peut être préférable de conserver plusieurs modèles.
Exemple : un rapport de maintenance, un rapport de dépannage et un rapport de contrôle réglementaire peuvent utiliser des sections et une organisation différentes.
Cette approche permet généralement d'obtenir des rapports plus lisibles et plus simples à maintenir.