Run Generate Conditions
Use Specify Condition when a Run generate pass needs named scenarios or fixed answer overrides. Leave it empty to generate the default simulation path.
The Run dialog’s Sample size is always the total number of generated rows. Scenario count and weight only decide how those rows are distributed across scenarios.
Schema
Specify Condition accepts a JSON array:
[
{
"name": "qualified-path",
"count": 20,
"overrides": {
"SQ1": "1",
"Q3": ["a", "c"]
}
},
{
"name": "fallback-path",
"weight": 2,
"overrides": {
"SQ1": "2"
}
}
]
| Field | Required | Purpose |
|---|---|---|
name | Yes | Scenario name shown in Run generate diagnostics and summaries. |
count | No | Repeat hint for this scenario. It does not replace Sample size. |
weight | No | Weight hint used when count is not present. Rounded to a non-negative repeat count. |
overrides | Yes | Answers to prefill by export variable name before the simulator completes the remaining flow. |
Sample size precedence
If Sample size is 100, Run generate creates 100 rows even when scenario counts add up to a different number.
[{ "name": "only-one", "count": 1, "overrides": { "SQ1": "1" } }]
The example above still creates 100 rows. The single scenario is used as the distribution hint for those rows.
If every scenario expands to zero repeats, Run generate falls back to the default scenario behavior.
[
{ "name": "disabled", "count": 0, "overrides": { "SQ1": "1" } },
{ "name": "also-disabled", "weight": 0, "overrides": { "SQ1": "2" } }
]
Override values
Use the same exported variable names that appear in response/download data.
- Single choice: provide one option value.
- Multi choice: provide an array of option values.
- Number: provide a number or numeric string.
- Text/open-ended: provide a string.
- Date: provide the date string expected by the question.
Run generate validates override variables against the saved Test survey source. Invalid JSON blocks the run and shows a diagnostic before any rows are generated.
Notes
- Specify Condition affects only Run generate simulation data.
- It does not change Survey Link response collection.
- It does not change response export variables or storage contracts.