About this article
In order to support Mac and Office Online users, a web add-in can be distributed to end-users through the Microsoft 365 Admin Portal. This article will detail the steps to distribute the manifest files.
Please follow the steps in this article to make sure our web add-in is deployed correctly.
- Seamless SSO and provisioning
- Step-by-step guide deployment
- Updating an existing add-in
-
How retrieve the original product ID if your manifest upload failed due to a product ID issue
Prerequisites
|
|
Seamless SSO and provisioning
For SSO to work without user interaction, you must reach out to your Partner or Templafy Support for a custom manifest.xml file. This is to ensure that users are redirected correctly to your tenant-URL to initiate the SP-login and provision the users correctly to your own tenant.
Step-by-step guide deployment
Uploading a new add-in
- Go to the Microsoft 365 Admin Portal (https://admin.microsoft.com)
- Click
Settings
- Click
Integrated apps
- Click
Upload custom apps
- Select
Upload manifest file (.xml) from device.
and clickChoose file
Browse location of the manifest file (.xml) for upload, select it and click "Open"
- Select which Users/Groups should have access (or Everyone) and click
Next
- Accept permissions request by clicking
Next
- Click
Finish deployment
to begin the deployment of the add-in
- On this step, the progress for the deployment can be monitored
|
Updating an existing add-in
- Go to the Microsoft 365 Admin Portal (https://admin.microsoft.com)
- Click
Settings
- Click
Integrated apps
- From the list of deployed apps, choose Templafy Company Templates
- Double click the Templafy app to open the app overview
- In the app overview, select
Update add-in
from the Actions menu
- Select
Upload manifest file (.xml) from device.
and clickChoose file
Browse location of the manifest file (.xml) for upload, select it and click "Open" - Click
Next
- Accept permissions and initiate the update by clicking
Accept and update
|
How retrieve the original product ID if your manifest upload failed due to a product ID issue:
- Open the developer tools from your browser (F12 for Windows, Cmd+Opt+J for Mac)
- Reupload the manifest to trigger the error message
- In the developer tools window, click on the "uploadCustomApp" request under the "Name" column
- You can then find the original product ID under the "Payload" header tab as seen in the below screenshot (Form Data -> ProductId)
- Please note, that the product ID can only be retrieved from the developer tools. IDs that might appear in upload error message are not related to the product ID.
Notes
Office on Mac
If the Office version for Mac is lower than 16.36 (released on 04/13/2020) our web add-in may not automatically display in the ribbon. If this occurs, users will have to manually add the Web add-in from the Admin managed part of the Office add-in store (Web add-in is deployed to O365 devices but not being displayed)
Deployment time
Using Centralized Deployment from Microsoft, it can take a minimum of 24 hours for all users targeted to the web add-in to see it in their Office programs, but a maximum of 72 hours. See more in Microsoft's FAQ site here:
Comments
0 comments
Article is closed for comments.