Learn
Documentation
Support
Community

ServiceNow - Service catalog connector thinklet

Configure ServiceNow - Incident management connector thinklets to take specific actions within your workflow.

Action: Get service catalog item

Get service catalog item retrieves detailed service catalog item data. This action is utilized in workflows, for instance, to retrieve the internal ID of a service catalog item, which is necessary for other actions related to ordering the service. The Thinklet relies on the Service Catalog - GET /sn_sc/servicecatalog/items API endpoint.

Example of Thinklet setup:

  • Parameters: Configure the data used as parameters for this action. Hover over the tooltip icon for more information on how the parameter is mapped and what data is required.

    • Search text - Text for searching service catalog items

  • Outputs: View the outputs of the connector thinklet.

    • Service catalog item ID (ServiceCatalogItemID)

    • Name (Name) - Service catalog item name

    • Short description (ShortDescription) - Service catalog item short description

    • Availability (Availability) - Service availability

    • Type (Type)

    • Class name (ClassName)

Details of API Service thinklet when recreating the connector:

Field
Value

Resource Path

api/sn_sc/servicecatalog/items?sysparm_limit=1&sysparm_text={{SerachText}}

Method

GET

Payload

Outputs

Availability $.result[0].availability

Name $.result[0].short_description

ShortDescription $.result[0].short_description

ClassName $.result[0].sys_class_name ServiceCatalogItemID $.result[0].sys_id

Type $.result[0].type

Action: Request service catalog item

Request service catalog item places an order for catalog item which results in the creation of service request ticket. The Thinklet relies on the POST /sn_sc/servicecatalog/items/{sys_id}/order_now API endpoint.

Example of Thinklet setup:

  • Parameters: Configure the data used as parameters for this action. Hover over the tooltip icon for more information on how the parameter is mapped and what data is required.

    • Service catalog item ID (ServiceCatalogItemID) - Service catalog item ID

    • Requested for user ID (RequestedForUserID) - Requested for user ID

    • Quantity (OrderQuantity) - Ordered service quantity

  • Outputs: View the outputs of the connector thinklet.

    • Request number (RequestNumber)

    • Request ID (RequestID)

The table below provides the details of the API Service connector when re-creatu:

Field
Value

Resource Path

api/sn_sc/servicecatalog/items/{{ServiceCatalogItemID}}/order_no

Method

POST

Payload

{"sysparm_requested_for":"{{RequestedForUserID}}","sysparm_quantity":"{{OrderQuantity}}"}

Outputs

RequestNumber $.result.number

RequestID $.result.sys_id

Action: Update service catalog request descriptions

Update service catalog request description updates the service catalog request ticket description and short description fields. The Thinklet relies on the Table request PATCH API endpoint.

  • Parameters: Configure the data used as parameters for this action. Hover over the tooltip icon for more information on how the parameter is mapped and what data is required.

    • Request ID (RequestID) - Request ID

    • Description (Description) - Description

    • Short description (ShortDescription) - Short description

  • Outputs: View the outputs of the connector thinklet.

    • Request number (RequestNumber)

    • Request ID (RequestID)

The table below provides the details of the API Service connector when recreating the connector:

Field
Value

Resource Path

api/now/table/sc_request/{{RequestID}}

Method

PATCH

Payload

{"description":"{{Description}}","short_description":"{{ShortDescription}}"}

Outputs

RequestNumber $.result.number

RequestID $.result.sys_id

Refer to the Configuring connector thinklets documentation for more information about connector thinklets.

Last updated

Was this helpful?