Installing the Office 365 Content Picker in your Office 365 tenant

The Wedia Office 365 is a web application that contains dedicated code that handle interactions with an Office 365 host software, such as Word, Powerpoint and Outlook.

The Office 365 Content Picker is only available on

  • Window 10,

  • Windows 11,

  • MacOS X.

Please note that we require Microsoft 365 version published after the version 16.0.13530.20424 released on Mar 09, 2021.

Please note that you will need to complete one installation for Word / Excel / Powerpoint, and another one for Outlook, as they don’t share the same manifest.xml structure.

But both manifests point to the same code and configuration files, it is just the manifest that changes format.

To use the Office 365 Content Picker, system integrators must make sure that the Wedia server is set to :

  • REST API : Cookie same site option must be set to none

  • in the HTTP SECURITY HEADERS options : make sure that in the Framed options, the xframedOptions.enabled is set to unchecked for the following urls :

  • /office-picker/office-asset-picker.html

A complete documentation for system integrators is available here : https://crossmedia.atlassian.net/wiki/spaces/WD/pages/2094530586

In order to give access to your internal users, you need to install the Wedia Add in in your Office 365 Tenant.

You will need proper rights to follow the installation process.

Step 1 — Connect to your tenant administration Add-In management page

Here is the link to follow : https://admin.microsoft.com/AdminPortal/Home?#/Settings/AddIns

You can also find the Add-ins option in : Settings / Add-ins menu.

Step 2 — Follow the Deploy Add-in Wizard.

Click on the “Deploy Add-in” button

Click “Next” to get past the welcome screen.

We’ll be using the “Upload custom apps” option : the Wedia Content Picker is unique to your organization, and is running in a dedicated container in the Wedia infrastructure.

When clicking on this option, you will be prompted to upload the manifest file :

Please ask your project manager at Wedia to get your personalized manifest XML file, and to upload it by choosing the first option “I have the manifest file on this device”.

 

If the upload is successful, a recap screen will show you this plugin screen :

In that screen, you can choose who will see the plugin in their Office 365 toolbar (see https://crossmedia.atlassian.net/wiki/spaces/WD/pages/339345553 for user installation)

The deploy can take some time :

If the deploy is successful, a message inviting you to test the installation will appear :

Updating who can see the plugin in their Office apps :

To change who will see this application in their Office ribbon, you can click on the Plugin line to change the visibility options :

This can also be used to disable the add-in completely.

Note that users will be notified of the availability of the new addin directly in the application :

 

Validate the manifest.xml

You might encounter an error when deploying manifests if they are not valid. You can get detailed explanations to know how to correct your manifests.

Given node is installed on your machine, you can run the following command:

npx --ignore-existing office-addin-manifest validate <PATH_TO_YOUR_MANIFEST_FILE>

Detailed explanations can be found at https://docs.microsoft.com/fr-fr/office/dev/add-ins/testing/troubleshoot-manifest

 

Activating/deactivation the content picker for certain Office 365 apps.

In the manifest.xml, in the “hosts” section you can comment certain apps to activate the Wedia Content Picker for certain Office 365 apps. For example, to deactivate the Content Picker for Excel, comment this part :