Create Record activity
Summarize
Summary of Create Record activity
The Create Record activity in ServiceNow’s Yokohama release enables playbooks to pause and prompt end users to create a record within a specified form view. This activity allows you to configure the target table and the form view presented to the user for record creation. It is designed to facilitate interactive data entry during playbook execution.
Show less
Roles and Availability
This activity is classified as a common activity. It can be added to playbooks by users with the admin, playbook.admin, or pdauthor roles.
Configuration Inputs
To set up the Create Record activity, use the activity properties panel to define the following inputs:
- Label: The title displayed on the activity and playbook card.
- Description: Informational text about the activity’s purpose or outcome.
- Run condition: Conditions that must be met for the activity or stage to run, using data from prior activities.
- Start Rule: Defines when the stage or activity starts, such as at playbook start, after specific stages or activities, or with a delay.
- Table: The target table where the new record will be created.
- Create Record View: The form view displayed to the user for record creation. If left blank, the default view is used. This can be customized using the Form Builder.
- Template Fields: Optional field values pre-populated during record creation.
Outputs
The activity provides outputs that can be consumed by subsequent playbook activities:
- Table: The table where the new record was created.
- Create Record View: The form view used for creation.
- Record Created Sys ID: The unique identifier of the created record.
Design Considerations
- Customize form views to show only necessary fields, focusing on required or validated fields to streamline user input.
- Design playbooks to run non-interactive activities before interactive ones like Create Record, since interactive activities pause the playbook and block dependent activities from starting.
- Be aware that many form views may not be supported in Workspace; test accordingly.
By leveraging the Create Record activity, ServiceNow customers can integrate user-driven record creation seamlessly into playbook workflows, enhancing data accuracy and process control during interactive playbook stages.
Pause the playbook and prompt the end user to create a record in a form view. Use this activity to allow the end user to create a record. This activity requires you to configure the desired table for which record to create, and the desired form view that the end user will see when creating the record.
Roles and availability
This activity is available as a common activity. Users with the admin, playbook.admin, or pd_author can add this activity to a playbook.
Inputs
| Input | Type | Description |
|---|---|---|
| Label | String | Title to display as activity and playbook card. |
| Description | String | Information to display about activity usage or outcome. |
| Run condition | Condition Builder | Conditions that must be met to run an activity or stage. You can use data from prior activities to build conditions. Note: Show additional options to see this field. |
| Start Rule | Choice | Under , select a start rule for when your stage should start running:
|
| Start with delay | True/False | Option to wait for a duration of time before running an activity or stage. When enabled, this input displays the Start with delay input properties. Note: Show additional options to see this field. |
| Table | Table Name | Table in which to insert new record. |
| Create Record View | String | Form view to use for record creation. If you don't provide a form view, the system uses the default view. Use the new tab button Note: Many form views are not supported in Workspace. |
| Template Fields | Template Value | Field values to set during record creation. |
Outputs
| Output | Type | Description |
|---|---|---|
| Table | Table Name | Table containing new record. |
| Create Record View | String | Form view used for record creation. |
| Record Created | Sys ID | Unique identifier of the record that this activity created. |
Design considerations
- Create form views for activities that you want to render in a playbook during runtime.
- Use a form view to display only the fields your users need to create a record. Your view should display required fields or those fields validated by other business logic. See View Management.
- Run non-interactive activities before interactive activities
- While a Create Record activity interactively gathers data from users, it prevents the playbook from starting any dependent activities. For example, a Create Record activity would prevent starting After Previous activities, which may be in other stages. Where possible, design your playbooks to run non-interactive activities before interactive activities that could block them.