Konwertuj ASP na PDF

Raporty, faktury i wypełnione formularze generowane przez witrynę Classic ASP są często potrzebne jako pliki o stałym układzie do wysyłania pocztą e-mail, drukowania lub archiwizacji, gdy odbiorcy nie mogą uzyskać dostępu do aplikacji IIS. Plik PDF musi być tworzony na podstawie strony renderowanej przez serwer, a nie na podstawie pliku źródłowego .asp.

Czym jest plik ASP

Plik .asp zwykle zawiera kod Classic Active Server Pages dla Microsoft IIS. Może łączyć HTML z VBScript lub JScript, zapytaniami do bazy danych, plikami include, wartościami sesji i komponentami po stronie serwera; IIS wykonuje ten kod i wysyła wynikowy kod HTML do przeglądarki.

Plik ASP nie jest przenośnym formatem dokumentu. Bezpośrednie otwarcie pliku report.asp z poziomu File Explorer nie uruchamia go za pośrednictwem IIS, dlatego kod po stronie serwera, zawartość bazy danych i pliki include nie wygenerują zamierzonej strony. Classic ASP jest nadal dostępne jako funkcja IIS, ale jest starszą technologią; różni się od plików ASP.NET, takich jak .aspx, .cshtml i .razor.

Niektóre niezwiązane programy również używają rozszerzenia .asp. Jeśli plik nie pochodzi z projektu internetowego IIS, przed próbą konwersji ustal aplikację, która go utworzyła.

Co zapewnia PDF

PDF przechowuje widok tekstu, czcionek, obrazów, grafiki wektorowej i wymiarów strony o stałym układzie. Odbiorcy mogą otworzyć wyeksportowany raport bez serwera WWW, połączenia z bazą danych, konta aplikacji ani sesji, która go wygenerowała.

PDF zachowuje widoczny wynik w momencie eksportu, a nie działanie aplikacji internetowej. Zapytania do bazy danych, przesyłanie formularzy, stan logowania, elementy sterujące JavaScript i interaktywne wykresy nie pozostają funkcjonalne.

Konwertowanie wyrenderowanej strony ASP za pomocą przeglądarki

1. Uruchom aplikację na jej serwerze IIS lub na poprawnie skonfigurowanej lokalnej instalacji IIS. W przypadku lokalnego Classic ASP włącz usługę roli IIS World Wide Web Services → Application Development Features → ASP i skonfiguruj witrynę, uprawnienia puli aplikacji, ścieżki plików include oraz dostęp do bazy danych.
2. Otwórz stronę za pomocą adresu HTTP lub HTTPS, takiego jak http://localhost/reports/monthly.asp. Nie otwieraj pliku źródłowego za pomocą ścieżki file://.
3. Zaloguj się i wprowadź parametry raportu przed eksportem. Poczekaj, aż tabele, obrazy i wykresy generowane przez JavaScript zakończą ładowanie.
4. W Microsoft Edge, Google Chrome, Firefox lub innej aktualnej przeglądarce wybierz Print → Save as PDF. Wybierz rozmiar papieru, orientację, marginesy, skalę oraz nagłówki lub stopki, a następnie zapisz plik PDF.

Edge i Chrome są zwykle najlepszym wyborem w przypadku jednorazowego eksportu, ponieważ drukują ten sam bieżący widok renderowany przez przeglądarkę, który jest używany do wyświetlania raportu. Włącz opcję Background graphics, gdy układ wykorzystuje kolorowe nagłówki, cieniowane wiersze, tła logo lub obrazy tła CSS.

Automatyzacja cyklicznego eksportu

W przypadku dostępnej, nieuwierzytelnionej strony Chromium może drukować adres URL z wiersza poleceń: chrome.exe --headless --print-to-pdf=report.pdf http://localhost/reports/monthly.asp. Przeglądarka musi mieć dostęp do witryny IIS, w tym do wszystkich wymaganych zasobów.

W przypadku stron wymagających uwierzytelnienia lub stron, które ładują dane asynchronicznie, użyj Playwright lub Puppeteer, aby się zalogować, zaczekać na element oznaczający gotowość raportu i wywołać funkcję PDF przeglądarki. Jest to bardziej niezawodne niż natychmiastowe drukowanie z poziomu polecenia, ponieważ umożliwia zachowanie plików cookie i oczekiwanie na wykresy lub żądania API. Unikaj wkhtmltopdf w przypadku nowoczesnych witryn, chyba że jego wynik został przetestowany; jego stary silnik WebKit może znacznie różnić się pod względem obsługi CSS i JavaScript.

Konwersja online i sprawdzanie wyników

Usługi online, takie jak CloudConvert, mogą konwertować przesłany kod HTML lub publiczną stronę internetową do formatu PDF, ale nie mogą wykonywać przesłanego pliku źródłowego ASP jako aplikacji IIS. Używaj ich wyłącznie w przypadku niewrażliwego, już wyrenderowanego kodu HTML lub publicznego adresu URL; nie przesyłaj danych klientów, plików cookie sesji, prywatnych adresów URL ani kodu źródłowego.

Użyj arkusza stylów drukowania, aby usunąć nawigację, elementy sterujące i paski boczne. Reguły takie jak @media print, @page i break-inside: avoid mogą sterować widocznością, marginesami, podziałami stron i dzieleniem wierszy tabel.

Sprawdź końcowy plik PDF pod kątem obciętych szerokich tabel, brakujących czcionek, niedziałających adresów URL obrazów i pustych wykresów opóźnionych. Pliki PDF generowane przez przeglądarkę nie są automatycznie zgodne z PDF/A ani w pełni otagowane pod kątem dostępności; gdy obowiązują takie wymagania, użyj zweryfikowanego procesu PDF/A lub procesu zapewniającego dostępność.