Office アドインでのユーザー エラーのトラブルシューティング
時折、ユーザーは開発した Office アドインの問題に遭遇することがあります。 たとえば、アドインが読み込みに失敗したり、アクセスできないなどです。 この記事の情報は、ユーザーが Office アドインを使用する際に遭遇する一般的な問題を解決するために用いることができます。
また、Fiddler を使用して、アドインの問題を特定してデバッグすることもできます。
一般的なエラーとトラブルシューティングの手順
次の表は、ユーザーが遭遇する可能性がある一般的なエラー メッセージとエラーを解決するためにユーザーが実行できる手順を示しています。
エラー メッセージ | 解決策 |
---|---|
アプリのエラー: カタログに到達できませんでした | ファイアウォールの設定を確認します。Catalog" は AppSource を参照します。 このメッセージは、ユーザーが AppSource にアクセスできないことを示します。 |
アプリのエラー: このアプリを起動できませんでした。 このダイアログを閉じて問題を無視するか、[再起動] をクリックしてもう一度お試しください。 | 最新の Office 更新プログラムがインストールされていることを確認するか、 Windows インストーラーで更新します。 |
エラー: オブジェクトがプロパティまたはメソッド 'defineProperty' をサポートしていません | Internet Explorerが互換モードで実行されていないことを確認します。 [ツール>の互換性ビューの設定] に移動します。 |
ブラウザーのバージョンがサポートされていないため、アプリを読み込めませんでした。 サポートされているブラウザーのバージョンの一覧についてはここをクリックしてください。 | ブラウザーが HTML5 のローカル ストレージをサポートしていることを確認するか、Internet Explorer の設定をリセットします。 サポートされているブラウザーの詳細については、「Office アドインを実行するための要件」を参照してください。 |
アドインをインストールすると、ステータス バーに "アドイン読み込み中のエラー" と表示される
- Office を終了します。
- マニフェストが有効であることを確認します。 「Office アドインのマニフェストを検証する」を参照してください。
- アドインを再起動します。
- もう一度アドインをインストールする。
また、フィードバックを寄せることができます。Windows または Mac 用 Excel を使用している場合は、Excel から直接 Office の機能拡張チームにフィードバックを送信できます。 これを行うには、[ファイル]>[フィードバック]>[問題点、改善の報告] の順に選択します。 問題点、改善の報告により、問題を理解するために必要なログが提供されます。
Outlook アドインが正常に機能しない
Windows で実行され、Internet Explorer を使用している Outlook アドインが正常に機能しない場合は、Internet Explorer でスクリプトのデバッグを有効にしてみてください。
- [ツール]>[インターネット オプション] [詳細設定]> の順に移動します。
- [参照] で、[スクリプトのデバッグを無効にする (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 イベント。
注:
マニフェストに変更を加えるたびに、マニフェストのバージョン番号を上げる必要があります。
- アドインで XML マニフェストを使用する場合は、「 Version 要素」を参照してください。
- アドインで統合マニフェストを使用する場合は、「 version プロパティ」を参照してください。
関連項目
Office Add-ins
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示