Record Producer action

  • Release version: Washingtondc
  • Updated February 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 in Flow Designer allows users to create a Task record from a selected catalog item. This action is part of the ServiceNow core actions available for users with the flowdesigner or admin roles, enabling them to configure flows effectively.

    Show full answer Show less

    Key Features

    • Inputs:
      • Catalog Item: Reference to the catalog item used for creating the Task record.
      • Catalog Item Inputs: Strings representing catalog variables associated with the selected catalog item.
      • Don't fail on error: A boolean indicating whether to abort the action upon encountering an error.
    • Outputs:
      • Table: Indicates the name of the table where the Task record was created.
      • Record: Reference to the Task record generated.
      • Error Message: String containing any error messages produced during the operation.
      • Status: Completion status of the action, indicating success or error.

    Key Outcomes

    Upon execution, users can expect to see success or error statuses in the flow execution details page. If errors occur, messages will guide troubleshooting, typically indicating issues with logic in the flow or action. Following design considerations, such as escaping quotation marks and validating data pills, ensures smoother operation and reduces potential errors during execution.

    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 Flow Designer 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.