Formula: IS_SIMULATED

This article will explain provide details and examples of this formula syntax usage

Background

This formula syntax is used when you are trying to perform actions in your programming if it has been created using the Test Data Generation feature. Some reasons/examples you would use this are:

• If you want to conditionally set questions/variables for simulated test data
• If you want to skip specific questions, variables and or pages such as third party API calls
• Skipping links to external exercises which require leaving CMIX and coming back

Formula Syntax

IS_SIMULATED

• This formula returns a Boolean value "TRUE" or "FALSE"
• This allows you use logic to program your survey to account for Test Data Generation. 
• This formula is NOT AVAILABLE for use in Data Download Filters 

Examples

You can reference this formula in a number of ways. Below are some examples:

Example 1: 

You want to skip a specific question and/or page because it would route you outside of CMIX to an external exercise which you cannot generate test data for. For this reason you want to skip those specific portions so you can generate completes.

You can use any of the following to check if the data has been run using the Test Data Generation feature:

• You can check if the data was simulated using:
  Only if: IS_SIMULATED == TRUE
  Action: Skip
• An alternate method would be to simply say the following because it will return "TRUE" if it is simulated:
  Only if: IS_SIMULATED
  Action: Skip

You can use any of the following to check if the data has not been run using the Test Data Generation feature:

• You can check if the data was NOT simulated using:
  Only if: IS_SIMULATED == FALSE
  Action: Skip
• An alternate method would be to simply say the following because it will return "FALSE" if it is NOT simulated:
  Only if: !(IS_SIMULATED)
  Action: Skip