Trident で Office アドインをテストする

  • [アーティクル]

以前のバージョンの Windows と Office をサポートする予定の場合、アドインは、Internet Explorer 11 によって提供される "Trident" という組み込み可能なブラウザー コントロールで動作する必要があります。 コマンド ラインを使用すると、アドインで使用される最新の Web ビューから、このテストのために Trident に切り替えることができます。 Internet Explorer 11 Webview コントロールを使用する Windows および Office のバージョンについては、「 Office アドインで使用されるブラウザーと Webview コントロール」を参照してください。この記事では、"webview" とは、Webview コントロールと JavaScript エンジンの組み合わせを指します。

重要

Internet Explorer と Microsoft Edge レガシからの Web ビューは、Office アドインで引き続き使用されます

Office 2019 を通じたボリューム ライセンスの永続的なバージョンを含む、一部のプラットフォームと Office バージョンの組み合わせは、引き続き、Internet Explorer 11 ("Trident" と呼ばれる) と Microsoft Edge レガシ ("EdgeHTML" と呼ばれる) に付属する Webview コントロールを使用してアドインをホストします(「 ブラウザーと Office アドインで使用される Webview コントロール」を参照)。Internet Explorer 11 は、2023 年 2 月に Windows 10 と Windows 11 で無効になっており、起動するための UI が削除されました。しかし、それはまだそれらのオペレーティングシステムと一緒にインストールされています。 そのため、Internet Explorer の Trident やその他の機能は、引き続き Office からプログラムで呼び出すことができます。

これらの Web ビューでアドインを起動したときに、アドインのユーザーに正常なエラー メッセージを提供することで、これらの組み合わせを少なくとも最小限の方法でサポートすることをお勧めします (ただし、必要ありません)。 次の点に注意してください。

  • Internet Explorer または Microsoft Edge レガシで Office on the web が開かなくなりました。 そのため、 AppSource では、これらのブラウザーで Office on the web のアドインはテストされません。
  • AppSource では、Trident または EdgeHTML を使用するプラットフォームと Office デスクトップ バージョンの組み合わせが引き続きテストされます。 ただし、アドインでこれらの Web ビューがサポートされていない場合にのみ警告が発行されます。アドインは AppSource によって拒否されません。
  • スクリプト ラボ ツールで Trident がサポートされなくなりました。

以前のバージョンの Windows と Office をサポートする予定の場合、アドインは、Internet Explorer 11 によって提供される "Trident" という組み込み可能なブラウザー コントロールで動作する必要があります。 コマンド ラインを使用すると、アドインで使用される最新の Web ビューから、このテストのために Trident に切り替えることができます。 Internet Explorer 11 Webview コントロールを使用する Windows および Office のバージョンについては、「 Office アドインで使用されるブラウザーと Webview コントロール」を参照してください。

重要

Trident では、ES5 より後の JavaScript バージョンはサポートされていません。 ECMAScript 2015 以降の構文と機能を使用する場合は、トランスパイラーまたはポリフィルまたはその両方を使用する必要があります。 これらのオプションの詳細については、「以前の Microsoft Webview と Office バージョンをサポートする」を参照してください。

また、Trident では、メディア、記録、場所など、一部の HTML5 機能はサポートされていません。 詳細については、「 アドインが実行時に実行されている Web ビューを決定する」を参照してください。

注:

  • Web 上の Office は Internet Explorer 11 で開くことができないので、Internet Explorer を使用して Web 上の Office でアドインをテストすることはできません (また、必要ありません)。

  • Office Web アドインが機能するためには、Internet Explorer のセキュリティ強化の構成 (ESC) がオフになっている必要があります。 アドインの開発時にクライアントとして Windows Server コンピューターを使用している場合は、Windows Server で ESC が既定でオンになっていることに注意してください。

Trident Webview に切り替える

ヒント

最近のバージョンの Office では、Office が使用している Webview コントロールを識別する 1 つの方法は、使用可能なアドインの パーソナリティ メニュー を使用することです。 (Outlook ではパーソナリティ メニューはサポートされていません)。メニューを開き、[ セキュリティ情報] を選択します。 Windows の [ セキュリティ情報] ダイアログで、 ランタイム は Microsoft Edge、 Microsoft Edge レガシ、または Internet Explorer を報告します。 古いバージョンの Office では、ランタイムはダイアログに含まれていません。

Trident Webview を切り替えるには、2 つの方法があります。 コマンド プロンプトで簡単なコマンドを実行することも、既定で Trident を使用するバージョンの Office をインストールすることもできます。 最初の方法をお勧めしますが、次のシナリオでは 2 つ目を使用する必要があります。

  • プロジェクトは Visual Studio と IIS で開発されました。 Node.js ベースではありません。
  • テストで絶対に堅牢である必要があります。
  • 開発用コンピューターで Microsoft 365 のベータ チャネルを使用することはできません。
  • Mac で開発しています。
  • 何らかの理由でコマンド ライン ツールが機能しない場合。

コマンド ラインを使用して切り替える

プロジェクトが Node.js ベース (つまり、Visual Studio とインターネット情報サーバー (IIS) で開発されていない) 場合は、通常は最新の Web ビューを使用する Windows と Office のバージョンを組み合わせて使用する場合でも、アドインを実行するために Internet Explorer によって提供される Edge レガシまたは Trident Webview コントロールのいずれかを使用するように Windows 上の Office に強制できます。 Windows と Office のバージョンのさまざまな組み合わせで使用されるブラウザーと Web ビューの詳細については、「 Office アドインで使用されるブラウザーと Webview コントロール」を参照してください。

注:

Webview の変更を強制するために使用されるツールは、Microsoft 365 のベータ サブスクリプション チャネルでのみサポートされます。 Microsoft 365 Insider プログラムに参加し、[ベータ チャネル] オプションを選択して Office Beta ビルドにアクセスします。 「 Office について: 使用している Office のバージョン」も参照してください。

厳密には、ベータ チャネルが必要なのは、このツールの webview スイッチです ( 手順 2 を参照)。 このツールには、この要件を持たない他のスイッチがあります。

  1. プロジェクトが Office アドイン用 Yeoman ジェネレーターを使用して作成されていない場合は、office-addin-dev-settings ツールをインストールする必要があります。 コマンド プロンプトで次のコマンドを実行します。

    npm install office-addin-dev-settings --save-dev

    重要

    Office-addin-dev-settings ツールは Mac ではサポートされていません。

  2. プロジェクトのルートにあるコマンド プロンプトで、Office で次のコマンドで使用する Web ビューを指定します。 <path-to-manifest>を相対パスに置き換えます。これは、プロジェクトのルートにある場合はマニフェスト ファイル名だけです。 <webview>をieまたはedge-legacyに置き換えます。 オプションの名前は、Web ビューが作成されたブラウザーの名前に注意してください。 ie オプションは "Trident" を意味し、edge-legacy オプションは "EdgeHTML" を意味します。

    npx office-addin-dev-settings webview <path-to-manifest> <webview>

    次に例を示します。

    npx office-addin-dev-settings webview manifest.xml ie

    npx office-addin-dev-settings webview manifest.json edge-legacy

    コマンド ラインに、Webview の種類が IE (または Edge レガシ) に設定されていることを示すメッセージが表示されます。

  3. 完了したら、次のコマンドを使用して、Windows と Office のバージョンの組み合わせの既定の Web ビューを使用して再開するように Office を設定します。

    npx office-addin-dev-settings webview <path-to-manifest> default

Internet Explorer を使用するバージョンの Office をインストールする

次の手順に従って、Microsoft Edge レガシ Web ビュー (EdgeHTML) を使用してアドインを実行する Office のバージョン (Microsoft 365 サブスクリプションからダウンロード) または Internet Explorer (Trident) を使用するバージョンをインストールします。

  1. 任意の Office アプリケーションで、リボンの [ ファイル ] タブを開き、[ Office アカウント ] または [アカウント] を選択 します。 [About host-name]\(ホスト名について\) ボタン (Word についてなど) を選択します。

  2. 開いたダイアログで、xx.x.xxxxx.xxxxx の完全なビルド番号を見つけて、そのコピーをどこかに作成します。

  3. Office 展開ツールをダウンロードします。

  4. ダウンロードしたファイルを実行して、ツールを抽出します。 ツールをインストールする場所を選択するように求められます。

  5. ツールをインストールしたフォルダー ( setup.exe ファイルがある場所) で、 config.xml という名前のテキスト ファイルを作成し、次の内容を追加します。

    <Configuration>
  <Add OfficeClientEdition="64" Channel="SemiAnnual" Version="16.0.xxxxx.xxxxx">
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>
</Configuration>

  6. Version値を変更します。

    • EdgeHTML を使用するバージョンをインストールするには、 16.0.11929.20946に変更します。
    • Trident を使用するバージョンをインストールするには、 16.0.10730.20348に変更します。

  7. 必要に応じて、 OfficeClientEdition の値を "32" に変更して 32 ビット Office をインストールし、必要に応じて Language ID 値を変更して Office を別の言語でインストールします。

  8. 管理者としてコマンド プロンプトを開きます。

  9. setup.exeとconfig.xml ファイルを含むフォルダーに移動します。

  10. 次のコマンドを実行します。

    setup.exe /configure config.xml

    このコマンドは Office をインストールします。 このプロセスには数分かかる場合があります。

  11. Office キャッシュをクリアします。

重要

インストール後は、Office の自動更新をオフにして、使用を完了する前に使用する Webview を使用しないバージョンに Office が更新されないようにしてください。 これは、インストールから数分以内に発生する可能性があります。 次の手順に従ってください。

  1. Office アプリケーションを起動し、新しいドキュメントを開きます。
  2. リボンの [ ファイル ] タブを開き、[ Office アカウント ] または [アカウント] を選択 します。
  3. [ 製品情報 ] 列で、[ 更新オプション] を選択し、[ 更新プログラムの無効化] を選択します。 このオプションを使用できない場合、Office は自動的に更新されないように既に構成されています。

古いバージョンの Office の使用が完了したら、 config.xml ファイルを編集し、 Version を以前にコピーしたビルド番号に変更して、新しいバージョンを再インストールします。 次に、管理者コマンド プロンプトで setup.exe /configure config.xml コマンドを繰り返します。 必要に応じて、自動更新を再度有効にします。

関連項目