html إلى xps

تحويل HTML إلى XPS باستخدام C# .NET.

HTML هو التنسيق المفضل لعرض المحتوى على الويب، ولكن هناك مواقف تتطلب تنسيق مستند أكثر موثوقية وثباتًا. وهنا يصبح تحويل HTML إلى XPS (مواصفات ورق XML) أمرًا بالغ الأهمية. 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.

  1. إنشاء مثيل لفئة Configuration حيث نقوم بتمرير بيانات اعتماد العميل كوسائط.
var configurations = new Configuration(clientId, clientSecret1);
  1. قم بتهيئة ConvertApi حيث نقوم بتمرير كائن التكوين كحجة إدخال.
var apiInstance = new ConvertApi(configurations);
  1. قم بتحميل ملف HTML المدخل إلى التخزين السحابي.
fileUpload.UploadFile(new UploadFileRequest("sourceFile.html", stream));
  1. قم بإنشاء مثيل ConvertSettings حيث نحدد اسم HTML المدخل، والتنسيق الناتج كـ xps واسم مستند XPS الناتج كوسائط.
var settings = new ConvertSettings{...}
  1. اتصل بواجهة برمجة التطبيقات 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 !");
    }
}
html إلى xps

الصورة: - معاينة لتحويل HTML إلى XPS.

يمكن تنزيل ملف 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

روابط مفيدة

خاتمة

يعد تحويل HTML إلى XPS أمرًا بالغ الأهمية لإنشاء مستندات متسقة وعالية الجودة ومناسبة للطباعة والأرشفة والمشاركة عبر الأنظمة الأساسية. سواء اخترت استخدام GroupDocs.Conversion Cloud SDK الشامل لـ .NET أو نهج الأمر cURL الخفيف، فإن كلا الطريقتين تقدمان حلولاً موثوقة ومرنة لتحقيق هذا التحويل. نشجعك على استكشاف واجهة برمجة التطبيقات الخاصة بنا والاستفادة من قدراتها لتبسيط احتياجات تحويل المستندات الخاصة بك وتقديم مخرجات احترافية بتنسيق ثابت دون عناء.

المقالات الموصى بها

ننصحك بشدة بزيارة الروابط التالية لمعرفة المزيد عن: