On this page, you can find things to be aware of with the Digizuite™ Office Connector 2.0 (from now on OC).
Lock
A document is automatically locked when it is opened through Digizuite™ Media Manager 5 or OC and the Office Connector is opened. When a given document is locked, no other users can replace this document. Please note that a document doesn't get locked before OC is opened in the document. This means that if a user opens a document but doesn't open OC, other users might still lock the document. Furthermore, the document must not be saved locally before opening the Office Connector if the document is to be locked
A user won't be able to acquire the lock for an Office document if he/she isn't a "Content Creator".
Templates
...
Mac limitation
The OC has the following limitation for Mac users:
- A Mac user must always save an Office document as a new asset in the DC the first time it is saved in a session. After this initial save, the document can be replaced in the same session.
A session is started when the OC is opened, and a session is stopped when the OC or the Office application is closed.
The following use-case describes this limitation in more detail:
- Find an existing Office document in MM (e.g. a Word document).
- Open the existing document.
- Open OC in the local Office application (e.g. Word), which has just been opened.
- Make changes to the document.
- Save the document with the OC - on Mac, the existing document in the DC can not be replaced but only saved as a new asset.
Upload/save functionality
A user must have the MediaPortal_Uploader role to be able to upload anything from the OC.
Furthermore, the following roles are used for controlling uploads from the OC:
- Office_Can_Upload_New: Allows the user to save an Office document from the OC as a new asset in the DC.
- Office_Can_Replace: Allows the user to replace an Office document, which already exists in the DC, from the OC.
These roles are assigned to the following user groups out of the box:
- Superadministrator
- Administrator
- Content Creator
The following user groups are thus not able to save anything from the OC out of the box:
- Light user
- Guest
It is possible to disable uploads from the OC completely from the ConfigManager with the configuration option "Disable Office Connector uploads".
Templates
When opening an Office template from through Digizuite™ Media Manager 5 or OC, the following behavior is expected:
- Word templates (".dotx"): The document can only be saved as a new plain Word document (".docx").
...
- PowerPoint templates (".potx"): The document can only be saved as a new plain PowerPoint document (".pptx").
...
...
- Excel templates (".xltx")
...
- : The template itself can be overridden, or a new template can be saved. Note that it is not possible to
...
- save a plain new Excel document (".xlsx") with the OC in this case.
It is not possible to save PowerPoint templates (".potx") with the OC. Thus, if the OC is opened when working on a PowerPoint template (".potx"), and the document is saved with the OC, it will be saved as a regular PowerPoint document (".pptx").
Asset info in previews
The asset information that is shown in previews (see 2.2.2 Quick asset information) can be configured by editing the Digizuite_System_Framework_AssetInfo search.
It is possible to include a Media Manager link for all assets in the preview information. This can be done by giving the base URL of the Digizuite™ Media Manager 5 to redirect to in the "MM5 base URL"-configuration field from the DAM CenterThe templates will be saved for Word and Excel.
Document titles
Remember that the following characters can't be used in titles of Office documents:
...
It might not be possible to open certain documents if their titles are too long. The maximum allowed length of a title depends on the length of the base URL for the installed OC.
Saving a document
A user must have at least one of the following rights: Asset_Can_Replace or Asset_Can_Revise, in order to be able to save a document from OC.
| Info |
|---|
In order to be able to replace an asset (an Office document), it must be checked out to oneself. In order to check out an asset, one needs to have write rights to it. By default Content Creators, Administrators, and Super Administrators are the only users who have this right. Hence, Light Users and Guest users are not permitted to replace. |
In order to save an Excel document, please make sure that you are not actively editing a cell.
Opening existing documents
...
Please ensure that you are not actively editing a cell in Excel while opening the OC.
Office Online
Attaching multiple images in Outlook Online sometimes results in infinite loading spinners. This issue has been reported to the team behind Office-js: https://github.com/OfficeDev/office-js/issues/857.
It is possible to use the OC in Word Online.The following Office Online applications are supported:
- Word Online
- PowerPoint Online
- Outlook Online
It is not possible to insert images with the OC in Excel Online.
It is not recommended to use the OC in PowerPoint Online. In PowerPoint Online, inserted images might not have the correct dimensions, and it is impossible to insert images if an editable area is active.
Existing documents from Digizuite™ Media Manager 5 can only be opened in local Office applications.
When saving a document from an online Office application, the filename of the online document at the time the Office Connector was opened is used. Changing the title of the document in the online application while the Office Connector is open therefore doesn't have any effect.
Office Connector on Mac
The OC might have some issues on Mac. Specifically, this relates to being able to open existing documents from Digizuite™ Media Manager 5 or the OC. The issues are caused by some issues with Microsoft's Office URI Scheme on Mac, which will hopefully be fixed in the future. Until then, full functionality of the OC on Mac cannot be guaranteed.
Outlook
If the Outlook-specific manifest file has been configured and installed (see OC 5.4.0 2 Installation and Configuration Guide), the OC is available when composing emails in Outlook.
No save functionality is available in Outlook.
Upload/save functionality
We currently use the roles Asset_Can_Replace and Asset_Can_Revise for determining whether a user is allowed to replace an existing asset and upload a new asset, respectively, from the OC. These roles are not assigned to the light users out of the box, but they are assigned to the other user groups.
Debugging
To check if you have an issue with your manifest file, please try validating it with the following tool: https://github.com/OfficeDev/Office-Addin-Scripts/tree/master/packages/office-addin-validator. manifest
If you have issues loading the Office Connector when using localhost, please try following the documentation at: https://docs.microsoft.com/en-us/office/troubleshoot/error-messages/cannot-open-add-in-from-localhost
...