Load Office add-ins with a manifest file
- Last UpdatedJan 18, 2023
- 2 minute read
In specific situations, there can be issues downloading and authenticating the Data Assistant and Configuration Assistant Office add-in. These issues can be due to organizational policies may prohibit downloading Office add-ins directly from Microsoft's store, or if your organization uses single sign-on (SSO) to authenticate you for AVEVA Insight. In the event that downloads are restricted by your organization, or if your organization uses SSO for AVEVA Insight authentication, you can use a manifest file to successfully load and use the Data Assistant and Configuration Assistant add-ins.
To load Office add-ins with a manifest file, save the appropriate manifest file content below as an XML file for each of your products. In each file, ensure that you replace [DOMAINSUFFIX] with the appropriate suffix for your region.
Data Assistant for AVEVA Insight
<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0" xmlns:ov="http://schemas.microsoft.com/office/taskpaneappversionoverrides"
xsi:type="TaskPaneApp">
<Id>7708CBF4-576B-48ED-B7F2-22C5863CF3C7</Id>
<Version>1.3.0.0</Version>
<ProviderName>AVEVA Group PLC</ProviderName>
<DefaultLocale>en-US</DefaultLocale>
<DisplayName DefaultValue="Data Assistant for AVEVA Insight"/>
<Description DefaultValue="Easily integrate data from your AVEVA Insight subscription into your Excel spreadsheets."/>
<IconUrl DefaultValue="https://online.wonderware.[DOMAINSUFFIX]/InfoClientPlugin/Images/icon-wwonline-provider.png"/>
<SupportUrl DefaultValue="https://www.wonderware.com/contact/contact-support ">
<Override Locale="en-US" Value="https://www.wonderware.com/contact/contact-support "/>
</SupportUrl>
<AppDomains>
<AppDomain>https://wwonline.auth0.com</AppDomain>
<AppDomain>https://profile.connect.AVEVA.com</AppDomain>
<AppDomain>https://signin.connect.AVEVA.com</AppDomain>
<AppDomain>https://login.windows.net</AppDomain>
<AppDomain>https://login.microsoftonline.com</AppDomain>
<AppDomain>https://identity.connect.AVEVA.com</AppDomain>
</AppDomains>
<Hosts>
<Host Name="Workbook"/>
</Hosts>
<Requirements>
<Sets DefaultMinVersion="1.2">
<Set Name="ExcelApi"/>
</Sets>
</Requirements>
<DefaultSettings>
<SourceLocation DefaultValue="https://online.wonderware.[DOMAINSUFFIX]/InfoClientPlugin/Home.html"/>
</DefaultSettings>
<Permissions>ReadWriteDocument</Permissions>
</OfficeApp>
Configuration Assistant for AVEVA Insight
<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0" xmlns:ov="http://schemas.microsoft.com/office/taskpaneappversionoverrides"
xsi:type="TaskPaneApp">
<Id>1EF1D853-1CAF-4497-8F5B-7AC26743EFB7</Id>
<Version>1.3.0.0</Version>
<ProviderName>AVEVA Group PLC</ProviderName>
<DefaultLocale>en-US</DefaultLocale>
<DisplayName DefaultValue="Configuration Assistant for AVEVA Insight"/>
<Description DefaultValue="Execute administrative tasks against your AVEVA Insight subscription."/>
<IconUrl DefaultValue="https://online.wonderware.[DOMAINSUFFIX]/TagAdministrator/Images/icon-administrator-x32.png"/>
<SupportUrl DefaultValue="https://www.wonderware.com/contact/contact-support ">
<Override Locale="en-US" Value="https://www.wonderware.com/contact/contact-support "/>
</SupportUrl>
<AppDomains>
<AppDomain>https://wwonline.auth0.com</AppDomain>
<AppDomain>https://profile.connect.AVEVA.com</AppDomain>
<AppDomain>https://signin.connect.AVEVA.com</AppDomain>
<AppDomain>https://login.windows.net</AppDomain>
<AppDomain>https://login.microsoftonline.com</AppDomain>
<AppDomain>https://identity.connect.AVEVA.com</AppDomain>
</AppDomains>
<Hosts>
<Host Name="Workbook"/>
</Hosts>
<Requirements>
<Sets DefaultMinVersion="1.2">
<Set Name="ExcelApi"/>
</Sets>
</Requirements>
<DefaultSettings>
<SourceLocation DefaultValue="https://online.wonderware.[DOMAINSUFFIX]/TagAdministrator/"/>
</DefaultSettings>
<Permissions>ReadWriteDocument</Permissions>
</OfficeApp>
In the manifest file, add an <AppDomain> entry for each of your organization's SSO URLs, as in the following example:
<AppDomains>
<AppDomain>https://sso1.domain.com</AppDomain>
<AppDomain>https://sso2.domain.com</AppDomain>
<AppDomain>https://sso3.domain.com</AppDomain>
</AppDomains>
Refer to the following Microsoft support articles for using the manifest file to load your add-ins:
-
For local Microsoft Office - https://docs.microsoft.com/en-us/office/dev/add-ins/testing/create-a-network-shared-folder-catalog-for-task-pane-and-content-add-ins
-
For Microsoft Office on the web - https://docs.microsoft.com/en-us/office/dev/add-ins/testing/sideload-office-add-ins-for-testing