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

  • [アーティクル]

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

重要

インターネット エクスプローラーとMicrosoft Edge 従来版からの Web ビューは、Office アドインで引き続き使用されます

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

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

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

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

重要

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

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

注:

  • Office on the webインターネット エクスプローラー 11 で開くことができないので、インターネット エクスプローラーを使用してOffice on the webでアドインをテストすることはできません (必要はありません)。

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

Trident Webview に切り替える

ヒント

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

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

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

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

プロジェクトが Node.js ベース (つまり、Visual Studio とインターネット情報サーバー (IIS) で開発されていない) 場合は、通常より最近の Web ビューを使用する Windows と Office のバージョンを組み合わせて使用する場合でも、Edge レガシによって提供される EdgeHTML Webview コントロールまたはインターネット エクスプローラーによって提供される 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> 。これは、プロジェクトのルートにある場合はマニフェスト ファイル名だけです。 を または edge-legacyにie置き換えます<webview>。 オプションの名前は、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

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

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

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

インターネット エクスプローラーを使用する Office のバージョンをインストールする

Microsoft Edge 従来版 Webview (EdgeHTML) を使用してアドインを実行する Office のバージョン (Microsoft 365 サブスクリプションからダウンロード) またはインターネット エクスプローラー (Trident) を使用するバージョンをインストールするには、次の手順に従います。

  1. 任意の Office アプリケーションで、リボンの [ ファイル ] タブを開き、[ Office アカウント ] または [アカウント] を選択 します。 [About host-name]\(ホスト名について\) ボタン ([About 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 をインストールし、Office を Language ID 別の言語でインストールするために必要に応じて値を変更します。

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

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

  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 プロンプトでコマンドを繰り返します。 必要に応じて、自動更新を再度有効にします。

関連項目