• An Office Connector license must be purchased and activated via the Remote Admin module of the Cumulus (Web) Server Console.
• A SSL-enabled web server must be available (needed for the communication between the add-in and a Cumulus installation).
• Microsoft Office must be installed (Windows: Office 2013, 2016 with latest updates, macOS: Office 2016 with latest updates).
Preparing the Web Server
As an administrator, you must configure the SSL-enabled web server.
Additionally, you must prepare the manifest files that are needed to actually insert the add-ins into MS Word and PowerPoint, and distribute them to the users which shall use the Cumulus Office Connector.
To prepare the SSL-enabled web server:
1. Copy the OfficeConnector.zip file into the webapps folder of your web server (e.g., \apache-tomcat-8.0.36\webapps) and unpack it. A new folder, COC, is created, which contains all necessary files.
This all that must be done to configure the web server.
For your convenience, the COC folder provides the file “manifest.zip” which contains the manifest files (canto-cumulus.manifest.powerpoint.xml, and canto-cumulus.manifest.word.xml). These files are needed to actually insert the add-ins to Word and PowerPoint.
To prepare the manifest files:
1. Open each manifest file in a text editor of your choice.
2. Replace any occurrence of sample.canto.com with the address of your web server.
Now you can distribute the prepared manifest files to anyone who shall make use of the Cumulus Office Connector.
• In an organization with an Office 365 environment, the Cumulus Office Connector add-in can be deployed centrally to one or multiple users via the Office 365 admin center, as described here.
• Individual users, with or without Office 365, can install and activate the Cumulus Office Connector add-in manually (this procedure is called “sideloading”) as described below.
Sideloading the Add-In
As an individual user who wants to make use of the Cumulus Office Connector in your MS Word or PowerPoint, you must perform several steps. There are different procedures on Windows and macOS.
As a prerequisite, you must have access to the necessary manifest files (canto-cumulus.manifest.powerpoint.xml, and canto-cumulus.manifest.word.xml), as prepared by an administrator to work with the SSL-enabled web server.
On Windows
NOTE: For Add-Ins to work properly, Protect Mode must be enabled in the MS Internet Explorer 11 security settings for both, Internet zone, and Restricted Site zone. This is typically enabled by default.
To install the Cumulus Office Connector on a Windows computer:
1. Create a new folder on your c: drive, e.g. c:\Manifest. Move both manifest files into this folder.
2. Share the newly created folder with yourself.
To do so:
• Right-click on the folder. From the context menu, choose Properties.
• Open the Sharing tab. Click Share.
• On the Choose people ... dialog, your user name is already listed. Add anyone else with whom you want to share your add-in.
• Click Share > Done > Close.
3. Specify the shared folder as trusted catalog
To do so:
• Open a new document, either in Word or in PowerPoint.
• Choose the File tab, then Options.
• Choose Trust Center, then click Trust Center Settings .
• In the Catalog Url box, enter the full network path to the shared folder catalog (e.g., \\[computer name]\Manifest ), and then click Add Catalog.
• IMPORTANT: Activate the Show in Menu option
• Click OK.
• Close the Office application, and start it again to apply your changes.
The Cumulus Office Connector add-in is now installed and can be added to the Home tab of the ribbon in MS Word or PowerPoint, respectively.
To add the Cumulus Office Connector add-in to the ribbon in Word and PowerPoint:
1. On the Insert tab of the ribbon in Word, or PowerPoint, select My Add-ins (or My Apps in Office 2013):
2. In the Office Add-ins dialog (Apps for Office in Office 2013), select Shared Folders.
Select Cumulus Browser, then click OK to insert the add-in.
The Cumulus Office Connector add-in is now available in the Home tab of the ribbon (or in the My Apps menu in Office 2013) in MS Word or PowerPoint, respectively.
NOTE: A sideloaded add-in must be inserted into the Home ribbon anew every time you restart Word or PowerPoint.
On macOS
To install the Cumulus Office Connector on macOS:
1. Move the manifest files into application-specific folders:
• MS Word: move canto-cumulus.manifest.word.xml to ~/Library/Containers/com.microsoft.Word/Data/Documents/wef/ (If the wef folder does not yet exist, create it.)
• MS PowerPoint: move canto-cumulus.manifest.powerpoint.xml to ~/Library/Containers/com.microsoft.Powerpoint/Data/Documents/wef/ (If the wef folder does not yet exist, create it.)
• Restart Word/PowerPoint and open a (new) document.
The Cumulus Office Connector add-in is now installed and can be added to the Home tab of the ribbon in MS Word or PowerPoint, respectively.
To add the add-in to the ribbon in Word and PowerPoint
1. On the Insert tab of the ribbon in Word or PowerPoint, click the small arrow on the right side of My Add-ins.
2. Select Cumulus Browser from the Developer Add-ins.
The Cumulus Office Connector add-in is now available in the Home tab of the ribbon in MS Word or PowerPoint, respectively.
NOTE: A sideloaded add-in must be inserted into the Home ribbon anew every time you restart Word or PowerPoint.
