Survey Definition Event
About Survey Definition Events
Survey Definition Events allow you to trigger Workflows based on changes to a project’s status. You can base your event on a survey being published, activated, or closed.
Qtip: To use this feature, you must be a Brand Administrator.
Example: For example, I can create a workflow so that I am notified every time a user in my license publishes a survey.
Setting up a Survey Definition Event
- Click the navigation menu in the top left corner.
- Choose Workflows.
Qtip: You cannot use this event in the Workflows tab of an individual survey.
- Click Create a workflow.
- Select Started when an event is received.
- Select the Survey Definition Event.
- Select Survey Definition Event.
- Click Next.
- Choose the survey status change that causes the workflow to trigger.
You may choose multiple statuses. Your options include: - Click Finish.
- Click the plus sign ( + ) and then Conditions to build the conditions for the event to trigger. See Setting Conditions for Survey Definition Events for more information about the conditions available for this event.
Example: In this example, I want the workflow to trigger for only one specific survey, which is indicated by the Survey ID condition.
Qtip: If you do not set conditions for this event, then the workflow will trigger any time a survey in your brand undergoes your selected survey status change. - Click the plus sign ( + ) and then Task to add a task to your workflow.
- Choose the task(s) you want to happen when the workflow is triggered. Visit choosing tasks for more information about each available task.
Example: For example, I can use an email task to automatically send my teammate an email letting them know that the survey data is ready to analyze. - Enable your workflow by clicking the On/Off toggle.
Qtip: Visit the Reporting & History tab if you need to troubleshoot your workflow or see a log of when the workflow fired.
Setting Conditions for Survey Definition Events
Usually, you will want to include conditions as part of your workflow. If you do not include conditions, then the workflow will trigger for any status change for any survey in your brand. When creating conditions for a survey definition event, you can base your conditions on the following fields:
- Survey ID: This is the Survey ID for the survey that should trigger the workflow.
Qtip: You can only use this condition for projects that have a survey ID beginning in SV_.
- Survey Data: Create a condition based on various survey data fields, such as when the survey was last modified or a survey owned by a specific user.
- Survey Name: The survey’s name.
- Survey Status: The survey’s status.
- Owner ID: The user ID of the user who owns the survey.
- Question Count: The number of questions in the survey.
- Last Modified: The time when the survey was last edited.
- Organization ID: The ID of the organization that owns the survey.
- Creator ID: The user ID of the user who originally created the survey.
- Last Activated: The time when the survey was last activated.