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.
You can also use Fiddler to identify and debug issues with your add-ins.
Dec 31, 2019 Troubleshoot user errors with Office Add-ins.; 5 minutes to read +8; In this article. 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.
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.
When installing an add-in, you see 'Error loading add-in' in the status bar
You can also give us feedback: if using Excel on Windows or Mac, you can report feedback to the Office extensibility team directly from Excel. To do this, select File | Feedback | Send a Frown. Sending a frown provides the necessary logs to understand the issue.
Outlook add-in doesn't work correctly
If an Outlook add-in running on Windows and using Internet Explorer is not working correctly, try turning on script debugging in 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.
Add-in doesn't activate in Office 2013
If the add-in doesn't activate when the user performs the following steps:
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 an Office Add-in's manifest and Debug your add-in with runtime logging to debug add-in manifest issues.
Add-in dialog box cannot be displayed
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:
'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.'
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.
Important
Do not add the URL for an add-in to your list of trusted sites if you don't trust the add-in.
To add a URL to your list of trusted sites:
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.
Changes to add-in commands including ribbon buttons and menu items do not take effect
If changes you've made in the manifest, such as file names of ribbon button icons or text of menu items, do not seem to take effect, try clearing the Office cache on your computer.
For Windows:
Delete the contents of the folder
%LOCALAPPDATA%MicrosoftOffice16.0Wef .
For Mac:
Add-ins are often cached in Office for Mac, for performance reasons. Normally, the cache is cleared by reloading the add-in. If more than one add-in exists in the same document, the process of automatically clearing the cache on reload might not be reliable.
You can clear the cache by using the personality menu of any task pane add-in.
You can also clear the cache manually by deleting the contents of the
~/Library/Containers/com.Microsoft.OsfWebHost/Data/ folder.
Note
If that folder doesn't exist, check for the following folders and if found, delete the contents of the folder:
For iOS:
Call
window.location.reload(true) from JavaScript in the add-in to force a reload. Alternatively, you can reinstall Office.
![]() Changes to static files, such as JavaScript, HTML, and CSS do not take effect
The browser may be caching these files. To prevent this, turn off client-side caching when developing. The details will depend on what kind of server you are using. In most cases, it involves adding certain headers to the HTTP Responses. We suggest the following set:
For an example of doing this in an Node.JS Express server, see this app.js file. For an example in an ASP.NET project, see this cshtml file.
If your add-in is hosted in Internet Information Server (IIS), you could also add the following to the web.config.
If these steps don't seem to work at first, you may need to clear the browser's cache. Do this through the UI of the browser. Sometimes the Edge cache isn't successfully cleared when you try to clear it in the Edge UI. If that happens, run the following command in a Windows Command Prompt.
See also-->
Requirement sets are named groups of API members. Office Add-ins use requirement sets specified in the manifest or use a runtime check to determine whether an Office host supports APIs that an add-in needs. For more information, see Office versions and requirement sets.
Add-in commands are UI elements that extend the Office UI and start actions in your add-in. You can use add-in commands to add a button on the ribbon or an item to a context menu. For more information, see Add-in commands for Excel, Word, and PowerPoint and Add-in commands for Outlook.
Microsoft Dynamics Office Add-in For Mac Download
The initial release of add-in commands doesn't have a corresponding requirement set (that is, there isn't an AddinCommands 1.0 requirement set). The following table lists the Office host applications that support the initial release version, and the build versions or number for those applications.
![]()
Microsoft Dynamics Office Add-in For Mac Os
The add-in commands 1.1 requirement set introduces the ability to autoopen a task pane with documents.
The following table lists the add-in commands 1.1 requirement set, the Office host applications that support that requirement set, and the build or version numbers for the Office application.
Microsoft For Mac
* The Office.context.requirements.isSetSupported method will erroneously return
false for versions 16.9 – 16.14 (inclusive), but the requirement set is supported on these versions.
Microsoft Dynamics Office Add-in For Mac Windows 7Office versions and build numbers
To find out more about versions, build numbers, and Office Online Server, see:
Microsoft Office Mac FreeOffice Common API requirement sets
For information about Common API requirement sets, see Office Common API requirement sets.
Microsoft Dynamics Office Add-in For Mac FreeSee alsoComments are closed.
|
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |