How do I prevent scripts from running in an Automated Test Run (ATR)?

This script allows you to skip scripts that are causing an Automated Test Run (ATR) to fail, so that you can generate ATR test data for your study.

Example

A common example of the ATR failing would be for questions that have specific validation requirements such as email address or postal/zip code, which are sometimes implemented using scripting. These scripts will hide questions and scripts that have the potential to cause the ATR to fail; this will allow you to generate your ATR data.

When running ATR without skipping some scripts, you would receive the ATR error:
"The study has some validations on workflow step "Question Name" 1: Please enter one response only."

Detailed Steps

To prevent scripts from running during an ATR, follow these steps:

1. Copy and paste the script below into Notepad or a similar text editing tool.
2. Copy and paste the script(s) that needs to be hidden from the ATR into the script in Notepad:
3. From the Surveys app, open the power survey and go to Power Survey Authoring.
4. Click the Questionnaire tab of your study.
5. Navigate to the question that contains the script in the Questionnaire tree.
6. In the Scripting section of the question, click Edit Scripts. 
7. Copy the script(s) that need to be hidden from the ATR.
8. Paste the script(s) that need to be hidden from the ATR into the script in Notepad so that it replaces the text: “//YOUR SCRIPT GOES HERE”
9. Save the completed script in Notepad.
10. Navigate to the location of the script in the Questionnaire tree.
11. Copy and paste the completed script back into its original location. Example: On Load or On Validate section of a question.
12. Click Save.
13. Click Validate.

Script

/*

Script Name: How to prevent scripts from running in an Automated Test Run (ATR)?

To ensure your script works as expected, always copy the original script from the script library found in the support portal. Failure to use the most up to date script from the script library may cause unexpected results. 

*/

// Prevents script from running during an ATR.
if ( !IsATR){
// YOUR SCRIPT GOES HERE
}

More Information

Read this article to learn more about Testing Your Study.