Microsoft Outlook

Overview

You can integrate data from Outlook to LiveTiles Intranet Hub by using the Outlook Data Provider configuration. The Outlook REST API will be used to retrieve the data.

Data Provider

The Outlook Data Provider configuration requires the following parameters that you need to specify:

• configTypeKey: The unique key of the data provider.
• propertyMappings: The unique key of the property mapper.
• resource: The path to the Outlook API for the desired data.
• version: the version of the Outlook API that will be used. At the time of writing the following versions were avialable: 1.0 (deprecated), 2.0 and beta. It is recommended to use the latest stable version that is available for the type of data you wish to retreive.

Have a look at the reference for more information about the OutlookDataProviderConfig.

Data Source

Besides the data provider, there is also an Outlook Data Source with two configurable properties:

• configTypeKey: The unique key of the data source
• propertyMappingsKey: The unique key of the property mapper You can find more details about the OutlookDataSourceUserConfig in the reference.

Tasks

You can retrieve Outlook tasks via a Data Provider or a Data Source.
For this, the following permissions are required, which have to be approved in SharePoint Online Administration Center of your Microsoft 365 Tenant:

App: Office 365 Exchange Online
Permission: Tasks.Read

Examples

Data Provider

Below you can see a sample configuration where the Outlook Data Provider is used within a Content Items Web Part:

"MyWidget": {
  "configTypeKey": "widget_contentItems",
  "title": {
    "de": "Aufgaben",
    "en": "Tasks"
  },
  "tabs": [
    {
      "title": {
        "de": "Aufgaben",
        "en": "Tasks"
      },
      "data": {
          "configTypeKey": "dataProvider_outlook",
          "propertyMappings": "propertyMapper_outlook_task",
          "resource": "me/tasks",
          "version": "v2.0"
      },
      "layoutTemplate": {
        "configTypeKey": "layoutTemplate_list",
        "columns": 1
      },
      "itemTemplate": {
        "configTypeKey": "itemTemplate_simple",
        "imageWidth": "2.5rem",
        "imageDisplayMode": "Round"
      }
    }
  ]
}

Data Source

Sample configuration of a Content Items Web Part with the Outlook Data Source:

"MyWidget": {
  "configTypeKey": "widget_contentItems",
  "title": {
    "de": "Aufgaben",
    "en": "Tasks"
  },
  "tabs": [
    {
      "title": {
        "de": "Aufgaben",
        "en": "Tasks"
      },
      "data": {
        "contentType": "Task",
        "dataSource": {
            "configTypeKey": "userDataSource_outlook",
            "propertyMappingsKey": "propertyMapper_outlook_task"
        }
      },
      "layoutTemplate": {
        "configTypeKey": "layoutTemplate_list",
        "columns": 1
      },
      "itemTemplate": {
        "configTypeKey": "itemTemplate_simple",
        "imageWidth": "2.5rem",
        "imageDisplayMode": "Round"
      }
    }
  ]
}