Konwersja HTML przez ActiveX — osadź konwersję HTML we własnej aplikacji

Twoja aplikacja webowa musi zamieniać strony HTML na PDF, DOC lub TIFF po stronie serwera. Oczywiste opcje są bolesne: przeglądarka headless zużywa ogromne ilości pamięci i pada pod obciążeniem, proces wiersza poleceń startuje wolno i trudno go monitorować, a chmurowe API wyprowadza Twoje dane i nalicza opłaty za każde wywołanie.

Total HTML Converter X udostępnia pełny interfejs ActiveX / COM. Zainstancjonuj obiekt raz z .NET, PHP, Python, ASP, VBScript lub dowolnego środowiska obsługującego COM, wywołaj Convert() i odbierz plik wyjściowy. Żadnych podprocesów, żadnego renderowania w przeglądarce, żadnego zewnętrznego API. Pliki nigdy nie opuszczają Twojego serwera.

Co daje Ci interfejs ActiveX

• Konwersja wewnątrzprocesowa. Konwerter działa w przestrzeni procesu Twojej aplikacji. Brak Process.Start(), brak parsowania stdout, brak procesów-zombie.
• Wiele formatów wyjściowych z jednego wywołania. PDF, DOC, DOCX, XLS, TIFF, JPEG, RTF, TXT, XHTML, EMF — format przekazujesz jako parametr.
• Pełne renderowanie CSS. Style CSS 1 i CSS 2, obrazy inline, tabele i czcionki webowe renderowane przez własny silnik konwertera — bez zależności od przeglądarki.
• Wbudowane zabezpieczenia PDF. Hasła właściciela i użytkownika, ograniczenia kopiowania/drukowania, znaki wodne, podpisy cyfrowe — ustawiane jako parametry metody.
• Obsługa błędów przez HRESULT. Wyjątki COM pojawiają się jako natywne błędy Twojego języka (wyjątek .NET, PHP COMException, wyjątek win32 w Pythonie). Żadnego parsowania logów.
• Jedna licencja, nieograniczona liczba użytkowników. Zainstaluj na jednym serwerze, udostępniaj konwersję wszystkim użytkownikom swojej aplikacji.

(30-dniowy okres próbny — bez podawania e-maila)

Licencja serwerowa od $249.90

Czym naprawdę jest ActiveX / COM

ActiveX to model komponentowy firmy Microsoft. W praktyce oznacza to, że Total HTML Converter X rejestruje w systemie Windows klasę COM (HTMLConverter.HTMLConverterX), którą może zainstancjonować i wywoływać dowolne środowisko obsługujące COM. Nie wywołujesz REST API ani procesu wiersza poleceń — ładujesz bibliotekę DLL do swojej aplikacji i wywołujesz metody na obiekcie wewnątrzprocesowym.

Ma to znaczenie z trzech powodów:

• Szybkość. Brak startu procesu, brak IPC, brak gniazd. Konwerter to DLL ładowany raz.
• Niezawodność. Brak osieroconych procesów, brak plików PID, brak przeszukiwania logów. Jeśli wywołanie się nie powiedzie, Twój język rzuca wyjątek z HRESULT.
• Bezpieczeństwo. Żadne pliki nie są przesyłane przez sieć. Brak wspólnego katalogu tymczasowego. Konwersja zachodzi w pamięci lub we własnym katalogu roboczym Twojego procesu.

Dowolny język rozumiejący COM zadziała: C# i VB.NET przez interop .NET, C++ przez CoCreateInstance, PHP przez klasę COM, Python przez pywin32, Classic ASP przez Server.CreateObject, VBScript, JScript/WSH, Delphi, PowerShell, Ruby przez win32ole oraz Node.js przez winax.

Jak zintegrować Total HTML Converter X

• Krok 1. Zainstaluj Total HTML Converter X na maszynie Windows, na której działa Twoja aplikacja. Instalator automatycznie rejestruje klasę COM.
• Krok 2. Zweryfikuj rejestrację. Z wiersza poleceń uruchomionego z uprawnieniami administratora wykonaj reg query HKCR\HTMLConverter.HTMLConverterX. Jeśli klucz istnieje, obiekt COM jest gotowy.
• Krok 3. Dodaj referencję do obiektu COM w swoim projekcie. W .NET dodaj referencję COM lub użyj Type.GetTypeFromProgID(). W PHP użyj new COM("HTMLConverter.HTMLConverterX"). W Pythonie użyj win32com.client.Dispatch("HTMLConverter.HTMLConverterX").
• Krok 4. Wywołaj Convert(source, destination, options). Przekaż ścieżkę wejściowego HTML, ścieżkę pliku wyjściowego oraz łańcuch opcji z flagami takimi jak -c PDF, -OwnerPassword secret, -Watermark CONFIDENTIAL.
• Krok 5. Obsłuż zwracaną wartość lub wyjątek. Przy powodzeniu plik wyjściowy zostanie utworzony. Przy niepowodzeniu wywołanie COM rzuci natywny wyjątek języka z HRESULT i tekstem błędu.
• Krok 6. Wdróż. Dla ASP.NET lub IIS upewnij się, że tożsamość puli aplikacji ma uprawnienia do odczytu źródłowego HTML, zapisu do ścieżki wyjściowej oraz dostępu do rejestru COM. Dla Pythona lub PHP użytkownik uruchamiający skrypt potrzebuje tych samych uprawnień.

Przykłady kodu

C# / .NET

var conv = Activator.CreateInstance(
    Type.GetTypeFromProgID("HTMLConverter.HTMLConverterX"));
conv.GetType().InvokeMember("Convert",
    System.Reflection.BindingFlags.InvokeMethod, null, conv,
    new object[] { @"C:\In\report.html", @"C:\Out\report.pdf",
                   "-c PDF -OwnerPassword s3cret -NoPrint" });

PHP

$c = new COM("HTMLConverter.HTMLConverterX");
$c->Convert(
    "C:\\In\\report.html",
    "C:\\Out\\report.pdf",
    "-c PDF -Watermark DRAFT -log C:\\Logs\\html.log"
);

Python (pywin32)

import win32com.client
conv = win32com.client.Dispatch("HTMLConverter.HTMLConverterX")
conv.Convert(
    r"C:\In\report.html",
    r"C:\Out\report.pdf",
    "-c PDF -OwnerPassword secret -NoPrint"
)

Classic ASP / VBScript

Set Conv = Server.CreateObject("HTMLConverter.HTMLConverterX")
Conv.Convert _
    "C:\In\report.html", _
    "C:\Out\report.pdf", _
    "-c PDF -Watermark ""COMPANY CONFIDENTIAL"""
Set Conv = Nothing

Opcje formatu wyjściowego

Trzeci argument Convert() to łańcuch flag oddzielonych spacjami. Kluczowa flaga to -c FORMAT. Zmień ją, a zmienisz format wyjściowy:

Możesz łączyć z flagami zabezpieczeń i układu:

• -OwnerPassword secret — hasło właściciela PDF (kontroluje uprawnienia)
• -UserPassword open123 — hasło otwarcia PDF
• -NoPrint / -NoCopy / -NoModify — ograniczenia uprawnień PDF
• -Watermark "CONFIDENTIAL" — tekstowy znak wodny na każdej stronie
• -PageSize A4 / Letter / Legal — rozmiar papieru
• -log C:\Logs\html.log — zapis logu konwersji do monitorowania

ActiveX vs wiersz poleceń vs przeglądarka headless

Kiedy użyć integracji ActiveX

1. Aplikacje webowe o dużej przepustowości. Witryna ASP.NET lub Classic ASP konwertuje podglądy e-maili HTML, faktury lub wyciągi do PDF przy każdym żądaniu. ActiveX eliminuje narzut uruchamiania procesu — każda konwersja to wywołanie metody, a nie podproces.
2. Niestandardowe przepływy dokumentów. Usługa Windows pobiera pliki HTML z obserwowanego folderu, konwertuje je do PDF ze znakami wodnymi firmy i umieszcza wyniki w systemie zarządzania dokumentami. Usługa hostuje obiekt COM bezpośrednio; bez shell-outu, bez plików wsadowych.
3. Backendy SaaS z wieloma dzierżawcami. Każdy dzierżawca przesyła szablony HTML wymagające konwersji. Interfejs ActiveX pozwala Twojemu backendowi kolejkować i przetwarzać konwersje z tym samym modelem współbieżności co reszta potoku.
4. Środowiska odizolowane od sieci. Wdrożenia on-premises, gdzie chmurowe API konwersji są zablokowane lub zabronione. Komponent ActiveX działa całkowicie wewnątrz perymetru sieci.
5. Istniejące architektury oparte na COM. Aplikacje legacy zbudowane na Classic ASP, VB6 lub C++ z COM już wiedzą, jak pracować z komponentami ActiveX. Total HTML Converter X wpina się tak samo.
6. Zastąpienie potoków opartych na przeglądarkach headless. Zespoły odchodzące od Puppeteer lub PhantomJS z powodu presji pamięciowej, częstych aktualizacji lub awarii przechodzą na ActiveX dla przewidywalnego zużycia zasobów.

Dlaczego Total HTML Converter X

Stworzony z myślą o serwerach

Brak GUI, brak okien potwierdzenia, brak monitów "Zapisz jako". Działa pod IIS, wewnątrz usług Windows lub z zadań harmonogramu bez zalogowanego użytkownika.

Własny silnik renderujący

Przeglądarka nie jest wymagana. Konwerter parsuje HTML i CSS własnym kodem. Oznacza to, że aktualizacje Chrome nie zepsują Twojego potoku, nie ma profili przeglądarki, nie ma niezgodności wersji driverów.

Jedna licencja na serwer

W przeciwieństwie do cenników per użytkownik lub per konwersja, Total HTML Converter X jest licencjonowany per serwer. Obsłuż tysiące użytkowników z jednej licencji.

Dołączone projekty przykładowe

Instalator dostarcza działające projekty przykładowe dla ASP, PHP i C++. Otwórz je w Visual Studio, wybranym IDE lub edytorze tekstu i dostosuj do swoich potrzeb.

30-dniowa wersja próbna, w pełni funkcjonalna

Bez znaku wodnego, bez limitu konwersji, bez konieczności podawania e-maila przy pobieraniu. Zintegruj z prototypem, udowodnij, że działa, a następnie kup licencję.

(30-dniowy okres próbny — bez podawania e-maila)

Licencja serwerowa od $249.90

Konwerter plików HTML dla serwerów Opinie klientów 2026

"Zastąpiłem potok Puppeteer, który zużywał 2 GB RAM na workera i padał każdej nocy. Wywołanie ActiveX wpasowuje się w naszą istniejącą usługę roboczą .NET — jedno wywołanie metody, brak podprocesu, brak przeglądarki headless do restartowania. Pamięć pozostaje stabilna. Jakość wyjścia PDF jest lepsza niż ta, którą dawał nam Chromium, zwłaszcza na CSS z tabelami."

Daniel Park Senior Backend Engineer

"Prowadzimy portal rozliczeniowy w PHP pod IIS. Faktury są generowane jako szablony HTML, konwertowane do PDF na bieżąco i wysyłane e-mailem do klientów. Integracja COM to trzy linie PHP. Brak API chmurowego, żadne pliki nie opuszczają naszego serwera. Jednorazowa licencja $249.90 zwróciła się w pierwszym tygodniu użytkowania w porównaniu z API naliczającym opłaty per dokument, które rozważaliśmy."

Amira Hassan Web Applications Developer

"Zintegrowałem z aplikacją Classic ASP, która działa od ponad 15 lat. <code>Server.CreateObject("HTMLConverter.HTMLConverterX")</code> zadziałało za pierwszym razem pod IIS. Dobrze, że rejestracje 32-bit i 64-bit są oddzielne &mdash; potrzebowałem wersji 32-bitowej. Dokumentacja mogłaby mieć więcej przykładów specyficznie dla VB6, ale przykład ASP był wystarczająco bliski, aby go zaadaptować."

Victor Rossi IT Integration Lead

FAQ ▼