Інтеграція в веб‑додаток 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 для кращої продуктивності.

Крок 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 для завантаження та конвертації документа. У цьому прикладі виклик є синхронним, але ви також можете використати асинхронну версію, якщо ваша дія контролера є async.

var loadResult = editorApi.LoadDocument(loadOptions);

Метод LoadDocument повертає об’єкт результату, що містить URL‑адреси до згенерованого HTML та інші метадані. Ви можете зберегти loadResult для подальшого отримання або передати HTML безпосередньо на фронтенд.

Крок 4: Обробка результату завантаження

Після завантаження ви можете передати HTML на front‑end або зберегти його для подальшого використання. Цей крок завершує робочий процес integrating document editor into ASP.NET Core web app і готує документ до взаємодії користувача.

У реальному сценарії ви зазвичай повертатимете HTML‑вміст з дії контролера:

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

Ви також можете захотіти впровадити кешування, щоб уникнути повторного завантаження того самого документа, що може покращити час відповіді при integrating into an ASP.NET Core web application у масштабі.

Інтеграція Document Editor у веб‑застосунок 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, що дозволяє обрати підхід, який найкраще відповідає вашій архітектурі.

Питання та відповіді

Подальше читання