یکپارچه‌سازی در یک برنامه وب ASP.NET Core امکان ویرایش یکپارچه اسناد را مستقیماً در پورتال وب شما فراهم می‌کند. GroupDocs.Editor Cloud SDK for .NET یک API قدرتمند ارائه می‌دهد که به شما اجازه می‌دهد فایل‌های DOCX را روی سرور بارگذاری، ویرایش و ذخیره کنید. این راهنما شما را از طریق تنظیمات مورد نیاز راهنمایی می‌کند، کد گام‌به‌گام را نشان می‌دهد و یک مثال کامل ارائه می‌دهد که می‌توانید در عرض چند دقیقه اجرا کنید. در پایان می‌توانید با اطمینان، ویرایش اسناد را به یک برنامه ASP.NET Core اضافه کنید.

پیش‌نیازها و راه‌اندازی

قبل از شروع، مطمئن شوید که موارد زیر را دارید:

  • .NET 6.0 SDK یا نسخه‌های بعدی نصب شده
  • یک IDE مانند 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 مستند شده است. مقداردهی اولیهٔ مشتری یک بار برای هر درخواست برای اکثر سناریوها کافی است؛ همچنین می‌توانید آن را به‌عنوان یک singleton در کانتینر تزریق وابستگی ASP.NET Core ثبت کنید تا عملکرد بهتری داشته باشید.

مرحله ۲: تعریف گزینه‌های بارگذاری

با استفاده از LoadOptions، فایل منبع و مکان خروجی مورد نظر را مشخص کنید. این شیء به سرویس می‌گوید که کدام سند را باز کند و رندر شده HTML را در کجا ذخیره کند.

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

LoadOptions، FileInfo و RenderOptions به شما امکان می‌دهند که نحوه رندر سند برای ویرایش را کنترل کنید. به عنوان مثال، می‌توانید RenderOptions را طوری تنظیم کنید که شامل تصاویر باشد، سبک‌های اصلی را حفظ کند یا تعداد صفحات رندر شده را محدود کنید.

مرحله ۳: فراخوانی LoadDocument

API را برای بارگذاری و تبدیل سند فراخوانی کنید. این فراخوانی در این مثال به صورت همزمان است، اما می‌توانید از نسخهٔ ناهمزمان نیز استفاده کنید اگر عمل‌کنندهٔ کنترلر شما async باشد.

var loadResult = editorApi.LoadDocument(loadOptions);

متد LoadDocument یک شیء نتیجه را برمی‌گرداند که شامل URLهای رندر شدهٔ HTML و سایر متادیتاها است. می‌توانید loadResult را برای بازیابی بعدی ذخیره کنید یا HTML را مستقیماً به front‑end پاس دهید.

مرحله 4: پردازش نتیجه بارگذاری

پس از بارگذاری، می‌توانید HTML را به فرانت‌اند سرو کنید یا برای استفاده بعدی ذخیره کنید. این گام جریان کاری یکپارچه‌سازی ویرایشگر سند در برنامه وب ASP.NET Core را کامل می‌کند و سند را برای تعامل کاربر آماده می‌سازد.

در یک سناریوی واقعی، معمولاً محتویات HTML را از یک اکشن کنترلر برمی‌گردانید:

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

شما ممکن است بخواهید برای جلوگیری از بارگذاری مجدد مکرر همان سند، کش‌گذاری را پیاده‌سازی کنید، که می‌تواند زمان پاسخ را هنگام integrating into an ASP.NET Core web application در مقیاس بزرگ بهبود بخشد.

ادغام ویرایشگر سند در برنامه وب 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 و API خام REST، انعطاف‌پذیری را هنگام یکپارچه‌سازی در یک برنامه وب ASP.NET Core به دست می‌آورید، که به شما اجازه می‌دهد روشی را انتخاب کنید که بهترین تطابق را با معماری شما داشته باشد.

سوالات متداول

مطالعه بیشتر