Microsoft Search
Overview
You can aggregate content from any Microsoft Search connector to LiveTiles Intranet Hub by using the Microsoft Search data provider.
Capabilities
The Microosft Search data provider can aggregate content using the currently logged-in user's context. This means, that all content is permission trimmed by design out of the box using the Microsoft Search rules.
Configuration
configTypeKey
: "dataProvider_msSearch"propertyMappings
: Either a key of a built in property mapper (propertyMapper_serviceNow_kb_simple
orpropertyMapper_serviceNow_kb_page
) or build the property mappings manually to fit the desired itemTemplatecontentSource
: The Microsoft Search connector id that you want to bring data fromqueryTemplate
: The query template cand be used in order to set some pre-defined conditions. For example if your data provider should bring only the items that have a specific type, you could do queryTemplate: "Type:SpecificType". This works in the same way as the SharePoint Search query template works alreadysortProperties
: (Optional) You can specify the data provider sorting rules that will be applied against the Microsoft Search API. Please note that the properties you mark in the sortProperties need to be marked asRefinable
in the MS Search Connector. More info here: Microsoft Search API SortrowLimit
: (Optional) Limits the number of results returned
Disclaimer if you want to use the builtin propertyMappers, make sure the following are set:
- The OOTB MS Search settings remained the same
- SysUpdatedOn - Queryable, Retrieveable, Refinable
- PreviewContent - Retrieveable
Examples
The following configuration displays a widget that aggregates Service Now KB Articles from a connection with id 'LiveTilesServiceNowKB'
{
"configTypeKey": "widget_tabs",
"title": "Service Now KB Articles",
"tabs": [
{
"configTypeKey": "webParts_contentItemsTab",
"connectableKey": "ServiceNowKB",
"data": {
"configTypeKey": "dataProvider_msSearch",
"contentSources": "/external/connections/LiveTilesServiceNowKB",
"propertyMappings": "propertyMapper_serviceNow_kb_simple",
"connectableKey": "ServiceNowKB_dataProvider",
"sortProperties": [
{
"name": "label_LastModifiedDateTime",
"isDescending": true
}
]
},
"layoutTemplate": {
"configTypeKey": "layoutTemplate_list",
"columns": 1,
"scrollType": "buttons"
},
"itemTemplate": {
"configTypeKey": "itemTemplate_simple",
"imageWidth": "2.5rem",
"imageDisplayMode": "Round"
}
}
]
}