<term> element is used to terminate participants. Use the
cond attribute to create condition logic that will terminate participants if evaluated to "True".
<term cond="Q1.r6">Q1: Selected "None of the above" at Q1</term>
Use legible, descriptive text within the body of the
<term> element that shows up in the "Terminates" tab of the Response Summary. This helps you better understand why a participant was terminated.
<term> element has access to the following attributes. Click each attribute to read about it in detail.
||string||Python expression that must be "True" in order to execute.|
||string||Checks for duplicate data and terminates if found (cannot be used with
Note: This attribute is not usable in surveys with
||bool||Include in incidence count (default is 1).|
||slist||Comma-separated list of markers to set before terminating.|
||string||Unique symbolic identifier (only required if using
cond - Set the Terminate Condition
cond attribute controls whether or not the participant should terminate. If the condition evaluates to "True", the
<term> element will execute and the participant will be terminated.
For example, see below for a survey that is fielded for females only.
<radio label="Q1" optional="0"> <title>Are you...</title> <row label="r1">Male</row> <row label="r2">Female</row> </radio> <suspend/> <term cond="Q1.r1">Q1: Male participant</term>
dupeCheck - Terminate Based on Duplicate Values
Note: This attribute cannot be used in surveys with
dupeCheck attribute will terminate if the value provided already exists within the dataset. This includes qualified, terminated, and partial participants.
In the example below, if anyone enters an email address that has already been provided (i.e., duplicate e-mail address) at Q1, even if terminated or partial, then they will be terminated.
<text label="Q1" optional="0"> <title>Please enter your email address below:</title> </text> <suspend/> <term label="Email_Check" dupeCheck="Q1.val">Q1: Duplicate Email Address</term>
You can also use the below code to terminate anyone who enters the survey with an
extraVariable that has already been seen.
<term label="Duplicate_ID" dupeCheck="ID" incidence="0">ID Check: Duplicate ID</term>
label attribute can only be used when working in the XML Editor as it is incompatible with the Survey Editor.
incidence - Control Incidence Counts Based on Termination
incidence attribute controls whether or not to record the terminated participant in the incidence count.
incidence="0" is specified, the participant will not appear in the incidence calculation.
Note: The incidence calculation is:
(qualified + overquote) / (click-through - partial - excluded).
<term cond="QDisclaimer.r2" incidence="0">Disclaimer: Disagreed to disclaimer</term>
markers - Set a Marker When Terminated
makers attribute enables you to set additional markers when terminating the participant.
<term cond="Q1.c1.all" markers="straightliner,Q1_SL">Q1: Straightlined at Q1</term> <term cond="(timeSpent() < 300) and not gv.isSST()" markers="speeder,lt_5minutes">Speeder: Less than 5 minutes</term>
label - Set the Terminate Name
label attribute is only required if the
dupeCheck attribute is being used. This is the unique identifier for the
<term dupeCheck="Email.val" label="Email_Checker">Email: Duplicate Email Entered</term>