Konwertuj CFM na PDF

Strona ColdFusion często wymaga konwersji, gdy raport generowany przez serwer musi zostać przesłany, wydrukowany, zarchiwizowany lub udostępniony jako dokument o stałym układzie. Wymagana metoda zależy od tego, czy plik PDF ma zawierać stronę wyrenderowaną przez ColdFusion, czy kod źródłowy CFM.

Czym jest format CFM

.cfm to plik ColdFusion Markup zawierający instrukcje CFML wraz z HTML, CSS, JavaScript, a czasami także zapytaniami do bazy danych. Adobe ColdFusion i Lucee wykonują pliki CFM na serwerze, aby tworzyć dynamiczne strony, formularze, raporty i komponenty aplikacji. Plik CFM zazwyczaj nie jest gotowym dokumentem: kod po stronie serwera musi zostać wykonany, zanim przeglądarka otrzyma wygenerowany HTML.

Czym jest format PDF

PDF przechowuje stały układ strony, który można spójnie wyświetlać i drukować w Adobe Acrobat Reader, przeglądarkach internetowych oraz systemowych przeglądarkach PDF. Nadaje się do faktur, raportów, przesyłania dokumentów i archiwizacji, ponieważ odbiorcy nie potrzebują ColdFusion ani dostępu do oryginalnej bazy danych. PDF zachowuje wygląd wyrenderowanej strony, a nie wykonywalne działanie CFML ani aktywne źródło danych.

Konwertowanie wyrenderowanej strony ColdFusion

1. Uruchom plik CFM za pośrednictwem Adobe ColdFusion lub Lucee na lokalnym albo hostowanym serwerze internetowym.
2. Otwórz jego adres URL HTTP lub HTTPS w przeglądarce, na przykład https://example.test/report.cfm?id=42. Jeśli strona jest chroniona, najpierw się uwierzytelnij.
3. Przed utworzeniem pliku PDF sprawdź rekordy, obrazy, czcionki, tabele, podziały stron i obliczone wartości.
4. Wybierz Print → Save as PDF w Chrome, Edge, Firefox lub Safari. W razie potrzeby ustaw rozmiar papieru, orientację, marginesy, zakres stron, skalę i grafiki tła.

Ta metoda przeglądarkowa przechwytuje stronę po wygenerowaniu danych wyjściowych przez ColdFusion i skrypty po stronie klienta. Zwykle jest najlepszym wyborem, gdy ważne jest wizualne podobieństwo do strony internetowej.

Generowanie pliku PDF w ColdFusion

W przypadku raportu znajdującego się pod Twoją kontrolą Adobe ColdFusion może bezpośrednio renderować znaczniki za pomocą <cfdocument>:

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

Umieść znaczniki raportu wewnątrz bloku cfdocument albo opakuj nim istniejące wygenerowane dane wyjściowe. Wersje Adobe ColdFusion i instalacje Lucee mogą różnić się pod względem silnika PDF oraz obsługi CSS, czcionek, obrazów i JavaScript, dlatego przetestuj dokładną wersję serwera. Nowoczesny responsywny CSS i JavaScript działający wyłącznie w przeglądarce mogą być renderowane inaczej niż podczas wyświetlania strony w Chrome.

W przypadku automatycznego generowania danych wyjściowych wiernie odwzorowujących przeglądarkę użyj aktualnego renderera opartego na Chromium, takiego jak Playwright, Puppeteer lub Chromium headless, dla wyrenderowanego adresu URL. Podstawowe polecenie Chromium to:

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

Strona chroniona może wymagać wstępnie uwierzytelnionego kontekstu przeglądarki, pliku cookie sesji, nagłówka HTTP lub wewnętrznego endpointu renderowania. Nie umieszczaj danych uwierzytelniających w publicznym adresie URL i nie zakładaj, że renderer uruchamiany z wiersza poleceń automatycznie uzyska dostęp do sesji użytkownika.

Konwertowanie kodu źródłowego CFM

Jeśli wymagany jest czytelny zapis kodu, a nie wygenerowany raport, otwórz plik w Visual Studio Code, Notepad++ lub innym edytorze kodu i wybierz Print → Save as PDF. Wynikowy plik PDF zawiera kod źródłowy i komentarze; nie wykonuje CFML, nie odpytuje bazy danych ani nie zawiera wygenerowanych rekordów. Wyróżnianie składni, numery wierszy i czcionki o stałej szerokości mogą ułatwić przegląd kodu, ale zwiększają liczbę stron.

Korzystanie z konwertera online

Konwersja online jest odpowiednia wyłącznie w przypadku już wyrenderowanego, niepoufnego HTML lub innego eksportu, który nie zawiera kodu po stronie serwera. Usługa taka jak CloudConvert może konwertować obsługiwane pliki HTML do PDF; sprawdź, czy aktualna usługa akceptuje wymaganą strukturę HTML i potrzebne zasoby. Adobe Acrobat online to kolejna opcja dla obsługiwanych danych wejściowych dokumentów, ale nie zastępuje środowiska uruchomieniowego ColdFusion.

Nie przesyłaj surowych plików CFM, danych uwierzytelniających do bazy danych, plików cookie sesji, zastrzeżonego kodu źródłowego ani poufnych danych raportu, chyba że warunki dostawcy dotyczące szyfrowania, przechowywania, przetwarzania i usuwania danych spełniają Twoje wymagania. Ogólny konwerter zazwyczaj nie potrafi wykonywać ColdFusion, rozwiązywać dołączanych plików po stronie serwera, uzyskiwać dostępu do bazy danych aplikacji ani uwierzytelniać się w chronionych zasobach.

Ograniczenia jakości i zgodności

• Drukowanie z przeglądarki może pomijać kolory tła CSS, zawartość wychodzącą poza obszar, elementy interaktywne, zasoby ładowane leniwie lub obrazy zablokowane przez uwierzytelnianie. Włącz grafiki tła i sprawdź każdą stronę wynikowego pliku PDF.
• cfdocument może generować inne podziały stron i stylowanie niż przeglądarka, ponieważ obsługiwane przez niego CSS, czcionki internetowe, JavaScript i silnik PDF mogą się różnić.
• Używaj bezwzględnych lub osiągalnych adresów URL zasobów i potwierdź, że proces renderowania może uzyskać dostęp do obrazów, arkuszy stylów i czcionek. Ścieżki względne działające w sesji przeglądarki mogą zawieść w rendererze po stronie serwera lub rendererze headless.
• Aby uzyskać powtarzalne dane wyjściowe, używaj stałych parametrów URL i stabilnego zrzutu danych. Aktywne zapytania, znaczniki czasu, wartości losowe i sesje przypisane do użytkownika mogą zmieniać każdy plik PDF.
• PDF zachowuje wygląd, a nie działanie aplikacji; odnośniki mogą pozostać klikalne, ale formularze, filtry, menu, aktualizacje AJAX i inne funkcje interaktywne mogą zostać usunięte lub przestać działać.