Submit Catalog Item Request action
Summarize
Summary of Submit Catalog Item Request action
The Submit Catalog Item Request action in ServiceNow enables you to create a requested item (screqitem) as part of a Service Catalog Request (screquest). This action is available as a core Workflow Studio service and can be added to flows by users with theflowdesigneroradminroles. It allows automation of catalog item requests within ServiceNow workflows.
Show less
Inputs
This action requires specifying the catalog item to request and supports dynamically added inputs based on the selected catalog item. Key inputs include:
- Catalog Item: The name of the requested catalog item.
- Quantity: Number of items requested.
- Special Instructions: Text describing any special requirements for the request.
- Delivery Address: Location for item delivery.
- Requested for: User for whom the item is requested.
- Don't fail on error: Option to allow the flow to continue if an error occurs.
- Wait for Completion: Option to pause the flow until the request completes.
- Enable timeout: Allows specifying a timeout for the wait condition to avoid indefinite delays (used in conjunction with Wait for Completion).
- Duration: Specifies how long to wait before timing out, entered as hours, minutes, and seconds.
- Schedule: Defines a work schedule to compute timeout duration, enabling business-hour aware waiting.
Note: Some Service Catalog variable types are not supported, including list collector lookup, multiple choice lookup, and select box.
Outputs
The action returns the following outputs to be used later in the flow:
- Error Message: Text describing any error encountered.
- Requested Item: Document ID of the created requested item.
- Status: Numeric indicator of action outcome: 0 for success, 1 for error, and 2 for timeout.
Design considerations
- Escape quotation marks in string data pills: Use the String Replace transform function to avoid JSON formatting issues with complex string variables.
- Validate data pills with transform functions: Apply transform functions to ensure input data correctness before submission.
These considerations improve robustness and error handling when automating catalog item requests in flows.
Create a requested item [sc_req_item] on a Service Catalog Request [sc_request].
Roles and availability
Available as a Workflow Studio ServiceNow core action. Users with the flow_designer or admin role can add an action to a flow and define configuration details.
Inputs
| Input | Description |
|---|---|
| Catalog Item | Name of the requested catalog item. Extra inputs may be added dynamically, depending on which catalog item is selected. For example, when the requested catalog item is a new email account, a field for Preferred Email address appears. Note: The following Service Catalog variable types are not supported.
|
| Quantity | Number of items requested. |
| Special Instructions | Text describing any special instructions about the item request. |
| Delivery Address | Location where the requested item should be delivered. |
| Requested for | User that the item is requested for. |
| Don't fail on error | Option to determine whether to fail the flow if the action produces an error. |
| Wait for Completion | Option to force the flow to wait until the action has been completed before continuing. |
| Enable timeout | Option to limit the amount of time that the flow waits for the action to be completed before continuing.
Note: Use the Enable timeout option to prevent this action from
continuing to run. If the condition to continue is never met, a timeout value specifies when the system skips the Wait for Condition action and go to the next item in the flow. You must set a Duration value
to enable a timeout. You can also select a Schedule if you want to compute the duration end date based on a specific work schedule. This field appears only when the Wait for Completion option is selected. |
| Duration | Amount of time that the flow waits before continuing when the Enable timeout option is selected. Enter the time to wait in hours, minutes, and seconds. If you leave this field empty, the flow does not wait. This field appears only when the Wait for Completion option is selected. |
| Schedule | Schedule used to compute the timeout duration when the Enable timeout option is selected. For example, waiting for 10 hours as part of an 8-5 weekdays schedule causes the flow to wait for one or more business days. If you leave this field empty, the timeout runs without a schedule. This field appears only when the Wait for Completion option is selected. |
Output
| Field | Description | Data Type |
|---|---|---|
| Error Message | Message that displays if the action produces an error. | String |
| Requested Item | Document ID for the requested item. | Document ID |
| Status | The completion status of the action as a numeric value.
|
Choice |
Example
Design considerations
Follow these design considerations when creating flows that contain Submit a Catalog Item Request actions.
- Escape quotation marks from string data pills with the String Replace transform function
- Complex string variables are converted into JSON format when stored in the system. To prevent any JSON formatting errors, you can use a Replace String transform function to escape the quotation marks present in any string data pills you use for catalog variables. See String transform functions.
- Use transform functions to validate data pills
- Whenever you use a data pill to provide data for an action input, you can use a transform function to validate the data. See Transform functions for a list of available transform functions.