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.