Unified Search integration

If available, filter the repository for specific content types.

Browse search results and select one to open it in a new tab.

Hide any search results.

Displays the username of the account signed into the active repository. In non-Igloo repositories, select to log out of that repository.

Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections.

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a title for each supported language. 

This field can contain a maximum of 140 characters.

Enter the URL of a location in your digital workplace. Users who click the widget's title, if it has one, will go to this location. Whether you enter the link as a relative URL or an absolute URL does not matter, it will convert to an absolute URL the next time you edit the widget.

This field can contain a maximum of 2,083 characters.

Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a description for each supported language.

Select which content property to search. Options include:

• All
• Title
• Description
• Content
• Labels
• Comments
• Href
• Attachment

Select which content type to search. Options include:

• All
• Blogs
• Calendars
• Pages
• Documents
• Forums
• Wikis

Select to show this tab in the widget.

If you enable this tab, you must also enter a Google Team Drive ID. Not entering this value will result in the widget displaying an error.

Enter the ID of your Google Team Drive. This field is required.

This ID appears in the last part of your Google Team Drive's URL. In the example URL below, the Google Team Drive ID would be 0AKVA.

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

Enter a custom query template. Use {{query}} to represent the user's search query.

The default query template is:

trashed = false and name contains '{{query}}'

See Google's article, Search query terms (Google) for additional parameters.

Select to show this tab in the widget.

If you enable this tab, you must also enter an Azure Tenant ID and API Base URL. Not entering this value will result in the widget displaying an error.

Enter your Azure Tenant ID. This field is required.

The default Azure Tenant ID of "common" works for most Office 365 Sharepoint environments. If you want to replace this value with your specific ID and need assistance finding what this ID is, see Microsoft's article, Find your Office 365 tenant ID (Microsoft).

Enter your SharePoint Online domain. This field is required.

Example:
https://mystorage.sharepoint.com

Enter a comma-separated list of which parent URLs search.

This field restricts search results to only the specified parent locations. You can use this filter to limit search to specific sites or folders. For example, you can include a comma-separated list of site names such as:

sites/Ottawa Office, sites/Toronto Office

This field is blank by default.

Enter a location or path to search. Search results will only include content that shares this URL path. If you are using Cloud Hybrid search, you should leave this field blank.

Example: Searching a single site called Ottawa HQ:
sites/Ottawa HQ/

Example: Searching all folders or sites with the name Assets:
Assets

This field is blank by default.

Enter a custom query template. Use {searchterms} to represent the user's search query.

The default query template is:

'{searchterms} OR title:{searchterms} OR fileExtension:{searchterms}'

See Microsoft's article, Building search queries in SharePoint, for additional parameters.

Select to show this tab in the widget.

If you enable this tab, you must also enter an Initial Folder ID. Not entering this value will result in the widget displaying an error.

Enter the ID of the base folder; only content under this location is searched. This field is required.

This folder ID appears in the last part of your Box URL. In the example URL below, the folder ID would be 464103.

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

The default value of 0 is the root ID of your Box.

Select to show this tab in the widget.

If you enable this tab, you must also enter an Initial Folder ID. Not entering this value will result in the widget displaying an error.

Enter the ID of the base folder; only content under this location is searched. This field is required.

This folder ID appears in the part of your Dropbox URL after /home. In the example URL below, the folder ID would be /Office Photos.

https://www.dropbox.com/home/Office Photos 

Select to show this tab in the widget.

If you enable this tab, you must also enter a ServiceNow instance and ServiceNow Application ID. Not entering this value will result in the widget displaying an error.

Enter the Igloo provided Application ID. This Application ID is matched to your ServiceNow URL OAuth Application and can be reused in other ServiceNow widgets that connect to the same ServiceNow instance.

If you do not already have an existing Application ID for the ServiceNow instance you want to connect to, follow these steps:

1. Within the ServiceNow Instance that you are using, create a new OAuth Application (OAuth API Endpoint) that will be only be used for connections to your Igloo digital workplaces (System OAuth > Application Registry). When setting up this Application, note the following fields (other fields can be left in their default state):
   • Name: Enter a descriptive name for this OAuth Application.
   • Client Secret: Leave this blank to generate a random value once the Application is created.
   • Logo URL: Enter the URL of your digital workplace logo. This will typically take the form: https://{workplace URL}/download.public/logo.
   • Comments: Enter an explanation of what this Application is being used for.
2. Submit a ticket to Igloo Support requesting an Application ID and Redirect URL. In this ticket, include the listed below as it relates to your digital workplace and ServiceNow OAuth Application Endpoint:
   • Widget: State that you want to set up the ServiceNow Integration Widget.
   • Workplace URL: Provide the URL of your digital workplace.
   • Client ID: Provide your ServiceNow OAuth Client ID. This can be found by navigating to System OAuth > Application Registry while in ServiceNow.
   • Client Secret: Provide your  ServiceNow OAuth Client Secret. This can be found by navigating to System OAuth > Application Registry while in ServiceNow.
   • Hosting: Indicate whether your ServiceNow environment is on-premise or cloud-based.
3. Enter the Redirect URL that the Igloo Support team provides you into the Redirect URL field of your ServiceNow OAuth Application Endpoint.

Enter the names of the ServiceNow knowledge base(s) that you want to search. Separate multiple knowledge bases with a comma. These names must match the name of the knowledge base in ServiceNow. Within ServiceNow, you can view a list of your knowledge bases by navigating to Administration > Knowledge Bases.