ComOffice SDK · サーバー

サーバーでOfficeドキュメントを扱う

一つの.NETパッケージがWindows Serverとx64 Linuxで動作し、APIも同じです。サービスやバッチジョブ、コンテナーの中で、Word、Excel、PowerPointファイルを開いて編集・保存し、ページを画像にレンダリングしたり、PDFに書き出したりできます。

.NET 8+Windows ServerLinux x64コンテナー

2027-01-01まで無料で評価できます。GitHubからダウンロードしてください。

C#

using ComOfficeKit;

Engine.Configure(new EngineOptions {
    WorkingDirectory = workDir,
    WorkingDirectoryQuota = 2L << 30 });
License.Configure(LicenseStorage.Memory);
License.Activate(key);

using var limit = new CancellationTokenSource(
    TimeSpan.FromSeconds(60));
using var doc =
    Document.Open(input, limit.Token);
doc.ExportPdf(output, limit.Token);

できること

一つの.NETライブラリで、ドキュメントを開き、変更し、保存し、ページを描画できます。

開く、編集、保存

.docx、.xlsx、.xlsm、.pptx、.csv、.tsvファイルを開き、上書き保存または別名で保存できます。空のドキュメント、ワークブック、プレゼンテーションも作成できます。

ページ画像、テキスト、PDF

任意のページを24〜600 dpiのPNG画像にレンダリングし、ドキュメント全体をPDFに書き出します。各ページで描画されたテキストとその位置も取得できます。これを使えば、アプリのユーザーが画像上のテキストを選択、コピー、検索できます。

Word文書

ドキュメントのテキストを読み取り、全体のテキストを置換し、二つのドキュメントを比較して、差分を変更履歴として示す三つ目のドキュメントを作成します。

ワークブック

シートの一覧を取得し、セルの内容の読み取りと設定を行い、数式が計算した値をセルの表示どおりに読み取ります。

動作環境

Windows ServerとLinux(いずれもx64)で、同じパッケージを使います。

Windows Server

Windows Server 2022と2025でテスト済みで、Windowsコンテナーも、両者のフルイメージと2025の小さいイメージでテストされています。詳しくはComOffice for Windowsをご覧ください。

Linux

glibc 2.34以降のx64 Linux(Ubuntu 24.04、Debian 12、Red Hat Enterprise Linux 9でテスト済み)と、Microsoftの.NET 8ランタイムイメージを使ったLinuxコンテナー。詳しくはLinuxでのComOfficeをご覧ください。

一つのパッケージ

どちらも同じ.NETパッケージと同じAPIなので、サービスを変更せずに移せます。ライセンスには対象のプラットフォームが記載されています。

サーバーでの実行

サーバー向けガイドの要点です。スーパーバイザーとワーカーのサンプルも付いています。

ワーカープロセス

同時に変換するドキュメントの数だけワーカープロセスを動かします。通常はプロセッサーごとに一つです。エンジンは一つのプロセスの中で一度に一つのドキュメントしかレイアウトしないため、スレッドを増やしても速くならず、ワーカーをクラッシュさせたドキュメントがほかのジョブを巻き込むこともありません。

すべてのジョブの上限

元のサイズをはるかに超えて展開されるドキュメントは、何かを書き込む前に拒否されます。ディスクには上限があり、各呼び出しはキャンセルでき、キャンセルされた呼び出しは何も変更しません。メモリーはコンテナーやジョブオブジェクトで制限します。

フォント

ドキュメントで使われているフォントをインストールしてください。各ドキュメントは描画に使えなかったフォントを報告するため、作成者のレイアウトとページの収まりが異なる場合も理由がわかります。

Webページで表示

Webページでのドキュメント表示は今すぐ使えます(表示のみ)。各ページはサーバーがComOfficeで描画し、ブラウザーがそれを表示します。エンジンはサーバー上にとどまり、ブラウザーが受け取るのは、各ページの画像とテキスト、ドキュメント全体のPDFだけです。Webビューアーはすぐに使えます。コンポーネント、それが呼び出すサービス、HTML、React、Vueのスターターがそろっています。各ページのテキストを画像の上に重ねるので、選択、コピー、検索ができます。text-layer="none"にすると画像だけを表示します。ドキュメントを変更するときは、サービスがSDKで編集します。

よくある質問

どのサーバーで動作しますか?

Windows Server 2022と2025、およびglibc 2.34以降のx64 Linux(Ubuntu 24.04、Debian 12、Red Hat Enterprise Linux 9でテスト済み)で、いずれも.NET 8以降が必要です。どちらもコンテナーで実行できます。

Webページにドキュメントを表示できますか?

はい、今すぐ使えます(表示のみ)。Webビューアーは、ページに組み込める既製のコンポーネント、それが呼び出すサービス、HTML、React、Vueのスターターを提供します。各ページはサーバーがComOfficeで描画し、ブラウザーがそれを表示します。テキストは選択、コピー、検索できます。ドキュメントを変更するときは、サービスがSDKで編集します。サービスをインターネットに公開する前に、独自のサインインを追加してください。ブラウザーの中で直接動くSDKは開発中です。

サーバーではライセンスをどう扱えばよいですか?

ライセンスはメモリーに保持し、各ワーカーの起動時に有効化してください。コンテナーは実行のあいだに何も保持しないためです。ライセンスには対象のプラットフォームが記載されているため、サーバーにはそのプラットフォームを含むライセンスが必要です。

どうすれば入手できますか?

GitHubからダウンロードできます。各リリースにはパッケージが添付され、READMEには2027-01-01まで有効な無料の評価用キーが公開されています。ライセンスについては、お問い合わせフォームで営業チームにプロジェクトについてお知らせいただくか、sales@comofficekit.comまでメールをお送りください。

PDFファイルを開けますか?

いいえ。ComOfficeが扱えるのは.docx、.xlsx、.xlsm、.pptx、.csv、.tsvファイルで、これらをPDFに書き出します。PDFドキュメントを開いたり編集したりすることはできません。

サーバーでのComOfficeについてのお問い合わせ

開発内容をお知らせください。営業チームから折り返しご連絡します。sales@comofficekit.comへ直接メールをお送りいただくこともできます。