تحويل HTML بواسطة ActiveX — دمج تحويل HTML في تطبيقك

يحتاج تطبيق الويب الخاص بك إلى تحويل صفحة HTML إلى PDF أو DOC أو TIFF على الخادم. الخيارات الواضحة مؤلمة: متصفح بلا واجهة يستهلك ذاكرة RAM ويتعطل تحت الحمل، وعملية سطر أوامر بطيئة في البدء ويصعب مراقبتها، وواجهة API سحابية تُسرّب بياناتك وتحاسبك على كل مكالمة.

يوفر Total HTML Converter X واجهة ActiveX / COM كاملة. قم بإنشاء الكائن مرة واحدة من .NET أو PHP أو Python أو ASP أو VBScript أو أي بيئة تشغيل قادرة على التعامل مع COM، واستدعِ Convert()، واحصل على ملف الإخراج. بدون إنتاج عمليات فرعية، بدون عرض للمتصفح، بدون واجهة API خارجية. الملفات لا تغادر خادمك أبدًا.

ماذا تقدم لك واجهة ActiveX

• تحويل داخل العملية. يعمل المحول داخل مساحة عملية تطبيقك. بدون Process.Start()، بدون تحليل stdout، بدون عمليات زومبي.
• إخراج بصيغ متعددة من استدعاء واحد. PDF، DOC، DOCX، XLS، TIFF، JPEG، RTF، TXT، XHTML، EMF — مرِّر الصيغة كمعامل.
• عرض CSS كامل. أنماط CSS 1 و CSS 2، الصور المضمّنة، الجداول، وخطوط الويب يتم عرضها بواسطة محرك المحول الخاص — بدون الاعتماد على متصفح.
• أمان PDF مدمج. كلمات مرور المالك والمستخدم، قيود النسخ/الطباعة، العلامات المائية، التوقيعات الرقمية — تُعيَّن كمعاملات للطريقة.
• معالجة الأخطاء عبر HRESULT. تظهر استثناءات COM كأخطاء أصلية للغة (استثناء .NET، COMException لـ PHP، استثناء win32 لـ Python). بدون تحليل السجلات.
• رخصة واحدة، عدد غير محدود من المستخدمين. قم بالتثبيت على خادم واحد، وقدِّم التحويل لكل مستخدم من تطبيقك.

(تجربة 30 يومًا — بدون الحاجة إلى بريد إلكتروني)

رخصة الخادم تبدأ من 249.90$

ما هو ActiveX / COM فعليًا

ActiveX هو نموذج مكوّنات من Microsoft. عمليًا، يعني ذلك أن Total HTML Converter X يسجّل فئة COM في Windows (HTMLConverter.HTMLConverterX) يمكن لأي بيئة تشغيل تدعم COM أن تنشئ منها كائنًا وتستدعيها. أنت لا تستدعي REST API أو عملية سطر أوامر — أنت تُحمّل DLL داخل تطبيقك وتستدعي الطرق على كائن داخل العملية.

هذا مهم لثلاثة أسباب:

• السرعة. بدون بدء عملية، بدون IPC، بدون مقبس. المحول هو DLL يُحمَّل مرة واحدة.
• الموثوقية. بدون عمليات يتيمة، بدون ملفات PID، بدون تحليل للسجلات. إذا فشل الاستدعاء، تُطلق لغتك استثناءً مع HRESULT.
• الأمان. لا تُنقل ملفات عبر الشبكة. لا يوجد دليل مؤقت مشترك. يحدث التحويل في الذاكرة أو في دليل عمل العملية الخاص بك.

أي لغة تتحدث COM تعمل: C# و VB.NET عبر .NET interop، C++ عبر CoCreateInstance، PHP عبر فئة COM، Python عبر pywin32، Classic ASP عبر Server.CreateObject، VBScript، JScript/WSH، Delphi، PowerShell، Ruby عبر win32ole، و Node.js عبر winax.

كيفية دمج Total HTML Converter X

• الخطوة 1. تثبيت Total HTML Converter X على جهاز Windows حيث يعمل تطبيقك. يقوم المُثبِّت بتسجيل فئة COM تلقائيًا.
• الخطوة 2. التحقق من التسجيل. من موجّه أوامر بصلاحيات مرتفعة، شغّل reg query HKCR\HTMLConverter.HTMLConverterX. إذا كان المفتاح موجودًا، فإن كائن COM جاهز.
• الخطوة 3. الإشارة إلى كائن COM من مشروعك. في .NET، أضف مرجع COM أو استخدم Type.GetTypeFromProgID(). في PHP، استخدم new COM("HTMLConverter.HTMLConverterX"). في Python، استخدم win32com.client.Dispatch("HTMLConverter.HTMLConverterX").
• الخطوة 4. استدعِ Convert(source, destination, options). مرِّر مسار HTML الإدخال ومسار ملف الإخراج وسلسلة خيارات مع أعلام مثل -c PDF، -OwnerPassword secret، -Watermark CONFIDENTIAL.
• الخطوة 5. التعامل مع القيمة المُرجَعة أو الاستثناء. عند النجاح، يُنشَأ ملف الإخراج. عند الفشل، يُطلِق استدعاء COM استثناءً أصليًا للغة مع HRESULT ونص الخطأ.
• الخطوة 6. النشر. لـ ASP.NET أو IIS، تأكد من أن هوية تجمّع التطبيقات لديها صلاحية قراءة HTML المصدر والكتابة إلى مسار الإخراج والوصول إلى سجل COM. لـ Python أو PHP، يحتاج المستخدم الذي يُشغّل السكربت إلى نفس الصلاحيات.

نماذج الكود

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

خيارات صيغة الإخراج

المعامل الثالث لـ Convert() هو سلسلة أعلام مفصولة بمسافات. العلم الرئيسي هو -c FORMAT. غيِّره وتغيير الإخراج:

يمكنك الجمع بين أعلام الأمان والتخطيط:

• -OwnerPassword secret — كلمة مرور مالك PDF (تتحكم في الصلاحيات)
• -UserPassword open123 — كلمة مرور فتح PDF
• -NoPrint / -NoCopy / -NoModify — قيود صلاحيات PDF
• -Watermark "CONFIDENTIAL" — ختم نص علامة مائية على كل صفحة
• -PageSize A4 / Letter / Legal — حجم الورق
• -log C:\Logs\html.log — كتابة سجل التحويل للمراقبة

ActiveX مقابل سطر الأوامر مقابل المتصفح بلا واجهة

متى تستخدم دمج ActiveX

1. تطبيقات الويب عالية الإنتاجية. موقع ASP.NET أو Classic ASP يحوّل معاينات البريد الإلكتروني HTML أو الفواتير أو كشوفات الحساب إلى PDF في كل طلب. يُزيل ActiveX عبء إنشاء العمليات — كل تحويل هو استدعاء طريقة، لا عملية فرعية.
2. سير عمل مستندات مخصّص. خدمة Windows تلتقط ملفات HTML من مجلد مراقَب، وتحوّلها إلى PDF مع علامات مائية للشركة، وتُودِع النتائج في نظام إدارة المستندات. الخدمة تستضيف كائن COM مباشرة؛ بدون shell-out، بدون ملفات دفعية.
3. واجهات خلفية لـ SaaS متعدد المستأجرين. يقدّم كل مستأجر قوالب HTML تحتاج إلى تحويل. تتيح واجهة ActiveX للواجهة الخلفية وضع تحويلات في قائمة الانتظار ومعالجتها بنفس نموذج التزامن المستخدم في بقية خط الأنابيب.
4. بيئات معزولة عن الشبكة. النشر في المقر حيث تُحظر أو تُمنع واجهات برمجة التحويل السحابية. يعمل مكوّن ActiveX بالكامل داخل محيط الشبكة.
5. البنيات القائمة على COM الموجودة. التطبيقات القديمة المبنية على Classic ASP أو VB6 أو C++ مع COM تعرف بالفعل كيفية العمل مع مكوّنات ActiveX. يندمج Total HTML Converter X بنفس الطريقة.
6. استبدال خطوط أنابيب المتصفح بلا واجهة. الفرق التي تنتقل بعيدًا عن Puppeteer أو PhantomJS بسبب ضغط الذاكرة أو كثرة التحديثات أو تكرار الأعطال تتحوّل إلى ActiveX لاستخدام موارد يمكن التنبؤ به.

لماذا Total HTML Converter X

مصمَّم خصيصًا للخوادم

بدون واجهة رسومية، بدون مربعات تأكيد، بدون مطالبات "حفظ باسم". يعمل تحت IIS، داخل خدمات Windows، أو من المهام المجدولة دون تسجيل دخول مستخدم.

محرك عرض خاص

لا حاجة لمتصفح. يحلّل المحول HTML و CSS بكوده الخاص. هذا يعني لا تحديثات Chrome تكسر خط أنابيبك، لا ملفات تعريف متصفح، لا عدم تطابق لإصدارات برامج التشغيل.

رخصة واحدة لكل خادم

على عكس التسعير لكل مستخدم أو لكل تحويل، يُرخَّص Total HTML Converter X لكل خادم. اخدم آلاف المستخدمين من رخصة واحدة.

مشاريع نموذجية مُضمّنة

يأتي المُثبِّت بمشاريع نموذجية عاملة لـ ASP و PHP و C++. افتحها في Visual Studio أو بيئة التطوير المفضّلة لديك أو محرر نصوص وكيِّفها وفقًا لاحتياجاتك.

تجربة 30 يومًا كاملة الوظائف

بدون علامة مائية، بدون حد للتحويل، بدون بريد إلكتروني مطلوب للتنزيل. ادمجها في النموذج الأولي الخاص بك، أثبت أنها تعمل، ثم رخِّصها.

(تجربة 30 يومًا — بدون الحاجة إلى بريد إلكتروني)

رخصة الخادم تبدأ من 249.90$

محول ملفات HTML للخوادم آراء العملاء 2026

"استبدلتُ خط أنابيب Puppeteer كان يستهلك 2 غيغابايت من ذاكرة RAM لكل عامل ويتعطل ليلًا. يتناسب استدعاء ActiveX مع خدمة عامل .NET الحالية لدينا — استدعاء طريقة واحد، بدون عملية فرعية، بدون متصفح بلا واجهة يحتاج إعادة تشغيل. تبقى الذاكرة مستقرة. جودة إخراج PDF أفضل مما أعطانا Chromium، خاصةً مع CSS الذي يحتوي على جداول."

Daniel Park Senior Backend Engineer

"نُشغّل بوابة فوترة PHP تحت IIS. تُنشَأ الفواتير كقوالب HTML، وتُحوَّل إلى PDF فورًا، وتُرسَل عبر البريد الإلكتروني إلى العملاء. دمج COM هو ثلاثة أسطر من PHP. بدون واجهة API سحابية، بدون ملفات تغادر خادمنا. رخصة 249.90$ لمرة واحدة سدّدت نفسها في الأسبوع الأول من الاستخدام مقارنةً بواجهة API لكل مستند كنا نقيّمها."

Amira Hassan Web Applications Developer

"دمجتُه مع تطبيق Classic ASP يعمل منذ أكثر من 15 عامًا. نجح <code>Server.CreateObject("HTMLConverter.HTMLConverterX")</code> من أول محاولة تحت IIS. من الجيد أن تسجيلات 32-بت و 64-بت منفصلة &mdash; احتجتُ الإصدار 32-بت. يمكن للوثائق الاستفادة من المزيد من العيّنات لـ VB6 تحديدًا، لكن عيّنة ASP كانت قريبة بما يكفي للتكيّف."

Victor Rossi IT Integration Lead

FAQ ▼