OFFICE Web アドインに関する VSTO アドイン開発者ガイド

[アーティクル]
05/20/2023

そのため、Windows で実行される Office アプリケーション用の VSTO アドインをいくつか作成しました。次に、Windows、Mac、および Office スイートの Web ブラウザーバージョンで実行される Office を拡張する新しい方法を検討しています: Office Web アドイン。

重要

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

Office Web アドインのオブジェクトモデルは Excel、Word、その他の Office アプリケーションのオブジェクトモデルと似たようなパターンをたどるので、それらのオブジェクトモデルへの理解が大きな助けとなるでしょう。ただし、いくつか課題があります。

C# または Visual Basic .NET ではなく、別の言語 (JavaScript または TypeScript) を使用します。 (Web アドインで既存のコードの一部を再利用する方法もあります。後で説明します)。
Office Web アドインは、VSTO アドインとは別に展開されます。
Office Web アドインは、Office アプリケーションに埋め込まれた簡略化された Web ビューコントロールで実行される Web アプリケーションであるため、Web アプリケーションの基本的な理解と、Web サーバーまたはクラウドアカウントでのホスト方法を理解する必要があります。

これらの理由から、この記事の多くは、 Office 拡張機能に関する初心者向けガイドと重複しています。追加されたのは、VSTO アドイン開発者がエクスペリエンスを活用し、既存のコードを再利用するのに役立つ学習リソースです。

手順 0: 前提条件

Office Web アドイン (Office アドインとも呼ばれる) は、Office に組み込まれている基本 Web アプリケーションです。そのため、まず、Web アプリケーションとその Web 上でのホスト方法に関する基本的な理解が必要です。インターネット、書籍、オンラインコース上にこれについての膨大な情報があります。 Web アプリケーションに関する知識がまったくない場合は、検索エンジンで「Web アプリとは」を検索することをお勧めします。
Office アドインの作成に使用する主要なプログラミング言語は、JavaScript または TypeScript です。どちらの言語にも慣れていないが、VBA、VB.NET、C#の経験がある場合は、TypeScript の方が学習しやすいでしょう。繰り返しになりますが、インターネット、書籍、オンラインコース上に、これらの言語に関する豊富な情報があります。

手順 1: 基本から始める

今にもコーディングを始めたいと考えておられるかもしれませんが、IDE やコードエディターを開く前に、Office アドインについて、以下をお読みください。

Office アドインプラットフォームの概要: Office Web アドインとは何であるか、VSTO アドインなどの Office を拡張する以前の方法との違いを説明します。
Office アドインを開発する: ツール、アドイン UI の作成、JavaScript API を使用した Office ドキュメントの操作を含む、Office アドインの開発とライフサイクルの概要について説明します。

これらの記事には多くのリンクが含まれていますが、Office アドインに移行している場合は、これらを読み、次のセクションに進むときに、ここに戻ることをお勧めします。

手順 2: ツールをインストールし、最初のアドインを作成する

全体像を把握できたので、クイックスタートのいずれかを行います。プラットフォームについて学習する場合は、Excel クイックスタートをお勧めします。 Visual Studio をベースにしたバージョンと、Node.js と Visual Studio Code をベースにしたバージョンがあります。 VSTO アドインから移行している場合は、Visual Studio バージョンの方が作業がしやすいかもしれません。

手順 3: コーディング

オーナーズマニュアルを読んでも、理解することはできません。この Excel チュートリアルを使用してコーディングを開始してください。 Office JavaScript ライブラリとアドインのマニフェストにある一部の XML を使用します。後の手順で両方の背景を学習することになるので、何も覚える必要はありません。

手順 4: JavaScript ライブラリを理解する

Microsoft Learn トレーニングの「Office JavaScript API の理解」チュートリアルを使用して、Office JavaScript ライブラリの全体像を把握します。

次に、スクリプトラボツール (API を実行および探索するためのサンドボックス) を使用して、Office JavaScript API を探索します。

VSTO アドイン開発者向けの特別なリソース

サンプルのアドインを見るには、Excel アドイン JavaScript SalesTracker が良いでしょう。これは VSTO アドインと Office Web アドインの共通点や違いを強調するために作成されたもので、このサンプルの readme では比較する上での重要なポイントについてを紹介しています。

手順 5: マニフェストを理解する

Web アドインマニフェストの目的と、Office アドインマニフェストでの XML マークアップまたは JSON の概要について理解します。

手順 6 (VSTO 開発者のみ): VSTO コードを再利用する

VSTO アドインのコードをサーバー上の Web アプリケーションのバックエンドへと移動し、JavaScript や TypeScript で Web API として利用できるようにすることにより、Office Web アドインで VSTO アドインのコードを再利用することができます。ガイダンスについては、「チュートリアル: 共有コードライブラリを使用して VSTO アドインと Office アドインの間でコードを共有する」を参照してください。

次の手順

おめでとうございます。Office Web アドインの VSTO アドイン開発者向け学習パスを完了しました! ドキュメントの詳細については、以下をご覧ください。

その他の Office アプリケーション向けのチュートリアルおよびクイックスタート:
その他の重要な主題:

次の方法で共有