Record Producer action

  • Release version: Xanadu
  • Updated August 1, 2024
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Record Producer action

    The Record Producer action enables you to create a Task record from a Record Producer Catalog Item (sccatitem) in ServiceNow. The created Task record inherits values from the catalog item's variable inputs, streamlining task creation within workflows. This action is available as a Workflow Studio ServiceNow core action and can be added to flows by users with theflowdesigneroradminroles.

    Show full answer Show less

    Key Features

    • Inputs:
      • Catalog Item: Reference to the catalog item used to create the Task record.
      • Catalog Item Inputs: String of catalog variables associated with the selected catalog item, which can be managed under Service Catalog > Catalog Definitions > Record Producers.
      • Don't fail on error: Boolean flag to control if the action should 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: String detailing any error that occurred during record creation.
      • Status: Numeric code indicating success (0) or error (1) of the action.
    • Error Handling: Common errors such as "Record generation failed" indicate issues like conflicting logic that abort record insertion. These errors are visible on the flow execution details page.
    • Design Considerations:
      • Escape quotation marks in string data pills using the String Replace transform function to avoid JSON formatting errors.
      • Use transform functions to validate data pills before passing them as inputs to the action, ensuring data integrity and flow reliability.

    Practical Benefits for ServiceNow Customers

    This action simplifies automating task creation from catalog items within flows, ensuring data consistency by inheriting catalog variable values. It provides clear input and output parameters for easy integration and error handling to support robust flow design. By following recommended design practices, customers can avoid common pitfalls related to data formatting and validation, resulting in more reliable and maintainable workflows.

    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 Service Catalog > Catalog Definitions > Record Producers.
    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.
    • Success [0]: The action succeeded.
    • Error [1]: The action produced an error.

    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.