SharePoint Online Libraries

Configuration

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.

Content Name

By default the file name of the file in the SharePoint document library will be used to display your content in the 'Content Chooser' experience. Alternatively, you can give your content a different name by entering an additional name in the Title field. Providing a name in the Title field is optional and is not required for the content to appear in the 'Content Chooser' experience.

Attention: Your Title field label might be translated in your SharePoint experience! So, in for example a french SharePoint document library user experience the title column would appear as Titre and not Title. Nevertheless, the column labeled Titre will work :-)

Content Name Translation

If you are sharing your contents across language regions you might want to translate the content names so that users can explore your contents in their native language. To add translations to any content in your SharePoint document library you need to add an additional column per language. We offer a simple naming convention to enable this scenario:

Title + . + language code

So for instance, if you would want to show translated French content file names you would need to create an additional column named 'Title.fr'. Make sure you spell the column correctly in your first attempt as renaming the column might only give it a different label but not actually rename the column Name/ID. We also recommend to create new columns via the SharePoint document library 'Library settings' page to make sure your column gets named correctly. Once you have created the column you can go ahead and add a translation for each content file you wish to translate. Thereafter your users viewing the 'Content Chooser' in french will automatically see the translated french content names.

Here is a link to a list of ISO 639-1 language codes you can use:
http://www.lingoes.net/en/translator/langcode.htm

Attention: make sure you type your language code in lower case - upper case will not work.

Attention: If your 'Title' field is translated in your SharePoint experience (for instance 'Titre' for french) you will still need to create your translation columns using the exact english spelling for your additional Title.LanguageCode columns.

Folder Name Translation

To translate the folder names shown in the Content Chooser you would have to create a new SharePoint Content type for your folders that includes the translation columns like Title.fr and assign that folder content type to your document library. Please consult the SharePoint documentation on how to create and assign content types to document libraries.

Special Columns in SharePoint Document Libraries

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