HTML هو التنسيق المفضل لعرض المحتوى على الويب، ولكن هناك مواقف تتطلب تنسيق مستند أكثر موثوقية وثباتًا. وهنا يصبح تحويل HTML إلى XPS (مواصفات ورق XML) أمرًا بالغ الأهمية. XPS هو تنسيق موحد يضمن تخطيط الصفحة المتسق، مما يجعله مثاليًا لإنشاء مستندات وتقارير وأرشيفات جاهزة للطباعة حيث يكون التنسيق الدقيق ضروريًا.
- واجهة برمجة تطبيقات تحويل .NET HTML إلى XPS
- HTML إلى XPS في C# .NET
- تحويل HTML إلى XPS باستخدام أوامر cURL
- محول مجاني من HTML إلى XPS
واجهة برمجة تطبيقات تحويل .NET HTML إلى XPS
توفر GroupDocs.Conversion Cloud SDK for .NET طريقة قوية وفعّالة لتحويل ملفات HTML إلى تنسيق XPS. باستخدام هذه المجموعة، يصبح دمج إمكانيات التحويل في تطبيقات .NET أمرًا بسيطًا ويمكّن من تحويل محتوى HTML إلى مستندات XPS عالية الجودة بسلاسة. الخطوة الأولى في هذا النهج هي تثبيت مجموعة SDK من خلال البحث عن GroupDocs.Conversion-Cloud في مدير الحزم NuGet والنقر فوق الزر “تثبيت”. خيار آخر هو تنفيذ الأمر التالي في وحدة تحكم مدير الحزم.
NuGet\Install-Package GroupDocs.Conversion-Cloud -Version 24.2.0
بعد اكتمال التثبيت، يُرجى الحصول على بيانات اعتماد واجهة برمجة التطبيقات المخصصة (أي معرف العميل وسر العميل).يمكنك زيارة هذا البرنامج التعليمي القصير الذي يشرح التفاصيل حول كيفية الحصول على بيانات اعتماد واجهة برمجة التطبيقات.
HTML إلى XPS في C# .NET
يشرح هذا القسم التفاصيل حول كيفية إنشاء تقارير ذات تخطيط ثابت أو إنشاء مستندات جاهزة للطباعة عن طريق تحويل HTML إلى تنسيق XPS باستخدام C# .NET.
- إنشاء مثيل لفئة
Configuration
حيث نقوم بتمرير بيانات اعتماد العميل كوسائط.
var configurations = new Configuration(clientId, clientSecret1);
- قم بتهيئة
ConvertApi
حيث نقوم بتمرير كائن التكوين كحجة إدخال.
var apiInstance = new ConvertApi(configurations);
- قم بتحميل ملف HTML المدخل إلى التخزين السحابي.
fileUpload.UploadFile(new UploadFileRequest("sourceFile.html", stream));
- قم بإنشاء مثيل
ConvertSettings
حيث نحدد اسم HTML المدخل، والتنسيق الناتج كـxps
واسم مستند XPS الناتج كوسائط.
var settings = new ConvertSettings{...}
- اتصل بواجهة برمجة التطبيقات ConvertDocumentRequest لإجراء تحويل HTML إلى XPS وحفظ ملف XPS الناتج في التخزين السحابي.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
// مزيد من الأمثلة على https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// احصل على بيانات اعتماد API الخاصة بك
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// قم بإنشاء مثيل لفئة التكوين وقم بتهيئته باستخدام معرف العميل والسر الخاص بالعميل.
var configurations = new Configuration(clientId, clientSecret1);
// قم بتحديد قيمة ApiBaseUrl لتعيين عنوان URL الأساسي لواجهة برمجة تطبيقات تحويل HTML إلى XPS.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// قم بتهيئة مثيل لفئة ConvertApi باستخدام كائن من فئة Configuration.
var apiInstance = new ConvertApi(configurations);
// تحميل HTML المدخل من محرك الأقراص المحلي
using (var stream = System.IO.File.OpenRead("input.html"))
{
// إنشاء مثيل لـ FileApi
var fileUpload = new FileApi(configurations);
// تحميل ملف HTML المدخل إلى التخزين السحابي
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
// إنشاء ConvertSettings حيث نقوم بتحديد اسم HTML المصدر واسم ملف XPS الناتج
var settings = new ConvertSettings
{
StorageName = "default",
FilePath = "input.html",
Format = "xps",
OutputPath = "resultant.xps"
};
// استدعاء طريقة ConvertDocument لعملية تحويل HTML إلى XPS.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
if (response != null && response.Equals("OK"))
{
// طباعة رسالة النجاح
Console.WriteLine("The HTML to XPS conversion completed successfully !");
}
}
يمكن تنزيل ملف XPS الناتج الذي تم إنشاؤه في المثال أعلاه من resultantFile.xps.
تحويل HTML إلى XPS باستخدام أوامر cURL
يوفر تحويل HTML إلى XPS باستخدام GroupDocs.Conversion Cloud وأوامر cURL نهجًا مرنًا وفعالًا عندما تفضل أدوات سطر الأوامر والأتمتة. علاوة على ذلك، يعد هذا النهج مفيدًا بشكل خاص في السيناريوهات التي تتطلب المعالجة الآلية أو الدفعية، مما يجعله مثاليًا للمطورين الذين يدمجون تحويل المستندات في البرامج النصية أو سير العمل على جانب الخادم.
الخطوة الأولى في هذا النهج هي إنشاء رمز وصول JWT ثم تنفيذ أمر cURL التالي لتحويل صفحة الويب إلى ملف XPS. ثم يتم تخزين الملف الناتج في التخزين السحابي.
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"xps\",\"OutputPath\": \"{resultantFile}\"}"
يرجى استبدال sourceFile
باسم ملف HTML المدخل، وresultantFile
باسم ملف XPS الناتج وaccessToken
برمز وصول JWT المخصص.
- إذا كان متطلبك هو حفظ ملف XPS الناتج على محرك الأقراص المحلي، فيرجى محاولة استخدام أمر cURL التالي.
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"xps\"}" \
-o "{resultantFile}"
محول HTML إلى XPS مجاني
يمكنك التفكير في استكشاف الإمكانات القوية لواجهة برمجة تطبيقات GroupDocs.Conversion Cloud REST من خلال استخدام تطبيقنا المجاني HTML to XPS Conversion. إنه تطبيق خفيف الوزن وفعال للغاية، مما يتيح لك تجربة الإمكانات القوية لواجهة برمجة التطبيقات داخل متصفح الويب.
روابط مفيدة
خاتمة
يعد تحويل HTML إلى XPS أمرًا بالغ الأهمية لإنشاء مستندات متسقة وعالية الجودة ومناسبة للطباعة والأرشفة والمشاركة عبر الأنظمة الأساسية. سواء اخترت استخدام GroupDocs.Conversion Cloud SDK الشامل لـ .NET أو نهج الأمر cURL الخفيف، فإن كلا الطريقتين تقدمان حلولاً موثوقة ومرنة لتحقيق هذا التحويل. نشجعك على استكشاف واجهة برمجة التطبيقات الخاصة بنا والاستفادة من قدراتها لتبسيط احتياجات تحويل المستندات الخاصة بك وتقديم مخرجات احترافية بتنسيق ثابت دون عناء.
المقالات الموصى بها
ننصحك بشدة بزيارة الروابط التالية لمعرفة المزيد عن: