batch element

The batch element allows a group of Inquisit scripts to be run in sequence.

Syntax

<batch>
/ directory = "location"
/ file = "path"
/ groupassignment = assignment
/ groups = (integer, integer, integer, ... of modulus)
/ onscriptbegin = value
/ onscriptend = value
/ requiredpermissions = (permission, permission, ...)
/ selectionmode = selectionmode or expression
/ sessions = (integer, integer, integer, ... of modulus)
</batch>

Properties

batch.currentgroupnumber
batch.currentscript
batch.directory
batch.file
batch.groupcount
batch.name
batch.typename

Functions

None.

Remarks

The batch element should be defined in a separate script file. The batch element may not include own script file in its list of files.

Examples

The following batch runs three scripts files in sequence. The files are located in the same directory as the batch file.

<batch>
/ file="script1.iqx"
/ file="script2.iqx"
/ file="script3.iqx"
</batch>

The following batch runs three scripts files in different orders for even and odd numbered group ids. The files are located in the same directory as the batch file.

<batch>
/ groups=(1 of 2)
/ file="script1.iqx"
/ file="script2.iqx"
/ file="script3.iqx"
</batch>

<batch>
/ groups=(2 of 2)
/ file="script3.iqx"
/ file="script2.iqx"
/ file="script1.iqx"
</batch>

The following batch runs one of three depending on the session number. The files are located in the same directory as the batch file.

<batch>
/ sessions=(1 of 3)
/ file="phase1.iqx"
</batch>

<batch>
/ sessions=(2 of 3)
/ file="phase2.iqx"
</batch>

<batch>
/ sessions=(3 of 3)
/ file="phase3.iqx"
</batch>