Převod souboru CFM do PDF

Stránka ColdFusion často vyžaduje převod, když je třeba serverem vygenerovanou sestavu odeslat, vytisknout, archivovat nebo sdílet jako neměnný dokument. Požadovaný postup závisí na tom, zda má PDF obsahovat stránku vykreslenou pomocí ColdFusion, nebo zdrojový kód CFM.

Co je formát CFM

.cfm je soubor ColdFusion Markup obsahující instrukce CFML společně s HTML, CSS, JavaScript a někdy také databázovými dotazy. Adobe ColdFusion a Lucee zpracovávají soubory CFM na serveru a vytvářejí dynamické stránky, formuláře, sestavy a komponenty aplikací. Soubor CFM obvykle není hotový dokument: předtím, než prohlížeč obdrží vygenerované HTML, musí se spustit kód na straně serveru.

Co je formát PDF

PDF uchovává neměnné rozvržení stránky, které lze konzistentně zobrazit a vytisknout v Adobe Acrobat Reader, webových prohlížečích a PDF prohlížečích operačních systémů. Hodí se pro faktury, sestavy, podání a archivaci, protože příjemci nepotřebují ColdFusion ani přístup k původní databázi. PDF zachovává vykreslený vzhled, nikoli spustitelné chování CFML nebo živý zdroj dat.

Převod vykreslené stránky ColdFusion

1. Spusťte soubor CFM prostřednictvím Adobe ColdFusion nebo Lucee na místním či hostovaném webovém serveru.
2. Otevřete jeho HTTP nebo HTTPS URL v prohlížeči, například https://example.test/report.cfm?id=42. Pokud je stránka chráněná, nejprve se ověřte.
3. Před vytvořením PDF zkontrolujte záznamy, obrázky, písma, tabulky, zalomení stránek a vypočítané hodnoty.
4. V prohlížeči Chrome, Edge, Firefox nebo Safari zvolte Print → Save as PDF. Podle potřeby nastavte velikost papíru, orientaci, okraje, rozsah stránek, měřítko a grafiku na pozadí.

Tato metoda tisku z prohlížeče zachytí stránku poté, co ColdFusion a její skripty na straně klienta vygenerují výstup. Obvykle jde o nejlepší volbu, pokud záleží na vizuální podobnosti s webovou stránkou.

Generování PDF v ColdFusion

U sestavy, kterou máte pod kontrolou, může Adobe ColdFusion vykreslit značky přímo pomocí <cfdocument>:

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

Vložte značky sestavy do bloku cfdocument nebo jím obalte již vygenerovaný výstup. Verze Adobe ColdFusion a instalace Lucee se mohou lišit v podpoře PDF engine, CSS, písem, obrázků a JavaScriptu, proto otestujte přesnou verzi serveru. Moderní responzivní CSS a JavaScript určený pouze pro prohlížeč se mohou vykreslovat jinak než stránka zobrazená v Chrome.

Pro automatizovaný výstup věrný prohlížeči použijte aktuální renderer založený na Chromium, například Playwright, Puppeteer nebo Chromium headless, a to nad vykreslenou URL. Základní příkaz Chromium je:

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

Chráněná stránka může vyžadovat předem ověřený kontext prohlížeče, relační cookie, HTTP hlavičku nebo interní endpoint pro vykreslování. Nevkládejte přihlašovací údaje do veřejné URL a nepředpokládejte, že renderer příkazového řádku získá automaticky přístup k uživatelské relaci.

Převod zdrojového kódu CFM

Pokud je požadován čitelný záznam kódu namísto vygenerované sestavy, otevřete soubor ve Visual Studio Code, Notepad++ nebo jiném editoru kódu a zvolte Print → Save as PDF. Výsledné PDF obsahuje zdrojový kód a komentáře; nespouští CFML, nedotazuje se databáze ani neobsahuje vygenerované záznamy. Zvýraznění syntaxe, čísla řádků a neproporcionální písma mohou zlepšit kontrolu kódu, ale zvyšují počet stránek.

Použití online převodníku

Online převod je vhodný pouze pro již vykreslené, necitlivé HTML nebo jiný export, který neobsahuje kód na straně serveru. Služba, jako je CloudConvert, může převádět podporované nahrané soubory HTML do PDF; ověřte, zda aktuální služba přijímá strukturu HTML a zdroje, které potřebujete. Další možností pro podporované vstupní dokumenty je Adobe Acrobat online, nejde však o náhradu runtime ColdFusion.

Nenahrávejte nezpracované soubory CFM, přihlašovací údaje k databázi, relační cookies, proprietární zdrojový kód ani důvěrná data sestav, pokud podmínky poskytovatele týkající se šifrování, uchovávání, zpracování a mazání nesplňují vaše požadavky. Obecný převodník obvykle nedokáže spouštět ColdFusion, řešit serverové includes, přistupovat k databázi aplikace ani se ověřovat u chráněných zdrojů.

Omezení kvality a kompatibility

• Tisk z prohlížeče může vynechat barvy pozadí CSS, obsah přesahující oblast, interaktivní ovládací prvky, zdroje načítané lazy loadingem nebo obrázky blokované ověřováním. Povolte grafiku na pozadí a zkontrolujte každou stránku výsledného PDF.
• cfdocument může vytvářet jiné stránkování a styly než prohlížeč, protože se může lišit jeho podpora CSS, webových písem, JavaScriptu a PDF engine.
• Používejte absolutní nebo dostupné URL zdrojů a ověřte, že proces vykreslování má přístup k obrázkům, šablonám stylů a písmům. Relativní cesty, které fungují v relaci prohlížeče, mohou selhat v rendereru na straně serveru nebo v headless rendereru.
• Pro reprodukovatelný výstup používejte pevné parametry URL a stabilní snímek dat. Živé dotazy, časová razítka, náhodné hodnoty a relace specifické pro uživatele mohou každé PDF změnit.
• PDF zachovává vzhled, nikoli chování aplikace; odkazy mohou zůstat aktivní, ale formuláře, filtry, nabídky, aktualizace AJAX a další interaktivní funkce mohou být odstraněny nebo přestat fungovat.