Record Producer action
Summarize
Summary of Record Producer action
The Record Producer action in ServiceNow enables the creation of a Task record from a Record Producer Catalog Item (sccatitem). This Task record inherits values from the catalog item's variables, streamlining task generation based on catalog inputs.
Show less
This action is available as a Workflow Studio ServiceNow core action and can be added to flows by users with the flowdesigner or admin roles, allowing configuration within flow logic.
Key Features
- Inputs:
- Catalog Item: Reference to the catalog item used for task creation.
- Catalog Item Inputs: String of catalog variables associated with the chosen catalog item. These variables can be viewed under Service Catalog > Catalog Definitions > Record Producers.
- Don't fail on error: Boolean flag indicating whether the action should continue or fail upon encountering an error.
- Outputs:
- Table: Name of the table where the Task record was created.
- Record: Reference to the created Task record.
- Error Message: Descriptive string if the record creation fails.
- Status: Numeric code indicating completion status (0 for success, 1 for error).
- Error Handling: The action reports specific error messages in execution details, such as "Record generation failed," which often indicates conflicts with other record insertions within the flow.
Design Considerations
- When using string data pills, escape quotation marks by applying the String Replace transform function to prevent JSON formatting errors caused by complex string variables.
- Use transform functions to validate data pills before they are used as inputs in the action, ensuring data integrity and reducing errors.
Practical Application
ServiceNow customers can leverage this action to automate the creation of task records based on catalog items within flows, improving efficiency and consistency. Configuring inputs correctly and applying transform functions help maintain robust flow execution and error handling.
Create a Task record from a Record Producer Catalog Item [sc_cat_item]. The Task record inherits values from the catalog item's variable values.
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
Provide a value for each input that your action needs. To add dynamic values, you can also drag and drop pills from the Data panel or select them from the pill picker.
| Input | Data type | Description |
|---|---|---|
| Catalog Item | Record | Reference to catalog item used to create a Task record. |
| Catalog Item Inputs | String | Catalog variables associated with the catalog item you choose. You can view associated catalog variables for Catalog Items from . |
| Don't fail on error | True/False | Catalog variable indicating whether to fail on error. |
Outputs
These outputs appear in the Data panel. You can use them as inputs elsewhere in your flow.
| Output | Data type | Description |
|---|---|---|
| Table | Table Name | Table where Task record was created. |
| Record | Record | Reference to Task record created. |
| Error Message | String | Error message produced when the record operation fails. |
| Status | Choice | Completion status of the action. The flow execution details page displays one
of these numeric values.
|
Error messages
If an error occurs with this action, the following error messages appear in the execution details page.
| Error message | Description |
|---|---|
| Record generation failed, check logs to get more information. | This error typically occurs when your flow or action contains logic to insert a record or records into other tables. When this logic exists, the Record Producer action aborts inserting the record into the table. |
Design considerations
Follow these design considerations when creating flows that contain Record Producer 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.