OC 5.1.1 4 Important knowledge

Owned by Tobias Thornfeldt Wolters
Last updated: Jan 21, 2020

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

If a Word template (".dotx") or a PowerPoint template (".potx") is opened through Digizuite™ Media Manager 5 or OC, a new document will be created based on the template. The document can therefore only be saved as a new document. If the document was created from a Word template, the new document will be saved as a plain Word document (".docx"). Likewise, if the document was created from a PowerPoint template, the new document will be saved as a plain PowerPoint document (".pptx"). This means that it is not possible to save the changes directly to the template itself.

It is not recommended to use Excel templates (".xltx") with OC. Please note that it is possible to open Excel templates from Digizuite™ Media Manager 5 and OC, but this will open the template itself. If the template is saved as "Existing Asset", the template will be replaced, and if the template is saved as "New Asset", a new template will be saved.

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 Center.

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.

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

When trying to open existing documents from Digizuite™ Media Manager 5 or OC, a popup might occur in the Office application, stating that the file format and the file extension don't match.

Choosing the option "Yes" ignores this and opens the document.

Please ensure that you are not actively editing a cell in Excel while opening the OC.

Office Online

It is possible to use the OC in Word 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.

Debugging

The following command is very useful for debugging the OC on Windows with developer tools: "C:\Windows\SysWOW64\F12\IEChooser.exe"

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-validator. 

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