Questionnaire activity
Summarize
Summary of Questionnaire activity
The Questionnaire activity in ServiceNow Playbooks enables you to collect user inputs during a playbook run without requiring a predefined data table. It replaces the older Collect User Data activity and is ideal when you do not need to store data persistently, run reports on the collected data, or use the data outside the playbook context. For scenarios where a data table exists to hold collected information, the User Form activity is recommended instead.
Show less
Key Features
- Availability and Roles: Available as a common activity. Users with admin, playbook.admin, or pdauthor roles can add this activity to playbooks.
- Use Cases: Collect various user inputs such as shipping addresses or yes/no questions to influence playbook flow dynamically.
- Common Properties: Includes configurable inputs like Label (activity title), Description, Run Condition (conditions to execute the activity), and Schedule Start Rule (defining when the activity or stage starts).
- Start with Delay: Optionally delay activity or stage execution.
- Questionnaire Configuration: Easily add or edit questions agents respond to during the playbook. This setup is done within the Questionnaire tab without needing data definitions.
- Assignment Controls: Allows specifying Assignment Group and Assigned To fields to control who can view and edit the collected data during the playbook run. By default, these map to the trigger record’s assignment fields, ensuring appropriate access rights.
- Outputs: Provides a reference to the record containing the collected data. Using the pill-picker, you can access this data for use in subsequent activities within the playbook.
Practical Application for ServiceNow Customers
This activity streamlines gathering user input without extra configuration overhead like creating tables or managing records externally. It is especially useful for transient data collection during a playbook run—perfect for decision-making points or collecting information needed only temporarily within the process. Leveraging assignment controls ensures proper access governance, and outputs allow smooth data handoff between activities.
Customers can expect to quickly configure user input steps in their playbooks, tailor questions as needed, and control execution timing and access, enhancing automation efficiency and user experience.
Collects inputs from a user during a playbook run to use later in the playbook.
- You don't have a table already,
- You don't need to run reports on the collected data,
- And you don't need to use the data outside of the playbook.
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.
- Collect a shipping address, then reference the address when generating a shipping label.
- Ask the user "yes" or "no" questions, and determine subsequent activities based on the user's responses.
Common properties
These properties are common to all to activities in Playbooks.
| 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: Select 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: Select Show additional options to see this field. |
Questionnaire
- Add questions for agents to respond to,
- Edit existing questionnaires.
Inputs
Many of these inputs are common to activities in Playbooks.
| Input | Type | Description |
|---|---|---|
| Assignment Group for this Process Step | Reference.Group [sys_user_group] | Assignment group allowed to perform this playbook activity. If you don't set any values for Assignment Group or Assigned To, any user can read and edit the collected
data. The Assignment group and Assigned to fields limit who has access to do so. To specify only individual users, use the Assigned To field. The same users do not need to be specified in both
fields. Note: By default, these fields are mapped to the Assignment Group and Assigned To fields of the trigger record. This means that users assigned to work on the
parent record have access to submit, view and edit the collected data by default. |
| Assigned to this Process Step | Reference.User [sys_user] | User allowed to perform this playbook activity. If you don't set any values for Assignment Group or Assigned To, any user can read and edit the collected data. The
Assignment group and Assigned to fields limit who has access to do so. To specify only individual users, use the Assigned To field. The same users do not need to be specified in both
fields. Note: By default, these fields are mapped to the Assignment Group and Assigned To fields of the trigger record. This means that users assigned to work on the
parent record have access to submit, view and edit the collected data by default. |
Outputs
| Output | Type | Description |
|---|---|---|
| Record | Reference.Flow Data | Reference to record containing collected data. Use the pill-picker to dot-walk to to see all collected data. To learn more about the pill-picker, see Dot-walking examples. |