Skip to main content

Cyware Orchestrate

ServiceNow ITSM 3.0.0

App Vendor: ServiceNow ITSM

App Category: Case/Ticket Management

Connector Version: 3.1.0

API Version: Tokyo

About App

The ServiceNow IT Service Management (ITSM) focuses on streamlining and automating IT service delivery and management processes. It provides tools for incident, problem, change, and asset management, enhancing efficiency in IT operations.

The ServiceNow ITSM app is configured with Orchestrate to perform the following actions:

Action Name

Description

Checkout Item Order Request 

This action checkouts an item order request based on the specified parameters.

Close Incident 

This action closes an incident.

Create Change Request 

This action creates a change request in ServiceNow ITSM.

Create Incident 

This action creates a new incident in the incident table.

Create Item Order Request 

This action creates a catalog item order request based on the specified parameters.

Create New Record in a Table 

This action creates a record in the table in ServiceNow ITSM.

Create Request Item 

This action adds a request item in ServiceNow ITSM.

Delete Record from Table 

This action deletes a record from a table.

Download Attachment 

This action gets the file attachment with a specific sys_id value. Note: It will show both the content and file path where the file is stored.

Generic Action 

This is a generic action to perform any additional use case that you want on ServiceNow ITSM.

Get Attachment Metadata 

The action gets the metadata for multiple attachments using the system ID.

Get Change Request Record 

This action retrieves the details of the change request records.

Get Details of a Record 

This action gets more details about a record from the table.

Get Incident Details by Incident Number 

This action gets the incident details by the incident number.

Get Requested Item Record (RITM) 

This action retrieves details of a requested item record.

Get Stats Of A Table 

This action gets the statistics of a table.

Get User Roles 

This action gets a list of user roles.

Get Users 

This action gets user details based on the specified table.

List Catalog Items 

This action retrieves a list of catalog items based on the specified parameters.

Perform Analytics on Fields 

This action performs analytics on the specified fields (experimental).

Resolve Incident Records 

This action resolves incident records.

Search Records From Table 

This action performs a search for the records from the table.

Update Incident 

This action updates an incident.

Update Request Item Record (RITM) 

This action updates the requested item record.

Update Table Record 

This action updates a record of a table.

Upload File 

This action uploads a multipart file attachment.

Configuration Parameters

The following configuration parameters are required for the ServiceNow ITSM app to communicate with the ServiceNow ITSM enterprise application. The parameters can be configured by creating instances in the app.

Parameter

Description

Field Type

Required/Optional

Comments

Username 

Enter the username to connect to ServiceNow ITSM.

Text

Required

Password 

Enter the password for the provided ServiceNow ITSM account.

Password

Required

Base URL 

Enter the base URL to access ServiceNow ITSM.

Example:

https://instancename.service-now.com/api

Text

Required

Client ID 

Enter the client ID.

Text

Optional

Client Secret 

Enter the client secret to authorize communication with the application.

Password

Optional

Time-Based One-Time-Password Secret 

Enter the secret password generated for MFA using the one time password.

Password

Optional

Proxy Type 

Enter the proxy type.

Text

Optional

Proxy URL 

Enter the proxy URL.

Text

Optional

Proxy Username 

Enter the proxy username.

Text

Optional

Proxy Password 

Enter the proxy password.

Password

Optional

Verify 

Verify the SSL/TLS certificate while authenticating with the server. It's recommended to enable this option. By default, the verification is not enabled.

Boolean

Optional

Default:

false

Timeout 

Enter the timeout for the actions in seconds.

Integer

Optional

Allowed values:

15-120

Default:

15

Action: Checkout Item Order Request

This action checks out an item order request based on the specified system ID.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

System ID 

Enter the system ID of the attachment.

Example:

1f27d9a5db131010a3c28a18489619b6

Text

Required

You can retrieve this ID using the action Create Item Order Request. 

Example Request

[
    {
        "sys_id": "011f117a9f3002002920bde8132e7020"
    }
]

Action Response Parameters

Parameter

Type

Description

result.cart_id

String

Unique identifier for the shopping cart. Example: "0d8c7a32c3211200d68d3b0ac3d3aeba"

result.subtotal_price

String

Subtotal price of the items in the cart. Example: "$3,350.00"

result.subtotal_recurring_frequency

String

Recurring frequency of the subtotal. Example: ""

result.subtotal_recurring_price

String

Recurring price of the subtotal. Example: "$300.00"

result.total_title

String

Title for the total section. Example: "Total"

result.monthly.subtotal_price

String

Subtotal price for the monthly items. Example: "$50.00"

result.monthly.subtotal_recurring_frequency

String

Recurring frequency for the monthly items. Example: "Monthly"

result.monthly.subtotal_recurring_price

String

Recurring price for the monthly items. Example: "$0.00"

result.monthly.total_title

String

Title for the monthly total section. Example: "Total"

result.monthly.items[].catalog_item_id

String

Unique identifier for the catalog item. Example: "90af095bcd38798071a208d710d1b64f"

result.monthly.items[].variables

Object

Variables associated with the catalog item. Example: {}

result.monthly.items[].quantity

String

Quantity of the item. Example: "1"

result.monthly.items[].localized_price

String

Localized price of the item. Example: "$50.00"

result.monthly.items[].price

String

Price of the item. Example: "$50.00"

result.monthly.items[].recurring_frequency

String

Recurring frequency of the item. Example: "Monthly"

result.monthly.items[].localized_recurring_price

String

Localized recurring price of the item. Example: "$0.00"

result.monthly.items[].recurring_price

String

Recurring price of the item. Example: "$0.00"

result.monthly.items[].item_name

String

Name of the item. Example: "Belkin iPad Mini Case"

result.monthly.items[].cart_item_id

String

Unique identifier for the cart item. Example: "cb6e485fc3211200d68d3b0ac3d3ae35"

result.monthly.items[].delivery_time

String

Delivery time for the item. Example: "2 Days"

result.monthly.show_subtotal_price

String

Flag to show or hide the subtotal price. Example: "true"

result.monthly.subtotal_title

String

Title for the monthly subtotal section. Example: "Subtotal"

result.none.subtotal_price

String

Subtotal price for items with no recurring frequency. Example: "-"

result.none.subtotal_recurring_frequency

String

Recurring frequency for items with no recurring frequency. Example: ""

result.none.subtotal_recurring_price

String

Recurring price for items with no recurring frequency. Example: "$0.00"

result.none.total_title

String

Title for the total section. Example: "Total"

result.none.items[].catalog_item_id

String

Unique identifier for the catalog item. Example: "186d917a6fab7980575967ddbb3ee4f2"

result.none.items[].variables

Object

Variables associated with the catalog item. Example: {"Preferred Email address": "abel.tuter@example.com"}

result.none.items[].quantity

String

Quantity of the item. Example: "1"

result.none.items[].localized_price

String

Localized price of the item. Example: "$0.00"

result.none.items[].price

String

Price of the item. Example: "$0.00"

result.none.items[].recurring_frequency

String

Recurring frequency of the item. Example: ""

result.none.items[].localized_recurring_price

String

Localized recurring price of the item. Example: "$0.00"

result.none.items[].recurring_price

String

Recurring price of the item. Example: "$0.00"

result.none.items[].item_name

String

Name of the item. Example: "New Email Account"

result.none.items[].cart_item_id

String

Unique identifier for the cart item. Example: "17c5241fc3211200d68d3b0ac3d3ae7f"

result.none.items[].delivery_time

String

Delivery time for the item. Example: "global.Workflow"

result.none.show_subtotal_price

String

Flag to show or hide the subtotal price. Example: "false"

result.none.subtotal_title

String

Title for the subtotal section. Example: "Subtotal"

result.yearly.subtotal_price

String

Subtotal price for the yearly items. Example: "$3,300.00"

result.yearly.subtotal_recurring_frequency

String

Recurring frequency for the yearly items. Example: "Annually"

result.yearly.subtotal_recurring_price

String

Recurring price for the yearly items. Example: "$300.00"

result.yearly.total_title

String

Title for the yearly total section. Example: "Total"

result.yearly.items[].catalog_item_id

String

Unique identifier for the catalog item. Example: "04b7e94b4f7b4200086eeed18110c7fd"

result.yearly.items[].variables

Object

Variables associated with the catalog item. Example: {"Adobe Photoshop": "", "Adobe Acrobat": "true", "Optional Software": "", "Additional software requirements": "MS Office 2007"}

result.yearly.items[].quantity

String

Quantity of the item. Example: "3"

result.yearly.items[].localized_price

String

Localized price of the item. Example: "$1,100.00"

result.yearly.items[].price

String

Price of the item. Example: "$1,100.00"

result.yearly.items[].recurring_frequency

String

Recurring frequency of the item. Example: "Annually"

result.yearly.items[].localized_recurring_price

String

Localized recurring price of the item. Example: "$100.00"

result.yearly.items[].recurring_price

String

Recurring price of the item. Example: "$100.00"

result.yearly.items[].item_name

String

Name of the item. Example: "Standard Laptop"

result.yearly.items[].cart_item_id

String

Unique identifier for the cart item. Example: "9fc5241fc3211200d68d3b0ac3d3ae7e"

result.yearly.items[].delivery_time

String

Delivery time for the item. Example: "5 Days"

result.yearly.show_subtotal_price

String

Flag to show or hide the subtotal price. Example: "true"

result.yearly.subtotal_title

String

Title for the yearly subtotal section. Example: "Subtotal"

result.show_subtotal_price

String

Flag to show or hide the overall subtotal price. Example: "true"

result.subtotal_title

String

Title for the overall subtotal section. Example: "Subtotal"

Action: Close Incident

This action closes an incident.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

System ID 

Enter the system ID of the incident to close.

Example:

0a9cdf93dbd31010a3c28a1848961994

Text

Required

You can retrieve this ID using the action Create Incident.

Work notes 

Enter the work notes for closing the incident.

Example:

Resolved

Text

Required

Example Request

[
    {
        "sys_id": "0a9cdf93dbd31010a3c28a1848961994",
        "work_notes": "Resolved"
    }
]

Action Response Parameters

Parameter

Field Type

Description

{app_instance} 

JSON Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.result.upon_approval

String

Action to take upon approval. Example: "proceed"

app_instance.result.location

Object

Location details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f", "value": "108752c8c611227501d4ab0e392ba97f"}

app_instance.result.expected_start

String

Expected start time. Example: ""

app_instance.result.reopen_count

String

The number of times the incident was reopened. Example: ""

app_instance.result.close_notes

String

Notes added upon closing the incident. Example: ""

app_instance.result.additional_assignee_list

String

List of additional assignees. Example: ""

app_instance.result.impact

String

Impact level of the incident. Example: "1"

app_instance.result.urgency

String

Urgency level of the incident. Example: "1"

app_instance.result.correlation_id

String

Correlation ID for the incident. Example: ""

app_instance.result.sys_tags

String

System tags associated with the incident. Example: ""

app_instance.result.sys_domain

Object

Domain details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global"}

app_instance.result.description

String

Detailed description of the incident. Example: ""

app_instance.result.group_list

String

List of groups involved. Example: ""

app_instance.result.priority

String

Priority level of the incident. Example: "1"

app_instance.result.delivery_plan

String

Delivery plan details. Example: ""

app_instance.result.sys_mod_count

String

Modification count of the incident. Example: "7"

app_instance.result.work_notes_list

String

List of work notes. Example: ""

app_instance.result.business_service

String

Business service associated with the incident. Example: ""

app_instance.result.follow_up

String

Follow-up details. Example: ""

app_instance.result.closed_at

String

Timestamp when the incident was closed. Example: ""

app_instance.result.sla_due

String

SLA due date and time. Example: "2017-07-05 05:58:24"

app_instance.result.delivery_task

String

Delivery task details. Example: ""

app_instance.result.sys_updated_on

String

Last update timestamp. Example: "2016-01-22 14:12:37"

app_instance.result.parent

String

Parent incident details. Example: ""

app_instance.result.work_end

String

Work end timestamp. Example: ""

app_instance.result.number

String

Incident number. Example: "INC0000050"

app_instance.result.closed_by

String

User who closed the incident. Example: ""

app_instance.result.work_start

String

Work start timestamp. Example: ""

app_instance.result.calendar_stc

String

Calendar duration in seconds. Example: ""

app_instance.result.category

String

Incident category. Example: "hardware"

app_instance.result.business_duration

String

Business duration of the incident. Example: ""

app_instance.result.incident_state

String

Current state of the incident. Example: "2"

app_instance.result.activity_due

String

Activity due timestamp. Example: "2016-01-22 16:12:37"

app_instance.result.correlation_display

String

Correlation display value. Example: ""

app_instance.result.company

Object

Company details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec", "value": "31bea3d53790200044e0bfc8bcbe5dec"}

app_instance.result.active

String

Indicates if the incident is active. Example: "true"

app_instance.result.due_date

String

Due date of the incident. Example: ""

app_instance.result.assignment_group

Object

Assignment group details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3", "value": "8a5055c9c61122780043563ef53438e3"}

app_instance.result.caller_id

Object

Caller ID details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c", "value": "5b7c200d0a640069006b3845b5d0fa7c"}

app_instance.result.knowledge

String

Indicates if knowledge is required. Example: "false"

app_instance.result.made_sla

String

Indicates if the SLA was met. Example: "true"

app_instance.result.comments_and_work_notes

String

Comments and work notes. Example: ""

app_instance.result.parent_incident

String

Parent incident details. Example: ""

app_instance.result.state

String

State of the incident. Example: "2"

app_instance.result.user_input

String

User input details. Example: ""

app_instance.result.sys_created_on

String

Creation timestamp. Example: "2015-11-02 18:05:40"

app_instance.result.approval_set

String

Approval set details. Example: ""

app_instance.result.reassignment_count

String

Number of times reassigned. Example: "0"

app_instance.result.rfc

String

RFC details. Example: ""

app_instance.result.child_incidents

String

Details of child incidents. Example: ""

app_instance.result.opened_at

String

Opened timestamp. Example: "2015-11-02 21:58:24"

app_instance.result.short_description

String

Short description of the incident. Example: "Can't access Exchange server - is it down?"

app_instance.result.order

String

Order details. Example: ""

app_instance.result.sys_updated_by

String

User who last updated the incident. Example: "admin"

app_instance.result.resolved_by

String

User who resolved the incident. Example: ""

app_instance.result.notify

String

Notification preference. Example: "1"

app_instance.result.upon_reject

String

Action to take upon rejection. Example: "cancel"

app_instance.result.approval_history

String

Approval history details. Example: ""

app_instance.result.problem_id

String

Problem ID details. Example: ""

app_instance.result.work_notes

String

Work notes details. Example: ""

app_instance.result.calendar_duration

String

Calendar duration details. Example: ""

app_instance.result.close_code

String

Close code details. Example: ""

app_instance.result.sys_id

String

System ID of the incident. Example: "ef43c6d40a0a0b5700c77f9bf387afe3"

app_instance.result.approval

String

Approval status. Example: "not requested"

app_instance.result.caused_by

String

Details of the cause. Example: ""

app_instance.result.severity

String

Severity level of the incident. Example: "3"

app_instance.result.sys_created_by

String

User who created the incident. Example: "glide.maint"

app_instance.result.resolved_at

String

Resolution timestamp. Example: ""

app_instance.result.assigned_to

Object

Assigned to user details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd", "value": "681b365ec0a80164000fb0b05854a0cd"}

app_instance.result.business_stc

String

Business duration in seconds. Example: ""

app_instance.result.wf_activity

String

Workflow activity details. Example: ""

app_instance.result.sys_domain_path

String

System domain path. Example: "/"

app_instance.result.cmdb_ci

Object

Configuration item details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6", "value": "281190e3c0a8000b003f593aa3f20ca6"}

app_instance.result.opened_by

Object

Opened by user details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint", "value": "glide.maint"}

app_instance.result.subcategory

String

Subcategory of the incident. Example: ""

app_instance.result.rejection_goto

String

Rejection go-to details. Example: ""

app_instance.result.sys_class_name

String

Class name of the incident. Example: "incident"

app_instance.result.watch_list

String

Watch list details. Example: ""

app_instance.result.time_worked

String

Time worked on the incident. Example: ""

app_instance.result.contact_type

String

Type of contact. Example: "phone"

app_instance.result.escalation

String

Escalation level of the incident. Example: "3"

app_instance.result.comments

String

Comments added to the incident. Example: ""

Action: Create Change Request

This action creates a change request in ServiceNow ITSM.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Request type 

Enter the request type.

Example:

normal

Text

Required

Allowed values:

  • standard

  • normal

  • emergency

Category of change request 

Enter the category of the change request.

Example:

normal

Text

Required

Allowed values:

  • standard

  • normal

  • emergency

System ID of configuration item 

Enter the system ID of the configuration item.

Text

Required

Impact of the request 

Provide the impact of the change request.

Example:

2

Text

Required

Accepted values:

  • 1 - high

  • 2 - medium

  • 3 - low

Short description 

Provide a short description or summary of the change request.

Example:

Sample Description for Reference

Text

Optional

Description 

Provide the details for the change request.

Text

Optional

System ID of group 

Enter the system ID of the group to assign the request.

Text

Optional

Start date 

Provide a start date as input.

The date should be in the format:

2015-10-20 23:59:59

Text

Optional

End date 

Provide an end date. 

The date should be in the format:

2015-10-20 23:59:59

Text

Optional

Work note 

Provide a work note.

Text

Optional

Query params 

Enter additional parameters in the form of key-value pairs.

Example:

{"quantity": 10}

Key Value

Optional

Example Request

[
    {
        "impact": "3",
        "category": "normal",
        "request_type": "normal",
        "short_description": "Sample Description for Reference",
        "configuration_item": "table"
    }
]

Action Response Parameters

Parameter

Type

Description

(app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.result.sys_id

String

System ID of the record. Example: "b0dbda5347c12200e0ef563dbb9a718f"

app_instance.result.state

Object

State details with value and display value. Example: {"value": "-5", "display_value": "New"}

app_instance.result.type

Object

Type details with value and display value. Example: {"value": "normal", "display_value": "Normal"}

app_instance.result.short_description

Object

Short description details with value and display value. Example: {"value": "Remove server", "display_value": "Remove server"}

app_instance.result.__meta

Object

Meta-information object. Example: {"ignoredFields": ["no_such_field"]}

Action: Create Incident

This action creates a new incident in the incident table.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Short Description 

Provide a short description of the incident.

Example:

Sample description for reference

Text

Required

Urgency 

Enter the urgency of the incident. Possible values are 1, 2 or 3.

Example:

3

Text

Required

Allowed values:

  • 1

  • 2

  • 3

Impact 

Enter the impact of the incident. Possible values are 1, 2, or 3.

Example:

3

Text

Required

Allowed values:

  • 1

  • 2

  • 3

Caller ID 

Enter the caller ID associated with the incident.

Example:

user

Text

Optional

Additional Data 

Enter additional data to be added while creating the incident in ServiceNow ITSM.

Key Value

Optional

Example Request

[
    {
        "impact": "3",
        "urgency": "3",
        "caller_id": "user",
        "short_description": "sample description for reference"
    }
]

Action Response Parameters

Parameter

Field Type

Description

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.result.upon_approval

String

Action to be taken upon approval. Example: "proceed"

app_instance.result.location

String

Location information. Example: ""

app_instance.result.expected_start

String

Expected start time. Example: ""

app_instance.result.reopen_count

String

Number of times the incident was reopened. Example: "0"

app_instance.result.close_notes

String

Notes added upon closing the incident. Example: ""

app_instance.result.additional_assignee_list

String

List of additional assignees. Example: ""

app_instance.result.impact

String

Impact level. Example: "2"

app_instance.result.urgency

String

Urgency level. Example: "2"

app_instance.result.correlation_id

String

Correlation ID. Example: ""

app_instance.result.sys_tags

String

System tags. Example: ""

app_instance.result.sys_domain.link

String

URL to the system domain resource. Example: "https://instance.servicenow.com/api/now/table/sys_user_group/global"

app_instance.result.sys_domain.value

String

Value of the system domain. Example: "global"

app_instance.result.description

String

Description of the incident. Example: ""

app_instance.result.group_list

String

List of groups. Example: ""

app_instance.result.priority

String

Priority level. Example: "3"

app_instance.result.delivery_plan

String

Delivery plan. Example: ""

app_instance.result.sys_mod_count

String

System modification count. Example: "0"

app_instance.result.work_notes_list

String

List of work notes. Example: ""

app_instance.result.business_service

String

Business service associated with the incident. Example: ""

app_instance.result.follow_up

String

Follow-up information. Example: ""

app_instance.result.closed_at

String

Timestamp when the incident was closed. Example: ""

app_instance.result.sla_due

String

SLA due date. Example: ""

app_instance.result.delivery_task

String

Delivery task. Example: ""

app_instance.result.sys_updated_on

String

Timestamp when the incident was last updated. Example: "2016-01-22 14:28:24"

app_instance.result.parent

String

Parent incident ID. Example: ""

app_instance.result.work_end

String

Work end time. Example: ""

app_instance.result.number

String

Incident number. Example: "INC0010002"

app_instance.result.closed_by

String

User who closed the incident. Example: ""

app_instance.result.work_start

String

Work start time. Example: ""

app_instance.result.calendar_stc

String

Calendar static time. Example: ""

app_instance.result.category

String

Incident category. Example: "inquiry"

app_instance.result.business_duration

String

Business duration. Example: ""

app_instance.result.incident_state

String

State of the incident. Example: "1"

app_instance.result.activity_due

String

Activity due date. Example: ""

app_instance.result.correlation_display

String

Correlation display. Example: ""

app_instance.result.company

String

Company associated with the incident. Example: ""

app_instance.result.active

String

Indicates if the incident is active. Example: "true"

app_instance.result.due_date

String

Due date of the incident. Example: ""

app_instance.result.assignment_group.link

String

URL to the assignment group resource. Example: "https://instance.servicenow.com/api/now/table/sys_user_group/287ebd7da9fe198100f92cc8d1d2154e"

app_instance.result.assignment_group.value

String

Value of the assignment group. Example: "287ebd7da9fe198100f92cc8d1d2154e"

app_instance.result.caller_id

String

Caller ID. Example: ""

app_instance.result.knowledge

String

Indicates if the incident is a knowledge article. Example: "false"

app_instance.result.made_sla

String

Indicates if the SLA was met. Example: "true"

app_instance.result.comments_and_work_notes

String

Comments and work notes associated with the incident. Example: ""

app_instance.result.parent_incident

String

Parent incident ID. Example: ""

app_instance.result.state

String

State of the incident. Example: "1"

app_instance.result.user_input

String

User input related to the incident. Example: ""

app_instance.result.sys_created_on

String

Timestamp when the incident was created. Example: "2016-01-22 14:28:24"

app_instance.result.approval_set

String

Approval set information. Example: ""

app_instance.result.reassignment_count

String

Number of times the incident was reassigned. Example: "0"

app_instance.result.rfc

String

RFC (Request for Change) ID. Example: ""

app_instance.result.child_incidents

String

Number of child incidents. Example: "0"

app_instance.result.opened_at

String

Timestamp when the incident was opened. Example: "2016-01-22 14:28:24"

app_instance.result.short_description

String

Short description of the incident. Example: "Unable to connect to office wifi"

app_instance.result.order

String

Order information. Example: ""

app_instance.result.sys_updated_by

String

User who last updated the incident. Example: "admin"

app_instance.result.resolved_by

String

User who resolved the incident. Example: ""

app_instance.result.notify

String

Notification type. Example: "1"

app_instance.result.upon_reject

String

Action to be taken upon rejection. Example: "cancel"

app_instance.result.approval_history

String

Approval history. Example: ""

app_instance.result.problem_id

String

Problem ID associated with the incident. Example: ""

app_instance.result.work_notes

String

Work notes associated with the incident. Example: ""

app_instance.result.calendar_duration

String

Calendar duration. Example: ""

app_instance.result.close_code

String

Close code. Example: ""

app_instance.result.sys_id

String

System ID of the incident. Example: "c537bae64f411200adf9f8e18110c76e"

app_instance.result.approval

String

Approval status. Example: "not requested"

app_instance.result.caused_by

String

Cause of the incident. Example: ""

app_instance.result.severity

String

Severity level. Example: "3"

app_instance.result.sys_created_by

String

User who created the incident. Example: "admin"

app_instance.result.resolved_at

String

Timestamp when the incident was resolved. Example: ""

app_instance.result.assigned_to

String

User assigned to the incident. Example: ""

app_instance.result.business_stc

String

Business static time. Example: ""

app_instance.result.wf_activity

String

Workflow activity. Example: ""

app_instance.result.sys_domain_path

String

Path of the system domain. Example: "/"

app_instance.result.cmdb_ci

String

Configuration item. Example: ""

app_instance.result.opened_by.link

String

URL to the user who opened the incident. Example: "https://instance.servicenow.com/api/now/table/sys_user/6816f79cc0a8016401c5a33be04be441"

app_instance.result.opened_by.value

String

Value of the user who opened the incident. Example: "6816f79cc0a8016401c5a33be04be441"

app_instance.result.subcategory

String

Subcategory of the incident. Example: ""

app_instance.result.rejection_goto

String

Rejection goto information. Example: ""

app_instance.result.sys_class_name

String

Class name of the incident. Example: "incident"

app_instance.result.watch_list

String

List of watchers. Example: ""

app_instance.result.time_worked

String

Time worked on the incident. Example: ""

app_instance.result.contact_type

String

Type of contact. Example: "phone"

app_instance.result.escalation

String

Escalation level. Example: "0"

app_instance.result.comments

String

Comments on the incident. Example: ""

Action: Create Item Order Request

This action creates a catalog item order request based on the specified parameters.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

System ID

Enter the system ID of the attachment.

Example:

1f27d9a5db131010a3c28a18489619b6

Text

Required

Quantity

Enter the quantity of the item. This cannot be a negative number.

Text

Required

Extra params

Enter additional parameters as key-value pairs.

Key Value

Optional

Example Request

[
    {
        "sys_id": "cd4459a497503110b963bf1e6253af22",
        "post_params": {
            "Column_name": "Sample column"
        },
        "sysparm_quantity": "1"
    }
]

Action Response Parameters

Parameter

Type

Description

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.result.sys_id

String

System ID of the record. Example: "cf56a3fcdb3a2300e890f71fbf9619ac"

app_instance.result.number

String

Request number. Example: "REQ0010012"

app_instance.result.request_number

String

Request number. Example: "REQ0010012"

app_instance.result.request_id

String

Request ID. Example: "cf56a3fcdb3a2300e890f71fbf9619ac"

app_instance.result.table

String

Name of the table. Example: "sc_request"

Action: Create New Record in a Table

This action creates a record in the table in ServiceNow ITSM.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table name 

Specify the table name.

Example:

u_co_test

Text

Required

Post params 

Enter parameters to be filled while creating the record in the form of key-value pairs.

Key Value

Required

Example Request

[
    {
        "table_name": "u_co_test_table",
        "post_params": {
            "Column_name": "Test Column"
        }
    }
]

Action Response Parameters

Parameter

Type

Description

upon_approval

String

Action to be taken upon approval. Example: "proceed"

location

String

Location information.

expected_start

String

Expected start time. 

reopen_count

String

Number of times the incident was reopened. Example: "0"

close_notes

String

Notes added upon closing the incident. 

additional_assignee_list

String

List of additional assignees. 

impact

String

Impact level. Example: "2"

urgency

String

Urgency level. Example: "2"

correlation_id

String

Correlation ID. 

sys_tags

String

System tags.

sys_domain.link

String

URL to the system domain resource. Example: "https://instance.servicenow.com/api/now/table/sys_user_group/global"

sys_domain.value

String

Value of the system domain. Example: "global"

description

String

Description of the incident. 

group_list

String

List of groups. 

priority

String

Priority level. Example: "3"

delivery_plan

String

Delivery plan. 

sys_mod_count

String

System modification count. Example: "0"

work_notes_list

String

List of work notes.

business_service

String

Business service associated with the incident.

follow_up

String

Follow-up information. 

closed_at

String

Timestamp when the incident was closed. 

sla_due

String

SLA due date. 

delivery_task

String

Delivery task. 

sys_updated_on

String

Timestamp when the incident was last updated. Example: "2016-01-22 14:28:24"

parent

String

Parent incident ID.

work_end

String

Work end time.

number

String

Incident number. Example: "INC0010002"

closed_by

String

User who closed the incident. 

work_start

String

Work start time. 

calendar_stc

String

Calendar static time.

category

String

Incident category. Example: "inquiry"

business_duration

String

Business duration. 

incident_state

String

State of the incident. Example: "1"

activity_due

String

Activity due date.

correlation_display

String

Correlation display.

company

String

Company associated with the incident.

active

String

Indicates if the incident is active. Example: "true"

due_date

String

Due date of the incident. Example: ""

assignment_group.link

String

URL to the assignment group resource. Example: "https://instance.servicenow.com/api/now/table/sys_user_group/287ebd7da9fe198100f92cc8d1d2154e"

assignment_group.value

String

Value of the assignment group. Example: "287ebd7da9fe198100f92cc8d1d2154e"

caller_id

String

Caller ID. 

knowledge

String

Indicates if the incident is a knowledge article. Example: "false"

made_sla

String

Indicates if the SLA was met. Example: "true"

comments_and_work_notes

String

Comments and work notes associated with the incident. Example: ""

parent_incident

String

Parent incident ID. 

state

String

State of the incident. Example: "1"

user_input

String

User input related to the incident.

sys_created_on

String

Timestamp when the incident was created. Example: "2016-01-22 14:28:24"

approval_set

String

Approval set information.

reassignment_count

String

Number of times the incident was reassigned. Example: "0"

rfc

String

RFC (Request for Change) ID.

child_incidents

String

Number of child incidents. Example: "0"

opened_at

String

Timestamp when the incident was opened. Example: "2016-01-22 14:28:24"

short_description

String

Short description of the incident. Example: "Unable to connect to office wifi"

order

String

Order information. 

sys_updated_by

String

User who last updated the incident. Example: "admin"

resolved_by

String

User who resolved the incident.

notify

String

Notification type. Example: "1"

upon_reject

String

Action to be taken upon rejection. Example: "cancel"

approval_history

String

Approval history. 

problem_id

String

Problem ID associated with the incident.

work_notes

String

Work notes associated with the incident.

calendar_duration

String

Calendar duration. 

close_code

String

Close code. 

sys_id

String

System ID of the incident. Example: "c537bae64f411200adf9f8e18110c76e"

approval

String

Approval status. Example: "not requested"

caused_by

String

Cause of the incident. 

severity

String

Severity level. Example: "3"

sys_created_by

String

User who created the incident. Example: "admin"

resolved_at

String

Timestamp when the incident was resolved.

assigned_to

String

User assigned to the incident. 

business_stc

String

Business static time. 

wf_activity

String

Workflow activity.

sys_domain_path

String

Path of the system domain. Example: "/"

cmdb_ci

String

Configuration item.

opened_by.link

String

URL to the user who opened the incident. Example: "https://instance.servicenow.com/api/now/table/sys_user/6816f79cc0a8016401c5a33be04be441"

opened_by.value

String

Value of the user who opened the incident. Example: "6816f79cc0a8016401c5a33be04be441"

subcategory

String

Subcategory of the incident. 

rejection_goto

String

Rejection goto information. 

sys_class_name

String

Class name of the incident. Example: "incident"

watch_list

String

List of watchers.

time_worked

String

Time worked on the incident.

contact_type

String

Type of contact. Example: "phone"

escalation

String

Escalation level. Example: "0"

comments

String

Comments on the incident.

Action: Create Request Item

This action adds an item request in sc_req_item table in ServiceNow ITSM.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table name 

Enter the table name. 

Example: 

incident

Text

Required

Request item information 

Enter information to add to the request item in the form of key-value pairs. 

Example:

{"quantity": 10}

Key Value

Optional

Example Request

[
    {
        "table_name": "u_co_test_table",
        "action_payload": {
            "Column_Name": "Incident"
        }
    }
]

Action Response Parameters

Parameter

Type

Description

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.result.upon_approval

String

Action to take upon approval. Example: "proceed"

app_instance.result.location

Object

Location details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f", "value": "108752c8c611227501d4ab0e392ba97f"}

app_instance.result.expected_start

String

Expected start time. 

app_instance.result.reopen_count

String

Reopen count. 

app_instance.result.close_notes

String

Notes on closure.

app_instance.result.additional_assignee_list

String

Additional assignee list. 

app_instance.result.impact

String

Impact level. Example: "1"

app_instance.result.urgency

String

Urgency level. Example: "1"

app_instance.result.correlation_id

String

Correlation ID. 

app_instance.result.sys_tags

String

System tags.

app_instance.result.sys_domain

Object

System domain details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global"}

app_instance.result.description

String

Description of the incident. 

app_instance.result.group_list

String

List of groups.

app_instance.result.priority

String

Priority level. Example: "1"

app_instance.result.delivery_plan

String

Delivery plan. 

app_instance.result.sys_mod_count

String

System modification count. Example: "7"

app_instance.result.work_notes_list

String

List of work notes. 

app_instance.result.business_service

String

Business service.

app_instance.result.follow_up

String

Follow-up information. 

app_instance.result.closed_at

String

Closure timestamp.

app_instance.result.sla_due

String

SLA due date. Example: "2017-07-05 05:58:24"

app_instance.result.delivery_task

String

Delivery task. 

app_instance.result.sys_updated_on

String

Timestamp of last update. Example: "2016-01-22 14:12:37"

app_instance.result.parent

String

Parent incident.

app_instance.result.work_end

String

Work end time. 

app_instance.result.number

String

Incident number. Example: "INC0000050"

app_instance.result.closed_by

String

User who closed the incident.

app_instance.result.work_start

String

Work start time. 

app_instance.result.calendar_stc

String

Calendar short time code. 

app_instance.result.category

String

Category of the incident. Example: "hardware"

app_instance.result.business_duration

String

Business duration. 

app_instance.result.incident_state

String

State of the incident. Example: "2"

app_instance.result.activity_due

String

Activity due date. Example: "2016-01-22 16:12:37"

app_instance.result.correlation_display

String

Correlation display. 

app_instance.result.company

Object

Company details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec", "value": "31bea3d53790200044e0bfc8bcbe5dec"}

app_instance.result.active

String

Active status. Example: "true"

app_instance.result.due_date

String

Due date. 

app_instance.result.assignment_group

Object

Assignment group details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3", "value": "8a5055c9c61122780043563ef53438e3"}

app_instance.result.caller_id

Object

Caller ID details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c", "value": "5b7c200d0a640069006b3845b5d0fa7c"}

app_instance.result.knowledge

String

Knowledge article. Example: "false"

app_instance.result.made_sla

String

SLA met status. Example: "true"

app_instance.result.comments_and_work_notes

String

Comments and work notes. 

app_instance.result.parent_incident

String

Parent incident.

app_instance.result.state

String

State of the incident. Example: "2"

app_instance.result.user_input

String

User input. 

app_instance.result.sys_created_on

String

Timestamp of creation. Example: "2015-11-02 18:05:40"

app_instance.result.approval_set

String

Approval set. 

app_instance.result.reassignment_count

String

Reassignment count. Example: "0"

app_instance.result.rfc

String

RFC number. 

app_instance.result.child_incidents

String

Child incidents.

app_instance.result.opened_at

String

Timestamp when the incident was opened. Example: "2015-11-02 21:58:24"

app_instance.result.short_description

String

Short description of the incident. Example: "Can't access Exchange server - is it down?"

app_instance.result.order

String

Order number.

app_instance.result.sys_updated_by

String

User who last updated the incident. Example: "admin"

app_instance.result.resolved_by

String

User who resolved the incident. Example: "admin"

app_instance.result.notify

String

Notification preference. Example: "1"

app_instance.result.upon_reject

String

Action to take upon rejection. Example: "cancel"

app_instance.result.approval_history

String

Approval history.

app_instance.result.problem_id

String

Problem ID.

app_instance.result.work_notes

String

Work notes.

app_instance.result.calendar_duration

String

Calendar duration.

app_instance.result.close_code

String

Close code.

app_instance.result.sys_id

String

System ID. Example: "ef43c6d40a0a0b5700c77f9bf387afe3"

app_instance.result.approval

String

Approval status. Example: "not requested"

app_instance.result.caused_by

String

Causing factor.

app_instance.result.severity

String

Severity level. Example: "3"

app_instance.result.sys_created_by

String

User who created the incident. Example: "glide.maint"

app_instance.result.resolved_at

String

Timestamp when the incident was resolved. Example: "2015-11-09 22:59:24"

app_instance.result.assigned_to

Object

Assigned user details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd", "value": "681b365ec0a80164000fb0b05854a0cd"}

app_instance.result.business_stc

String

Business short time code.

app_instance.result.wf_activity

String

Workflow activity.

app_instance.result.sys_domain_path

String

System domain path. Example: "/"

app_instance.result.cmdb_ci

Object

CMDB CI details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6", "value": "281190e3c0a8000b003f593aa3f20ca6"}

app_instance.result.opened_by

Object

Opened by user details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint", "value": "glide.maint"}

app_instance.result.subcategory

String

Subcategory of the incident. Example: ""

app_instance.result.rejection_goto

String

Rejection redirection.

app_instance.result.sys_class_name

String

Class name of the incident. Example: "incident"

app_instance.result.watch_list

String

Watch list.

app_instance.result.time_worked

String

Time worked.

app_instance.result.contact_type

String

Type of contact. Example: "phone"

app_instance.result.escalation

String

Escalation level. Example: "3"

app_instance.result.comments

String

Comments.

Action: Delete Record from Table

This action deletes a record from a table.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table name

Enter the table name from which the record must be deleted.

Example:

u_co_test

Text

Required

System ID

Enter the system ID of the record in the table that must be deleted.

Example:

0a9cdf93dbd31010a3c28a1848961994

Text

Required

Example Request

[
    {
        "sys_id": "2270d1e097503110b963bf1e6253afa3",
        "table_name": "u_co_test_table"
    }
]

Action Response Parameters

Parameter

Type

Response

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.parent

String

Parent record ID.

app_instance.made_sla

String

Indicates if the SLA was met. Example: "true"

app_instance.watch_list

String

List of watchers.

app_instance.upon_reject

String

Action to be taken upon rejection. Example: "cancel"

app_instance.sys_updated_on

String

Timestamp when the record was last updated. Example: "2016-01-19 04:52:04"

app_instance.approval_history

String

Approval history.

app_instance.number

String

Record number. Example: "PRB0000050"

app_instance.sys_updated_by

String

User who last updated the record. Example: "glide.maint"

app_instance.opened_by.link

String

URL to the user who opened the record. Example: "https://instance.servicenow.com/api/now/table/sys_user/glide.maint"

app_instance.opened_by.value

String

Value of the user who opened the record. Example: "glide.maint"

app_instance.user_input

String

User input related to the record.

app_instance.sys_created_on

String

Timestamp when the record was created. Example: "2016-01-19 04:51:19"

app_instance.sys_domain.link

String

URL to the system domain resource. Example: "https://instance.servicenow.com/api/now/table/sys_user_group/global"

app_instance.sys_domain.value

String

Value of the system domain. Example: "global"

app_instance.state

String

State of the record. Example: "4"

app_instance.sys_created_by

String

User who created the record. Example: "glide.maint"

app_instance.knowledge

String

Indicates if the record is a knowledge article. Example: "false"

app_instance.order

String

Order information.

app_instance.closed_at

String

Timestamp when the record was closed. Example: "2016-01-19 04:52:04"

app_instance.cmdb_ci.link

String

URL to the configuration item resource. Example: "https://instance.servicenow.com/api/now/table/cmdb_ci/55b35562c0a8010e01cff22378e0aea9"

app_instance.cmdb_ci.value

String

Value of the configuration item. Example: "55b35562c0a8010e01cff22378e0aea9"

app_instance.delivery_plan

String

Delivery plan.

app_instance.impact

String

Impact level. Example: "3"

app_instance.active

String

Indicates if the record is active. Example: "false"

app_instance.work_notes_list

String

List of work notes.

app_instance.business_service

String

Business service associated with the record.

app_instance.priority

String

Priority level. Example: "4"

app_instance.sys_domain_path

String

Path of the system domain. Example: "/"

app_instance.time_worked

String

Time worked on the record.

app_instance.expected_start

String

Expected start time.

app_instance.rejection_goto

String

Rejection goto information.

app_instance.opened_at

String

Timestamp when the record was opened. Example: "2016-01-19 04:49:47"

app_instance.business_duration

String

Business duration. Example: "1970-01-01 00:00:00"

app_instance.group_list

String

List of groups.

app_instance.work_end

String

Work end time.

app_instance.approval_set

String

Approval set information.

app_instance.wf_activity

String

Workflow activity.

app_instance.work_notes

String

Work notes associated with the record.

app_instance.short_description

String

Short description of the record. Example: "Switch occasionally drops connections"

app_instance.correlation_display

String

Correlation display.

app_instance.delivery_task

String

Delivery task.

app_instance.work_start

String

Work start time.

app_instance.assignment_group

String

Assignment group.

app_instance.additional_assignee_list

String

List of additional assignees.

app_instance.description

String

Description of the record. Example: "Switch occasionally drops connections"

app_instance.calendar_duration

String

Calendar duration. Example: "1970-01-01 00:02:17"

app_instance.close_notes

String

Close notes. Example: "updated firmware"

app_instance.sys_class_name

String

Class name of the record. Example: "problem"

app_instance.closed_by

String

User who closed the record.

app_instance.follow_up

String

Follow-up information.

app_instance.sys_id

String

System ID of the record. Example: "04ce72c9c0a8016600b5b7f75ac67b5b"

app_instance.contact_type

String

Type of contact. Example: "phone"

app_instance.urgency

String

Urgency level. Example: "3"

app_instance.company

String

Company associated with the record.

app_instance.reassignment_count

String

Number of times the record was reassigned.

app_instance.activity_due

String

Activity due date.

app_instance.assigned_to

String

User assigned to the record.

app_instance.comments

String

Comments on the record.

app_instance.approval

String

Approval status. Example: "not requested"

app_instance.sla_due

String

SLA due date.

app_instance.comments_and_work_notes

String

Comments and work notes.

app_instance.due_date

String

Due date.

app_instance.sys_mod_count

String

Modification count. Example: "1"

app_instance.sys_tags

String

System tags.

app_instance.escalation

String

Escalation level. Example: "0"

app_instance.upon_approval

String

Action to be taken upon approval. Example: "proceed"

app_instance.correlation_id

String

Correlation ID.

app_instance.location

String

Location information.

Action: Download Attachment

This action gets the file attachment with a specific sys_id value. Note: It will show both the content and file path where the file is stored.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

System ID 

Enter the system ID of the attachment.

Example:

1f27d9a5db131010a3c28a18489619b6

Text

Required

File name 

Enter the file name from which you want to download the file. 

Text

Optional

Default: 

{sys_id}_attachment

Example Request

[
    {
        "sys_id": "c219e1ae97003110b963bf1e6253af32"
    }
]

Action Response Parameters

Parameter

Type

Description

Binary file attachment

Unknown

Binary response not shown.

Action: Generic Action

This is a generic action to perform any additional use case that you want on ServiceNow ITSM.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Method 

Enter the HTTP method to be used.

Text

Required

Allowed values:

  • GET

  • PUT

  • DELETE

  • POST

Endpoint 

Enter the endpoint.

Example:

cyl/cyware/incident

Text

Required

Query parameters 

Enter the query parameters for the API request as key-value pairs.

Key Value

Optional

Payload 

Enter the body of the API request as key-value pairs.

Key Value

Optional

Example Request

[
    {
        "http_method": "GET",
        "resource_path": "sn_sc/servicecatalog/items"
    }
]
Action: Get Attachment Metadata

The action retrieves the metadata for multiple attachments using the system ID.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table system ID 

Enter the system ID of the record on the specified table to which you want to attach the file.

Example: 

a83820b58f723300e7e16c7827bdeed2

Text

Optional

Extra parameters 

Enter the query parameters for the API request as key-value pairs.

Key Value

Optional

Example Request

[
    {
        "table_sys_id": "70d7ad0597c43110b963bf1e6253af52"
    }
]

Action Response Parameters

Parameter

Type

Description

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.table_sys_id

String

System ID of the table. Example: "5054b6f8c0a800060056addcf551ecf8"

app_instance.size_bytes

String

Size in bytes. Example: "462"

app_instance.download_link

String

Download link. Example: "https://instance.service-now.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file"

app_instance.sys_updated_on

String

Timestamp when the record was last updated. Example: "2009-05-21 04:12:21"

app_instance.sys_id

String

System ID of the record. Example: "615ea769c0a80166001cf5f2367302f5"

app_instance.sys_created_on

String

Timestamp when the record was created. Example: "2009-05-21 04:12:21"

app_instance.file_name

String

File name. Example: "blocks.swf"

app_instance.sys_created_by

String

User who created the record. Example: "glide.maint"

app_instance.compressed

String

Indicates if the file is compressed. Example: "true"

app_instance.sys_updated_by

String

User who last updated the record. Example: "glide.maint"

app_instance.table_name

String

Table name. Example: "content_block_programmatic"

app_instance.sys_mod_count

String

Modification count. Example: "0"

app_instance.content_type

String

Content type. Example: "application/x-shockwave-flash"

app_instance.size_compressed

String

Size when compressed. Example: "485"

Action: Get Change Request Record

This action retrieves the details of the change request records.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Request type 

Enter the request type of a record.

Example:

normal

Text

Required

Allowed values:

  • "normal"

  • "standard"

  • "emergency"

Change request system ID 

Enter the system ID of the change request.

Example:

0a9cdf93dbd31010a3c28a1848961994

Text

Required

Example Request

[
    {
        "request_type": "normal",
        "request_sys_id": "41f1550197843110b963bf1e6253afaa"
    }
]

Action Response Parameters

Parameter

Type

Description

app_instance.action_status

Number

Current action status of the associated change request. Possible values: 1 (Blocked internally), 2 (Blocked by customer), 3 (Blocked internally and by customer), 4 (Needs attention)

app_instance.active

Boolean

Flag indicating whether the change request is active. Possible values: true (Active), false (Not active). Default: true

app_instance.activity_due

String

Date and time for which the associated case is expected to be completed.

app_instance.additional_assignee_list

Array

List of sys_ids of additional persons assigned to work on the change request.

app_instance.approval

String

Type of approval process required. Default: not requested

app_instance.approval_history

String

Most recent approval history journal entry.

app_instance.approval_set

String

Date and time that the associated action was approved.

app_instance.assigned_to

String

Sys_id of the user assigned to the change request.

app_instance.assignment_group

String

Sys_id of the group assigned to the change request.

app_instance.backout_plan

String

Description of the plan to execute if the change must be reversed.

app_instance.business_duration

String

Length in scheduled work hours, work days, and work weeks that it took to complete the change.

app_instance.business_service

String

Sys_id of the business service associated with the change request. Located in the Service [cmdb_ci_service] table.

app_instance.cab_date

String

Date on which the Change Advisory Board (CAB) meets.

app_instance.cab_delegate

String

Sys_id of the user that can substitute for the CAB manager during a CAB meeting. Located in the User [sys_user] table

app_instance.cab_recommendation

String

Description of the CAB recommendations for the change request. Maximum length: 4,000

app_instance.cab_required

Boolean

Flag indicating whether the CAB is required. Possible values: true (Required), false (Not required). Default: false

app_instance.calendar_duration

String

Not currently used by Change Management.

app_instance.category

String

Category of the change, for example hardware, network, or software. Default: Other

app_instance.change_plan

String

Activities and roles for managing and controlling the change request.

app_instance.chg_model

String

Sys_id of the change model that the associated change request was based on. Located in the Change Model [chg_model] table.

app_instance.close_code

String

Code assigned to the change request when it was closed. For example, Successful, Successful with issues, and Unsuccessful.

app_instance.close_notes

String

Notes that the person entered when closing the change request.

app_instance.closed_at

String

Date and time that the associated change request was closed.

app_instance.closed_by

String

Sys_id of the person that closed the change request. Located in the User [sys_user] table.

app_instance.cmdb_ci

String

Sys_id of the configuration item associated with the change request. Located in the Configuration Item [cmdb_ci] table.

app_instance.comments

Array

List of customer-facing work notes entered in the associated change request.

app_instance.comments_and_work_notes

Array

List of both internal and customer-facing work notes entered for the associated change request. Maximum length: 4,000

app_instance.company

String

Sys_id of the company associated with the change request. Located in the Company [core_company] table.

app_instance.conflict_last_run

String

Date and time that the conflict detection script was last run on the change request.

app_instance.conflict_status

String

Current conflict status as detected by the conflict detection script, such as Conflict and Not Run. Maximum length: 40. Default: Not Run

app_instance.contact_type

String

Method in which the change request was initially requested. Possible values: chat, email, phone, social, web

app_instance.contract

String

Sys_id of the contract associated with the change request. Located in the Contract [ast_contract] table.

app_instance.correlation_display

String

User-friendly name for the correlation_id. Maximum length: 100

app_instance.correlation_id

String

Globally unique ID (GUID) of a matching change request record in a third-party system. Maximum length: 100

app_instance.delivery_plan

String

No longer in use. Sys_id of the delivery plan associated with the change request. Located in the Execution Plan [sc_cat_item_delivery_plan] table.

app_instance.delivery_task

String

No longer in use. Sys_id of the delivery task associated with the change request. Located in the Execution Plan Task [sc_cat_item_delivery_task] table.

app_instance.description

String

Detailed description of the change request. Maximum length: 4,000

app_instance.due_date

String

Task due date. Not used by change request process.

app_instance.due_date

String

Task due date. Not used by change request process.

app_instance.end_date

String

Date and time when the change request is to be completed.

app_instance.escalation

Number (Integer)

Current escalation level. Possible values: 0 (Normal), 1 (Moderate), 2 (High), 3 (Overdue). Default: 0

app_instance.expected_start

String

Date and time when the task is to start. Not used by the change request process.

app_instance.follow_up

String

Date and time when a user followed-up with the person requesting the change request.

app_instance.group_list

Array

List of sys_ids and names of the groups associated with the change request. Maximum length: 4,000

app_instance.impact

Number (Integer)

Impact the change request will have on the customer. Possible values: 1 (High), 2 (Medium), 3 (Low). Default: 3

app_instance.implementation_plan

String

Sequential steps to execute to implement this change. Maximum length: 4,000

app_instance.justification

String

Benefits of implementing this change and the impact if this change is not implemented. Maximum length: 4,000

app_instance.knowledge

Boolean

Flag indicating whether there are any knowledge base (KB) articles associated with the change request. Possible values: true (Associated KB articles), false (No associated KB articles)

app_instance.location

String

Sys_id and name of the location of the equipment referenced in the change request. Located in the Location [cmn_location] table.

app_instance.made_sla

Boolean

No longer used. Flag indicating whether the change request was implemented in alignment with the associated service level agreement.

app_instance.needs_attention

Boolean

Flag indicating whether the change request needs attention. Possible values: true (Needs attention), false (Does not need attention). Default: false

app_instance.number

String

Change number assigned to the change request by the system, such as CHG0040007.

app_instance.on_hold

Boolean

Flag indicating whether the change request is currently on hold. Possible values: true (On hold), false (Not on hold). Default: false

app_instance.on_hold_reason

String

If the on_hold parameter is "true", description of the reason why the change request is being held up. Maximum length: 4,000

app_instance.on_hold_task

String

If the on_hold parameter is "true", list of the sys_ids of the tasks that must be completed before the hold is released. Maximum length: 4,000

app_instance.opened_at

String

Date and time that the change release was created.

app_instance.opened_by

String

Sys_id and name of the user that created the change release. Located in the User [sys_user] table.

app_instance.order

Number (Integer)

Not used by Change Management. Optional numeric field by which to order records, such as when retrieving them from a database.

app_instance.outside_maintenance_schedule

Boolean

Flag indicating whether maintenance by an outside company has been scheduled for the change request. Possible values: true (Outside maintenance scheduled), false (No outside maintenance scheduled). Default: false

app_instance.parent

String

Sys_id and name of the parent task to this change request, if any. Located in the Task [task] table.

app_instance.phase

String

Current phase of the change request. Possible values: accept, build, plan, requested.

app_instance.phase_state

String

Change_phase records that should be created for a change. Possible values: complete, on hold, open, rejected, requested, work in progress.

app_instance.priority

Number (Integer)

Priority of the change request. Possible values: 1 (Critical), 2 (High), 3 (Moderate), 4 (Low). Default: 4

app_instance.production_system

Boolean

Flag indicating whether the change request is for a ServiceNow instance that is in a production environment. Possible values: true (Production environment), false (Non-production environment).

app_instance.reason

String

Description of why the change request was initiated.

app_instance.reassignment_count

Number (Integer)

Number of times that the change request has been reassigned to a new owner. Default: 0

app_instance.rejection_goto

String

Sys_id of the task to perform if the change request is rejected. Located in the Task [table].

app_instance.requested_by

String

Sys_id of the user that requested the change. Located in the User [sys_user] table.

app_instance.requested_by_date

String

Date and time when the change is requested to be implemented by.

app_instance.result

Array

List containing one or more change request record objects. Each object describes a change request. Each element in the change request object corresponds to a field in its associated record in the Change Request [change_request] table. All elements contain value and display_value name-value pairs. Date fields also contain display_value_internal name-value pairs.

app_instance.review_comments

String

Comments entered when the change request was reviewed. Maximum length: 4,000

app_instance.review_date

String

Date that the change request was reviewed.

app_instance.review_status

String

Current status of the requested change request review.

app_instance.risk_impact_analysis

String

Description of the risk and analysis of implementing the change request. Maximum length: 4,000

app_instance.route_reason

Number (Integer)

Not currently used by Change Management. Reason that the change request was transferred. Possible values: 1 (Transfer with Resolution), 9 (Transfer without Resolutions)

app_instance.scope

Number (Integer)

Size of the change request. Possible values: 1 (Massive), 2 (Large), 3 (Medium), 4 (Small), 5 (Tiny). Default: 3

app_instance.service_offering

String

Sys_id of the service offering associated with the change request. Located in the Offering [service_offering] table.

app_instance.short_description

String

Description of the change request. Maximum length: 40

app_instance.skills

Array

List of the sys_ids of all of the skills required to implement the change request. Located in the Skill [cmn_skill] table.

app_instance.sla_due

String

No longer in use. Date and time that the change request must be completed based on the associated service level agreement.

app_instance.sn_esign_document

String

Sys_id of any E-signed document attached to the change request. Located in the Attachment [sys_attachment] table.

app_instance.sn_esign_esignature_configuration

String

Sys_id of the E-signed signature template used for the associated document. Located in the E-signature Template [sn_esign_configuration] table.

app_instance.start_date

String

Date and time that the change request is planned to start implementation.

app_instance.state

Number (Integer)

Current state of the change request. Possible values are defined in the change model.

app_instance.std_change_producer_version

String

Sys_id of the record producer and change proposal associated with the change request. Located in the Standard Change Template Version [std_change_producer_version] table.

app_instance.sys_class_name

String

Name of the table in which the change request is located.

app_instance.sys_created_by

String

Name of the user that initially created the change request. Maximum length: 40

app_instance.sys_created_on

String

Date and time that the associated change request record was originally created.

app_instance.sys_domain

String

If using domains in the instance, the name of the domain to which the change module record is associated.

app_instance.sys_domain_path

String

If using domains in the instance, the domain path in which the associated change module record resides.

app_instance.sys_id

String

Unique identifier of the associated change request record.

app_instance.sys_mod_count

Number (Integer)

Number of updates to the case since it was initially created.

app_instance.sys_updated_by

String

Person that last updated the case. Maximum length: 40

app_instance.sys_updated_on

String

Date and time when the case was last updated.

app_instance.task_effective_number

String

Universal request number. Maximum length: 40

app_instance.task_for

String

Not used by Change Management. Sys_id of the user that the task was created for. Located in the User [sys_user] table.

app_instance.test_plan

String

Description of the associated test plan for the change. Maximum length: 4,000

app_instance.time_worked

String

Total amount of time worked on the change request.

app_instance.type

String

Change request type. Possible values: emergency, normal, standard. Maximum length: 40

app_instance.unauthorized

Boolean

Flag indicating whether the change request is unauthorized. Possible values: true (Unauthorized), false (Authorized)

app_instance.universal_request

String

Sys_id of the Parent Universal request to which this change request is a part of. Located in the Task [task] table.

app_instance.upon_approval

String

Action to take if the change request is approved. Possible values: do_nothing, proceed. Maximum length: 40

app_instance.upon_reject

String

Action to take if the change request is rejected. Possible values: cancel, goto. Maximum length: 40

app_instance.urgency

Number (Integer)

Urgency of the change request. Possible values: 1 (High), 2 (Medium), 3 (Low). Default: 3

app_instance.user_input

String

Additional user input. Maximum length: 4,000

app_instance.variables

String

Name-value pairs of variables associated with the change request. Maximum length: 40

app_instance.watch_list

Array

List of sys_ids of the users who receive notifications about this change request when additional comments are added or if the state of a change request is changed to Resolved or Closed. Located in the User [sys_user] table.

app_instance.wf_activity

String

Sys_id of the workflow activity record associated with the change request. Located in the Workflow Activity [wf_activity] table.

app_instance.work_end

String

Date and time work ended on the change request.

app_instance.work_notes

String

Information about how to resolve the change request, or steps taken to resolve it. Maximum length: 4,000

Action: Get Details of a Record

This action gets more details about a record from the table.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table name

Enter the table name.

Example:

u_co_test

Text

Required

System ID

Enter the system ID of the record that needs to be fetched.

Example:

0a9cdf93dbd31010a3c28a1848961994

Text

Required

Query params

Enter query parameters as key-value pairs to filter the results.

Key Value

Optional

Allowed keys:

  • sysparm_display_value

  • sysparm_exclude_reference_link

  • sysparm_fields

  • sysparm_query_no_domain

  • sysparm_view

Example Request

[
   {
        "table_name": "u_co_test_table",
        "sys_id": "0a9cdf93dbd31010a3c28a1848961994"
    }
]

Action Response Parameters

Parameter

Type

Description

upon_approval

String

Action to be taken upon approval. Example: "proceed"

location

String

Location information. Example: ""

expected_start

String

Expected start time. Example: ""

reopen_count

String

Number of times the incident was reopened. Example: "0"

close_notes

String

Notes added upon closing the incident. Example: ""

additional_assignee_list

String

List of additional assignees. Example: ""

impact

String

Impact level. Example: "2"

urgency

String

Urgency level. Example: "2"

correlation_id

String

Correlation ID. Example: ""

sys_tags

String

System tags. Example: ""

sys_domain.link

String

URL to the system domain resource. Example: "https://instance.servicenow.com/api/now/table/sys_user_group/global"

sys_domain.value

String

Value of the system domain. Example: "global"

description

String

Description of the incident. Example: ""

group_list

String

List of groups. Example: ""

priority

String

Priority level. Example: "3"

delivery_plan

String

Delivery plan. Example: ""

sys_mod_count

String

System modification count. Example: "0"

work_notes_list

String

List of work notes. Example: ""

business_service

String

Business service associated with the incident. Example: ""

follow_up

String

Follow-up information. Example: ""

closed_at

String

Timestamp when the incident was closed. Example: ""

sla_due

String

SLA due date. Example: ""

delivery_task

String

Delivery task. Example: ""

sys_updated_on

String

Timestamp when the incident was last updated. Example: "2016-01-22 14:28:24"

parent

String

Parent incident ID. Example: ""

work_end

String

Work end time. Example: ""

number

String

Incident number. Example: "INC0010002"

closed_by

String

User who closed the incident. Example: ""

work_start

String

Work start time. Example: ""

calendar_stc

String

Calendar static time. Example: ""

category

String

Incident category. Example: "inquiry"

business_duration

String

Business duration. Example: ""

incident_state

String

State of the incident. Example: "1"

activity_due

String

Activity due date. Example: ""

correlation_display

String

Correlation display. Example: ""

company

String

Company associated with the incident. Example: ""

active

String

Indicates if the incident is active. Example: "true"

due_date

String

Due date of the incident. Example: ""

assignment_group.link

String

URL to the assignment group resource. Example: "https://instance.servicenow.com/api/now/table/sys_user_group/287ebd7da9fe198100f92cc8d1d2154e"

assignment_group.value

String

Value of the assignment group. Example: "287ebd7da9fe198100f92cc8d1d2154e"

caller_id

String

Caller ID. Example: ""

knowledge

String

Indicates if the incident is a knowledge article. Example: "false"

made_sla

String

Indicates if the SLA was met. Example: "true"

comments_and_work_notes

String

Comments and work notes associated with the incident. Example: ""

parent_incident

String

Parent incident ID. Example: ""

state

String

State of the incident. Example: "1"

user_input

String

User input related to the incident. Example: ""

sys_created_on

String

Timestamp when the incident was created. Example: "2016-01-22 14:28:24"

approval_set

String

Approval set information. Example: ""

reassignment_count

String

Number of times the incident was reassigned. Example: "0"

rfc

String

RFC (Request for Change) ID. Example: ""

child_incidents

String

Number of child incidents. Example: "0"

opened_at

String

Timestamp when the incident was opened. Example: "2016-01-22 14:28:24"

short_description

String

Short description of the incident. Example: "Unable to connect to office wifi"

order

String

Order information. Example: ""

sys_updated_by

String

User who last updated the incident. Example: "admin"

resolved_by

String

User who resolved the incident. Example: ""

notify

String

Notification type. Example: "1"

upon_reject

String

Action to be taken upon rejection. Example: "cancel"

approval_history

String

Approval history. Example: ""

problem_id

String

Problem ID associated with the incident. Example: ""

work_notes

String

Work notes associated with the incident. Example: ""

calendar_duration

String

Calendar duration. Example: ""

close_code

String

Close code. Example: ""

sys_id

String

System ID of the incident. Example: "c537bae64f411200adf9f8e18110c76e"

approval

String

Approval status. Example: "not requested"

caused_by

String

Cause of the incident. Example: ""

severity

String

Severity level. Example: "3"

sys_created_by

String

User who created the incident. Example: "admin"

resolved_at

String

Timestamp when the incident was resolved. Example: ""

assigned_to

String

User assigned to the incident. Example: ""

business_stc

String

Business static time. Example: ""

wf_activity

String

Workflow activity. Example: ""

sys_domain_path

String

Path of the system domain. Example: "/"

cmdb_ci

String

Configuration item. Example: ""

opened_by.link

String

URL to the user who opened the incident. Example: "https://instance.servicenow.com/api/now/table/sys_user/6816f79cc0a8016401c5a33be04be441"

opened_by.value

String

Value of the user who opened the incident. Example: "6816f79cc0a8016401c5a33be04be441"

subcategory

String

Subcategory of the incident. Example: ""

rejection_goto

String

Rejection goto information. Example: ""

sys_class_name

String

Class name of the incident. Example: "incident"

watch_list

String

List of watchers. Example: ""

time_worked

String

Time worked on the incident. Example: ""

contact_type

String

Type of contact. Example: "phone"

escalation

String

Escalation level. Example: "0"

comments

String

Comments on the incident. Example: ""

Action: Get Incident Details by Incident Number

This action gets incident details by the incident number.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Incident number 

Enter the incident number to get details.

Example:

inc04521

Text

Required

Example Request

[
    {
        "incident_number": "inc04521"
    }
]

Action Response Parameters

Parameter

Type

Description

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.upon_approval

String

Action to take upon approval. Example: "Escalate".

app_instance.location

Object

Location information with link and value.

app_instance.expected_start

String

Expected start time. Example: "2024-06-17 10:00:00".

app_instance.reopen_count

String

Number of times the incident was reopened. Example: "2".

app_instance.close_notes

String

Notes added upon closing the incident. Example: "Issue resolved".

app_instance.additional_assignee_list

String

List of additional assignees. Example: "user1, user2".

app_instance.impact

String

Impact level of the incident. Example: "1" (High).

app_instance.urgency

String

Urgency level of the incident. Example: "3" (Low).

app_instance.correlation_id

String

Correlation ID for related incidents. Example: "CORR12345".

app_instance.sys_tags

String

System tags for the incident. Example: "tag1, tag2".

app_instance.sys_domain

Object

Domain information with link and value.

app_instance.description

String

Detailed description of the incident. Example: "User cannot access software".

app_instance.group_list

String

List of groups associated with the incident. Example: "group1, group2".

app_instance.priority

String

Priority level of the incident. Example: "3" (Low).

app_instance.delivery_plan

String

Delivery plan for the incident. Example: "Plan A".

app_instance.sys_mod_count

String

Number of times the record was modified. Example: "4".

app_instance.work_notes_list

String

List of work notes for the incident. Example: "Note 1, Note 2".

app_instance.business_service

String

Business service affected by the incident. Example: "Email Service".

app_instance.follow_up

String

Follow-up actions required. Example: "Check after 24 hours".

app_instance.closed_at

String

Timestamp when the incident was closed. Example: "2024-06-18 15:30:00".

app_instance.sla_due

String

SLA due date. Example: "2015-11-11 22:04:15".

app_instance.delivery_task

String

Delivery task associated with the incident. Example: "Task 123".

app_instance.sys_updated_on

String

Timestamp when the incident was last updated. Example: "2015-11-01 22:37:27".

app_instance.parent

String

Parent incident ID. Example: "INC0000045".

app_instance.work_end

String

Timestamp when the work ended. Example: "2024-06-17 17:00:00".

app_instance.number

String

Unique number of the incident. Example: "INC0000046".

app_instance.closed_by

String

User who closed the incident. Example: "admin".

app_instance.work_start

String

Timestamp when the work started. Example: "2024-06-17 09:00:00".

app_instance.calendar_stc

String

Calendar time spent on the incident. Example: "3 hours".

app_instance.category

String

Category of the incident. Example: "software".

app_instance.business_duration

String

Business duration of the incident. Example: "2 days".

app_instance.incident_state

String

State of the incident. Example: "1" (Open).

app_instance.activity_due

String

Due date for the next activity. Example: "2024-06-18 12:00:00".

app_instance.correlation_display

String

Display value for the correlation ID. Example: "CORR12345".

app_instance.company

String

Company associated with the incident. Example: "ABC Corp".

app_instance.active

String

Active status of the incident. Example: "true".

app_instance

String

Due date of the incident. Example: "2024-06-18 17:00:00".

app_instance.assignment_group

Object

Assignment group information with link and value.

app_instance.caller_id

Object

Caller ID information with link and value.

app_instance.knowledge

String

Knowledge article status. Example: "false".

app_instance.made_sla

String

SLA met status. Example: "false".

app_instance.comments_and_work_notes

String

Comments and work notes associated with the incident. Example: "Initial analysis done".

app_instance.parent_incident

String

Parent incident ID. Example: "INC0000045".

app_instance.state

String

State of the incident. Example: "1" (Open).

app_instance.user_input

String

User input associated with the incident. Example: "User input details".

app_instance.sys_created_on

String

Timestamp when the incident was created. Example: "2015-11-01 22:05:30".

app_instance.approval_set

String

Approval set for the incident. Example: "Approval set details".

app_instance.reassignment_count

String

Number of times the incident was reassigned. Example: "1".

app_instance.rfc

String

RFC associated with the incident. Example: "RFC12345".

app_instance.child_incidents

String

Child incidents associated with this incident. Example: "INC0000047, INC0000048".

app_instance.opened_at

String

Timestamp when the incident was opened. Example: "2015-11-02 22:04:15".

app_instance.short_description

String

Short description of the incident. Example: "Can't access SFA software".

app_instance.order

String

Order associated with the incident. Example: "Order123".

app_instance.sys_updated_by

String

User who last updated the incident. Example: "glide.maint".

app_instance.resolved_by

String

User who resolved the incident. Example: "resolver1".

app_instance.notify

String

Notification status of the incident. Example: "1".

app_instance.upon_reject

String

Action to take upon rejection. Example: "Reassign".

app_instance.approval_history

String

History of approvals for the incident. Example: "Approval history details".

app_instance.problem_id

Object

Problem ID information with link and value.

app_instance.work_notes

String

Work notes associated with the incident. Example: "Work note details".

app_instance.calendar_duration

String

Calendar duration of the incident. Example: "2 hours".

app_instance.close_code

String

Code indicating the reason for closing the incident. Example: "Resolved".

app_instance.sys_id

String

System ID of the incident. Example: "a9e30c7dc61122760116894de7bcc7bd".

app_instance.approval

String

Approval status of the incident. Example: "not requested".

app_instance.caused_by

String

Cause of the incident. Example: "Network issue".

app_instance.severity

String

Severity level of the incident. Example: "3" (Low).

app_instance.sys_created_by

String

User who created the incident. Example: "admin".

app_instance.resolved_at

String

Timestamp when the incident was resolved. Example: "2024-06-18 10:30:00".

app_instance.assigned_to

String

User assigned to the incident. Example: "assignee1".

app_instance.business_stc

String

Business stc details. Example: "Business STC info".

app_instance.wf_activity

String

Workflow activity details. Example: "Workflow activity info".

app_instance.sys_domain_path

String

System domain path. Example: "/".

app_instance.cmdb_ci

Object

Configuration item information with link and value.

app_instance.opened_by

Object

User who opened the incident with link and value.

app_instance.subcategory

String

Subcategory of the incident. Example: "Software issue".

app_instance.rejection_goto

String

Action to take if rejected. Example: "Escalate".

app_instance.sys_class_name

String

Class name of the incident. Example: "incident".

app_instance.watch_list

String

List of users watching the incident. Example: "user1, user2".

app_instance.time_worked

String

Total time worked on the incident. Example: "2 hours".

app_instance.contact_type

String

Type of contact for the incident. Example: "phone".

app_instance.escalation

String

Escalation status of the incident. Example: "0" (Not escalated).

app_instance.comments

String

Comments associated with the incident. Example: "Additional comments".

Action: Get Requested Item Record (RITM)

This action retrieves details of a requested item record.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table name 

Enter the table name to get the requested item record.

Example:

incident

Text

Required

System ID of record 

Enter the system ID of the record to get details.

Example:

a83820b58f723300e7e16c7827bdeed2

Text

Required

Filters 

Specify the filters using key-value pairs to refine the data.

Example:

{'sysparm_display_value':'all'}

Key Value

Optional

Allowed keys:

  • sysparm_display_value

  • sysparm_exclude_reference_link

  • sysparm_fields

  • sysparm_query_no_domain

  • sysparm_view

Example Request

[
    {
        "table_name": "u_co_test_table",
        "record_sys_id": "82887de797c03110b963bf1e6253af0a"
    }
]

Action Response Parameters

Parameter

Type

Description

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.upon_approval

String

Action to take upon approval. Example: "Escalate".

app_instance.location

Object

Location information with link and value.

app_instance.expected_start

String

Expected start time. Example: "2024-06-17 10:00:00".

app_instance.reopen_count

String

Number of times the incident was reopened. Example: "2".

app_instance.close_notes

String

Notes added upon closing the incident. Example: "Issue resolved".

app_instance.additional_assignee_list

String

List of additional assignees. Example: "user1, user2".

app_instance.impact

String

Impact level of the incident. Example: "1" (High).

app_instance.urgency

String

Urgency level of the incident. Example: "3" (Low).

app_instance.correlation_id

String

Correlation ID for related incidents. Example: "CORR12345".

app_instance.sys_tags

String

System tags for the incident. Example: "tag1, tag2".

app_instance.sys_domain

Object

Domain information with link and value.

app_instance.description

String

Detailed description of the incident. Example: "User cannot access software".

app_instance.group_list

String

List of groups associated with the incident. Example: "group1, group2".

app_instance.priority

String

Priority level of the incident. Example: "3" (Low).

app_instance.delivery_plan

String

Delivery plan for the incident. Example: "Plan A".

app_instance.sys_mod_count

String

Number of times the record was modified. Example: "4".

app_instance.work_notes_list

String

List of work notes for the incident. Example: "Note 1, Note 2".

app_instance.business_service

String

Business service affected by the incident. Example: "Email Service".

app_instance.follow_up

String

Follow-up actions required. Example: "Check after 24 hours".

app_instance.closed_at

String

Timestamp when the incident was closed. Example: "2024-06-18 15:30:00".

app_instance.sla_due

String

SLA due date. Example: "2015-11-11 22:04:15".

app_instance.delivery_task

String

Delivery task associated with the incident. Example: "Task 123".

app_instance.sys_updated_on

String

Timestamp when the incident was last updated. Example: "2015-11-01 22:37:27".

app_instance.parent

String

Parent incident ID. Example: "INC0000045".

app_instance.work_end

String

Timestamp when the work ended. Example: "2024-06-17 17:00:00".

app_instance.number

String

Unique number of the incident. Example: "INC0000046".

app_instance.closed_by

String

User who closed the incident. Example: "admin".

app_instance.work_start

String

Timestamp when the work started. Example: "2024-06-17 09:00:00".

app_instance.calendar_stc

String

Calendar time spent on the incident. Example: "3 hours".

app_instance.category

String

Category of the incident. Example: "software".

app_instance.business_duration

String

Business duration of the incident. Example: "2 days".

app_instance.incident_state

String

State of the incident. Example: "1" (Open).

app_instance.activity_due

String

Due date for the next activity. Example: "2024-06-18 12:00:00".

app_instance.correlation_display

String

Display value for the correlation ID. Example: "CORR12345".

app_instance.company

String

Company associated with the incident. Example: "ABC Corp".

app_instance.active

String

Active status of the incident. Example: "true".

app_instance.due_date

String

Due date of the incident. Example: "2024-06-18 17:00:00".

app_instance.assignment_group

Object

Assignment group information with link and value.

app_instance.caller_id

Object

Caller ID information with link and value.

app_instance.knowledge

String

Knowledge article status. Example: "false".

app_instance.made_sla

String

SLA met status. Example: "false".

app_instance.comments_and_work_notes

String

Comments and work notes associated with the incident. Example: "Initial analysis done".

app_instance.parent_incident

String

Parent incident ID. Example: "INC0000045".

app_instance.state

String

State of the incident. Example: "1" (Open).

app_instance.user_input

String

User input associated with the incident. Example: "User input details".

app_instance.sys_created_on

String

Timestamp when the incident was created. Example: "2015-11-01 22:05:30".

app_instance.approval_set

String

Approval set for the incident. Example: "Approval set details".

app_instance.reassignment_count

String

Number of times the incident was reassigned. Example: "1".

app_instance.rfc

String

RFC associated with the incident. Example: "RFC12345".

app_instance.child_incidents

String

Child incidents associated with this incident. Example: "INC0000047, INC0000048".

app_instance.opened_at

String

Timestamp when the incident was opened. Example: "2015-11-02 22:04:15".

app_instance.short_description

String

Short description of the incident. Example: "Can't access SFA software".

app_instance.order

String

Order associated with the incident. Example: "Order123".

app_instance.sys_updated_by

String

User who last updated the incident. Example: "glide.maint".

app_instance.resolved_by

String

User who resolved the incident. Example: "resolver1".

app_instance.notify

String

Notification status of the incident. Example: "1".

app_instance.upon_reject

String

Action to take upon rejection. Example: "Reassign".

app_instance.approval_history

String

History of approvals for the incident. Example: "Approval history details".

app_instance.problem_id

Object

Problem ID information with link and value. Example: "https://instance.servicenow.com/api/now/table/problem/a9e4890bc6112276003d7a5a5c774a74"

app_instance.work_notes

String

Work notes associated with the incident. Example: "Work note details".

app_instance.calendar_duration

String

Calendar duration of the incident. Example: "2 hours".

app_instance.close_code

String

Code indicating the reason for closing the incident. Example: "Resolved".

app_instance.sys_id

String

System ID of the incident. Example: "a9e30c7dc61122760116894de7bcc7bd".

app_instance.approval

String

Approval status of the incident. Example: "not requested".

app_instance.caused_by

String

Cause of the incident. Example: "Network issue".

app_instance.severity

String

Severity level of the incident. Example: "3" (Low).

app_instance.sys_created_by

String

User who created the incident. Example: "admin".

app_instance.resolved_at

String

Timestamp when the incident was resolved. Example: "2024-06-18 10:30:00".

app_instance.assigned_to

String

User assigned to the incident. Example: "assignee1".

app_instance.business_stc

String

Business stc details. Example: "Business STC info".

app_instance.wf_activity

String

Workflow activity details. Example: "Workflow activity info".

app_instance.sys_domain_path

String

System domain path. Example: "/".

app_instance.cmdb_ci

Object

Configuration item information with link and value. Example:"https://instance.servicenow.com/api/now/table/cmdb_ci/a9c0c8d2c6112276018f7705562f9cb0"

app_instance.opened_by

Object

User who opened the incident with link and value. Example: "https://instance.servicenow.com/api/now/table/sys_user/46c6f9efa9fe198101ddf5eed9adf6e7"

app_instance.subcategory

String

Subcategory of the incident. Example: "Software issue".

app_instance.rejection_goto

String

Action to take if rejected. Example: "Escalate".

app_instance.sys_class_name

String

Class name of the incident. Example: "incident".

app_instance.watch_list

String

List of users watching the incident. Example: "user1, user2".

app_instance.time_worked

String

Total time worked on the incident. Example: "2 hours".

app_instance.contact_type

String

Type of contact for the incident. Example: "phone".

app_instance.escalation

String

Escalation status of the incident. Example: "0" (Not escalated).

app_instance.comments

String

Comments associated with the incident. Example: "Additional comments".

Action: Get Stats Of A Table

This action retrieves the aggregate statistics about existing table and column data.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table name 

Enter the table name to get the statistics.

Example:

incident

Text

Required

Query params 

Enter the query parameters as key-value pairs. 

Key Value

Optional

Allowed keys:

  • name-value pairs

  • sysparm__fields

  • sysparm_count

  • sysparm_display_value

  • sysparm_group_by

  • sysparm_having

  • sysparm_orderby

  • sysparm_query

Default: 

{sysparm_avg_fields: reassignment_count, business_stc data}

Example Request

[
    {
        "table_name": "incident"
    }
]

Action Response Parameters

Parameter

Type

Description

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.result

Array of Objects

Stats for the specified table.

app_instance.result.stats.avg.business_stc

String

Average business service time in seconds. Example: "804162.7143".

app_instance.result.stats.avg.reassignment_count

String

Average reassignment count. Example: "1.0000".

app_instance.result.groupby_fields.value

String

Assignment group value.

app_instance.result.groupby_fields.field

String

Field name for the assignment group. Example: "assignment_group".

Action: Get User Roles

This action gets a specified user's granted and inherited roles.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

User system ID 

Enter the system ID of the user for which the role information needs to be fetched.

Example:

005d500b536073005e0addeeff7b12f4

Text

Required

Example Request

[
    {
        "user_sysid": "0524a5e2d7320100ba986f14ce610300"
    }
]

Action Response Parameters

Parameter

Type

Description

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.result.user_name

String

Username. Example: "abel.tuter"

app_instance.result.from_group

Array of Strings

List of groups from which the user belongs. Example: ["[Azure Operators]/sn_azure.operator", "[Azure Operators]/sn_azure.operator/sn_azure.user"]

app_instance.result.from_role

Array of Strings

List of roles assigned to the user. Example: ["/snc_internal", "/cloud_user", "/cloud_user/pa_viewer", "/cloud_user/sn_azure.user", "/cloud_user/aws_user"]

Action: Get Users

This action gets user details based on the specified table.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table name 

Enter the table name.

Example:

incident

Text

Required

Maximum number of users 

Enter the maximum number of users to be returned.

Example:

10

Integer

Optional

Default value: 

1

Query params 

Enter query params as key-value pairs.

Key Value

Optional

Example Request

[
    {
        "table_name": "u_co_test_table",
        "limit_number_of_users": 10
    }
]

Action Response Parameters

Parameter

Type

Description

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.result.ID

String

User system ID.

app_instance.result.Name

String

User name (first and last).

app_instance.result.UserName

String

User's username.

app_instance.result.Email

String

User email address.

app_instance.result.Created

Date

Date and time the user was created.

app_instance.result.Updated

Date

Date and time the user was last updated.

Action: List Catalog Items

This action retrieves a list of catalog items based on the specified parameters.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Number of records 

Enter the maximum number of records to return.

Example:

100

Integer

Optional

Default value:

1000

Offset number 

Enter the starting record index for which to begin retrieving records. Use this value to paginate record retrieval.

Example:

0

Integer

Optional

Default value:

0

Extra params 

Enter additional parameters as key-value pairs to query.

Key Value

Optional

Example Request

[
    {
        "sysparm_limit": 100,
        "sysparm_offset": 0
    }
]

Action Response Parameters

Parameter

Type

Description

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.result[0].short_description

Null

Short description of the item.

app_instance.result[0].kb_article

String

Link to the associated knowledge base article.

app_instance.result[0].icon

String

Icon image path. Example: "images/icons/catalog_item.gifx"

app_instance.result[0].description

String

Detailed description of the item. Example: "Request an existing Standard Change Template is made unavailable when it is no longer required or no longer acceptable as a Standard Change. This will be confirmed by your Change Management team."

app_instance.result[0].type

String

Type of the item. Example: "record_producer"

app_instance.result[0].sys_class_name

String

Class name of the item. Example: "sc_cat_item_producer"

app_instance.result[0].sys_id

String

System ID of the item. Example: "011f117a9f3002002920bde8132e7020"

app_instance.result[0].catalogs

Array of Objects

List of catalogs containing the item. Example: [{"sys_id": "e0d08b13c3330100c8b837659bba8fb4", "title": "Service Catalog"}]

app_instance.result[0].name

String

Name of the item. Example: "Retire a Standard Change Template"

app_instance.result[0].category

Object

Category details of the item. Example: {"sys_id": "00728916937002002dcef157b67ffb6d", "title": "Template Management"}

app_instance.result[0].order

Number

Order of the item. Example: 30

Action: Perform Analytics on Fields

This action performs analytics on the specified fields (experimental).

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Params

Enter the parameters on which analytics need to be performed as key-value pairs.

Key Value

Required

Allowed keys:

  • sysparm_breakdown

  • sysparm_breakdown_relation

  • sysparm_contains

  • sysparm_display

  • sysparm_display_value

  • sysparm_elements_filter

  • sysparm_exclude_reference_link

  • sysparm_favorites

  • sysparm_from

  • sysparm_include_aggregates

  • sysparm_include_available_aggregates

  • sysparm_include_available_breakdowns

  • sysparm_include_forecast_scores

  • sysparm_include_realtime

  • sysparm_include_score_notes

  • sysparm_include_scores

  • sysparm_include_target_color_scheme

  • sysparm_include_trendline_scores

  • sysparm_key

  • sysparm_limit

  • sysparm_page

  • sysparm_per_page

  • sysparm_sortby

  • sysparm_sortdir

  • sysparm_step

  • sysparm_tags

  • sysparm_target

  • sysparm_to

  • sysparm_uuid

Example Request

[
    {
        "params": {
           "sysparm_limit": 100                         
        }
    }
]

Action Response Parameters

Parameter

Type

Description

app_instance.result[0].change_formatted

String

Formatted change value. 

app_instance.result[0].key

Boolean

Key value. Example: false

app_instance.result[0].value_unit

String

Unit of the value.

app_instance.result[0].value_formatted

String

Formatted value. 

app_instance.result[0].period_title

Null

Title of the period. 

app_instance.result[0].gapperc

Null

Gap percentage.

app_instance.result[0].gap

Null

Gap value. 

app_instance.result[0].target

Null

Target value

app_instance.result[0].period

Null

Period value. 

app_instance.result[0].target_formatted

String

Formatted target value.

app_instance.result[0].favorite

Boolean

Favorite status. Example: false

app_instance.result[0].direction_label

String

Direction label. Example: "Minimize"

app_instance.result[0].uuid

String

UUID of the item. Example: "fb007202d7130100b96d45a3ce6103b4"

app_instance.result[0].name

String

Name of the item. Example: "Number of open incidents"

app_instance.result[0].value_color

String

Color of the value. Example: "#000000"

app_instance.result[0].frequency_label

String

Frequency label. Example: "Daily"

app_instance.result[0].change

Null

Change value. 

app_instance.result[0].gap_formatted

String

Formatted gap value. 

app_instance.result[0].gapperc_formatted

String

Formatted gap percentage value. 

app_instance.result[0].value

Null

Value. Example: null

app_instance.result[0].unit

Object

Unit details with display value, link, and value. Example: {"display_value": "#", "link": "https://instance.service-now.com/api/now/v1/table/pa_units/17b365e2d7320100ba986f14ce6103ad", "value": "17b365e2d7320100ba986f14ce6103ad"}

app_instance.result[0].changeperc_formatted

String

Formatted change percentage value. Example: ""

app_instance.result[0].direction

Number

Direction value. Example: 2

app_instance.result[0].frequency

Number

Frequency value. Example: 10

app_instance.result[0].precision

Number

Precision value. Example: 0

app_instance.result[0].changeperc

Null

Change percentage value. 

app_instance.result[0].indicator

Object

Indicator details with display value, link, and value. Example: {"display_value": "Number of open incidents", "link": "https://instance.service-now.com/api/now/v1/table/pa_indicators/fb007202d7130100b96d45a3ce6103b4", "value": "fb007202d7130100b96d45a3ce6103b4"}

app_instance.result[0].description

String

Detailed description of the item. Example: "Number of incidents open based on resolved date is empty."

Action: Resolve Incident Records

This action resolves incident records.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

System ID 

Enter the system ID to resolve the incident records.

Example:

0a9cdf93dbd31010a3c28a1848961994

Text

Required

Work notes 

Enter the work notes.

Text

Required

Close code 

Enter the close code.

Text

Required

Allowed values:

  • Solved (Work Around)

  • Solved (Permanently)

  • Solved Remotely (Work Around)

  • Solved Remotely (Permanently)

  • Not Solved (Reproducible)

  • Not Solved (Too Costly)

Closing notes 

Enter the closing notes.

Text

Required

Example Request

[
    {
        "sys_id": "a3da1c0197c03110b963bf1e6253af53",
        "close_code": "Resolved",
        "work_notes": "Test instance",
        "close_notes": "This is resolved"
    }
]

Action Response Parameters

Parameter

Type

Description

app_instance.result.upon_approval

String

Action to take upon approval. Example: "proceed"

app_instance.result.location

Object

Location details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f", "value": "108752c8c611227501d4ab0e392ba97f"}

app_instance.result.expected_start

String

Expected start time. Example: ""

app_instance.result.reopen_count

String

Reopen count. Example: ""

app_instance.result.close_notes

String

Notes on closure. Example: ""

app_instance.result.additional_assignee_list

String

Additional assignee list. Example: ""

app_instance.result.impact

String

Impact level. Example: "1"

app_instance.result.urgency

String

Urgency level. Example: "1"

app_instance.result.correlation_id

String

Correlation ID. Example: ""

app_instance.result.sys_tags

String

System tags. Example: ""

app_instance.result.sys_domain

Object

System domain details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global"}

app_instance.result.description

String

Description of the incident. Example: ""

app_instance.result.group_list

String

List of groups. Example: ""

app_instance.result.priority

String

Priority level. Example: "1"

app_instance.result.delivery_plan

String

Delivery plan. Example: ""

app_instance.result.sys_mod_count

String

System modification count. Example: "7"

app_instance.result.work_notes_list

String

List of work notes. Example: ""

app_instance.result.business_service

String

Business service. Example: ""

app_instance.result.follow_up

String

Follow-up information. Example: ""

app_instance.result.closed_at

String

Closure timestamp. Example: ""

app_instance.result.sla_due

String

SLA due date. Example: "2017-07-05 05:58:24"

app_instance.result.delivery_task

String

Delivery task. Example: ""

app_instance.result.sys_updated_on

String

Timestamp of last update. Example: "2016-01-22 14:12:37"

app_instance.result.parent

String

Parent incident. Example: ""

app_instance.result.work_end

String

Work end time. Example: ""

app_instance.result.number

String

Incident number. Example: "INC0000050"

app_instance.result.closed_by

String

User who closed the incident. Example: ""

app_instance.result.work_start

String

Work start time. Example: ""

app_instance.result.calendar_stc

String

Calendar short time code. Example: ""

app_instance.result.category

String

Category of the incident. Example: "hardware"

app_instance.result.business_duration

String

Business duration. Example: ""

app_instance.result.incident_state

String

State of the incident. Example: "2"

app_instance.result.activity_due

String

Activity due date. Example: "2016-01-22 16:12:37"

app_instance.result.correlation_display

String

Correlation display. Example: ""

app_instance.result.company

Object

Company details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec", "value": "31bea3d53790200044e0bfc8bcbe5dec"}

app_instance.result.active

String

Active status. Example: "true"

app_instance.result.due_date

String

Due date. Example: ""

app_instance.result.assignment_group

Object

Assignment group details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3", "value": "8a5055c9c61122780043563ef53438e3"}

app_instance.result.caller_id

Object

Caller ID details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c", "value": "5b7c200d0a640069006b3845b5d0fa7c"}

app_instance.result.knowledge

String

Knowledge article. Example: "false"

app_instance.result.made_sla

String

SLA met status. Example: "true"

app_instance.result.comments_and_work_notes

String

Comments and work notes. Example: ""

app_instance.result.parent_incident

String

Parent incident. Example: ""

app_instance.result.state

String

State of the incident. Example: "2"

app_instance.result.user_input

String

User input. Example: ""

app_instance.result.sys_created_on

String

Timestamp of creation. Example: "2015-11-02 18:05:40"

app_instance.result.approval_set

String

Approval set. Example: ""

app_instance.result.reassignment_count

String

Reassignment count. Example: "0"

app_instance.result.rfc

String

RFC number. Example: ""

app_instance.result.child_incidents

String

Child incidents. Example: ""

app_instance.result.opened_at

String

Timestamp when the incident was opened. Example: "2015-11-02 21:58:24"

app_instance.result.short_description

String

Short description of the incident. Example: "Can't access Exchange server - is it down?"

app_instance.result.order

String

Order number. Example: ""

app_instance.result.sys_updated_by

String

User who last updated the incident. Example: "admin"

app_instance.result.resolved_by

String

User who resolved the incident. Example: "admin"

app_instance.result.notify

String

Notification preference. Example: "1"

app_instance.result.upon_reject

String

Action to take upon rejection. Example: "cancel"

app_instance.result.approval_history

String

Approval history. Example: ""

app_instance.result.problem_id

String

Problem ID. Example: ""

app_instance.result.work_notes

String

Work notes. Example: ""

app_instance.result.calendar_duration

String

Calendar duration. Example: ""

app_instance.result.close_code

String

Close code. Example: ""

app_instance.result.sys_id

String

System ID. Example: "ef43c6d40a0a0b5700c77f9bf387afe3"

app_instance.result.approval

String

Approval status. Example: "not requested"

app_instance.result.caused_by

String

Causing factor. Example: ""

app_instance.result.severity

String

Severity level. Example: "3"

app_instance.result.sys_created_by

String

User who created the incident. Example: "glide.maint"

app_instance.result.resolved_at

String

Timestamp when the incident was resolved. Example: "2015-11-09 22:59:24"

app_instance.result.assigned_to

Object

Assigned user details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd", "value": "681b365ec0a80164000fb0b05854a0cd"}

app_instance.result.business_stc

String

Business short time code. Example: ""

app_instance.result.wf_activity

String

Workflow activity. Example: ""

app_instance.result.sys_domain_path

String

System domain path. Example: "/"

app_instance.result.cmdb_ci

Object

CMDB CI details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6", "value": "281190e3c0a8000b003f593aa3f20ca6"}

app_instance.result.opened_by

Object

Opened by user details with link and value. Example: {"link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint", "value": "glide.maint"}

app_instance.result.subcategory

String

Subcategory of the incident. Example: ""

app_instance.result.rejection_goto

String

Rejection redirection. Example: ""

app_instance.result.sys_class_name

String

Class name of the incident. Example: "incident"

app_instance.result.watch_list

String

Watch list. Example: ""

app_instance.result.time_worked

String

Time worked. Example: ""

app_instance.result.contact_type

String

Type of contact. Example: "phone"

app_instance.result.escalation

String

Escalation level. Example: "3"

app_instance.result.comments

String

Comments. 

Action: Search Records From Table

This action searches for records from a table.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table name 

Enter the table name for which records must be retrieved.

Example:

u_co_test_table

Text

Required

Number of records 

Enter the maximum number of records to return.

Example:

100

Integer

Optional

Default value:

1000

Offset number 

Enter the starting record index to begin retrieving records. Use this value to paginate record retrieval.

Integer

Optional

Query string 

Enter the encoded query used to filter the result set.

Text

Optional

Query params 

Enter query parameters as key value pairs to filter the results.

Key Value

Optional

Example Request

[
    {
        "table_name": "u_co_test_table"
    }
]

Action Response Parameters

Parameter

Field Type

Description

{app_instance}

JSON Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.response

JSON Object

Includes the details of the response retrieved from the action.

app_instance.response.result 

Array of JSON Objects

returns a list of JSON objects. Each JSON object that includes the details of a record.

app_instance.response.result.active 

Boolean

A boolean indicating whether the record is active.

app_instance.response.result.assigned_to 

String

The user assigned to the record.

app_instance.response.result.caller_id 

JSON Object

The associated caller ID of the record.

app_instance.response.result.impact 

String

The impact level of the record.

app_instance.response.result.made_sla 

Boolean

A boolean indicating whether the record met its Service Level Agreement.

app_instance.response.result.number 

String

The ServiceNow unique identifier of the record.

app_instance.response.result.opened_by 

JSON Object

An object containing a link to the user who opened the record and the user's identifier.

app_instance.response.result.parent 

String

The parent incident of the record created, if any.

app_instance.response.result.state 

String

The current state of the record.

app_instance.response.result.short_description 

String

A brief description of the record.

app_instance.response.result.description 

String

A detailed description of the record.

app_instance.response.result.sys_class_name 

String

The class of the record

app_instance.response.result.contact_type 

String

The type of contact related to the record.

app_instance.response.result.urgency 

String

The urgency level of the record.

app_instance.response.result.approval 

String

The approval status of the record.

app_instance.response.result.priority 

String

The priority level of the record.

app_instance.response.result.sys_created_on 

String

The system created date and time of the record.

app_instance.response.result.sys_updated_on 

String

The system updated date and time of the record.

app_instance.response.result.closed_at 

String

The system closed date and time of the record.

app_instance.response.result.comments 

String

The comments added to the record.

app_instance.response.result.resolved_by 

String

ServiceNow ID of the user who resolved the record.

app_instance.response.result.close_code 

String

ServiceNow close code of the record.

Action: Update Incident

This action updates an incident.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

System ID 

Enter the system ID of the incident to be updated.

Example:

57fe9b17dbd31010a3c28a18489619d1

Text

Required

Additional parameters 

Enter the additional parameters to update in the incident in the form of key-value pairs.

Example:

"urgency": "1"

Key Value

Required

Example Request

[
    {
        "sys_id": "a3da1c0197c03110b963bf1e6253af53",
        "post_params": {
           "urgency": "1"
        }
    }
]

Action Response Parameters

Parameter

Field Type

Description

{app_instance}

JSON Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.response

JSON Object

Includes the details of the response retrieved from the action.

app_instance.response.result 

JSON Object

The JSON object that includes the details of the incident.

app_instance.response.result.active 

Boolean

A boolean indicating whether the incident is active.

app_instance.response.result.assigned_to 

String

The user assigned to the incident.

app_instance.response.result.caller_id 

JSON Object

The associated caller ID of the incident.

app_instance.response.result.impact 

String

The impact level of the incident.

app_instance.response.result.made_sla 

Boolean

A boolean indicating whether the incident met its Service Level Agreement.

app_instance.response.result.number 

String

The ServiceNow unique identifier of the incident.

app_instance.response.result.opened_by 

JSON Object

An object containing a link to the user who opened the incident and the user's identifier.

app_instance.response.result.parent 

String

The parent incident of the incident created, if any.

app_instance.response.result.state 

String

The current state of the incident.

app_instance.response.result.short_description 

String

A brief description of the incident.

app_instance.response.result.description 

String

A detailed description of the incident.

app_instance.response.result.sys_class_name 

String

The class of the incident

app_instance.response.result.contact_type 

String

The type of contact related to the incident.

app_instance.response.result.urgency 

String

The urgency level of the incident.

app_instance.response.result.approval 

String

The approval status of the incident.

app_instance.response.result.priority 

String

The priority level of the incident.

app_instance.response.result.sys_created_on 

String

Created date and time of the incident.

app_instance.response.result.comments 

String

The comments added to the incident.

app_instance.response.result.resolved_by 

String

ServiceNow ID of the user who resolved the incident.

app_instance.response.result.close_code 

String

ServiceNow close code of the incident.

Action: Update Request Item Record (RITM)

This action can be used to update the requested item record.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

System id of item record 

Enter the system ID of the requested item record.

Example:

005d500b536073005e0addeeff7b12f4

Text

Required

Table name 

Enter the table name. 

Example: 

co_table

Text

Required

Information to update 

Enter the field values to add or update in a record in the form of key-value pairs.

Example:

"quantity": "10"

Key Value

Optional

Action Response Parameters

Parameter

Type

Response

{app_instance}

Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.upon_approval

String

Action to take upon approval. Example: "Escalate".

app_instance.location

Object

Location information with link and value.

app_instance.expected_start

String

Expected start time. Example: "2024-06-17 10:00:00".

app_instance.reopen_count

String

The number of times the incident was reopened. Example: "2".

app_instance.close_notes

String

Notes added upon closing the incident. Example: "Issue resolved".

app_instance.additional_assignee_list

String

List of additional assignees. Example: "user1, user2".

app_instance.impact

String

Impact level of the incident. Example: "1" (High).

app_instance.urgency

String

Urgency level of the incident. Example: "3" (Low).

app_instance.correlation_id

String

Correlation ID for related incidents. Example: "CORR12345".

app_instance.sys_tags

String

System tags for the incident. Example: "tag1, tag2".

app_instance.sys_domain

Object

Domain information with link and value.

app_instance.description

String

Detailed description of the incident. Example: "User cannot access software".

app_instance.group_list

String

List of groups associated with the incident. Example: "group1, group2".

app_instance.priority

String

Priority level of the incident. Example: "3" (Low).

app_instance.delivery_plan

String

Delivery plan for the incident. Example: "Plan A".

app_instance.sys_mod_count

String

Number of times the record was modified. Example: "4".

app_instance.work_notes_list

String

List of work notes for the incident. Example: "Note 1, Note 2".

app_instance.business_service

String

Business service affected by the incident. Example: "Email Service".

app_instance.follow_up

String

Follow-up actions required. Example: "Check after 24 hours".

app_instance.closed_at

String

Timestamp when the incident was closed. Example: "2024-06-18 15:30:00".

app_instance.sla_due

String

SLA due date. Example: "2015-11-11 22:04:15".

app_instance.delivery_task

String

Delivery task associated with the incident. Example: "Task 123".

app_instance.sys_updated_on

String

Timestamp when the incident was last updated. Example: "2015-11-01 22:37:27".

app_instance.parent

String

Parent incident ID. Example: "INC0000045".

app_instance.work_end

String

Timestamp when the work ended. Example: "2024-06-17 17:00:00".

app_instance.number

String

Unique number of the incident. Example: "INC0000046".

app_instance.closed_by

String

User who closed the incident. Example: "admin".

app_instance.work_start

String

Timestamp when the work started. Example: "2024-06-17 09:00:00".

app_instance.calendar_stc

String

Calendar time spent on the incident. Example: "3 hours".

app_instance.category

String

Category of the incident. Example: "software".

app_instance.business_duration

String

Business duration of the incident. Example: "2 days".

app_instance.incident_state

String

State of the incident. Example: "1" (Open).

app_instance.activity_due

String

Due date for the next activity. Example: "2024-06-18 12:00:00".

app_instance.correlation_display

String

Display value for the correlation ID. Example: "CORR12345".

app_instance.company

String

Company associated with the incident. Example: "ABC Corp".

app_instance.active

String

Active status of the incident. Example: "true".

app_instance.due_date

String

Due date of the incident. Example: "2024-06-18 17:00:00".

app_instance.assignment_group

Object

Assignment group information with link and value.

app_instance.caller_id

Object

Caller ID information with link and value.

app_instance.knowledge

String

Knowledge article status. Example: "false".

app_instance.made_sla

String

SLA met status. Example: "false".

app_instance.comments_and_work_notes

String

Comments and work notes associated with the incident. Example: "Initial analysis done".

app_instance.parent_incident

String

Parent incident ID. Example: "INC0000045".

app_instance.state

String

State of the incident. Example: "1" (Open).

app_instance.user_input

String

User input associated with the incident. Example: "User input details".

app_instance.sys_created_on

String

Timestamp when the incident was created. Example: "2015-11-01 22:05:30".

app_instance.approval_set

String

Approval set for the incident. Example: "Approval set details".

app_instance.reassignment_count

String

Number of times the incident was reassigned. Example: "1".

app_instance.rfc

String

RFC associated with the incident. Example: "RFC12345".

app_instance.child_incidents

String

Child incidents associated with this incident. Example: "INC0000047, INC0000048".

app_instance.opened_at

String

Timestamp when the incident was opened. Example: "2015-11-02 22:04:15".

app_instance.short_description

String

Short description of the incident. Example: "Can't access SFA software".

app_instance.order

String

Order associated with the incident. Example: "Order123".

app_instance.sys_updated_by

String

User who last updated the incident. Example: "glide.maint".

app_instance.resolved_by

String

User who resolved the incident. Example: "resolver1".

app_instance.notify

String

Notification status of the incident. Example: "1".

app_instance.upon_reject

String

Action to take upon rejection. Example: "Reassign".

app_instance.approval_history

String

History of approvals for the incident. Example: "Approval history details".

app_instance.problem_id

Object

Problem ID information with link and value.

app_instance.work_notes

String

Work notes associated with the incident. Example: "Work note details".

app_instance.calendar_duration

String

Calendar duration of the incident. Example: "2 hours".

app_instance.close_code

String

Code indicating the reason for closing the incident. Example: "Resolved".

app_instance.sys_id

String

System ID of the incident. Example: "a9e30c7dc61122760116894de7bcc7bd".

app_instance.approval

String

Approval status of the incident. Example: "not requested".

app_instance.caused_by

String

Cause of the incident. Example: "Network issue".

app_instance.severity

String

Severity level of the incident. Example: "3" (Low).

app_instance.sys_created_by

String

User who created the incident. Example: "admin".

app_instance.resolved_at

String

Timestamp when the incident was resolved. Example: "2024-06-18 10:30:00".

app_instance.assigned_to

String

User assigned to the incident. Example: "assignee1".

app_instance.business_stc

String

Business stc details. Example: "Business STC info".

app_instance.wf_activity

String

Workflow activity details. Example: "Workflow activity info".

app_instance.sys_domain_path

String

System domain path. Example: "/".

app_instance.cmdb_ci

Object

Configuration item information with link and value.

app_instance.opened_by

Object

User who opened the incident with link and value.

app_instance.subcategory

String

Subcategory of the incident. Example: "Software issue".

app_instance.rejection_goto

String

Action to take if rejected. Example: "Escalate".

app_instance.sys_class_name

String

Class name of the incident. Example: "incident".

app_instance.watch_list

String

List of users watching the incident. Example: "user1, user2".

app_instance.time_worked

String

Total time worked on the incident. Example: "2 hours".

app_instance.contact_type

String

Type of contact for the incident. Example: "phone".

app_instance.escalation

String

Escalation status of the incident. Example: "0" (Not escalated).

app_instance.comments

String

Comments associated with the incident. Example: "Additional comments".

Action: Update Table Record

This action updates a record of a table.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table name 

Enter the table name where the record is present.

Example:

u_co_test_table

Text

Required

System ID 

Enter the system ID of the record to update.

Example:

0a9cdf93dbd31010a3c28a1848961994

Text

Required

Post params 

Enter key-value pairs to update in the record.

Key Value

Optional

Example Request

[
    {
        "sys_id": "0a9cdf93dbd31010a3c28a1848961994",
        "table_name": "u_co_test_table"
    }
]

Action Response Parameters

Parameter

Field Type

Description

{app_instance}

JSON Object

This parameter indicates the ID of the app instance configured in Orchestrate from which the response is retrieved.

app_instance.response

JSON Object

Includes the details of the response retrieved from the action.

app_instance.response.result 

JSON Object

The JSON object that includes the details of the record.

app_instance.response.result.active 

Boolean

A boolean indicating whether the record is active.

app_instance.response.result.assigned_to 

String

The user assigned to the record.

app_instance.response.result.caller_id 

JSON Object

The associated caller ID of the record.

app_instance.response.result.impact 

String

The impact level of the record.

app_instance.response.result.made_sla 

Boolean

A boolean indicating whether the record met its Service Level Agreement.

app_instance.response.result.number 

String

The ServiceNow unique identifier of the record.

app_instance.response.result.opened_by 

JSON Object

An object containing a link to the user who opened the record and the user's identifier.

app_instance.response.result.parent 

String

The parent incident of the record created, if any.

app_instance.response.result.state 

String

The current state of the record.

app_instance.response.result.short_description 

String

A brief description of the record.

app_instance.response.result.description 

String

A detailed description of the record.

app_instance.response.result.sys_class_name 

String

The class of the record

app_instance.response.result.contact_type 

String

The type of contact related to the record.

app_instance.response.result.urgency 

String

The urgency level of the record.

app_instance.response.result.approval 

String

The approval status of the record.

app_instance.response.result.priority 

String

The priority level of the record.

app_instance.response.result.sys_created_on 

String

The system created date and time of the record.

app_instance.response.result.sys_updated_on 

String

The system updated date and time of the record.

app_instance.response.result.closed_at 

String

The system closed date and time of the record.

app_instance.response.result.comments 

String

The comments added to the record.

app_instance.response.result.resolved_by 

String

ServiceNow ID of the user who resolved the record.

app_instance.response.result.close_code 

String

ServiceNow close code of the record.

Action: Upload File

This action uploads a multipart file attachment.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Table name 

Enter the table name to which you want to attach the file.

Example:

incident

Text

Required

Table system ID 

Enter the system ID of the record on the specified table to which you want to attach the file.

Example:

a83820b58f723300e7e16c7827bdeed2

Text

Required

File path 

Enter the file path.

Example:

/system/anna/statusReport

Text

Required

Example Request

[
    {
        "file_path": "/tmp/06d2531f-e52c-4f68-bc26-406d72eebf2f/TestFile",
        "table_name": "incident",
        "table_sys_id": "a83820b58f723300e7e16c7827bdeed2"
    }
]

Action Response Parameters

Parameter

Type

Description

app_instance.result.table_sys_id

String

System ID of the table. Example: "d71f7935c0a8016700802b64c67c11c6"

app_instance.result.size_bytes

String

Size of the file in bytes. Example: "36597"

app_instance.result.download_link

String

Download the link for the file. Example: "https://instance.service-now.com/api/now/attachment/994adbc64f511200adf9f8e18110c796/file"

app_instance.result.sys_updated_on

String

Timestamp of last update. Example: "2016-02-02 14:00:21"

app_instance.result.sys_id

String

System ID of the attachment. Example: "994adbc64f511200adf9f8e18110c796"

app_instance.result.image_height

String

Height of the image.

app_instance.result.sys_created_on

String

Timestamp of creation. Example: "2016-02-02 14:00:21"

app_instance.result.file_name

String

Name of the file. Example: "banner-CS0001345_v1_1.jpeg"

app_instance.result.sys_created_by

String

User who created the attachment. Example: "admin"

app_instance.result.compressed

String

Compression status. Example: "true"

app_instance.result.average_image_color

String

Average color of the image. 

app_instance.result.sys_updated_by

String

User who last updated the attachment. Example: "admin"

app_instance.result.sys_tags

String

System tags. 

app_instance.result.table_name

String

Name of the table. Example: "incident"

app_instance.result.image_width

String

Width of the image.

app_instance.result.sys_mod_count

String

System modification count. Example: "0"

app_instance.result.content_type

String

Content type of the file. Example: "image/jpeg"

app_instance.result.size_compressed

String

Compressed size of the file in bytes. Example: "25130"