ASP.NET Core Web アプリケーションに統合することで、Web ポータル内でシームレスにドキュメント編集が可能になります。GroupDocs.Editor Cloud SDK for .NET は、サーバー上で DOCX ファイルをロード、編集、保存できる強力な API を提供します。このガイドでは、必要なセットアップ手順を順を追って説明し、ステップバイステップのコードと数分で実行できる完全なサンプルを提供します。最後まで読めば、ASP.NET Core アプリケーションに自信を持ってドキュメント編集機能を追加できるようになります。

前提条件とセットアップ

開始する前に、以下が揃っていることを確認してください：

  • .NET 6.0 SDK またはそれ以降がインストールされていること
  • Visual Studio 2022 や VS Code などの IDE
  • Client Id と Client Secret を取得できる GroupDocs Cloud アカウント
  • Windows、Linux、または macOS の開発マシンへのアクセス

ASP.NET Core の Web アプリケーションへの統合には、すべてのドキュメント処理がリモートで行われるため、GroupDocs Cloud エンドポイントへの信頼できるネットワーク接続が必要です。デプロイ環境を適切に計画してください。

NuGet を使用して SDK をインストールする:

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 Web アプリケーションの全体アーキテクチャにどのように組み込まれるかを理解できるようにします。

ASP.NET Core Web アプリケーションへの統合ステップバイステップガイド

このセクションでは、ASP.NET Core Web アプリケーションへの統合プロセスを、個別の管理しやすいステップに分解して説明します。各ステップには、リファレンス実装から直接取得した短いコードフラグメントが含まれています。

ステップ 1: API 資格情報の構成

まず、クライアントの詳細を使用して Configuration オブジェクトをインスタンス化し、EditorApi クライアントを作成します。

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

var editorApi = new EditorApi(configuration);

EditorApi クラスは API reference にドキュメント化されています。ほとんどのシナリオでは、リクエストごとにクライアントを一度初期化すれば十分です。パフォーマンス向上のために、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 メソッドは、レンダリングされた HTML の URL とその他のメタデータを含む結果オブジェクトを返します。loadResult を後で取得できるように保存するか、HTML を直接フロントエンドに渡すことができます。

ステップ 4: ロード結果の処理

ロードした後、HTML をフロントエンドに提供するか、後で使用するために保存することができます。この手順により、integrating document editor into ASP.NET Core web app ワークフローが完了し、ドキュメントがユーザー操作のために準備されます。

実際のシナリオでは、通常、コントローラーアクションから HTML コンテンツを返します:

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

同じドキュメントを繰り返し再読み込みしないようにキャッシュを実装すると、スケール時に ASP.NET Core Web アプリケーションへの統合 の応答時間を改善できます。

ASP.NET Core Web アプリケーションへの Document Editor の統合 - 完全なコード例

次のコードは、構成から 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);

注意: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや構成値が実際の環境に合わせて更新されていることを確認し、すべての必須依存関係が正しくインストールされているか検証し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメントをご参照いただくか、サポートチームにお問い合わせください。

ASP.NET Core ドキュメント編集統合で cURL を使用する

直接的な 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

これらのコマンドは、C# コードを書かずに ASP.NET Core アプリケーションにドキュメント編集を追加 する方法を示しています。クイックテストや他のサービスとの統合に便利です。詳細については、公式 API ドキュメント をご覧ください。

.NET ライブラリと生の REST API の両方を習得することで、ASP.NET Core Web アプリケーションへの統合時に柔軟性が得られ、アーキテクチャに最適なアプローチを選択できます。

FAQs

さらに読む