Convertir CFM en PDF

Une page ColdFusion doit souvent être convertie lorsqu’un rapport généré par le serveur doit être soumis, imprimé, archivé ou partagé sous forme de document fixe. La méthode requise dépend du fait que le PDF doive contenir la page rendue par ColdFusion ou le code source CFM.

Qu’est-ce que le format CFM ?

.cfm est un fichier ColdFusion Markup contenant des instructions CFML ainsi que du HTML, du CSS, du JavaScript et parfois des requêtes de base de données. Adobe ColdFusion et Lucee exécutent les fichiers CFM sur un serveur afin de produire des pages, formulaires, rapports et composants d’application dynamiques. Un fichier CFM n’est normalement pas un document finalisé : le code côté serveur doit être exécuté avant que le navigateur ne reçoive le HTML généré.

Qu’est-ce que le format PDF ?

Le PDF stocke une mise en page fixe qui peut être affichée et imprimée de manière cohérente dans Adobe Acrobat Reader, les navigateurs web et les visionneuses PDF des systèmes d’exploitation. Il convient aux factures, rapports, soumissions et archivages, car les destinataires n’ont pas besoin de ColdFusion ni d’un accès à la base de données d’origine. Le PDF conserve l’apparence rendue, et non le comportement CFML exécutable ou la source de données active.

Convertir la page ColdFusion rendue

1. Exécutez le fichier CFM avec Adobe ColdFusion ou Lucee sur un serveur web local ou hébergé.
2. Ouvrez son URL HTTP ou HTTPS dans un navigateur, par exemple https://example.test/report.cfm?id=42. Authentifiez-vous d’abord si la page est protégée.
3. Vérifiez les enregistrements, images, polices, tableaux, sauts de page et valeurs calculées avant de créer le PDF.
4. Choisissez Print → Save as PDF dans Chrome, Edge, Firefox ou Safari. Définissez le format de papier, l’orientation, les marges, la plage de pages, l’échelle et les graphiques d’arrière-plan selon les besoins.

Cette méthode via le navigateur capture la page après que ColdFusion et ses scripts côté client ont généré le résultat. Il s’agit généralement du meilleur choix lorsque la similitude visuelle avec la page web est importante.

Générer le PDF dans ColdFusion

Pour un rapport que vous contrôlez, Adobe ColdFusion peut effectuer le rendu du balisage directement avec <cfdocument> :

<cfdocument format="pdf" filename="report.pdf" overwrite="true">
    <h1>Sales report</h1>
    <cfoutput>#reportHtml#</cfoutput>
</cfdocument>

Placez le balisage du rapport à l’intérieur du bloc cfdocument, ou entourez avec celui-ci la sortie générée existante. Les versions d’Adobe ColdFusion et les installations de Lucee peuvent différer en matière de moteur PDF, de CSS, de polices, d’images et de prise en charge du JavaScript : testez donc la version exacte du serveur. Le CSS responsive moderne et le JavaScript fonctionnant uniquement dans le navigateur peuvent être rendus différemment de la page affichée dans Chrome.

Pour une sortie automatisée fidèle au navigateur, utilisez un moteur de rendu actuel basé sur Chromium, tel que Playwright, Puppeteer ou Chromium headless, avec l’URL rendue. Une commande Chromium de base est la suivante :

chromium --headless --disable-gpu --print-to-pdf=report.pdf "https://example.test/report.cfm?id=42"

Une page protégée peut nécessiter un contexte de navigateur pré-authentifié, un cookie de session, un en-tête HTTP ou un endpoint de rendu interne. Ne placez pas d’identifiants dans une URL publique et ne supposez pas qu’un moteur de rendu en ligne de commande puisse accéder automatiquement à la session d’un utilisateur.

Convertir le code source CFM

Si l’objectif est d’obtenir une copie lisible du code plutôt que du rapport généré, ouvrez le fichier dans Visual Studio Code, Notepad++ ou un autre éditeur de code, puis choisissez Print → Save as PDF. Le PDF obtenu contient le code source et les commentaires ; il n’exécute pas le CFML, n’interroge pas la base de données et n’inclut pas les enregistrements générés. La coloration syntaxique, les numéros de ligne et les polices à chasse fixe peuvent faciliter la revue du code, mais ils augmentent le nombre de pages.

Utiliser un convertisseur en ligne

La conversion en ligne convient uniquement à du HTML déjà rendu, non confidentiel, ou à un autre export ne contenant aucun code côté serveur. Un service tel que CloudConvert peut convertir en PDF les fichiers HTML pris en charge ; vérifiez que le service actuel accepte la structure HTML et les ressources dont vous avez besoin. Adobe Acrobat online est une autre option pour les documents pris en charge, mais il ne remplace pas un environnement d’exécution ColdFusion.

Ne téléversez pas de fichiers CFM bruts, d’identifiants de base de données, de cookies de session, de code source propriétaire ou de données de rapport confidentielles à moins que les conditions du fournisseur concernant le chiffrement, la conservation, le traitement et la suppression ne répondent à vos exigences. Un convertisseur générique ne peut normalement pas exécuter ColdFusion, résoudre les inclusions côté serveur, accéder à la base de données de l’application ou s’authentifier auprès de ressources protégées.

Limites de qualité et de compatibilité

• L’impression depuis un navigateur peut omettre les couleurs d’arrière-plan CSS, le contenu qui déborde, les contrôles interactifs, les ressources chargées de manière différée ou les images bloquées par l’authentification. Activez les graphiques d’arrière-plan et inspectez chaque page du PDF obtenu.
• cfdocument peut produire une pagination et un style différents de ceux du navigateur, car la prise en charge du CSS, des polices web, du JavaScript et le moteur PDF peuvent différer.
• Utilisez des URL de ressources absolues ou accessibles et vérifiez que le processus de rendu peut accéder aux images, aux feuilles de style et aux polices. Les chemins relatifs qui fonctionnent dans une session de navigateur peuvent échouer dans un moteur de rendu côté serveur ou headless.
• Pour obtenir une sortie reproductible, utilisez des paramètres d’URL fixes et un instantané de données stable. Les requêtes en temps réel, les horodatages, les valeurs aléatoires et les sessions propres à chaque utilisateur peuvent modifier chaque PDF.
• Le PDF conserve l’apparence plutôt que le comportement de l’application ; les liens peuvent rester cliquables, mais les formulaires, filtres, menus, mises à jour AJAX et autres fonctionnalités interactives peuvent être supprimés ou devenir non fonctionnels.