Office アドインでのユーザー エラーのトラブルシューティングTroubleshoot user errors with Office Add-ins

時折、ユーザーは開発した Office アドインの問題に遭遇することがあります。たとえば、アドインが読み込みに失敗したり、アクセスできないなどです。この記事の情報は、ユーザーが Office アドインを使用する際に遭遇する一般的な問題を解決するために用いることができます。At times your users might encounter issues with Office Add-ins that you develop. For example, an add-in fails to load or is inaccessible. Use the information in this article to help resolve common issues that your users encounter with your Office Add-in.

また、Fiddler を使用して、アドインの問題を特定してデバッグすることもできます。You can also use Fiddler to identify and debug issues with your add-ins.

ユーザーの問題を解決した後、AppSource でカスタマー レビューに直接返信することができますAfter you resolve the user's issue, you can respond directly to customer reviews in AppSource.

一般的なエラーとトラブルシューティングの手順Common errors and troubleshooting steps

次の表は、ユーザーが遭遇する可能性がある一般的なエラー メッセージとエラーを解決するためにユーザーが実行できる手順を示しています。The following table lists common error messages that users might encounter and steps that your users can take to resolve the errors.

エラー メッセージError message 解決策Resolution
アプリのエラー: カタログに到達できませんでしたApp error: Catalog could not be reached ファイアウォールの設定を確認します。「カタログ」は、AppSource を指します。このメッセージは、ユーザーが AppSource にアクセスできないことを示しています。Verify firewall settings."Catalog" refers to AppSource. This message indicates that the user cannot access AppSource.
アプリのエラー: このアプリを起動できませんでした。このダイアログを閉じて問題を無視するか、[再起動] をクリックしてもう一度お試しください。APP ERROR: This app could not be started. Close this dialog to ignore the problem or click "Restart" to try again. Office の最新の更新プログラムがインストールされていることを確認するか、Office 2013 更新プログラムをダウンロードしてください。Verify that the latest Office updates are installed, or download the update for Office 2013.
エラー: オブジェクトがプロパティまたはメソッド 'defineProperty' をサポートしていませんError: Object doesn't support property or method 'defineProperty' Internet Explorerが互換モードで実行されていないことを確認します。 [ツール] > [互換表示設定] に移動します。Confirm that Internet Explorer is not running in Compatibility Mode. Go to Tools > Compatibility View Settings.
ブラウザーのバージョンがサポートされていないため、アプリを読み込めませんでした。サポートされているブラウザーのバージョンの一覧についてはここをクリックしてください。Sorry, we couldn't load the app because your browser version is not supported. Click here for a list of supported browser versions. ブラウザーが HTML5 のローカル ストレージをサポートしていることを確認するか、Internet Explorer の設定をリセットします。サポートされているブラウザーの詳細については、「Office アドインを実行するための要件」を参照してください。Make sure that the browser supports HTML5 local storage, or reset your Internet Explorer settings. For information about supported browsers, see Requirements for running Office Add-ins.

Outlook アドインが正常に機能しないOutlook add-in doesn't work correctly

Windows で実行している Outlook アドインが正常に機能しない場合は、Internet Explorer でスクリプトのデバッグを有効にしてみてください。If an Outlook add-in running on Windows is not working correctly, try turning on script debugging in Internet Explorer.

  • [ツール] > [インターネット オプション] > [詳細] に移動します。Go to Tools > Internet Options > Advanced.

  • [参照] で、 [スクリプトのデバッグを無効にする (Internet Explorer)][スクリプトのデバッグを無効にする (その他)] の各チェックボックスをオフにします。Under Browsing, uncheck Disable script debugging (Internet Explorer) and Disable script debugging (Other).

これらの設定は、問題のトラブルシューティングを行う場合にのみチェックボックスをオフにすることをお勧めします。チェックボックスをオフにしたままにすると、参照時にメッセージが表示されます。問題が解決したら、 [スクリプトのデバッグを無効にする (Internet Explorer)][スクリプトのデバッグを無効にする (その他)] の各チェックボックスをオンにしてください。We recommend that you uncheck these settings only to troubleshoot the issue. If you leave them unchecked, you will get prompts when you browse. After the issue is resolved, check Disable script debugging (Internet Explorer) and Disable script debugging (Other) again.

Office 2013 でアドインがアクティブにならないAdd-in doesn't activate in Office 2013

ユーザーが次の手順を実行したときに、アドインがアクティブにならない場合があります。If the add-in doesn't activate when the user performs the following steps:

  1. Office 2013 で自分の Microsoft アカウントでサインインする。Signs in with their Microsoft account in Office 2013.

  2. 自分の Microsoft アカウントの 2 段階検証を有効にする。Enables two-step verification for their Microsoft account.

  3. アドインを挿入しようとする際に、メッセージに従って ID の確認を行う。Verifies their identity when prompted when they try to insert an add-in.

Office の最新の更新プログラムがインストールされていることを確認するか、Office 2013 更新プログラムをダウンロードしてください。Verify that the latest Office updates are installed, or download the update for Office 2013.

アドインが作業ウィンドウで読み込まれない、または他のアドイン マニフェストの問題Add-in doesn't load in task pane or other issues with the add-in manifest

マニフェストの問題を検証し、トラブルシューティングする」を参照して、アドインのマニフェストの問題をデバッグしてください。See Validate and troubleshoot issues with your manifest to debug add-in manifest issues.

アドイン ダイアログ ボックスを表示できないAdd-in dialog box cannot be displayed

Office アドインを使用するとき、ユーザーは、ダイアログ ボックスの表示を許可するよう求められます。ユーザーが [許可] を選択すると、次のエラー メッセージが発生します。When using an Office Add-in, the user is asked to allow a dialog box to be displayed. The user chooses Allow, and the following error message occurs:

"ブラウザーのセキュリティ設定により、ダイアログ ボックスを作成できませんでした。別のブラウザーを試すか、アドレス バーに表示される [URL] とドメインが同じセキュリティ ゾーンに存在するようにブラウザーを構成してください。""The security settings in your browser prevent us from creating a dialog box. Try a different browser, or configure your browser so that [URL] and the domain shown in your address bar are in the same security zone."

ダイアログ ボックスのエラー メッセージのスクリーン ショット

影響を受けるブラウザーAffected browsers 影響を受けるプラットフォームAffected platforms
Internet Explorer、Microsoft EdgeInternet Explorer, Microsoft Edge Office OnlineOffice Online

この問題を解決するために、エンド ユーザーまたは管理者は、Internet Explore の信頼済みサイトのリストにアドインのドメインを追加することができます。Internet Explorer または Microsoft Edge ブラウザーのどちらを使用していても、同じ手順を使用します。To resolve the issue, end users or administrators can add the domain of the add-in to the list of trusted sites in Internet Explorer. Use the same procedure whether you're using the Internet Explorer or Microsoft Edge browser.

重要

アドインを信頼しない場合は、信頼済みサイトのリストにアドインの URL を追加しないでください。Do not add the URL for an add-in to your list of trusted sites if you don't trust the add-in.

URL を信頼済みサイトのリストに追加する方法:To add a URL to your list of trusted sites:

  1. Internet Explorer で [ツール] ボタンを選択し、[インター ネット オプション] > [セキュリティ] へ移動します。In Internet Explorer, choose the Tools button, and go to Internet options > Security.
  2. [信頼済みサイト] ゾーンを選択して、[サイト] を選択します。Select the Trusted sites zone, and choose Sites.
  3. エラー メッセージに表示される URL を入力して、[追加] を選択します。Enter the URL that appears in the error message, and choose Add.
  4. アドインの使用をもう一度お試しください。問題が続く場合は、他のセキュリティ ゾーンの設定を変えて、アドインのドメインが Office アプリケーションのアドレス バーに表示される URL と同じゾーンに存在するようにします。Try to use the add-in again. If the problem persists, verify the settings for the other security zones and ensure that the add-in domain is in the same zone as the URL that is displayed in the address bar of the Office application.

この問題は、ポップアップ モードでダイアログ API が使用されているときに発生します。この問題を防ぐには、displayInFrame フラグを使います。そのために、ページが iframe 内の表示をサポートしている必要があります。次の例は、フラグの使用方法を示しています。This issue occurs when the Dialog API is used in pop-up mode. To prevent this issue from occurring, use the displayInFrame flag. This requires that your page support display within an iframe. The following example shows how to use the flag.


Office.context.ui.displayDialogAsync(startAddress, {displayInFrame:true}, callback);

リボン ボタンとメニュー項目が含まれているアドイン コマンドへの変更が反映されないChanges to add-in commands including ribbon buttons and menu items do not take effect

アドイン コマンドにリボン ボタンのアイコンやメニュー項目のテキストなどの変更を加えても、その変更が反映されないことがあります。その場合は、以前のバージョンの Office のキャッシュをクリアしてください。Sometimes changes to add-in commands such as the icon for a ribbon button or the text of a menu item do not seem to take effect. Clear the Office cache of the old versions.

Windows の場合:For Windows:

フォルダー %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\ の内容を削除します。Delete the content of the folder %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\.

Mac の場合: For Mac:

フォルダー /Users/{your_name_on_the_device}/Library/Containers/com.Microsoft.OsfWebHost/Data/ の内容を削除します。Delete the content of the folder /Users/{your_name_on_the_device}/Library/Containers/com.Microsoft.OsfWebHost/Data/.

iOS の場合: For iOS:

アドイン内の JavaScript から window.location.reload(true) を呼び出して強制的に再読み込みします。または、Office を再インストールしてください。Call window.location.reload(true) from JavaScript in the add-in to force a reload. Alternatively, you can reinstall Office.

関連項目See also