org.mule.modules

mule-module-service-now

config

Namespace	http://www.mulesoft.org/schema/mule/servicenow
Schema Location	http://www.mulesoft.org/schema/mule/servicenow/current/mule-servicenow.xsd (View Schema)
Schema Version	1.0
Minimum Mule Version	3.4

Module Overview

Cloud Connector to connect to the service now This class provides the mirror methods to connect to the service now web services.

Summary

Configuration
<servicenow:config> Configure an instance of this module

Message Processors
<servicenow:delete-asset-record> Delete a record from the Asset table.
<servicenow:delete-incident-record> Delete a record from the Incident table.
<servicenow:delete-multiple-incident> Delete multiple record from the Incident table.
<servicenow:delete-multiple-user> Delete multiple record from the User table.
<servicenow:delete-user-group-record> Delete a record from the Group Member table.
<servicenow:delete-user-record> Delete a record from the User table.
<servicenow:delete-user-role-record> Delete a record from the User Role table.
<servicenow:get-asset> Query a single record from the Asset table and return the record and its fields.
<servicenow:get-asset-records> Query the Asset table by example values and return all matching records and their fields.
<servicenow:get-incident> Query a single record from the Incident table and return the record and its fields.
<servicenow:get-incident-keys> Query the Incident table by example values and return a comma delimited list of sys_id.
<servicenow:get-incident-records> Query the Incident table by example values and return all matching records and their fields.
<servicenow:get-user> Query a single record from the User table and return the record and its fields.
<servicenow:get-user-group-records> Query the Group Member table by example values and return all matching records and their fields.
<servicenow:get-user-keys> Query the User table by example values and return a comma delimited list of sys_id.
<servicenow:get-user-records> Query the User table by example values and return all matching records and their fields.
<servicenow:get-user-role-records> Query the User Role table by example values and return all matching records and their fields.
<servicenow:insert-asset> Creates a new record for the Asset table.
<servicenow:insert-incident> Creates a new record for the Incident table.
<servicenow:insert-user> Creates a new record for the User table.
<servicenow:insert-user-group> Creates a new record for the Group Member table.
<servicenow:insert-user-role> Creates a new record for the User Role table.
<servicenow:update-asset> Updates an existing record in the Asset table.
<servicenow:update-incident> Updates an existing record in the Incident table.
<servicenow:update-user> Updates an existing record in the User table.
<servicenow:update-user-group> Updates an existing record in the Group Member table.
<servicenow:update-user-role> Updates an existing record in the User Role table.

Configuration

To use the this module within a flow the namespace to the module must be included. The resulting flow will look similar to the following:

<mule xmlns="http://www.mulesoft.org/schema/mule/core"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:servicenow="http://www.mulesoft.org/schema/mule/servicenow"
      xsi:schemaLocation="
               http://www.mulesoft.org/schema/mule/core
               http://www.mulesoft.org/schema/mule/core/current/mule.xsd
               http://www.mulesoft.org/schema/mule/servicenow
               http://www.mulesoft.org/schema/mule/servicenow/current/mule-servicenow.xsd">

      <!-- here goes your flows and configuration elements -->

</mule>

Connection Pool

This connector offers automatic connection management via the use of a connection pool. The pool will act a storage mechanism for all the connections that are in-use by the user of this connector.

Prior to execution of a processor, the connector will attempt to lookup an already established connection and if one doesn't exists it will create one. That lookup mechanism is done in the connection pool via the use of connection variables declared as keys.

The user of the connector can configure the pool by adding a connection-pooling-profile to the connector configuration like this:

    <servicenow:connection-pooling-profile maxActive="10" maxIdle="10"
                             exhaustedAction="WHEN_EXHAUSTED_GROW" maxWait="120" minEvictionMillis="60000" evictionCheckIntervalMillis="30000"/>

The following is a list of connection attributes, each connection attribute can be configured at the config element level or they can also be added to each processor. If they are used at the processor level they get the benefit of full expression resolution.

Connection Attributes
Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
username		A username to connect to the service now	String	/	UTF-8
password		A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Reconnection Strategies

Reconnection Strategies specify how a connector behaves when its connection fails. You can control how Mule attempts to reconnect by specifying a number of criteria:

The type of exception
Number and frequency of reconnection attempts
The notifications generated, and more

With a reconnection strategy, you can better control the behavior of a failed connection, by configuring it, for example, to re-attempt the connection only once every 15 minutes, and to give up after 30 attempts. You can also send an automatic notification to your IT administrator whenever this reconnection strategy goes into effect. You can even define a strategy that attempts to reconnect only during business hours. Such a setting can prove useful if your server is frequently shut down for nightly maintenance.

Configuration

A reconnection strategy that allows the user to configure how many times a reconnection should be attempted and how long to wait between attempts.

    <servicenow:config>
         <reconnect count="5" frequency="1000"/>
    </servicenow:config>

Reconnect Attributes
Name	Default Value	Description
frequency	2000	Optional. How often (in ms) to reconnect
count	2	Optional. How many reconnection attempts to make

For more information about reconnection strategies in Mule, or even how to write your own custom reconnection strategy please check this section.

Message Processors

<servicenow:delete-asset-record>

Delete a record from the Asset table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
deleteAssetRequest	#[payload]	Optional. Delete Asset data	DeleteRecord	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
DeleteRecordResponse	DeleteResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:delete-incident-record>

Delete a record from the Incident table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
deleteIncidentRecordRequest	#[payload]	Optional. DeleteRecord object represents the incident to be deleted from servie now	DeleteRecord	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
DeleteRecordResponse	DeleteRecordResponse object contains the count of deleted record

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:delete-multiple-incident>

Delete multiple record from the Incident table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
deleteMultipleIncidentRequest	#[payload]	Optional. DeleteMultiple object for deleting multiple incident records from service now	DeleteMultiple	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
DeleteMultipleResponse	DeleteMultipleResponse object contains the count of deleted records

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:delete-multiple-user>

Delete multiple record from the User table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
deleteMultipleUserRequest	#[payload]	Optional. DeleteMultiple object for deleting multiple user records from service now	DeleteMultiple	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
DeleteMultipleResponse	DeleteMultipleResponse object contains the count of deleted records

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:delete-user-group-record>

Delete a record from the Group Member table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
deleteUserGroupRequest	#[payload]	Optional. Delete user role data	DeleteRecord	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
DeleteRecordResponse	DeleteRecordResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:delete-user-record>

Delete a record from the User table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
deleteUserRecordRequest	#[payload]	Optional. DeleteRecord object represents the user to be deleted from servie now	DeleteRecord	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
DeleteRecordResponse	DeleteRecordResponse object contains the count of deleted record

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:delete-user-role-record>

Delete a record from the User Role table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
deleteRecordRequest	#[payload]	Optional. Delete user role data	DeleteRecord	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
DeleteRecordResponse	DeleteRecordResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:get-asset>

Query a single record from the Asset table and return the record and its fields.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
getAssetRequest	#[payload]	Optional. Get object for retrieving user	Get	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
GetResponse	GetResponse object contains the user information

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:get-asset-records>

Query the Asset table by example values and return all matching records and their fields.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
assetsRecordsRequest	#[payload]	Optional. Request data	GetRecords	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
GetRecordsResponse	InsertResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:get-incident>

Query a single record from the Incident table and return the record and its fields.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
getIncidentRequest	#[payload]	Optional. Get object for retrieving incident	Get	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
GetResponse	GetResponse object contains the incident information

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:get-incident-keys>

Query the Incident table by example values and return a comma delimited list of sys_id.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
getIncidentKeysRequest	#[payload]	Optional. GetKeys object for retrieving incident keys	GetKeys	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
GetKeysResponse	GetKeysResponse object contains the incident keys information

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:get-incident-records>

Query the Incident table by example values and return all matching records and their fields.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
getIncidentRecordsRequest	#[payload]	Optional. GetRecords object for retrieving incident records	GetRecords	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
GetRecordsResponse	GetRecordResponse object contains the incident record information

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:get-user>

Query a single record from the User table and return the record and its fields.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
getUserRequest	#[payload]	Optional. Get object for retrieving user	Get	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
GetResponse	GetResponse object contains the user information

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:get-user-group-records>

Query the Group Member table by example values and return all matching records and their fields.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
getUserGroupRecordsRequest	#[payload]	Optional. Get user role record data	GetRecords	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
GetRecordsResponse	GetRecordsResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:get-user-keys>

Query the User table by example values and return a comma delimited list of sys_id.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
getUserKeysRequest	#[payload]	Optional. GetKeys object for retrieving user keys	GetKeys	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
GetKeysResponse	GetKeysResponse object contains the user keys information

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:get-user-records>

Query the User table by example values and return all matching records and their fields.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
getUserRecordsRequest	#[payload]	Optional. GetRecords object for retrieving user records	GetRecords	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
GetRecordsResponse	GetRecordResponse object contains the user record information

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:get-user-role-records>

Query the User Role table by example values and return all matching records and their fields.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
getUserRoleRecordsRequest	#[payload]	Optional. Get user role record data	GetRecords	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
GetRecordsResponse	GetRecordsResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:insert-asset>

Creates a new record for the Asset table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
insertAssetRequest	#[payload]	Optional. Insert Asset data	Insert	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
InsertResponse	InsertResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:insert-incident>

Creates a new record for the Incident table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
insertIncidentRequest	#[payload]	Optional. Insert object to be inserted into servie now system	Insert	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
InsertResponse	InsertResponse object contains the incident which has been inserted into the servie now system

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:insert-user>

Creates a new record for the User table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
insertUserRequest	#[payload]	Optional. User to be added to service now system	Insert	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
InsertResponse	InsertResponse object contains the user which has been inserted into the servie now system

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:insert-user-group>

Creates a new record for the Group Member table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
insertUserGroupRequest	#[payload]	Optional. User Group data	Insert	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
InsertResponse	InsertResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:insert-user-role>

Creates a new record for the User Role table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
insertUserRoleRequest	#[payload]	Optional. Insert user role data	Insert	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
InsertResponse	InsertResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:update-asset>

Updates an existing record in the Asset table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
updateAssetRequest	#[payload]	Optional. Update Asset data	Update	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
UpdateResponse	UpdateResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:update-incident>

Updates an existing record in the Incident table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
updateIncidentRequest	#[payload]	Optional. Update object to be updated in service now system	Update	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
UpdateResponse	UpdateResponse object contains the updated incident detail

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:update-user>

Updates an existing record in the User table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
updateUserRequest	#[payload]	Optional. Update object to be updated in service now system	Update	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
UpdateResponse	UpdateResponse object contains the updated incident detail

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:update-user-group>

Updates an existing record in the Group Member table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
updateUserGroupRequest	#[payload]	Optional. Insert user role data	Update	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
UpdateResponse	UpdateResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs

<servicenow:update-user-role>

Updates an existing record in the User Role table.

XML Sample

INCLUDE_ERROR

Attributes

Name	Default Value	Description	Java Type	MIME Type	Encoding
config-ref		Optional. Specify which configuration to use.
updateUserRoleRequest	#[payload]	Optional. Insert user role data	Update	/
Connection Parameters This are only required if you didn't specified them at the configuration element. They are also useful for overriding the values of the configurations or even if you need to extract them from the Mule message since they support expression evaluation.
username		Optional. A username to connect to the service now	String	/	UTF-8
password		Optional. A password to connect to the service now	String	/	UTF-8
serviceEndpoint		Optional. Tenant URL in ServiceNow. E.g.:https://dev1.service-now.com	String	/	UTF-8

Returns

Return Type	Description
UpdateResponse	UpdateResponse Object containing results of the operation

Exception Payloads

Payload Class	Description
Exception	if any error occurs