What is it?

The Multi-Service Search integration widget provides a central location to search for content located in the digital workplace and other file repositories. Supported repositories include: Igloo, Office 365 SharePoint (Online with support for Cloud Hybrid Search), Google Team Drive, Box, and Dropbox. Search results can be selected to open them in a new tab. Both Igloo and O365 SharePoint give the ability to search content or people.

A digital workplace must have the Integration Widget to use the Multi-Service Search integration widget.

Features and functionality

Perform a search by entering a search query in the widget’s textbox and pressing enter. Rerun the same search in other repositories by selecting their tab in the widget.

Session authentication and termination

To search a repository, first sign into it. Use the same credentials that would normally be used when accessing that repository in the web browser.

Logout of a repository by clicking the vertical ellipses found on the bottom right hand corner of the widget, and then click Sign Out.

General configuration options

• Search box hint text: This text appears in the empty search box and will disappear as a search query is entered.
• Results per page: This setting applies to all repositories. If the search results are greater than this value, they will be paginated.
• Default Repository: This option sets what repository will be automatically selected when first using the widget. Igloo will be the default repository.
• Enable: Each repository has an enable checkbox that can be clicked to toggle the ability to turn that repository on or off. Enabled repositories will appear as tabs in the widget. Be sure to configure the Advanced Option of a repository after turning it on.

Igloo configuration options

• Tab name: By default this will be Igloo. Use this text box to customize the tab name.
• Field search filter: Specify what part of content the search query will attempt to match. Options include: All, Title, Description, Content, Labels, Comments, Href, or attachment.
• Application search filter: Specify the type of content the search query will attempt to match. Options include: All, Blog, Calendars, Pages, Documents, Forums, or Wikis.

Google Team Drive configuration options

• Tab name: By default this will be Google Team Drive. Use this text box to customize the tab name.

• Google Team Drive ID: This field is required. The ID is the last portion of the Google Team Drive’s URL. Using the example URL below, the Google Team Drive ID would be 0AKVA.

  https://drive.google.com/drive/folders/0AKVA

• Query template: A default template that excludes items in the trash is provided. Additional query parameters can be found here.

  Default Query: trashed = false and name contains ‘{{query}}’

  Use {{query}} to represent what has been entered in the search box.

Office 365 SharePoint configuration options

• Tab name: By default this will be Office 365 SharePoint. Use this text box to customize the tab name.
• Azure Tenant ID: This field is required if this repository has been enabled. A value of “common” can be used. Refer to Microsoft's article, Find your Office 365 tenant ID, for instructions on locating this value.

• API Base URL: This field is required if this repository has been enabled. This is the SharePoint Online domain. For example:

  https://mystorage.sharepoint.com

• Filter Domain: Leave blank if not using Cloud Hybrid Search. If using Cloud Hybrid Search, only URLs entered here will be searched. Separate multiple URLs using commas.

• Path: Specify the base location where search will begin. If Cloud Hybrid Search is enabled, all domains that have a similar path will also be searched. This can be restricted with the Filter Domain option.

  Example 1: To search the folder Support in Shared Documents use: Shared Documents/Support

• Query Template: A default template is provided. Additional query parameters can be found here.

  Default Query: ‘{searchterms} OR title:{searchterms} OR fileExtension:{searchterms}’

  Use {searchterms} to represent what has been entered in the search box.

Office 365 SharePoint Cloud Hybrid Search

The Multi-Service Search widget can search both SharePoint Online and SharePoint On Premises if Microsoft’s Cloud Hybrid Search is setup. Requirements and instructions for configuring Cloud Hybrid Solution are provided by Microsoft here.

Box configuration options

• Tab name: By default this will be Box. Use this text box to customize the tab name.

• Initial folder ID: This field determines what folder’s contents will be searched. “0” is the root ID of a Box folder. Locate the ID of the desired folder by logging into Box and navigate to the desired folder. The ID is the last portion of the URL. Using the example URL below, the ID for the selected folder would be “464103”.

  https://app.box.com/folder/464103

Dropbox configuration options

• Tab name: By default this will be Dropbox. Use this text box to customize the tab name.

• Initial folder ID: This field determines what folder’s contents will be searched. Use “/” to search everything. Specify a folder by entering its ID. The ID will be the portion of the URL after /home/. Using the example URL below, the ID for the selected folder would be “/Photos”.

  https://www.dropbox.com/home/Photos -> /Photos
  https://www.dropbox.com/home/Photos/Sample%20Album -> /Photos/Sample Album

How to setup the Multi-Service Search widget to search Igloo and Office 365 SharePoint

1. Add the integration widget to your page

1. Navigate to the page where you would like to place the Multi-Service Search widget.
2. Click the action button on the page, and from the menu select Edit.
3. Drag the integration widget onto the page.

2. Edit the integration widget and select the Multi-Service Search widget

1. Select the edit button on the widget.
2. From the list of integrations select the widget titled Multi-Service Search widget

3. Enable Igloo and configure its options

1. Click the Enable check box for Igloo
2. Optional: Select an option from Field Search Filter to have the search query only search specific properties of content.
3. Optional: Select an option from Application Search Filter to have the search query only search the selected content types.

4. Enable Office 365 SharePoint and configure its options

1. Click the Enable check box for Office 365 SharePoint
2. Enter your API Base URL. This is the domain for your SharePoint Online instance and will typically take the form: https://mystorage.sharepoint.com .
3. Optional: If the value of “common” does not work for the Azure tenant ID field you will need to enter your Azure Tenant ID. Refer to Microsoft's article, Find your Office 365 tenant ID, for instructions on locating this value.
4. Optional: Specify what folder location in SharePoint Online that will be searched. This can be done by enter values for Site/Collections, Document Library, and/or Initial Path.
5. Optional: Determine what properties of files are searched by the search query. Additional query parameters can be found here. Use {searchterms} to represent what has been entered in the search box.

5. Apply these changes

Click the Update button located at the bottom of the widget to apply its settings. Then click Publish Page, located at the bottom of the page to have your settings applied to your live digital workplace.

6. In the widget authenticate with Office 365 SharePoint

Select the Multi-Service Search widget’s text box to expand it, and then select the tab associated with SharePoint. Click the login button to begin the authentication process and enter your Office 365 SharePoint credentials. Each member of your community will need to authenticate using their credentials.