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

  • [アーティクル]

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

重要

COM アドインと VSTO アドインは、現在プレビュー段階の 新しい Outlook on Windows ではサポートされていません。 これらのアドインは、従来の Outlook on Windows デスクトップ クライアントで引き続きサポートされています。 詳細については、「 新しい Outlook on Windows 用 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 ライブラリの 全体像を把握します。

次に、Script Lab ツール (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 アドイン開発者向け学習パスを完了しました! ドキュメントの詳細については、以下をご覧ください。