دمجها في تطبيق ويب ASP.NET Core يتيح تحرير المستندات بسلاسة مباشرة داخل بوابتك على الويب. GroupDocs.Editor Cloud SDK for .NET يوفر واجهة برمجة تطبيقات قوية تسمح لك بتحميل وتحرير وحفظ ملفات DOCX على الخادم. يوضح هذا الدليل الإعداد المطلوب، ويعرض كود خطوة بخطوة، ويوفر مثالًا كاملاً يمكنك تشغيله في دقائق. في النهاية ستكون قادرًا على إضافة تحرير المستندات إلى تطبيق ASP.NET Core بثقة.

المتطلبات والإعداد

قبل أن تبدأ، تأكد من أن لديك ما يلي:

  • .NET 6.0 SDK أو أحدث مثبت
  • بيئة تطوير متكاملة مثل Visual Studio 2022 أو VS Code
  • حساب GroupDocs Cloud للحصول على Client Id و Client Secret
  • الوصول إلى جهاز تطوير يعمل بنظام Windows أو Linux أو macOS

يتطلب التكامل مع تطبيق ويب ASP.NET Core أيضًا اتصال شبكة موثوق به بنقاط النهاية الخاصة بـ GroupDocs Cloud، لأن جميع معالجة المستندات تتم عن بُعد. خطط لبيئة النشر الخاصة بك وفقًا لذلك.

قم بتثبيت SDK عبر NuGet:

dotnet add package GroupDocs.editor-Cloud

قم بتنزيل أحدث حزمة من صفحة الإصدار الرسمية: GroupDocs.Editor Cloud SDK for .NET تنزيل.

إنشاء كائن التكوين باستخدام بيانات الاعتماد الخاصة بك (مقتطف من المثال الكامل):

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

مع تثبيت الحزمة وجاهزية بيانات الاعتماد، يمكنك المتابعة إلى التنفيذ. تشرح الأقسام التالية كل جزء من الشيفرة بالتفصيل، حتى تفهم كيف تتناسب المكتبة مع بنية تطبيق ويب ASP.NET Core الشاملة.

دليل خطوة بخطوة للتكامل في تطبيق ويب ASP.NET Core

هذا القسم يوضح عملية التكامل في تطبيق ويب ASP.NET Core إلى خطوات منفصلة وقابلة للإدارة. يتضمن كل خطوة مقطع شفرة قصير مأخوذ مباشرةً من تنفيذ المرجع.

الخطوة 1: تكوين بيانات اعتماد API

أولاً، قم بإنشاء كائن Configuration باستخدام تفاصيل العميل الخاص بك وأنشئ عميل EditorApi.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

تم توثيق الفئة EditorApi في مرجع API. تهيئة العميل مرة واحدة لكل طلب تكفي لمعظم السيناريوهات؛ يمكنك أيضًا تسجيله ككائن مفرد في حاوية حقن التبعيات في ASP.NET Core للحصول على أداء أفضل.

الخطوة 2: تعريف خيارات التحميل

حدد ملف المصدر وموقع الإخراج المطلوب باستخدام LoadOptions. يوضح هذا الكائن للخدمة أي مستند يجب فتحه وأين يتم تخزين HTML المُصدَّر.

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

LoadOptions، FileInfo و RenderOptions تتيح لك التحكم في كيفية عرض المستند للتحرير. على سبيل المثال، يمكنك ضبط RenderOptions لتضمين الصور، والحفاظ على الأنماط الأصلية، أو تحديد عدد الصفحات التي يتم عرضها.

الخطوة 3: استدعاء LoadDocument

استدعِ الـ API لتحميل المستند وتحويله. الاتصال متزامن في هذا المثال، ولكن يمكنك أيضًا استخدام النسخة غير المتزامنة إذا كان إجراء المتحكم الخاص بك غير متزامن.

var loadResult = editorApi.LoadDocument(loadOptions);

ترجع طريقة LoadDocument كائن نتيجة يحتوي على عناوين URL للـ HTML المعروض وغيرها من البيانات الوصفية. يمكنك تخزين loadResult لاسترجاعه لاحقًا أو تمرير الـ HTML مباشرة إلى الواجهة الأمامية.

الخطوة 4: معالجة نتيجة التحميل

بعد التحميل، يمكنك تقديم الـ HTML إلى الواجهة الأمامية أو تخزينه للاستخدام لاحقًا. تُكمل هذه الخطوة سير عمل دمج محرر المستندات في تطبيق ويب ASP.NET Core وتُعد المستند للتفاعل مع المستخدم.

في سيناريو واقعي، عادةً ما تقوم بإرجاع محتوى HTML من إجراء المتحكم:

return Content(loadResult.HtmlContent, "text/html");

قد ترغب أيضًا في تنفيذ التخزين المؤقت لتجنب إعادة تحميل نفس المستند بشكل متكرر، مما يمكن أن يحسن أوقات الاستجابة عند دمجها في تطبيق ويب ASP.NET Core على نطاق واسع.

دمج محرر المستندات في تطبيق ويب ASP.NET Core - مثال كامل للكود

يعرض الكود التالي العملية بالكامل من التكوين إلى تحميل ملف DOCX.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

var loadResult = editorApi.LoadDocument(loadOptions);

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث أي مسارات ملفات وقيم التكوين لتتناسب مع بيئتك الفعلية، وتحقق من تثبيت جميع الاعتمادات المطلوبة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

استخدام cURL لتكامل تحرير المستندات في ASP.NET Core

إذا كنت تفضل نهج REST مباشر، يمكن تنفيذ العملية نفسها باستخدام أوامر cURL. هذه الطريقة مفيدة للنمذجة السريعة أو عندما تحتاج إلى دمج المحرر في خدمة غير مكتوبة بـ .NET.

1. المصادقة والحصول على رمز الوصول

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

تحتوي الاستجابة على access_token يُستخدم في المكالمات اللاحقة.

2. تحميل ملف المصدر

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/storage/upload?path=/input.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.docx"

3. تحميل المستند للتحرير

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.docx" },
           "renderOptions": { "outputPath": "output.html" }
         }'

4. تحميل HTML المعروض

curl -X GET "https://api.groupdocs.cloud/v2.0/editor/storage/download?path=/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

توضح هذه الأوامر كيفية إضافة تحرير المستندات إلى تطبيق ASP.NET Core دون كتابة أي كود C#، وهو مفيد للاختبار السريع أو التكامل مع خدمات أخرى. لمزيد من التفاصيل، راجع وثائق API الرسمية.

من خلال إتقان كل من مكتبة .NET وواجهة REST API الخام، ستحصل على مرونة عند دمجها في تطبيق ويب ASP.NET Core، مما يتيح لك اختيار النهج الذي يتناسب بشكل أفضل مع بنية نظامك.

الأسئلة المتكررة

قراءة إضافية