| Format de document portable | |
|---|---|
| Power Fx | |
Syntaxe
| PDF (Screen [,{Size, DPI, Margin, Orientation, ExpandContainers}]) |
| PDF (Control name [,{Size, DPI, Margin, Orientation, ExpandContainers}]) |
Paramètres
| Nom | Description |
|---|---|
| Screen | Ce paramètre représente l'écran (ou la mise en page) que l'on souhaite exporter en PDF. |
| Control name | Ce paramètre représente le nom d'un contrôle spécifique que l'on veut capturer sous forme de PDF (ex. une galerie ou un formulaire). |
| Size | Ce paramètre définit le format du document (exemple "A4", "Letter"). Il détermine les dimensions de la page PDF générée. |
| DPI | Ce paramètre définit la résolution du rendu en points par pouce. Ce paramètre influe sur la qualité (et la taille) du fichier PDF. |
| Margin | Ce paramètre spécifie la marge (en pixels) autour du contenu capturé. Il permet d'ajouter de l'espace blanc autour de l'élément exporté. |
| Orientation | Ce paramètre définit l'orientation du PDF, soit "Portrait" (vertical) ou "Landscape" (horizontal). |
| ExpandContainers | Ce paramètre, lorsqu'il est défini à true, permet d'agrandir dynamiquement les conteneurs déroulants pour capturer tout leur contenu dans le PDF. |
Description
Cette fonction permet de générer un fichier PDF à partir d'une collection de données.
Remarques
- Fonction essentielle pour la génération de rapports imprimables : La fonction PDF est particulièrement utile dans les applications d'entreprise nécessitant l'exportation de rapports, de formulaires ou de reçus en version imprimable. Elle permet de convertir directement l'interface utilisateur en un document PDF sans passer par des outils externes. Cela facilite l'archivage, l'envoi par courriel ou l'impression de données saisies dans l'application.
- Deux modes d'utilisation : écran complet ou contrôle ciblé : Cette fonction peut capturer soit un Screen entier, soit un Control name spécifique comme une galerie, un formulaire ou une section de page. Cela donne un haut degré de flexibilité : on peut générer un PDF complet de l'écran ou isoler une partie précise, selon le besoin du scénario métier.
- Paramètres de qualité personnalisables avec DPI : Le paramètre DPI (dots per inch) influence directement la qualité du rendu visuel. Une valeur élevée produit un document net mais plus volumineux, tandis qu'une faible valeur allège le fichier mais peut nuire à la lisibilité. Il faut donc ajuster ce paramètre selon le contexte : archivage longue durée ou envoi rapide par courriel.
- Prise en charge des formats de papier internationaux : Grâce au paramètre Size, la fonction PDF peut générer des documents aux formats standards comme "A4", "Letter",... Cela est utile pour respecter les normes de mise en page selon les régions géographiques ou les exigences d'impression spécifiques à certains secteurs (juridique, administratif,...).
- Orientation de page ajustable selon le contenu : L'orientation Portrait ou Landscape peut être définie selon la disposition des données sur l'écran ou dans le contrôle. Cette option permet d'éviter des découpages ou des redimensionnements automatiques inappropriés, garantissant un rendu fidèle du contenu original à l'écran.
- Gestion intelligente des conteneurs dynamiques : Le paramètre ExpandContainers permet de forcer l'extension automatique des éléments déroulants, galeries ou panneaux pour inclure tout leur contenu visible ou non visible initialement. Sans cela, seuls les éléments affichés à l'écran seraient capturés, ce qui limiterait l'intérêt du PDF dans les rapports complets ou les factures à plusieurs lignes.
- Marge personnalisable pour un rendu plus professionnel : Le paramètre Margin autorise l'ajout d'un espace blanc autour du contenu exporté, ce qui est particulièrement utile pour éviter que des éléments ne soient coupés ou placés trop près des bords. Cette marge peut aussi donner un aspect plus esthétique et structuré au document PDF final.
- Ne capture que le rendu visuel, pas les données invisibles : La fonction PDF capture le visuel tel qu'il est défini dans l'interface utilisateur. Si certaines données sont masquées ou conditionnellement affichées, elles ne figureront pas dans le PDF, sauf si le paramètre ExpandContainers ou la logique de visibilité est correctement gérée. Cela nécessite une attention particulière pour garantir l'exhaustivité des informations exportées.
Dernière mise à jour : Jeudi, le 1 Mai 2025