Read

This Snap connects to the particular instance provided by ServiceNow, executes the query and fetches the records or keys depending on the chosen action, and returns the result as a document stream.

• Expected upstream Snaps: Any Snap that provides a document output view such as a Mapper Snap.
• Expected downstream Snaps: None or any Snap that has a document input view such as a Filter or a Data or a JSON Formatter.
• Expected input:  A Table Name and a search query.
• Expected output:  Return records as query results.

None

• Works in Ultra Tasks.

  In Ultra Pipelines, set the Page size as 1 for the Snap to process one document/record at a time.

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Configuring ServiceNow Accounts for information on setting up this type of account.

Required. The name of the table in the instance. The table name is suggestible but requires an account setting for the suggestions to appear.

Example: incident

Default value: [None]

This property specifies the fields to be retrieved from the table.
Note: This property works only when API type is selected as 'table'.

A property that determines whether to display values for the reference fields. 

• true=display reference field
• false=do not display
• all=display both—reference field and its value

Default value: true

Required. Number of documents for processing in a single batch.

Minimum Value: 1

Maximum Value: 500

Default Value: 500

A property that determines whether to display composite fields in a hierarchical order.

• true=display
• false=do not display

Default value: Selected

If selected, the input document will be passed through to the output view under the key 'original'.

Default value: Selected

A property that determines whether the query for an empty result is allowed or not. If selected, the Snap writes an empty document when it fetches no records. Otherwise, an exception is thrown.

Default value: Not selected

Specifies the maximum number of retry attempts when the Snap fails to read.

Example: 3

Minimum value: 0

Default value: 0

Specifies the minimum number of seconds the Snap must wait before each retry attempt.

Example: 3

Minimum value: 1

Default value: 1

Select one of the following three modes in which the Snap executes:

• Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.

• Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.

• Disabled: Disables the Snap and all Snaps that are downstream from it.

Default Value: Execute only
Example: Validate & Execute