Conditions by script - AskiaDesign Assistant

Conditions by Script

Note: the original version of AskiaScript (version 1) has been superseded by AskiaScript 2.0. For backwards compatibility with existing projects, AskiaScript 1.0 is still supported, but for all new scripting you should use AskiaScript 2.0, which is both considerably easier to use and more powerful. The following section of the Assistant describes AskiaScript 2.0. If you are working with an older project that includes AskiaScript 1 code, please refer to the Appendix on AskiaScript version 1.

The conditions by script feature enables you to define sophisticated routing instructions. You can set up:

Simple conditions outside of the simple script builder interface;

Simple conditions based on a variable other than the Start variable;

Conditions using AskiaScript functions;

Conditions based on more than one variable.

Note: For more information on creating scripts, see custom routing conditions in AskiaScript.

Creating a condition by script

To create a condition by script:

When editing your routing instruction, click

Click

to open the condition dialog, where you define the condition. The interface to define the condition appears as follows:

Use the condition dialog as described below.

In the top panel, type your script. Askiascript keywords are colour-coded to aid comprehension of the script.

In the left-hand panel at the bottom, you can obtain help about AskiaScript keywords; to do so, simply click the keywords you want to know about. You can quickly find a keyword in the list by typing it in the search keywords... box.

In the right-hand panel, you can select responses in the current question in order to add them to your condition. You can search the response list for a specific response by entering the response text in the search responses... box.

Runtime debug: Select this option to automatically start and show the debug mode when you test the questionnaire. This will happen in all test modes (fast, screen or web). Note: when you close the questionnaire and reopen it, this option is always cleared.

Compile: Click this button to validate your condition's syntax. Note: In no way does this validation imply that askiadesign has verified the condition's logic (i.e. whether or not your script will have the intended effect); it merely tests whether your condition adheres to the syntactic rules of the askiascript language.

Note: If you are familiar with the syntax of your condition, you can type it directly into the entry dialog. If you would like to add comments in your condition, use a single quotation mark before each comment, for example 'this is a comment.

Note: you can drag questions from the question list into the condition dialog, saving the need to type the question name.

Note: you can enter Unicode characters as part of your script.