Contact Us 1-800-596-4880

ServiceNow Connector 7.0 Reference

Anypoint Connector for ServiceNow (ServiceNow Connector) provides connections between Mule runtime engine (Mule) and ServiceNow apps.

Configuration

Default Configuration for ServiceNow Connector.

Name Type Description Default Value Required

Name

String

Name for this configuration. Connectors reference the configuration with this name.

x

Connection

Connection types for this configuration.

x

Encoding

String

Default character encoding for operations and sources. If not specified, uses Mule’s default encoding.

Read Timeout

Number

Default maximum time to wait for a response from the ServiceNow instance. If not specified, uses the transport’s read timeout.

Read Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Read Timeout field.

MILLISECONDS

User Tables List

Array of String

List of user-defined tables.

ServiceNow Version

Enumeration, one of:

  • EUREKA

  • FUJI

  • GENEVA

  • HELSINKI

  • ISTANBUL

  • JAKARTA

  • KINGSTON

  • MADRID

  • NEW_YORK

  • ORLANDO

  • PARIS

  • QUEBEC

  • ROME

  • SAN_DIEGO

  • TOKYO

  • UTAH

  • VANCOUVER

  • WASHINGTON

  • XANADU

  • YOKOHAMA

  • ZURICH

  • AUSTRALIA

Deprecated since 7.0.0. It’s retained for backward compatibility. The connector uses the API exposed by the ServiceNow instance specified in Service Address, so you don’t need a replacement version setting.

WASHINGTON

Name

String

ID used to reference this configuration.

x

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.

Basic Authentication Connection Type

Name Type Description Default Value Required

Service Address

String

Address of the ServiceNow service.

x

Proxy Configuration

One of:

Proxy configuration for the connection.

User Name

String

Username.

x

Password

String

Password.

x

Transport Configuration

Transport configuration.

TLS Configuration

TLS

TLS configuration for the connection.

Sign Security Strategy

WSS configuration for the signature security strategy.

Username Token Security Strategy

WSS configuration for the username token security strategy.

Reconnection

Configures a reconnection strategy to use when a connector operation fails to connect to an external server.

OAuth 2.0 Authorization Code Connection Type

Use OAuth 2.0 to delegate user authentication to the service hosting the user account. For more information, refer to Configuring OAuth 2.0 for Connectors, Configuring OAuth 2.0 for Connectors on CloudHub, or OAuth Support in the SDK.

Name Type Description Default Value Required

Service Address

String

Address of ServiceNow service.

x

Proxy Configuration

One of:

Proxy configuration for the connection.

Custom Transport Configuration

Custom transport configuration.

TLS Configuration

TLS

TLS configuration for the connection.

State

String

String value that you send when the OAuth dance is initiated and that is returned back by the service provider with the token callback.

Sign Security Strategy

WSS configuration for the signature security strategy.

Username Token Security Strategy

Username token WSS configuration.

Reconnection

Configures a reconnection strategy to use when a connector operation fails to connect to an external server.

Consumer Key

String

OAuth consumer key, as registered with the service provider.

x

Consumer Secret

String

OAuth consumer secret, as registered with the service provider.

x

Authorization Url

String

URL of the service provider’s authorization endpoint.

https://{instance-id}.service-now.com/oauth_auth.do

Access Token Url

String

URL of the service provider’s access token endpoint.

https://{instance-id}.service-now.com/oauth_token.do

Scopes

String

OAuth scopes to request during the OAuth dance. This value defaults to the scopes in the annotation.

Resource Owner Id

String

Resource owner ID to use with the authorization code grant type.

Before

String

Name of the flow to execute immediately before starting the OAuth dance.

After

String

Name of the flow to execute immediately after receiving an access token.

Listener Config

String

Configuration for the HTTP listener that listens for requests on the access token callback endpoint.

x

Callback Path

String

Path of the access token callback endpoint.

x

Authorize Path

String

Path of the local HTTP endpoint that triggers the OAuth dance.

x

External Callback Url

String

URL that the OAuth provider uses to access the callback endpoint if the endpoint is behind a proxy or accessed through an indirect URL.

Object Store

String

Configures the object store that stores data for each resource owner. If not configured, Mule uses the default object store.

Sources

To view custom or extended parent tables in ServiceNow Connector, select the Allow access to this table via web services and Allow configuration options in the table definition.

New / Updated Record

<servicenow:new-or-updated-record-listener>

Efficiently polls periodically for changes in the selected table and accepts only new records into the flow.

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

ServiceNow Time Zone

String

Timezone.

America/Los_Angeles

Table name

String

Name of the table from which to retrieve the records.

x

Query

String

Optional query that filters the result set. The syntax is sysparm_query=. All parameters are case-sensitive. Queries can contain more than one entry, such as [].

Display System References

Enumeration, one of:

  • TRUE

  • FALSE

  • ALL

Data retrieval operation for reference and choice fields. Based on this value, retrieves the display value and/or the actual value from the database.

FALSE

Exclude Reference Links

Boolean

Flag that indicates whether to exclude table API links for reference fields.

false

Encoding

String

Character encoding for polls. Overrides the configuration value.

Read Timeout

Number

Maximum time to wait for the response to each poll. Overrides the configuration value.

Read Timeout Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Read Timeout field.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Primary Node Only

Boolean

Determines whether to execute this source on only the primary node when running Mule instances in a cluster.

Scheduling Strategy

Scheduling Strategy

Configures the scheduler that triggers the polling.

x

Streaming Strategy

Configures how Mule processes streams. The default is to use repeatable streams.

Redelivery Policy

Defines a policy for processing the redelivery of the same message.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

Any

Attributes Type

Associated Configurations

Operations

To view custom or extended parent tables in ServiceNow Connector, select the Allow access to this table via web services and Allow configuration options in the table definition.

Invoke

<servicenow:invoke>

Default operation for ServiceNow SOAP invocations.

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Allow Empty Value

Boolean

Option that enables users to clear a specific field with a null or empty value for the update operation.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Service

String

Name of the ServiceNow table to invoke. Must contain only ASCII letters, digits, and underscores. Invalid names raise SERVICENOW:BAD_REQUEST.

x

Operation

String

Operation name of the service.

x

Show Reference Values

Enumeration, one of:

  • TRUE

  • FALSE

  • ALL

Chooses which values are returned for reference fields. Possible options are to return sys_ids, display values, or both. Use this option only for get and getRecords operations.

Body

Binary

XML body to include in the SOAP message, with all the required parameters, or null if no parameters are required.

#[payload]

Headers

Binary

XML headers to include in the SOAP message.

Attachments

Object

Attachments to include in the SOAP request.

Encoding

String

Character encoding for this invocation. Overrides the configuration value.

Read Timeout

Number

Maximum time to wait for the response to this invocation. Overrides the configuration value.

Read Timeout Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Read Timeout field.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

Retry strategy in case of connectivity errors.

Output

Type

SOAP Output Envelope

Attributes Type

Associated Configurations

Throws

  • SERVICENOW:RETRY_EXHAUSTED

  • SERVICENOW:SOAP_FAULT

  • SERVICENOW:PROCESSING_ERROR

  • SERVICENOW:BAD_RESPONSE

  • SERVICENOW:TIMEOUT

  • SERVICENOW:CONNECTIVITY

  • SERVICENOW:BAD_REQUEST

  • SERVICENOW:CANNOT_DISPATCH

  • SERVICENOW:INVALID_WSDL

  • SERVICENOW:ENCODING

  • SERVICENOW:NOT_FOUND

  • SERVICENOW:SECURITY

Unauthorize

<servicenow:unauthorize>

Deletes all the access token information of a given resource owner ID so that it is impossible to execute any operation for that user without repeating the OAuth dance.

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

x

Resource Owner Id

String

ID of the resource owner for whom to invalidate access.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

x

Associated Configurations

Object Types

Basic Authentication HTTP Message Dispatcher Provider

Default HTTP transport configuration.

Field Type Description Default Value Required

Username

String

Username to use.

x

Password

String

Password to use.

x

Read Timeout

Number

Read timeout value.

15000

Read Timeout Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Read Timeout field.

MILLISECONDS

Expiration Policy

Configures an expiration policy strategy.

Field Type Description Default Value Required

Max Idle Time

Number

Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Max Idle Time field.

Error Mapping

Field Type Description Default Value Required

Source

Enumeration, one of:

  • ANY

  • REDELIVERY_EXHAUSTED

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY

  • SERVER_SECURITY

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED

  • TIMEOUT

Target

String

x

HTTP Requester Based Transport Provider

Custom HTTP transport configuration.

Configure the response timeout, TLS, and proxy settings on the referenced HTTP Request configuration. The connector’s global and operation or source read-timeout overrides do not apply to this transport.

Field Type Description Default Value Required

Requester Config

String

Requester configuration.

x

OAuth2 HTTP Message Dispatcher Provider

OAuth transport configuration.

Field Type Description Default Value Required

Read Timeout

Number

Read timeout value.

15000

Read Timeout Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Read Timeout field.

MILLISECONDS

Reconnect

Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.

Field Type Description Default Value Required

Frequency

Number

How often to attempt to reconnect, in milliseconds.

Blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

Count

Number

How many reconnection attempts the Mule app can make.

Reconnect Forever

Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.

Field Type Description Default Value Required

Frequency

Number

How often to attempt to reconnect, in milliseconds.

Blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

Reconnection

Configures a reconnection strategy for an operation.

Field Type Description Default Value Required

Fails Deployment

Boolean

What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy:

  • true

    Allow the deployment to fail.

  • false

    Ignore the results of the connectivity test.

Reconnection Strategy

Reconnection strategy to use.

Redelivery Policy

Configures the redelivery policy for executing requests that generate errors. You can add a redelivery policy to any source in a flow.

Field Type Description Default Value Required

Max Redelivery Count

Number

Maximum number of times that a redelivered request can be processed unsuccessfully before returning a REDELIVERY_EXHAUSTED error.

Message Digest Algorithm

String

Secure hashing algorithm to use if the Use Secure Hash field is true. If the payload of the message is a Java object, Mule ignores this value and returns the value that the payload’s hashCode() returned.

Message Identifier

Redelivery Policy Message Identifier

One or more expressions that determine if a message was redelivered. This property can be set only if the Use Secure Hash field is false.

Object Store

ObjectStore

Configures the object store that stores the redelivery counter for each message.

Redelivery Policy Message Identifier

Configures how to identify a redelivered message and how to find out when the message was redelivered.

Field Type Description Default Value Required

Use Secure Hash

Boolean

If true, Mule uses a secure hash algorithm to identify a redelivered message.

Id Expression

String

One or more expressions that determine if a message was redelivered. This property can be set only if the Use Secure Hash field is false.

Repeatable File Store Stream

Configures the repeatable file-store streaming strategy by which Mule keeps a portion of the stream content in memory. If the stream content is larger than the configured buffer size, Mule backs up the buffer’s content to disk and then clears the memory.

Field Type Description Default Value Required

In Memory Size

Number

Maximum amount of memory that the stream can use for data. If the amount of memory exceeds this value, Mule buffers the content to disk. To optimize performance:

  • Configure a larger buffer size to avoid the number of times Mule needs to write the buffer on disk. This increases performance, but it also limits the number of concurrent requests your application can process, because it requires additional memory.

  • Configure a smaller buffer size to decrease memory load at the expense of response time.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

Unit for the In Memory Size field.

Repeatable In Memory Stream

Configures the in-memory streaming strategy by which the request fails if the data exceeds the MAX buffer size. Always run performance tests to find the optimal buffer size for your specific use case.

Field Type Description Default Value Required

Initial Buffer Size

Number

Initial amount of memory to allocate to the data stream. If the streamed data exceeds this value, the buffer expands by Buffer Size Increment, with an upper limit of Max In Memory Size value.

Buffer Size Increment

Number

Amount by which the buffer size expands if it exceeds its initial size. Setting a value of 0 or lower specifies that the buffer can’t expand.

Max Buffer Size

Number

The maximum amount of memory to use. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised. A value lower than or equal to zero means no limit.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

Unit for the Initial Buffer Size, Buffer Size Increment, and Buffer Unit fields.

SOAP Attributes

Attributes returned by the consume operation. Carries the protocol specific headers (such as HTTP headers) and additional transport data (such as the HTTP status line) bounded to the response.

Field Type Description Default Value Required

Additional Transport Data

Object

Additional transport data bundled in the response.

Protocol Headers

Object

Protocol headers bundled in the response.

SOAP Output Envelope

Represents the response of the consume operation. Bundles the SOAP body, SOAP headers, and MIME attachments if there are any.

Field Type Description Default Value Required

Attachments

Object

Set of attachments bounded to the response, or an empty map if there are no attachments.

Body

Binary

XML response body. Represents the <SOAP:BODY> element.

Headers

Object

Map of SOAP header names to repeatable XML streams. These are SOAP response headers, not the HTTP protocol headers returned in SoapAttributes.

Wss Key Store Configuration

Implementation for keystores, used for encryption, decryption, and signing.

Field Type Description Default Value Required

Key Store Path

String

Location of the keystore file.

x

Alias

String

Alias of the private key to use.

Password

String

Password to access the store.

x

Key Password

String

Password used to access the private key.

Type

String

Type of store, such as fjks, pkcs12, jceks, and so on.

jks

Wss Sign Security Strategy Adapter

Signs the SOAP request that is sent, using the private key of the keystore in the provided TLS context.

Field Type Description Default Value Required

Key Store Configuration

Keystore to use when signing the message.

x

Sign Algorithm Configuration

Algorithms to use on the signing.

WSS Signing Configuration Adapter

Group that holds the configuration for signing algorithms used in the sign security strategy.

Field Type Description Default Value Required

Signature Key Identifier

Enumeration, one of:

  • DIRECT_REFERENCE

  • X509_KEY_IDENTIFIER

Key identifier type to use for the signature.

X509_KEY_IDENTIFIER

Signature Algorithm

Enumeration, one of:

  • RSA_WITH_SHA224

  • RSA_WITH_SHA256

  • RSA_WITH_SHA384

  • RSA_WITH_SHA512

Signature algorithm to use. The default is set by the data in the certificate.

Signature Digest Algorithm

Enumeration, one of:

  • SHA256

  • SHA224

  • SHA384

  • SHA512

Signature digest algorithm to use.

SHA256

Signature C14n Algorithm

Enumeration, one of:

  • CANONICAL_XML_1_0

  • CANONICAL_XML_1_1

  • EXCLUSIVE_XML_CANONICALIZATION_1_0

Defines which signature c14n (canonicalization) algorithm to use.

EXCLUSIVE_XML_CANONICALIZATION_1_0

TLS

Field Type Description Default Value Required

Enabled Protocols

String

Comma-separated list of protocols to enable for this TLS context.

Enabled Cipher Suites

String

Comma-separated list of cipher suites to enable for this TLS context.

Trust Store

Trust store configuration.

Key Store

Key store configuration.

Revocation Check

Certificate revocation check configuration.

Trust Store

Field Type Description Default Value Required

Path

String

Location of the trust store.

Password

String

Password that protects the trust store.

Type

String

Type of store to use.

Algorithm

String

Algorithm to use for the trust store.

Insecure

Boolean

If true, certificate validation is disabled. Use this setting only when required.

Key Store

Field Type Description Default Value Required

Path

String

Location of the key store.

Type

String

Type of store to use.

Alias

String

Alias of the private key to use.

Key Password

String

Password that protects the private key.

Password

String

Password that protects the key store.

Algorithm

String

Algorithm to use for the key store.

Standard Revocation Check

Field Type Description Default Value Required

Only End Entities

Boolean

Verify only the last certificate in the certificate chain.

Prefer CRLs

Boolean

Try CRL before OCSP.

No Fallback

Boolean

Don’t use the secondary certificate revocation checking method.

Soft Fail

Boolean

Avoid a verification failure when the revocation server can’t be reached or is busy.

Custom OCSP Responder

Field Type Description Default Value Required

URL

String

URL of the OCSP responder.

Cert Alias

String

Alias of the certificate that signs the OCSP response.

CRL File

Field Type Description Default Value Required

Path

String

Path to the CRL file.

Proxy

Field Type Description Default Value Required

Host

String

Proxy host.

x

Port

Number

Proxy port.

x

Username

String

Username for proxy authentication.

Password

String

Password for proxy authentication.

Non Proxy Hosts

String

Hosts that bypass the proxy.

NTLM Proxy

Field Type Description Default Value Required

NTLM Domain

String

NTLM domain for proxy authentication.

x

Host

String

Proxy host.

x

Port

Number

Proxy port.

x

Username

String

Username for proxy authentication.

Password

String

Password for proxy authentication.

Non Proxy Hosts

String

Hosts that bypass the proxy.

WSS Username Token Security Strategy Adapter

Provides the capability to authenticate with a SOAP service using a username and a password by adding the UsernameToken element in the SOAP request.

Field Type Description Default Value Required

Username

String

Username required to authenticate with the service.

x

Password

String

Password for the provided username required to authenticate with the service.

x

Password Type

Enumeration, one of:

  • DIGEST

  • TEXT

Password parameter.

DIGEST