Getting started Community Training Tutorials Documentation APIs, AI & Tools
String
Anypoint Connector for ServiceNow (ServiceNow Connector) provides connections between Mule runtime engine (Mule) and ServiceNow apps.
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:
|
Time unit for the Read Timeout field. |
|
|
User Tables List |
Array of String |
List of user-defined tables. |
||
ServiceNow Version |
Enumeration, one of:
|
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. |
|
|
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. |
| 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 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. |
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 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. |
|
|
Access Token Url |
String |
URL of the service provider’s access token endpoint. |
|
|
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. |
| 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. |
<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. |
|
|
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 |
||
Display System References |
Enumeration, one of:
|
Data retrieval operation for reference and choice fields. Based on this value, retrieves the display value and/or the actual value from the database. |
|
|
Exclude Reference Links |
Boolean |
Flag that indicates whether to exclude table API links for reference fields. |
|
|
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:
|
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. |
| 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. |
<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 |
|
|
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 |
x |
|
Operation |
String |
Operation name of the service. |
x |
|
Show Reference Values |
Enumeration, one of:
|
Chooses which values are returned for reference fields. Possible options are to return |
||
Body |
Binary |
XML body to include in the SOAP message, with all the required parameters, or |
|
|
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:
|
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. |
|
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
<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 |
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. |
|
|
Read Timeout Time Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
|
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:
|
Time unit for the Max Idle Time field. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Source |
Enumeration, one of:
|
|||
Target |
String |
x |
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 |
OAuth transport configuration.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Read Timeout |
Number |
Read timeout value. |
|
|
Read Timeout Time Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
|
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 |
||
Count |
Number |
How many reconnection attempts the Mule app can make. |
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 |
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:
|
||
Reconnection Strategy |
Reconnection strategy to use. |
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 |
||
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 |
||
Object Store |
ObjectStore |
Configures the object store that stores the redelivery counter for each message. |
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 |
||
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 |
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:
|
||
Buffer Unit |
Enumeration, one of:
|
Unit for the In Memory Size field. |
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 |
||
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:
|
Unit for the Initial Buffer Size, Buffer Size Increment, and Buffer Unit fields. |
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. |
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 |
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 |
|
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. |
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:
|
Key identifier type to use for the signature. |
|
|
Signature Algorithm |
Enumeration, one of:
|
Signature algorithm to use. The default is set by the data in the certificate. |
||
Signature Digest Algorithm |
Enumeration, one of:
|
Signature digest algorithm to use. |
|
|
Signature C14n Algorithm |
Enumeration, one of:
|
Defines which signature c14n (canonicalization) algorithm to use. |
|
| 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. |
| 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 |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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:
|
Password parameter. |
|