Office アドインでのユーザー エラーのトラブルシューティング
時折、ユーザーは開発した Office アドインの問題に遭遇することがあります。 たとえば、アドインが読み込みに失敗したり、アクセスできないなどです。 この記事の情報は、ユーザーが Office アドインを使用する際に遭遇する一般的な問題を解決するために用いることができます。
また、ツールを使用して HTTP メッセージをインターセプトして、アドインに関する問題を特定してデバッグすることもできます。一般的な選択肢には、 Fiddler、 Charles、 Requestly などがあります。
一般的なエラーとトラブルシューティングの手順
次の表は、ユーザーが遭遇する可能性がある一般的なエラー メッセージとエラーを解決するためにユーザーが実行できる手順を示しています。
| エラー メッセージ | 解決方法 |
|---|---|
| アプリのエラー: カタログに到達できませんでした | ファイアウォールの設定を確認します。Catalog" は AppSource を参照します。 このメッセージは、ユーザーが AppSource にアクセスできないことを示します。 |
| アプリのエラー: このアプリを起動できませんでした。 このダイアログを閉じて問題を無視するか、[再起動] をクリックしてもう一度お試しください。 | 最新の Office 更新プログラムがインストールされていることを確認するか、 Windows インストーラーで更新します。 |
| エラー: オブジェクトがプロパティまたはメソッド 'defineProperty' をサポートしていません | Internet Explorerが互換モードで実行されていないことを確認します。 [ツール>互換性ビューの設定] に移動します。 |
| ブラウザーのバージョンがサポートされていないため、アプリを読み込めませんでした。 サポートされているブラウザーのバージョンの一覧についてはここをクリックしてください。 | ブラウザーが HTML5 のローカル ストレージをサポートしていることを確認するか、Internet Explorer の設定をリセットします。 サポートされているブラウザーの詳細については、「Office アドインを実行するための要件」を参照してください。 |
アドインをインストールすると、ステータス バーに [アドインの読み込み中にエラーが発生しました] と表示されます
- Office を終了します。
- コンピューターで時刻と日付が正しく設定されていることを確認します。 時刻と日付が正しくないと、アドインのマニフェストを確認するときに問題が発生する可能性があります。
- マニフェストが有効であることを確認します。 「Office アドインのマニフェストを検証する」を参照してください。
- アドインを再起動します。
- もう一度アドインをインストールする。
インストール前にアドイン パッケージが改ざんされた場合、このエラーが発生します。 アドインをもう一度ダウンロードし、再インストールしてみてください。 または、アドインの発行元に問い合わせてヘルプを表示します。
また、Windows または Mac で Office を使用している場合は、Office から直接 Office 機能拡張チームにフィードバックを報告することもできます。 これを行うには、[ヘルプ>Feedback>問題を報告する] を選択します。 レポートを送信すると、問題を理解するために必要な情報が提供されます。
Outlook アドインが正常に機能しない
Windows で実行され、Internet Explorer を使用している Outlook アドインが正常に機能しない場合は、Internet Explorer でスクリプトのデバッグを有効にしてみてください。
- [ツール>Internet Options>Advanced] に移動します。
- [参照] で、[スクリプトのデバッグを無効にする (Internet Explorer)] と [スクリプトのデバッグを無効にする (その他)] の各チェックボックスをオフにします。
これらの設定は、問題のトラブルシューティングを行う場合にのみチェックボックスをオフにすることをお勧めします。 チェックボックスをオフにしたままにすると、参照時にメッセージが表示されます。 問題が解決したら、[スクリプトのデバッグを無効にする (Internet Explorer)] と [スクリプトのデバッグを無効にする (その他)] の各チェックボックスをオンにしてください。
アドインが Office でアクティブ化されない
ユーザーが次の手順を実行したときに、アドインがアクティブにならない場合があります。
Office アプリケーションで自分の Microsoft アカウントでサインインします。
自分の Microsoft アカウントの 2 段階検証を有効にする。
アドインを挿入しようとする際に、メッセージに従って ID の確認を行う。
最新の Office 更新プログラムがインストールされていることを確認するか、 Windows インストーラーで更新します。
アドイン ダイアログ ボックスを表示できない
Office アドインを使用するとき、ユーザーは、ダイアログ ボックスの表示を許可するよう求められます。 ユーザーが [許可] を選択すると、次のエラー メッセージが表示されます。
"ブラウザーのセキュリティ設定により、ダイアログ ボックスが作成されません。 別のブラウザーを試すか、アドレス バーに表示されている [URL] とドメインが同じセキュリティ ゾーンになるようにブラウザーを構成します。
| 影響を受けるブラウザー | 影響を受けるプラットフォーム |
|---|---|
| Microsoft Edge | Office on the web |
この問題を解決するために、エンド ユーザーまたは管理者は、Microsoft Edge ブラウザー の信頼済みサイトのリストにアドインのドメインを追加することができます。
重要
アドインを信頼しない場合は、信頼済みサイトのリストにアドインの URL を追加しないでください。
URL を信頼済みサイトのリストに追加する方法:
- [コントロール パネル]で、[インターネット オプション] > [セキュリティ] に移動します。
- [信頼済みサイト] ゾーンを選択して、[サイト] を選択します。
- エラー メッセージに表示される URL を入力して、[追加] を選択します。
- アドインの使用をもう一度お試しください。 問題が続く場合は、他のセキュリティ ゾーンの設定を変えて、アドインのドメインが Office アプリケーションのアドレス バーに表示される URL と同じゾーンに存在するようにします。
この問題は、ポップアップ モードでダイアログ API が使用されているときに発生します。 この問題を防ぐには、displayInFrame フラグを使います。 そのために、ページが iframe 内の表示をサポートしている必要があります。 次の例は、フラグの使用方法を示しています。
Office.context.ui.displayDialogAsync(startAddress, {displayInIFrame:true}, callback);
アドインがアップグレードされない
アドインの更新されたマニフェストをデプロイすると、次のエラーが表示されることがあります。 ADD-IN WARNING: This add-in is currently upgrading. Please close the current message or appointment, and re-open in a few moments.
アドインで機能を追加したりバグを修正したりするときは、更新プログラムをデプロイする必要があります。 アドインが 1 人以上の管理者によって組織に展開されている場合、マニフェストの変更によっては、管理者が更新プログラムに同意する必要があります。 同意が付与されるまで、ユーザーはアドインからブロックされます。 次のマニフェストの変更では、管理者がもう一度同意する必要があります。
- 要求されたアクセス許可に対する変更。 「 アドインでの API 使用のアクセス許可の要求 」と「Outlook アドインの アクセス許可について」を参照してください。
- 追加または変更された スコープ。 (アドインが Microsoft 365 の統合マニフェストを使用している場合は適用されません)。
- 追加または変更された Outlook イベント。
注:
マニフェストに変更を加えるたびに、マニフェストのバージョン番号を上げる必要があります。
- アドインがアドインのみのマニフェストを使用している場合は、「 Version 要素」を参照してください。
- アドインで統合マニフェストを使用する場合は、「 version プロパティ」を参照してください。
関連項目
Office Add-ins