This document explains how to install, configure and extend the Squirro Service Insights for ServiceNow application. |
Squirro Service Insights for ServiceNow™ indexes data from your ServiceNow installation to provide a number of insights from that data. Out of the box, Squirro Service Insights provides the following functionality:
To achieve this, Squirro Service Insights installs the following components:
On the Squirro side, the following components need to be set up:
The Squirro Service Insights for ServiceNow™ user interface is always in English. But but the data any language is supported and can be processed by Squirro.
Squirro Service Insights is optimised for desktop browsers and does not currently support mobile devices.
The Squirro Service Insights for ServiceNow application is installed from the ServiceNow app store.
Before you start, please ensure that the following prerequisites are met.
Before setting up the Squirro Service Insights integration, you need access to a Squirro installation with a valid license.
Contact Squirro on support@squirro.com to start the process of setting this up.
Once installed, you will receive the following information from Squirro:
Follow this process to set up Squirro Service Insights for ServiceNow.
After following the Installation process, the menu Squirro is added to the ServiceNow navigation. Use the Properties screen to configure the Squirro Service Insights installation.
You should have received all of the properties that are requested in this form from Squirro. Please check the Prerequisites section if you do not have this information.
Squirro Service Insights provides three different roles, that can be used for permissions.
Role | Description | Setup Instructions |
---|---|---|
x_squir_si.indexer | Used for the user with which Squirro indexes the ServiceNow data. All users of Squirro Service Insights will be able to see all the data that this role has access to. | Create one ServiceNow user and assign this role to the user. That user will be used from the Squirro side to index the data. |
x_squir_si.user | Can access the Squirro Service Insights application, both on an individual incidents as well as the global dashboards. | Assign to any users or groups that should be able to use Squirro Service Insights. |
x_squir_si.admin | Can administer the Squirro Service Insights application by changing the properties. | Assign to any users or groups that should be able to administer Squirro Service Insights. |
To index the data from ServiceNow to Squirro, configure the ServiceNow user which is used to connect to the ServiceNow web service.
Squirro Service Insights for ServiceNow comes preconfigured with a few components. This default can be extended to tailor the solution more to your individual needs. Specifically two extensions are common:
To modify an existing dashboard, follow this process:
Completely new dashboards can be added. This is a two-stepped process, where the dashboard is first configured in Squirro, and then added to ServiceNow.
First create the new dashboard on Squirro:
Now this dashboard can be added to ServiceNow. For this, create a new UI page with the following HTML:
<?xml version="1.0" encoding="utf-8" ?> <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null"> <g:macro_invoke macro="x_squir_si_dashboard" dashboard_id="DASHBOARD_ID" /> </j:jelly> |
This makes use of a Squirro-provided UI Macro (x_squir_si_dashboard
) to simplify the integration. Replace the DASHBOARD_ID
value with the dashboard's identifier.