Libraries

The Content Chooser supports three types of Libraries, «SharePoint Online» libraries, OneDrive and OneDrive for Business Libraries and «Samples» libraries.

Selecting/Switching Libraries

Template Chooser Setup SharePoint Online

To switch a library just click on the name of the existing library (1) at the top of the Add-In. That will bring up a list of all available libraries for you to choose from. You can then just click on one of the libraries to switch.

SharePoint Online libraries

Content Chooser Setup SharePoint Online

At first you might have not configured your Office 365 SharePoint Tenant for the «Content Chooser». In this case, you will find a «Learn more» link (1) below the «SharePoint Online» library header. So if you want to configure your Office 365 Tenant’s «SharePoint Online» to work with the «Content Chooser» just click on the «Learn More» link and follow the instructions presented on the web page.

Once your Office 365 Tenant’s «SharePoint Online» has been configured for the «Content Chooser» you will see a list of all available document libraries you have access to. The libraries are listed below the «SharePoint Online» group header.

Managing Libraries

Content Chooser SharePoint Online Edit

If you want to manage the lists of «SharePoint Online» libraries just click on the «Edit» button to the far right of the «SharePoint Online» group header.

This will open a dedicated «SharePoint Online List» in your Office 365 Share Point Online Tenant. The URL of the list will be something like this
[YourTenant].sharepoint.com/sites/officeatwork/ContentChooser/Lists/ContentLibraries.

Content Chooser SharePoint online Template Libraries

The actual adding and removing of libraries is then done using native «SharePoint» functions. If you are not literate with «SharePoint Online» we recommend you to go through the «SharePoint» documentation or to reach out to someone with sufficient «SharePoint» experience.

You need to create an item in this list for each «SharePoint Online» Document or Picture library you want to use in the «Content Chooser» Add-in. The «Title» column will be used as the name of the library in the libraries list in your «Content Chooser» Add-in. The «URL» column must contain the URL of the library in your «SharePoint Online» tenant you want to use. This could look something like this:
https://[YourTenant].sharepoint.com/sites/officeatwork/ContentChooser/Pictures. The Application column will allow you to determine in what Office application the library shall appear.

Tip: The libraries you use can be located in any site collection within your SharePoint root host of our Office 365 Tenant’s «SharePoint Online».

Tip: Use the rich security options provided by «SharePoint Online» to determine what libraries are made available to users and groups within your organization.

Please note: The user will need at least read rights to the root site of the site collection you are connecting to.

SharePoint Document lIBRARY COLUMnS

The Content Chooser supports a number of officeatwork specific SharePoint columns that will give you some additional functionality per content. To benefit from these features you need to add any number of the columns described below to the SharePoint document libraries you want these features to work with.

officeatwork_subject

When inserting a content into an e-mail in Outlook the content of this SharePoint column gets additionally inserted into the 'e-mail subject' of the e-mail message by extending what already might be in the subject of the e-mail. The SharePoint column name must be 'officeatwork_subject' and of type 'Single line of text'.

officeatwork_recipients_to

When inserting a content into an e-mail in Outlook the content of this SharePoint column gets additionally inserted into the 'e-mail to' of the e-mail message by extending what already might be in the 'e-mail to' of the e-mail. The SharePoint column name must be 'officeatwork_recipients_to' and of type 'Single line of text'. The format of the e-mail addresses follows the standard SMTP format:

name <e-mail>; name <e-mail>; name <e-mail></e-mail></e-mail></e-mail>

Single e-mail address example:

Joe Duller <joe.duller@domain.com></joe.duller@domain.com>

Multiple e-mail addresses example:

Joe Duller <joe.duller@domain.com>; Tim Hiller <tim.hiller@domain.com></tim.hiller@domain.com></joe.duller@domain.com>

officeatwork_recipients_cc

When inserting a content into an e-mail in Outlook the content of this SharePoint column gets additionally inserted into the 'e-mail cc' of the e-mail message by extending what already might be in the 'e-mail cc' of the e-mail. The SharePoint column name must be 'officeatwork_recipients_cc' and of type 'Single line of text'. The format of the e-mail addresses follows the standard SMTP format (see officeatwork_recipients_to for details on this format).

officeatwork_recipients_bcc

When inserting a content into an e-mail in Outlook the content of this SharePoint column gets additionally inserted into the 'e-mail bcc' of the e-mail message by extending what already might be in the 'e-mail bcc' of the e-mail. The SharePoint column name must be 'officeatwork_recipients_bcc' and of type 'Single line of text'. The format of the e-mail addresses follows the standard SMTP format (see officeatwork_recipients_to for details on this format).

Teams libraries

The Teams libraries feature is currently in preview as we are using some Microsoft API’s that are in preview. As soon as Microsoft makes those API’s general available we will be making the Teams libraries feature also general available. Please note that Microsoft can still make changes to their preview API’s before making them general available. In this case we will have to accommodate those changes before we can make our Teams libraries feature general available. Thank you for your understanding.

Enabling

Enable Teams

Initially you need to enable the Teams libraries feature. To do this you click on the enable (1) button. This will start an admin permissions flow that only Office 365 Administrators can complete.

Configuring

Manage Teams Libraries

At first you might have not configured your Teams libraries. In this case, you will find a «Manager Libraries» (1) button below the «Teams» library header. If you already have setup some libraries, you will not see the «Manager Libraries» button. In this case, you can use the «Pen» icon (2) to start managing your libraries.

Manage Libraries

Manage Teams Libraries

New Library

To create a new library just click on the «Add Library» (1) button. A fly-out appears, that will allow you to select a Team, a channel and if you wish any sub-folder within that channel. Navigate and select to the channel or folder you wish to use as a Content Library and click on «Create Library» button at the bottom of the list. With this you have created a new Content Library linked to the channel or folder you just selected. Be aware that you can only create one Content Chooser library per team. So once you have created a library for a specific Team that team will not show up anymore in the fly-out. Once you have created a Content library within a team that library will become visible for all your team members. There is no need for all team members to repeat this step of creating a teams library for any specific team.

Edit or Remove a Library

To edit an existing library just click onto the library entry (2) in the list of libraries. To remove the library just click on the «Remove» button at the bottom of the library properties. You can not rename a Teams library as it will always show the name of the Team as the library name. Use the arrow back at the top of the page to return to the libraries list.

OneDrive and OneDrive for Business libraries

Manage OneDrive Libraries

At first you might have not configured your OneDrive or OneDrive for Business for the «Content Chooser». In this case, you will find a «Manager Libraries» (1) button below the «OneDrive» library header. If you already have setup some libraries, you will not see the «Manager Libraries» button. In this case, you can use the «Pen» icon (2) to start managing your libraries.

Please note: Organizational users that sign in with their Work or School account can choose to disable OneDrive support within the Content Chooser. This can make sense in case you want all your contents organized in SharePoint and not promote the management of contents on an individual level.

Manage Libraries

New Library

Manage OneDrive Libraries

To create a new library just click on the «Add Library» (1) button. A fly-out appears, that will allow you to select a folder. Navigate and select to the folder you wish to use as a Content Library and click on «Create Library» button at the bottom of the list. With this you have created a new Content Library linked to the folder you just selected.

Edit or Remove a Library

To edit an existing library just click onto the library entry (2) in the list of libraries. To remove the library just click on the «Remove» button at the bottom of the library properties. To rename the library just click into the «Name» field and change the name accordingly. Use the arrow back at the top of the page to return to the libraries list.

Samples libraries

The «Samples» libraries are here to help you to get a feeling of what the «Content Chooser» add-in can do for you without the need to setup your own libraries.

If you have not set up any of your own libraries the «Content Chooser» will always select the first «Samples» library for you by default when loading the libraries page.

Please note: All sample libraries including the «Samples» group will not be visible to organizational users with a Microsoft 365 or Office 365 Work or School account once you purchased a subscription and become a licensed user.