Office アドイン プラットフォームの概要

Office アドインのプラットフォームを使用して、Office アプリケーションを拡張し、Office ドキュメント内のコンテンツと対話するソリューションを構築します。 Office アドインを使用すると、HTML、CSS、JavaScript などの使い慣れた Web テクノロジを使用して、Outlook、Excel、Word、PowerPoint、OneNote、Project を拡張して操作できます。 ソリューションは、Windows、Mac、iPad、ブラウザーなど、複数のプラットフォームにわたる Office で実行できます。

重要

アドインには、次の 2 種類のマニフェストのいずれかを含めることができます。 この記事は、アドインがほとんどのシナリオで推奨される種類である Microsoft 365 の統合マニフェストを使用していることを前提として記述されています。 2 種類のアドインの詳細については、「 Office アドイン マニフェスト」を参照してください。

Office アプリケーションと埋め込みの Web サイト (アドイン) によって、無限の拡張性が実現します。

Office アドイン プラットフォームを使用して、次のことができます。

  • Office クライアントへの新機能の追加 - 外部データを Office に取り込む、Office ドキュメントを自動化する、Office クライアントで Microsoft などの機能を公開します。 たとえば、Microsoft Graph API を使用して、生産性の向上につながるデータに接続します。

  • Office アプリケーションで開かれているドキュメントを読み書きするカスタム Copilot エージェントを作成する (プレビュー) - ユーザーが自然言語を使用してアドインの機能にアクセスできるようにします。

  • Office ドキュメントに埋め込み可能な充実した対話型のオブジェクトを新しく作成する - マップやグラフ、ユーザーが自分の Excel スプレッドシートや PowerPoint プレゼンテーションに追加できる対話型の視覚化などを埋め込みます。

Office アドインのコンポーネント

Office アドインには、アプリ パッケージと独自の Web アプリケーションの 2 つの基本コンポーネントが含まれています。 パッケージには、アドインを Office クライアントと統合する方法など、さまざまな設定を定義するマニフェストが含まれています。 Web アプリケーションは Web サーバーか、Microsoft Azure などの Web ホスティング サービスでホストされる必要があります。

アプリ パッケージ

Microsoft 365 用アプリのアプリ パッケージは zip ファイルであり、マニフェスト ファイル、2 つのアプリ アイコン、追加の構成ファイルやローカライズ ファイル (可能性もあります) が含まれています。 アプリ ロジックとデータ ストレージは他の場所でホストされ、HTTPS 経由で Microsoft 365 ホスト アプリケーションによってアクセスされます。 アプリ パッケージを管理者に送信して組織に公開するか、パートナー センターに送信して Microsoft Marketplace に公開します。

アプリ パッケージの詳細な概要については、「 Microsoft 365 用アプリ パッケージ」を参照してください。

マニフェスト

マニフェストは、アドインの設定と機能を指定します。次のようなものがあります。

  • アドインの表示名、説明、ID、バージョン、および既定のロケール。

  • Office とアドインを統合する方法。

  • アドインと Copilot の統合方法 (プレビュー)。

  • アドインのアクセス許可レベルとデータ アクセスの要件。

マニフェストの詳細な概要については、「 Microsoft 365 用統合アプリ マニフェストを使用した Office アドイン」を参照してください。

Web アプリケーション

最も基本的な Office アドインは、Office アプリケーション内に表示される静的な HTML ページで構成されていますが、このページとは Office ドキュメントやその他のインターネット リソースとは一切やり取りしません。 ただし、Office ドキュメントと対話できるエクスペリエンス、またはユーザーが Office クライアント アプリケーションからオンライン リソースを操作できるようにするエクスペリエンスを作成するには、ホスト プロバイダーがサポートしているクライアント側とサーバー側の両方のテクノロジ (ASP.NET、PHP、Node.js など) を使用できます。 Office クライアントやドキュメントを操作するには、Office.js JavaScript API を使用します。

Hello World アドインのコンポーネント。

Office クライアントの拡張と、Office クライアントとの対話

Office クライアント アプリケーション内で、Office アドインは次のタスクを実行できます。

  • 機能を拡張する

  • Copilot から自然言語の指示を実行する (プレビュー)

  • 新しいオブジェクトを作成する (Excel または PowerPoint のみ)

Office 機能の拡張

次の機能を使用して、Office アプリケーションに新しい機能を追加できます。

  • カスタム リボン ボタンとメニュー コマンド (総称して "アドイン コマンド"と呼ばれます)。

  • Web ページがブラウザー内で実行できるほとんどすべての操作を実行できる webview コントロールを備えた挿入可能なタスク ペイン。

  • Office ドキュメントまたは Office アプリケーションのイベントに応答するイベント ハンドラー。

カスタム UI、作業ウィンドウ、イベント ハンドラーはアドイン マニフェストで指定されます。  

カスタム ボタンとメニュー コマンド

Web 版 Office と Windows 版の Office のリボンに、カスタム リボン ボタンやメニュー項目を追加することができます。 これにより、ユーザーは、Office アプリケーションから直接アドインに簡単にアクセスできます。 カスタム ボタンとメニュー項目は、カスタム HTML を使用した作業ウィンドウの表示や JavaScript 関数の実行など、さまざまなアクションを起動できます。

カスタム ボタンとメニュー コマンド。

作業ウィンドウ

ユーザーがソリューションと対話できるようにするために、アドイン コマンドに加えて、作業ウィンドウを使用できます。 Excel、Word、PowerPoint では、[ ホーム>アドイン ] ボタンを使用して作業ウィンドウのアドインを起動します。 Outlook では、ユーザーはアドイン ボタンまたはリボンの [ すべてのアプリ ] ボタンを使用して作業ウィンドウのアドインを起動します。

アドイン コマンドに加えて、作業ウィンドウを使用します。

Outlook の機能を拡張する

ユーザーは、メール、会議出席依頼、会議の返信、会議のキャンセル、または予定を表示、返信、または作成するときに Outlook アドインを実行できます。 Outlook アドインは次のタスクを実行できます。

  • Office アプリのリボンを拡張します。
  • Outlook アイテムを表示または作成しているときに、アイテムの横にコンテキストに応じて表示します。
  • ユーザーが新しいメッセージを作成するときなど、特定のイベントが発生したときにタスクを実行します。

注:

ユーザーの予定表、会議、または予定と対話するアドインは、ユーザーが Teams ではなく Outlook で予定表を開いた場合にのみ使用できます。 ただし、Teams 会議アプリを作成して Outlook で表示することはできます。 詳細については、「 Teams 会議アプリを Outlook に拡張する」を参照してください。

Outlook アドインの概要については、「Outlook アドインの概要」を参照してください。

Office ドキュメント内に新しいオブジェクトを作成する

コンテンツ アドインと呼ばれる Web ベースのオブジェクトを Excel ドキュメントおよび PowerPoint ドキュメント内に埋め込むことができます。 コンテンツ アドインにより、ユーザーは充実した Web ベースのデータの可視化、埋め込まれたメディア (YouTube ビデオ プレーヤーや画像ギャラリーなど)、およびその他の外部コンテンツを統合できます。

コンテンツ アドインと呼ばれる Web ベースのオブジェクトを埋め込みます。

Office JavaScript API

Office JavaScript API には、アドインを構築したり、Office のコンテンツおよび Web サービスと対話したりするためのオブジェクトとメンバーが含まれています。 Excel、Outlook、Word、PowerPoint、OneNote、Project で共有されている共通のオブジェクト モデルがあります。 Excel、OneNote、PowerPoint、Word には、より広範なアプリケーション固有のオブジェクト モデルもあります。 これらの API を使用すると、段落やワークブックなどの既知のオブジェクトにアクセスするため、特定のアプリケーションのためのアドインの作成が容易になります。

コード サンプル

マニフェスト、HTML Web ページ、ロゴのみを備えた最も簡単な Office アドインを作成する方法について説明します。 以下のサンプルは、関心のある Office アプリケーションを使い始めるのに役立ちます。

Office アドインが COM アドインおよび VSTO アドインと異なる点

COM アドインと VSTO アドインは、Office on Windows でのみ実行される以前の Office 統合ソリューションです。 COM アドインや VSTO アドインとは異なり、Office アドインは Web アドインです。アプリケーション (Excel など) はアドイン マニフェストを読み取り、UI でアドインのカスタム リボン ボタンとメニュー コマンドを接続します。 必要に応じて、アドインの JavaScript および HTML コードが読み込まれ、サンドボックス内のブラウザーまたは webview コントロールのコンテキストで実行されます。

さまざまな Office 拡張ソリューションの重点領域を示す 4 象限図。Office Web アドインと COM アドインおよび VSTO アドインはプロフェッショナル開発者を対象としていますが、VBA はエンド ユーザーを対象としています。Office Web アドインはクロスプラットフォーム エクスペリエンスと共同作業に重点を置いていますが、COM および VSTO アドインと VBA は Windows での個人のエクスペリエンスに対応します。

Office アドインは、VBA、COM、VSTO を使用して作成されたアドインと比較して、次のような利点があります。

  • クロスプラットフォームのサポート: Office アドインは、Office on the web、Windows、Mac、iPad で実行できます。

  • Microsoft 365 サポート用アプリ: Office アドインは、Teams アプリや Copilot エージェントなどの他の Microsoft 365 拡張機能と共にパッケージ化して、1 つのユニットとして展開することができます。

  • 一元的な展開と配布: 管理者は、Office アドインを組織全体に一元的に展開できます。

  • Microsoft Marketplace からの簡単なアクセス: ソリューションを Microsoft Marketplace に提出することで、幅広い対象ユーザーがソリューションを利用できるようにすることができます。

  • 標準の Web テクノロジに基づく: 好きなライブラリを使用して Office アドインを構築できます。

重要

COM アドインと VSTO アドインは、 Windows 上の新しい Outlook ではサポートされていません。 これらのアドインは、従来の Outlook on Windows デスクトップ クライアントで引き続きサポートされます。 詳細については、「 新しい Outlook on Windows 用の Outlook アドインの開発」を参照してください。

次の手順

Office アドインの開発の詳細については、「Office アドインを開発する」を参照してください。

関連項目

  • 最終更新: