Appboard/2.4/builder/data sources/third party/servicenow: Difference between revisions

imported>Andy.hopper
(Created page with '{{DISPLAYTITLE:ServiceNow Data Adapter}} This page provides details for configuring ServiceNow adapters in AppBoard. In many cases, you will want to pass a parameter value into…')
 
imported>Andy.hopper
Line 52: Line 52:
|'''[[appboard/2.4/builder/data_processing_scripts|Data Processing Script(s)]]'''
|'''[[appboard/2.4/builder/data_processing_scripts|Data Processing Script(s)]]'''
|List of one or more Data Processing Scripts to be run on the query.
|List of one or more Data Processing Scripts to be run on the query.
|}
==== Pre-Configured Content ====
The ServiceNow adapter is pre-configured to present the following data collections:
change_request
    incident_Last30Days
    incident_LastYear
    task
{|class="wikitable"
!Name
!Description
|-
|'''Name'''
|Name of this query entity.
|-
|'''Description'''
|A summary of the purpose of the query and any details or notes to provide for the system administrator
|-
|'''change_request'''
|Change Requests in the last 30 days.
|-
|'''incident_Last30Days'''
Incidents in the last 30 days.
|-
|'''incident_LastYear'''
Incidents in the last year.
|-
|}
|}

Revision as of 18:10, 31 October 2013

This page provides details for configuring ServiceNow adapters in AppBoard.

In many cases, you will want to pass a parameter value into a query rather than using a static query definition. AppBoard provides a system of variable expressions, called SHIM, that can be used for this purpose. For instructions on this option, see SHIM Expressions.


Data Source Configuration

Configure Connection Settings

The table below details the settings you can configure for a ServiceNow Data Source:

Name Description
url The base URL referring to the ServiceNow web service.
cacheTimeout Maximum time a response from the database is kept before discarding.
httpAuthUsername User name credential used to connect to ServiceNow.
httpAuthPassword User password credential used to connect to ServiceNow.

Query

You can configure one or more queries in each ServiceNow adapter configuration. Each configured query will have a different name, and result in a different Data Collection with that name. When naming a query, only alphanumeric characters, underscores, and hyphens are permitted.

Queries - Entity Settings Screen:

Name Description
Name Name of this query entity. Note: if editing the name all references internal to AppBoard are updated automatically, however in some cases Data Processing Scripts may have hardcoded references that will break as a result of the rename. In cases where AppBoard can detect this an error message is presented to the administrator identifying the affected scripts.
Description A summary of the purpose of the query and any details or notes to provide for the system administrator
query ServiceNow query expression.
table ServiceNow table to be queried.
Data Processing Script(s) List of one or more Data Processing Scripts to be run on the query.

Pre-Configured Content

The ServiceNow adapter is pre-configured to present the following data collections:

change_request

   incident_Last30Days
   incident_LastYear
   task
Name Description
Name Name of this query entity.
Description A summary of the purpose of the query and any details or notes to provide for the system administrator
change_request Change Requests in the last 30 days.
incident_Last30Days

Incidents in the last 30 days.

incident_LastYear

Incidents in the last year.