Pular para o conteúdo principal

FV Decipher Support

Todos os tópicos, recursos necessários para FV Decipher.

Base de Conhecimento da FocusVision

Elements and Attributes

Elements are obsolete and should no longer be used.

1:  Overview

The following is a list of all elements and attributes available in the system. Many of these elements and attributes are no longer used or not within best practices, so please use this page as a portal to the correct information. Click on each non-obsolete element to learn more about its application and syntax.

2:  Elements

CELL

Base class for row, columns and choices

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
aggregate bool
1
Do aggregate calculation on this cell?
alt string

              
Alternate short text for this group
amount int
0
Total/sum count
averages bool
1
Does this cell participate in average calculation?
chartText string

              
Text to display on public charts
cond string

              
Condition for displaying
dataRef string

              
Load data from this column
eid string

              
External source identifier
exclusive bool
0
If true, no other option can be selected with this one
extraError bool
1
Display an error if extra information entered but corresponding
field not checked
groups slist

              
Groups this cell belongs to. The first group is primary.
label string

              
Symbolic name for this element
okUnique bool
0
Item can be selected twice when uniqueness is required
open bool
0
This row/column requires open-ended entry if selected
openOptional bool
0
If 1, data does not have to be entered in optional field
openSize int
10
Number of character in open-ended input box
optional bool
0
Answers can be left out
percentages bool
1
Show percentages here
randomize bool
1
(new default value)
range string

              
Range for Number questions
size int
-1
Size for text/number questions
value long
-1
Numeric value for qualitative data
verify string

              
Verifiers

ELEMENT

A basic entity in the HTML. Each Element has an Args attribute which specifies the allowed arguments, on per line. (e.g. argname: description)

(Inherits attributes from OBJECT class)

Attribute Type Default Description
builderHint string

              
Builder can set this to anything
cmsEditable bool
1
Can be edited in change management
disabled bool
0
This item will not be displayed
id string

              
ID for builder
looprows string

              
Expand only for these loop rows (comma delimited)
mls iset

              
Languages to show this in
mode string
all
Display element in which mode?
onLoad string

              
Code to execute on loading the survey, mutating the element
randomize int
0
Shuffle item inside a Random tag?
style string

              
This name will be prepended when searching for styles for this element
translateable bool
1
Allow element to be translated
where iset
survey,report
Display this element where?
Value must be zero or more of notdp,survey,report,summary,none,
execute,data

ALERT

When completing survey, notify some emails about what happened

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
alert_owner string

              
 
allowedUsers string
ALL
 
body string

              
 
days string

              
 
emails string required  
label string required  
link bool

              
 
manager string

              
 
marker string

              
 
owners string

              
 
qns string

              
 
reminder bool

              
 
sender string
nobody@decipherinc.com
 
subject string

              
 
threshold string

              
 

ARG

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
datatype string required DataType of argument
name string required Name of argument

BLOCK

Unifies If and Random

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
randomizeChildren bool
0
Randomize our children like the <random> tag
readonly bool
0
Indicates if this block can be edited in Builder

CASE

Resources for translation of styles files etc.

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
cond string required Displayed if...
label string required Label of this resource

CD

Custom data element; can contain any attribute

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
type string required Classification of this pieces of data

CHOICE

A selectable entry inside a SELECT tag

(Inherits attributes from CELL class)

Attribute Type Default Description
aggregate bool
1
Do aggregate calculation on this cell?
alt string

              
Alternate short text for this group
amount int
0
Total/sum count
averages bool
1
Does this cell participate in average calculation?
chartText string

              
Text to display on public charts
cond string

              
Condition for displaying
dataRef string

              
Load data from this column
eid string

              
External source identifier
exclusive bool
0
If true, no other option can be selected with this one
extraError bool
1
Display an error if extra information entered but corresponding field not checked
groups slist

              
Groups this cell belongs to. The first group is primary.
label string

              
Symbolic name for this element
okUnique bool
0
Item can be selected twice when uniqueness is required
open bool
0
This row/column requires open-ended entry if selected
openOptional bool
0
If 1, data does not have to be entered in optional field
openSize int
10
Number of character in open-ended input box
optional bool
0
Answers can be left out
percentages bool
1
Show percentages here
randomize bool
1
(new default value)
range string

              
Range for Number questions
size int
-1
Size for text/number questions
value long
-1
Numeric value for qualitative data
verify string

              
Verifiers

CODE

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
builderHint string

              
Builder can set this to anything
cmsEditable bool
1
Can be edited in change management
disabled bool
0
This item will not be displayed
id string

              
ID for builder
looprows string

              
Expand only for these loop rows (comma delimited)
mls iset

              
Languages to show this in
Value must be zero or more of english,danish,french,italian,spanish,japanese,portuguese,german,
chinese,korean,malay,dutch,simplifiedchinese,traditionalchinese,swedish,hebrew,russian,
polish,arabic,uk,aus,vietnamese,indonesian,turkish,canadian,czech,hungarian,romanian,
slovak,thai,spanish_latin,spanish_south,ukrainian,norwegian,english_ca,spanish_mexico,
greek,albanian,finnish,french_belgium,dutch_belgium,english_india,english_china,english_hk,
english_tw,german_austria,simplifiedchinese_my,simplifiedchinese_sg,malay_sg,
traditionalchinese_tw,tagalog,hindi,kannada,tamil,english_sg,punjabi,english_nigeria,
arabic_qatar,arabic_saudiarabia,arabic_uae,estonian,latvian,lithuanian,samoan,tongan,
afrikaans,slovenian,arabic_morocco,arabic_egypt,arabic_lebanon,english_ireland,bulgarian,
croatian,serbian,spanish_brazil,spanish_argentina,spanish_chile,spanish_peru,
spanish_venezuela,spanish_colombia,spanish_ecuador,english_za,english_my,english_id,
spanish_eu,burmese,german_lu,french_lu,english_g1,english_g2,english_g3,english_g4,none
mode string
all
Display element in which mode?
onLoad string

              
Code to execute on loading the survey, mutating the element
randomize int
0
Shuffle item inside a Random tag?
style string

              
This name will be prepended when searching for styles for this element
translateable bool
1
Allow element to be translated
where iset
survey,report
Display this element where?
Value must be zero or more of notdp,survey,report,summary,none,execute,data

COL

A vertical entry in a question

(Inherits attributes from CELL class)

Attribute Type Default Description
favorite bool
0
Special favorite management code
legend ienum
default
Location of legend text
Value must be zero or more of none,both,top,bottom,default
radio bool
0
Make this checkbox a radio box
validateCell string

              
 
validateCol string

              
 

COMMENT

Display some formatted hint to the user

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
final bool
0
Stop survey after displaying
label string

              
Symbolic name for this question

CONDITION

Declare a named condition

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
label string required Condition label

DATASOURCE

Pull in data from an external file

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
datasourceKey string required Column label in the input file
filename string required Filename with data
label string required Symbolic name
normalizeKey enum
lower
Smash case before comparing?
Value must be one of none,lower
ourKey string required Python expression that is the merge key
storedVariables string

              
List of known variables at last access time
survey string

              
Survey where data was originally fetched from
title string

              
Optional human description

ELSE

Else can only be used inside an If. If the if-check fails, the part of the If after the else will be executed.

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
builderHint string

              
Builder can set this to anything
cmsEditable bool
1
Can be edited in change management
disabled bool
0
This item will not be displayed
id string

              
ID for builder
looprows string

              
Expand only for these loop rows (comma delimited)
mls iset

              
Languages to show this in
Value must be zero or more of english,danish,french,italian,spanish,japanese,portuguese,german,chinese,korean,malay,
dutch,simplifiedchinese,traditionalchinese,swedish,hebrew,russian,polish,arabic,uk,aus,vietnamese,indonesian,turkish,
canadian,czech,hungarian,romanian,slovak,thai,spanish_latin,spanish_south,ukrainian,norwegian,english_ca,
spanish_mexico,greek,albanian,finnish,french_belgium,dutch_belgium,english_india,english_china,english_hk,
english_tw,german_austria,simplifiedchinese_my,simplifiedchinese_sg,malay_sg,traditionalchinese_tw,tagalog,hindi,
kannada,tamil,english_sg,punjabi,english_nigeria,arabic_qatar,arabic_saudiarabia,arabic_uae,estonian,latvian,lithuanian,
samoan,tongan,afrikaans,slovenian,arabic_morocco,arabic_egypt,arabic_lebanon,english_ireland,bulgarian,croatian,
serbian,spanish_brazil,spanish_argentina,spanish_chile,spanish_peru,spanish_venezuela,spanish_colombia,
spanish_ecuador,english_za,english_my,english_id,spanish_eu,burmese,german_lu,french_lu,english_g1,english_g2,
english_g3,english_g4,none
mode string
all
Display element in which mode?
onLoad string

              
Code to execute on loading the survey, mutating the element
randomize int
0
Shuffle item inside a Random tag?
style string

              
This name will be prepended when searching for styles for this element
translateable bool
1
Allow element to be translated
where iset
survey,report
Display this element where?
Value must be zero or more of notdp,survey,report,summary,none,execute,data

EXEC

Execute arbitrary Python code

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
codecheck bool
1
Do code-checking
lock bool
0
Lock while executing
when set
survey
When to run this
Value must be zero or more of survey,virtualInit,finished,finishedPost,init,sqlTransfer,sqlTransferInit,flow,load,postKeywordCoder,
started,returning,verified,virtual

EXIT

Sending the respondent to a URL or displaying text upon completion

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
timeout int
0
redirect to URL after displaying finish page for that many seconds
url string

              
redirect instead of printing anything

EXTRA VARIABLES

 

(Inherits attributes from ELEMENT class)

Attribute Type Default Description

FINISH

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
now bool 0 Ends survey after page submit or immediately

GOTO

Transfer execution to another question

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
target label required Destination of GOTO

GROUP

Define a group for use in the report or survey

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
aggregate bool
1
Calculate aggregate information
alt string

              
Alternate short text for this group
groups slist

              
Groups this group belongs to
label string required Symbolic name for the group
percentages bool
1
Display percentages
randomize int
1
(new default value)

HTML

Allows some HTML code to be inserted into the survey, either code specified directly in the XML file or loaded from the survey's directory.

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
altlabel string

              
Alternate label
final bool
0
Stop survey after displaying
label string

              
Symbolic name
source string

              
Source file, relative to the survey directory. If not specified, the contents of the tag are used.

IF

Evaluate some code, and if it is true, execute the children of this tag. The condition is a Python expression. However, the strings gt, lt, le, ge will be replaced by > < <= and >= respectively, to allow for easier usage of comparisons which would otherwise have to be escaped in the XML code

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
codecheck bool
1
Do code-checking

LABEL

Placeholder for GOTO target

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
label string

              
Symbolic name for this question

LANGUAGE

 

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
name string required Name of the language
value string required Value to match against
var string required Variable to match against

LANGUAGES

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
default string

              
Default language if none match
var string

              
If set, read language directly from this variable

LOOP

(Inherits attributes from ELEMENT class)

i

Attribute Type Default Description
builderSource string

              
Source question (used by builder only)
count int
0
Number loop rows to include
label string required Identifier
randomizeChildren bool
0
Randomize loop row order?
suspend bool
1
Add suspend at the end?
title string

              
Informational title
translateVars slist
*default*
List of variables to be translated
vars slist

              
Template variables

LOOPROW

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
cond string

              
Optional condition (passed to block)
label string required Local identifier

LOOPVAR

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
name string required Name of loopvariable

MARKER

Set a marker

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
name string required What marker to set

NET

Grouping of certain values in a question

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
indices slist

              
Indices of items inside to include
label string

              
Label of this Net
labels slist

              
Labels of items inside to include
pos enum
above
Location of net relative to items
Value must be one of above,below
values slist

              
Values of items inside to include

NOANSWER

 

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
alt string

              
Alternative report text
cond string

              
Condition for displaying
label string required Symbolic name for this element

NOTE

Create a note in a survey, similar to a comment in xml

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description

NOTIFY

Email notification about meeting certain thresholds

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
email slist required Who to send to
threshold int

              
Threshold to be met
title string

              
Description sent in email
var string

              
Condition

PIPE

Display text based on certain conditions

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
capture string
yes
Capture pipe selection?
label string required Label of this pipe
title string

              
Title for generated question

QUOTA

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
doit bool
0
Really support multi/cross table
fieldReport slist

              
Show only to these restricted sources
filename string
quota.xls
File to load
label string

              
Symbolic name for this quota
multi slist

              
Cross-survey quota
norandom bool
0
Disable quota randomization
overquota label
noqual
Destination if overquota
sheet string

              
Sheet to use

RANDOM

Randomly select order for the questions to be displayed within this element

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
count int
0
Number of questions to display (per default all)
countVisibleOnly bool
0
The @count takes in account only things with true conditions
label string

              
Symbolic name

RES

Resource for translation of styles files etc.

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
label string required Label of this resource

ROW

A horizontal entry in a question

(Inherits attributes from CELL class)

Attribute Type Default Description
autofill string

              
Fill in this row if...
colLegend bool
0
Re-display top legend before this row
legend ienum
default
Location of legend text
Value must be zero or more of none,both,left,right,default
rightLegend string

              
Alternate legend on the right
validateCell string

              
 
validateRow string

              
 

SAMPLESOURCE

 

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
closed bool
0
 
completed string

              
Completed error text
disableBrowserDupes bool
0
Suppress normal cookie dupe check here
eid string

              
External source identifier
inuse string

              
ID in use error text
invalid string

              
Invalid sample source message
list string required List value to match this sample source
marker string

              
 
title string

              
 

SAMPLESOURCES

 

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
completed string

              
Completed error text
default string

              
Default list= value if not specified
inuse string

              
ID in use error text
invalid string

              
Invalid sample source message (default for all sources)

STYLE

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
after label

              
Do not display until this question has been passed
before label

              
Display only until this question has been passed
cols slist

              
Apply only for these cols
cond string

              
Condition to apply
copy string

              
Take defaults from this style
label string

              
Label of style
mode ienum
instead
(new default value)
Value must be zero or more of before,after,instead
name string

              
Name of style to override
rows slist

              
Apply only for these rows
with labellist

              
Display only when these items are shown
wrap ienum
none
Wrap in something before outputting
Value must be zero or more of none,ready

STYLEVAR

 

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
_where ienum
builder
Where to display in builder?
Value must be zero or more of builder,none,adv
desc string

              
Longer human-readable description used as tooltip
name string required Style variable name (with full namespace
placeholder string

              
placeholder value for builder input
posttext string

              
text to place after builder input
pretext string

              
text to place before builder input
tag ienum
any
Restrict to only this tag type?
Value must be zero or more of any,row,col,choice,question,survey
tags iset
default
not used
Value must be zero or more of question,row,col,choice,default
title string

              
Short title to use in builder
type ienum
string
variable type
Value must be zero or more of int,bool,string,text,url,size,area,css,enum,
color
values string

              
Comma-separated list of possible values

SURVEY

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
agents enum
normal
Use extended agents table?
Value must be one of normal,none,full
allowDupe bool
0
Allow multiple submissions by the same user
allowedCountries slist

              
Limit access only to these countries
alt string

              
Alternative (report) name
alternatecb bool
0
Use alternate CB layout
alwaysSaveData bool

Set to allow data load at page submission rather than survey completion
autoAddVariables bool
0
Automatically place new variables to layouts in the 'right' place
autoRecover bool
0
Automatically recover partials?
autobase enum
none
Automatic sbase application
Value must be one of none,empty,all
autosave bool
1
Automatically save progress of users
autosaveKey slist
session
Key for retrieving autosave
blankValue string

              
Blank value output in tab-delimetered files
browserDupes set
default
Handling dupes detected by browser
Value must be zero or more of default,cookie,safe,strict
builderCompat int
0
Builder compatibility level
builderCompatible bool
0
Whether or not this survey is readable by Builder
cache bool
0
Do style caching
capture bool
0
capture all incoming/outgoing data
capturePreciseTime bool
0
Capture precise timing info per page using Javascript
cbUseFwidth bool
0
Use fwidth for extraVariables in CB
checkboxBlankIfZero bool
0
Apply the blankIfZero option to all checkboxes
clientFeatures iset

              
OBSOLETE
Value must be zero or more of ppt,pdf,xsi,charts
clients slist

              
OBSOLETE
closed bool
0
Survey closed for further participants
codecheck bool
0
Do code-checking
compat int
0
Survey compatibility level
cookie bool
0
Force session cookies
createNets bool
0
Create virtual questions for all nets
createShown bool
0
Create a QQ_shown virtual for each question
dashboard string

              
Questions to be displayed in the dashboard
dashboardInclude string
include.dat
Include filename read in by the dashboard
dashboardIncludeKey string
source
What variable to use to merge include.dat records
debug set

              
Special debug
Value must be zero or more of autopop,nets,tv
desktopNotAllowedMessage string

              
Message to be displayed if mobile devices are not allowed
deviceNotAllowedMessage string

              
Message to be displayed if mobile devices are not allowed
displayOnError ienum
bad
What questions to display if any have error
Value must be zero or more of bad,all
emailInvitations int
0
Number of sent out email invitations, used to measure incidence count
endUser string

              
End user whose folder this survey should be placed in
extraVariables slist
source
Extra incoming CGI variables that are saved in the results file
featurephoneNotAllowedMessage string

              
Message to be displayed if mobile devices are not allowed
fingerprint set
none
Capture what fingerprinting information?
Value must be zero or more of none,all,etag,browser,flash,html5
fixedWidth enum
lax
Size of Fixed-Width fields
Value must be one of lax,tight
flatKey slist
record
Key for flat oe export
flatShowEmpty bool
1
Show empty lines in flat OE export
forbiddenCountries slist

              
Disallow access from these countries
forceDataCharset string

              
Downloaded files will use this charset
fullService bool
0
Only staff can edit this survey in builder
fwoe set

              
OE data shown in FW
Value must be zero or more of text,textarea,other
geoip set

              
Auto-generate geoIP question?
Value must be zero or more of all
imagePrefix string
record
Prefix before filenames when downloading data
indexed slist

              
extra variables indexed
lang string
english
Default language of the survey
loadData string

              
Load previous data from this extraVariable
loggedInCanSubmit bool
0
Logged-in users can submit data
markerTimeout int
900
Timeout before marker is released
minimumSegment int
0
Hide segments below this size
mobile enum
none
Level of compatibility with mobile devices
Value must be one of compat,mobileOnly,noMobile,ignore,none
mobileDeviceTerm string

              
NOT IMPLEMENTED, DO NOT USE (Term survey if circumstance is true)
mobileDevices set

              
Allowed mobile devices
Value must be zero or more of desktop,smartphone,featurephone,tablet,mobile
mobileOnlyMessage string

              
Message to be displayed if mobile devices are not allowed
name string required Name of the survey
namingScheme string
%L%R%C%H %L%R%C%Hoe
Naming format
newStyle bool
0
load nstyle and nstyle.local files as well, apply new style system
newVirtual bool
0
Use new virtual objects
noMobileMessage string

              
Message to be displayed if mobile devices are not allowed
oldProgress bool
0
Enable silly old progress system
onReport string

              
Code to run before running any report
otherLanguages slist

              
Additional languages
pipeAltLabels bool
0
Pipes use altlabels
pipeErrors bool
1
Pipe errors are fatal
precision int
2
Number of digits after decimal point
profile bool
0
Profile virtual questions
progressOnTop bool
1
Display progress bar on top of survey rather than before footer
project string

              
Project name, if non-default
projectType enum
beacon
Email only or Decipher project
Value must be one of beacon,info,email,spss
refcheck enum
default
Check code references
Value must be one of yes,no,default
requireLabels set
none
Where are labels required?
Value must be zero or more of none,all
requires set
default
Force surveys to have these browser technologies turned on
Value must be zero or more of javascript,default
sampleSource string

              
Sample sources, one per line
sbase string

              
Sbase auto-translations
scaling int
3
Max process scaling
secure bool
0
ensure all requests happen via https
setup set

              
Boilerplate setup
Value must be zero or more of quota,term,time,decLang
slowDashboard bool
0
Do not use qtime to get field report completion time data
smartphoneNotAllowedMessage string

              
Message to be displayed if mobile devices are not allowed
spssSimpleCheckbox bool
0
Use simple value labels for SPSS
sql bool
0
Store data in SQL
sqlRefreshTime int
3600
Period between refreshing SQL database
sqlTarget string

              
Where to save SQL data
sssoe string

              
OBSOLETE
state enum
none
Survey lifecycle
Value must be one of dev,testing,live,closed,none
tabletNotAllowedMessage string

              
Message to be displayed if mobile devices are not allowed
taboe set
text,textarea,other
OE data shown in TD
Value must be zero or more of text,textarea,other
trackCheckbox bool
0
Track visibility of checkbox cells
trackVars set
none
Track visibility of certain variable types
Value must be zero or more of checkbox,none
translate enum
no
Translation level
Value must be one of no,yes,audit
truesample set

              
Generate what TS checks?
Value must be zero or more of real,unique,qualified,engaged,off
type string

              
Use a different class for representing the survey
unique string

              
Require this extra variable to exist and be unique
uniqueOnly bool
0
Can unique= run without an invited.txt file?
unmacro bool
1
Survey can be saved
users slist

              
Additional people allowed to access the survey
uses slist

              
Load style library items
weights string

              
Weights and weight counts
zeroPad bool
0
Pad with zeros in fixed-width outputs

SUSPEND

After encountering this element, temporarily suspend execution of the survey

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
url string

              
Redirect to this URL instead of continuing

TERM

Terminate if condition is true

(Inherits attributes from CONTROL ELEMENT class)

Attribute Type Default Description
dupeCheck string

              
 
incidence bool
1
Include in incidence calculations
label string

              
 
markers string

              
Set these markers when terminating

VAR

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
database string

              
 
eid string

              
 
filename string

              
 
name string required Name of extraVariable
required bool
0
 
truesampleSource string

              
passed as source-id to TS
unique bool
0
 
values slist

              
Allowed values

QUESTION ELEMENT

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
adim ienum
auto
What should be the A-dimension?
Value must be zero or more of cols,rows,choices,auto
aggregate string

              
This question bases itself on data from other q
alt string

              
Alternate short text for this question
altlabel string

              
Alternate label
averages iset

              
What to show avg calc for
Value must be zero or more of cols,rows,choices,none,nosummary,summary
below label

              
Place this question below this question
blankIfZero bool
0
Blank if zero value
blankValue string
auto
blank value specific for this Q
choiceCond string

              
Condition to display a choice
choiceGroups iset
report,survey,restrict
Where are choice groups shown?
Value must be zero or more of report,survey,restrict
choiceNets iset
report,restrict
Show nets on choices where?
Value must be zero or more of report,sort,rsort,restrict
choiceShuffle string

              
Pre-defined order of items
colCond string

              
Condition to display a col
colGroups iset
report,survey,restrict
Where are col groups shown?
Value must be zero or more of report,survey,restrict
colLegend ienum
default
Default position for column legend. Overridable by legend attribute on each column
Value must be zero or more of none,both,top,bottom,default,group,beforeGroup
colLegendRows slist

              
Rows that should have addition legends on them
colNets iset
report,restrict
Show nets on cols where?
Value must be zero or more of report,sort,rsort,restrict
colShuffle string

              
Pre-defined order of items
comment string

              
Additional information displayed under the question
cond string

              
Condition for display
dataRef string

              
Load data from this column
dataSource label

              
Load data from this datasource
eid string

              
External source identifier
exec string

              
Code to execute before displaying the question
fwidth int
-1
Width in fixed-width/3S files
groupDepth int
1
Group hierarchy levels to display
grouping enum
auto
Do the elements belong together in cols, rows
Value must be one of cols,rows,auto
horizontalPercentages bool
0
Calculate percentages across
keepWith labellist

              
Display these question if this one has an error
keywordCoder bool
1
Show question in keyword coder
keywordCoderAggregate bool
0
Categorize everything at once in the KC
label string

              
Symbolic name for this question
namingScheme string

              
Label naming scheme, if non-standard
onReportBody string

              
Run this instead/before report body
open ienum
default
Location of OE input field
Value must be zero or more of default,left,right
optional bool
0
Can elements be left not filled out?
randomize bool
1
(new default value)
ratingDirection ienum
default
Does the rating follow the values or the reverse
Value must be zero or more of reverse,default
readonly bool
0
Indicates if this item can be edited in Builder
rightOf label

              
Place this question to the right of this question
rowCond string

              
Condition to display a row
rowGroups iset
report,survey,restrict
Where are row groups shown?
Value must be zero or more of report,survey,restrict
rowLegend ienum
default
Default position for row legend. Overridable by legend attribute on each row
Value must be zero or more of none,both,right,left,default
rowNets iset
report,restrict
Show nets on rows where?
Value must be zero or more of report,sort,rsort,restrict
rowShuffle string

              
Pre-defined order of items
sbase string

              
SBASE emitted in wincross
showSource bool
0
Show question source before the question
shuffle iset
none
Shuffle columns and/or rows and choices
Value must be zero or more of cols,rows,choices,groups,none
shuffleBy label

              
Adapt to the shuffled order of that question
sort iset
none
What to sort in the report
Value must be zero or more of cols,rows,choices,none,desc,asc,percentages
sortBy string

              
Label of item to sort by
sortChoices iset
none
Sort choices of the question before display
Value must be zero or more of asc,desc,survey,report,none
sortCols iset
none
Sort columns of the question before display
Value must be zero or more of asc,desc,survey,report,none
sortRows iset
none
Sort rows of the question before display
Value must be zero or more of asc,desc,survey,report,none
sql iset

              
SQL-related settings
Value must be zero or more of nosave,hide
sst bool
1
Show in SST?
title string required The displayed title of the question
tsengaged bool
1
Include in TrueSample engaged data?
type ienum
none
Question type
Value must be zero or more of rating,none
uses slist

              
Load style library items
validate string

              
Ran once for whole question
validateCell string

              
Run this code for each non-disabled cell
validateCol string

              
Ran once for each column
validateRow string

              
Ran once for each row
values ienum
none
Automatic assignment of values
Value must be zero or more of none,order
virtual string

              
Does not exist, computed dynamically

VERIFIABLE ELEMENT

An element to which verifier functions can be applied

(Inherits attributes from ELEMENT class)

Attribute Type Default Description
verify string

              
Verify functions that will be applied

CHECKBOX

Yes/No question

(Inherits attributes from QUESTION ELEMENT class)

Attribute Type Default Description
atleast int
0
If non-zero, at LEAST that many values must be selected
atmost int
0
If non-zero, at MOST that many values must be selected
exactly int
0
If non-zero, EXACTLY that many values must be selected
groupRestrict enum
none
If set, display a set of radio buttons for each group
Value must be one of none,cols
pipeMultiple string

              
Label of row to use as pipe text for multiple matches

FLOAT

Similar to number, allows entry of FP numbers

(Inherits attributes from QUESTION ELEMENT class)

Attribute Type Default Description
ignoreValues slist

              
List of values to be ignored in avg/stddev calculation
nets slist

              
Buckets for bucketization
optional bool
1
(new default value)
range string

              
Range of numbers
size int
6
Size of the input box

IMAGE

Uploadable image field

(Inherits attributes from TEXT class)

Attribute Type Default Description
displayInline bool
1
display uploaded files inline rather than as attachment

NUMBER

A set of input fields or drop-down boxes containing numbers

(Inherits attributes from QUESTION / VERIFIABLE ELEMENT class)

Attribute Type Default Description
amount int
0
If non-zero, max amount of points usable
ignoreValues slist

              
List of values to be ignored in avg/stddev calculation
nets slist

              
Buckets for bucketization
optional bool
1
(new default value)
points int
0
Number of points available in each cell
range string

              
Comma-separated list of permittable numbers
size int
0
Input size; if non-zero the elements are open text
unique bool
0
Each entry can be used only once

RADIO

Horizontal or vertical set of connected buttons

(Inherits attributes from QUESTION ELEMENT class)

Attribute Type Default Description
truesampleSurveyScore bool
0
Use this question as survey score rating question
unique bool
0
Each answer can only be selected once

SELECT

Drop-down box with a set of textual values

(Inherits attributes from QUESTION ELEMENT class)

Attribute Type Default Description
minRanks int
-1
Ranking (minimum amount to choose)
unique set
none
Require one unique choice per c/r
Value must be zero or more of none,rows,cols

TEXT

One-line text input

(Inherits attributes from QUESTION ELEMENT class)

Attribute Type Default Description
optional bool
1
(new default value)
size int
20
Size of the input box

TEXTAREA

Multi-line text input

(Inherits attributes from QUESTION ELEMENT class)

Attribute Type Default Description
height int
6
Height of the area
width int
40
Width of the textarea