Knowledge: Sysero for Office-Addin Installation (Version 2)
Back
Knowledge
Title*Sysero for Office-Addin Installation (Version 2)
ManualOffice Addin Installation
Manual Level TwoVersion 2
Created04/09/2024
DetailPlease note the new addins are currently only available for testing.
Introduction
Addins are available for the following products:
- Word
- Excel
- PowerPoint
- Outlook
For these applications no binaries are installed on the target systems. They are installed using a manifest file which is used to deploy the application to the target system. From a Sysero perspective the addin is 100% web based, interfaction with the client system being via the allowed Microsoft Javascript calls etc.
The Word, Excel and PowerPoint addins all share the same manifest file, while the Outlook ones requires its own.
Please note we do have a Teams addin in development, please contact Sysero to discuss any requirement.
Preparing Sysero Instance
Web.config
The following <appSettings> must be set:
<add key="IFrameAllowed" value="officedefault" />
Enable Applications/Data Rooms
See Knowledge Article How do I enable data room/application in Version 2 of Office Addin.
Installation
All applications share the same installation method with just a few minor differences. To install these applications you need to be a Microsoft AzureAD/Office365 admin for your tenant.
To install them follow these steps:
- If limiting deployment please indentify or create an AD group used to target addins.
- Go to Integrated apps - Microsoft 365 admin center, please note this link may change if Microsoft moves the location.
- Click Upload Custom Apps.
- Change App type to Office Add-in.
- Now copy link for one of the following manifests depending on type of addin:
- https://yoursyseroinstance/setup/officemanifest.aspx for Word, Excel or Powerpoint. If you just need Word add ?WordOnly=True on the end.
- https://yoursyseroinstance/setup/officemanifestoutlook.aspx for Outlook.
- Using link download manifest, then upload manifest file from location. Please note the ability to use direct link at this point will fail for many reasons e.g. it is on local intranet, which is why recommended to download manifest first.
- Click next.
- Select the target users via group etc.
- Click next through all other pages and wait for it to deploy. Please note we are not control in how long it takes to appear in users Office, it can take a number of days in some instances.
- Repeat the process for the other addin manifest if required.
Once working a single Sysero icon for the instance should appear on the various Office application ribbons. All functions required are available within a task pane once you click this icon.
Troubleshooting
Addin failed to Load
We have come across one scenario where old or bad manifest causes errors. After updating sometimes you need to clear out the addin cache from %localappdata\Microsoft\Office\16.0\Wef closing all Office apps first.
Additional Manual Locations