pages attribute

The pages attribute specifies the sequence of pages in a survey.

Member of

Syntax

/ pages = [pagenumber, pagenumber = pagename; pagenumber-pagenumber = selectmode(pagename, pagename,...); pagenumber, pagenumber-pagenumber = pagename]

Parameters

pagenumber

A non-negative integer specifying the page number.

pagename

The name of a page defined elsewhere in the script to be run in this survey.

selectionmode

One of the following values:

Value	Description
noreplace	Randomly selects without replacement which page in the group to run.
noreplacenorepeat	Randomly selects which page in the group to present without replacement and without selecting any single page consecutively.
replace	Randomly selects with replacement which page in the group to run.
replacenorepeat	Randomly selects which page in the group to present with replacement and without selecting any single page consecutively.
sequence	Runs each page in the group.

Remarks

The integers to the left of the equal signs represent ordinal positions within the sequence of pages. Pages can be directly assigned to a position in the sequence using the equals sign. A page can be simultaneously assigned to multiple positions by separating the position numbers with commas (equivalent to "and") or dashes (equivalent to "through"). All page numbers in the survey must be assigned to a page.

Examples

The following survey consists of 3 survey pages presented in fixed order:

<survey>
/ pages=[1=page1; 2=page2; 3=page3]
</survey>

The following survey presents 4 pages in random order.

<survey>
/ pages=[1-4=noreplace(page1, page2, page3)]
</survey>