Exporter vos états Access en PDF gratuitementDate de publication : 01/12/2005 , Date de mise à jour : 01/12/2005 Thèmes abordés : I. Le PDF gratuit II. Installer PDF Creator II-A. Télécharger PDF Creator II-B. Installer PDF Creator II-C. Configurer PDF Creator III. Installer PDF Tool Kit III-A. Télécharger PDF Tool Kit III-B. Installer PDF Tool Kit IV. Génération manuelle V. Génération automatique de PDF V-A. Méthodologie V-B. Changer l'imprimante par défaut V-C. Exporter l'état en PDF V-D. Ajouter l'état à la file d'attente V-E. Renommer un PDF généré automatiquement V-F. Ouverture d'un formulaire par Automation Access VI. La gestion avancée des PDF VI-A. Fonctionnement de AccessPDF VI-B. Table de mise en page VI-C. Le sous-formulaire VI-D. Le formulaire VII. Une Application portable VIII. Conclusion I. Le PDF gratuit
Pourquoi le PDF ? C'est une réponse à la question : "comment envoyer un état par mail ?" Les réponses habituelles sont : . le format Snapshot . l'export HTML . l'export Excel . l'export RTF / Word Les solutions HTML, Excel, ou même RTF/Word ne sont pas satisfaisantes car elles entraînent une détérioration de la présentation. Microsoft a bien prévu une solution propriétaire, équivalente au PDF quant à la qualité, mais trop peu de lecteurs de ce format sont installés. Vous pourrez cependant le trouver ici en téléchargement ( SnapShot Viewer).Comme presque tous les postes sont équipés, à l'heure actuelle d'un lecteur de PDF, la solution la plus pertinente reste donc ce format de fichier. PDF est l'acronyme de Printable Document Format, un format développé par Adobe Systems, dérivé du langage PostScript. L'idée majeure est de pouvoir échanger des documents à travers n'importe quelle plateforme. Il faut donc pouvoir générer le document et le lire, quels que soient les contextes système et logiciel. Adobe fournit bien entendu une solution, mais celle-ci est payante. Ce tutoriel a pour objet de vous présenter une solution alternative et non payante. II. Installer PDF Creator
PDF Creator est selon moi le meilleur logiciel libre de création de documents au format PDF. Cette section va vous guider pas à pas dans l'installation adéquate du logiciel. II-A. Télécharger PDF Creator
C'est sur le site de Sector7g, un groupe allemand, que vous allez pouvoir trouver le logiciel. http://sector7g.wurzel6.de/pdfcreator/index_en.htm La page de téléchargements est située sur le réseau sourceforge.net : https://sourceforge.net/project/showfiles.php?group_id=57796. Pour le télécharger directement cliquez : ici. ![]() télécharger le soft Et le lien pour le fichier de langage français : ici. II-B. Installer PDF Creator
Une fois que les téléchargements sont terminés nous passons à l'installation. Lançons : PDFCreator-0_8_0_AFPLGhostscript.exe ![]() lancer l'installation ![]() choisir les options ![]() paramétrage ![]() poursuite de l'installation ... Pour mettre le langage en français, il suffit de copier le fichier french.ini dans le répertoire d'installation, ici : C:\Program Files\PDFCreator\languages ![]() mettre le langage en français II-C. Configurer PDF Creator
Par le menu : Printer > Options nous allons pouvoir configurer correctement PDF Creator. Nous configurons la rubrique Auto-save de la manière suivante ![]() paramétrage auto save Notre but est d'éviter que le logiciel nous demande où placer systèmatiquement et par défaut les documents PDF ; pour cela nous définissons ici un répertoire temporaire, et nous spécifions que le nom du fichier sera la concaténation de la date et de l'heure courante. Nous validons en cliquant sur "Save". III. Installer PDF Tool KitUne fois les fichiers PDF créés, nous allons avoir besoin de les fusionner, de les séparer, de les modifier et le logiciel libre le plus simple pour effectuer ces opérations est PDF Tool Kit. III-A. Télécharger PDF Tool Kit
Vous pouvez trouver cet excellent logiciel sur : http://www.accesspdf.com/pdftk/ Pour le télécharger directement, cliquez : ici. III-B. Installer PDF Tool Kit
L'installation est des plus simples, il suffit de décompresser l'archive dans un répertoire précis. Ici, nous avons choisi : C:\Program Files\pdfmerge Le logiciel est prêt à l'emploi, il ne nécessite pas de paramètrage particulier puisqu'il fonctionne par ligne de commande. IV. Génération manuelle
C'est la manière la plus simple de créer un PDF. Il suffit d'ouvrir un état, puis d'en demander l'impression, choisir l'imprimante virtuelle PDFCreator. ![]() Imprimer Nous constatons que le fichier a bien été généré à l'endroit prévu ... ![]() Fichier généré V. Génération automatique de PDF
Nous allons aborder ici le processus qui permet d'automatiser la génération de fichiers PDF par programmation pour un état Access.
V-A. Méthodologie
Pour créer un document PDF, nous allons procéder par étape : . récupération de l'imprimante courante ; . définition de l'imprimante par défaut sur PDFCreator ; . impression des pages désirées ; . rétablissement de l'ancienne imprimante ; . renommage du document créé. Nous avons défini dans les options, de nommer le fichier de sortie en fonction de l'heure courante et non en fonction du nom du document. Pourquoi ? Parce que nous pouvons très bien lancer plusieurs traitements à la suite et que certains peuvent prendre beaucoup plus de temps que d'autres. Nous allons donc stocker dans une table, la file d'attente des créations de PDF à générer. V-B. Changer l'imprimante par défaut
La création du format PDF, dérivé du PostScript, se fait par l'intervention d'une imprimante virtuelle.
Le but de cette portion de code est de modifier les paramètres d'impression définis dans Windows. Pour changer ces paramètres, il est nécessaire d'écrire dans le fichier win.ini afin d'y déclarer la nouvelle imprimante.
V-C. Exporter l'état en PDF
La fonction contient les arguments suivants : . strReport (Nom de l'état) : nom de l'état à exporter en PDF ; . allPages (Type de page) (acPrintAll par défaut) : détermine si nous imprimons toutes les pages ou simplement une section ; . pStart (page de départ) et pEnd (page de fin) : dans le cas où nous n'imprimons pas toutes les pages Nous ouvrons l'état grâce à la commande fOpenRemoteReport qui prend en charge les opérations d'ouverture / d'impression / de fermeture de l'état. Nous allons détailler dans les paragraphes suivants les fonctions auxiliaires suivantes : . AddDocument nous permet d'ajouter notre impression dans la table de file d'attente des PDF. . ScanPDFfiles dont le but est de vider la file d'attente des documents PDF. . fOpenRemoteReport qui sert à ouvrir un état d'une autre base de données par Automation Access. V-D. Ajouter l'état à la file d'attente
Nous allons alors ajouter dans la table tblPDFdoc le nom de l'état, l'heure ainsi que la date courante et ce afin de le rapprocher du nom du PDF généré automatiquement par PDFCreator. Le champ [done] nous passons la valeur à False et prend la valeur True dès que l'état a été généré en PDF. V-E. Renommer un PDF généré automatiquement
Dans les options que nous avons définies sur PDFCreator, le fichier prend automatiquement le nom défini avec la date et l'heure courante suivi de l'extension PDF. Par exemple, lors d'une génération de fichier à 23h08m54s le 14/11/2005, le fichier s'appellera 20051114230854.pdf Notre code permet de chercher le fichier portant le nom dont la date est la plus proche de la date de demande de génération tout en étant supérieure. Une fois ce fichier trouvé, grâce à la fonction GetFirstFileName(), nous allons changer le nom du fichier. La modification du nom est effectuée par code en utilisant les fonctionnalités de l'objet FileSystemObject issu de la DLL Microsoft Scripting Runtime. Pour renommer les fichiers, nous employons la méthode .MoveFile . Dès que le fichier est renommé, nous modifions le statut du document dans la file d'attente en passant le champ Done à True. V-F. Ouverture d'un formulaire par Automation Access
Nous avons besoin pour notre application d'ouvrir un état situé sur une autre base que celle en cours.
Nous allons utiliser pour cela l'automation Access. Le fonctionnement est le même pour l'automation Excel plus connue, hormis que cette fois, il ne sera pas nécessaire de rajouter la référence aux objets Access puisque nous l'utilisons par défaut. Une fois l'objet de base Access instancié, nous allons ouvrir, imprimer puis fermer l'état avant de quitter la base. Il ne faudra pas oublier de libérer de la mémoire les objets que nous avons utilisés.
VI. La gestion avancée des PDF
Il arrive que la demande ne se limite pas au simple export d'un état. Les problèmes rencontrés suite à l'envoi de PDF bruts : . pages inutiles ; . nécessité d'envoyer plusieurs documents à la suite ; . répétition de certaines pages (type page de garde). Ces limitations font apparaître le besoin de gérer la mise en page des PDF en les découpant et en les fusionnant. Nous avons installé pour cela l'excellent outil PDF Tool Kit. VI-A. Fonctionnement de AccessPDF
PDFTK de AccessPDF est un logiciel de manipulation de PDF par ligne de commande.
Le script comprend trois parties : . l'exécutable suivi des différents noms de fichiers, chacun représentés par une lettre, . l'ordre de mise en page précédé du mot clé cat, dans l'exemple le document B, puis le A, puis le C sur la section allant de page 1 à page 2. . le nom du fichier de sortie précédé du mot clé output. Fonctionnement par l'exemple :
VI-B. Table de mise en page
Pour gérer efficacement les PDF nous allons utiliser une table et un formulaire ainsi qu'un sous-formulaire.
id est un numéro autoincrémenté. dnom est le nom du document pfrom est la page de départ (-1 si nous avons besoin de toutes les pages) pto est la page de fin (-1 si nous avons besoin de toutes les pages) docorder est un numérique servant à donner l'ordre de passage des documents. VI-C. Le sous-formulaire
Nous créons par l'assistant un formulaire instantanné à partir de la table que nous venons de créer tblPDFwork. Nous nommons le formulaire : subfrmPDFwork. Nous forçons l'affichage en mode feuille de données, ce sera notre sous-formulaire de saisie des membres du PDF compilé. ![]() forçage du mode feuille de données La source de données est le SQL suivant, un simple tri sur le champ zorder :
En mode feuille de données nous réduisons à zéro la première colonne qui affiche l'Id, de manière à obtenir ceci. ![]() sous-formulaire ajustement des colonnes VI-D. Le formulaire
Nous créons un formulaire indépendant comprenant :
. le sous-formulaire subfrmPDFwork ; . une liste des fichiers PDF sur le disque : lstFiles ; . des boutons ajout / suppression (cmdAdd, cmdDel) pour ajouter ou enlever un pdf de la compilation ; . deux textbox (txtFrom, txtTo) pour saisir les pages concernées ; . une textbox pour indiquer le nom de la compilation (txtProjectName) ; . un bouton pour lancer le script de génération : cmdGenerate.
Le code suivant permet de gérer les mises à jour (ajout / suppression) de la liste de la compilation de PDF. Pour info : remettre à jour un sous-formulaire : Me.NomduSousForm.Form.Requery
Le code suivant crée le PDF à partir des trois parties nécessaires au script de AccessPDF.
VII. Une Application portable
L'application AccessPDF assure de manière autonome la production de documents PDF mais elle peut tout aussi bien être intégrée à une base existante. Dans le cas d'une intégration, voici les différents éléments à ajouter : . adapter le code de la fonction GetPDF pour ouvrir un état local et non un état d'une base distante ; . table tblPDFdoc : qui contient la file d'attente des demandes de génération de PDF ; . table tblPDFwork : qui contient la liste des fichiers d'une compilation de PDF ; . formulaire frmPDFengine qui permet d'exporter un état en PDF ; . formulaire frmPDFworkshop qui permet de créer ou éditer une compilation de PDF ; . sous-formulaire subfrmPDFwork qui liste les membres d'une compilation ; . les différents modules modPDF, modDialogBox, modSettings, modOpenReport qui contient les routines de création et de gestion. ![]() le formulaire frmPDFEngine ![]() le formulaire frmPDFWorkshop VIII. Conclusion
Vous pouvez télécharger l'application AccessPDF en cliquant ici (version 2000 - 72 ko). Cet article a pour but de montrer que le format PDF est un excellent moyen d'échanger de l'information et de pallier à une des grandes lacunes d'Access, la distribution d'états. Ce format est désormais accessible à tous grâce au logiciel libre. L'atelier PDF que nous avons mis au point pourra facilement être transposé et adapté, on peut aisément imaginer l'ajout d'une fonctionnalité d'envoi automatique de mail. Je remercie les développeurs d'outils libres de qualité comme les équipes de Sector7g (développeurs de PDFCreator) et Sid Steward (l'auteur de PDF Tool Kit). Je remercie également l'équipe de la rédaction Access de developpez.com pour ses relectures et ses pertinentes remarques. |
Les sources présentées sur cette page sont libres de droits, et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une oeuvre intellectuelle protégée par les droits d'auteurs. Copyright © 2005 Charles A.. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.