qjsp

the qjsp search site
 
   
Schema questionairexml.xsd


Elements Groups Complex types
questionaire gquestionaireStructure tBlock
gQuestions tBlockReference
gSelectItems tCommonQuestionProps
qpageStructure tqFreeText
tqNumeric
tqSelect
tqSemDiff
tqStatement
tquestionaire
tquestionaireForm
tqYesNo


element questionaire
diagram
type tquestionaire
children name description author date styleSheet questionaireForm
annotation
documentation
Root element for a QueryXML-questionaire.
Each questionaire is nestet in this tag.

group gquestionaireStructure
diagram
children page
used by
element tquestionaire/questionaireForm
annotation
documentation
The structure of the questionaire, consisting of blocks and pagebreaks.

element gquestionaireStructure/page
diagram
children block blockReference
annotation
documentation
This represents one page.
MULTIPAGE FUNCTIONALITY NOT WORKING.  WILL BE IMPLEMENTED IN FUTURE RELEASE

group gQuestions
diagram
children basicQuestion qYesNo qSemDiff qSelect qFreetext qAgreeStatement qUniversalStatement mText qLickertQuest
used by
element tBlock/questions
annotation
documentation
A group containing a arbitary set of questions.

element gQuestions/basicQuestion
diagram
type extension of tCommonQuestionProps
children questionText ID additionalInfo helpText qbasicFreetext qbasicNumeric qbasicStatement qbasicLickert
attributes
Name Type Use Default Fixed Annotation
optional xs:boolean optional false
documentation
Usually, the user has to answer all questions.
If the "optional"-attribute is set to true, the user is allowed to omit the question.
annotation
documentation
You should not use this question-type. It's used only for implementation aspects.
A basic question. Beside common Tags, you have to choose one questiontype-tag.
Basic question can be convertet with the xsl-stylesheet without any problems.

element gQuestions/basicQuestion/qbasicFreetext
diagram
type extension of tqFreeText
attributes
Name Type Use Default Fixed Annotation
enableMultiLine xs:boolean optional false
documentation
allows the user to enter multiple lines of text.
annotation
documentation
QuestionType: A user-defined free text is used as an answer.

element gQuestions/basicQuestion/qbasicNumeric
diagram
type tqNumeric
children minValue maxValue
annotation
documentation
QuestionType: The user can enter a numeric value.

element gQuestions/basicQuestion/qbasicStatement
diagram
type extension of tqStatement
children statementSet
attributes
Name Type Use Default Fixed Annotation
alignSideBySide xs:boolean optional false
showBorder xs:boolean optional false
documentation
when enabled, each statementSet is surrounded with a border
multiSelect xs:boolean optional false
documentation
This attribute defines weather radio  buttons or check boxes are used..
annotation
documentation
QuestionType: The user can choose between different answer-sets. In each set, there are several answer-items to choose within.
Can be used for YesNo, Select, SemDiff and Statement.

element gQuestions/basicQuestion/qbasicLickert
diagram
children scala subQuestions
annotation
documentation
QuestionType: The user can define multiple questions with all the same result-scala.

element gQuestions/basicQuestion/qbasicLickert/scala
diagram
children scalaItem

element gQuestions/basicQuestion/qbasicLickert/scala/scalaItem
diagram
type xs:string

element gQuestions/basicQuestion/qbasicLickert/subQuestions
diagram
children subQuestion

element gQuestions/basicQuestion/qbasicLickert/subQuestions/subQuestion
diagram
type xs:string

element gQuestions/qYesNo
diagram
type extension of tCommonQuestionProps
children questionText ID additionalInfo helpText
attributes
Name Type Use Default Fixed Annotation
optional xs:boolean optional false
documentation
Usually, the user has to answer all questions.
If the "optional"-attribute is set to true, the user is allowed to omit the question.
enableDontKnow xs:boolean optional true
documentation
when setting this attribute to "true", there is a third option named "don't know"
annotation
documentation
QuestionType: You can select between "yes" or "no".
Optionally, there can be a "don't know" answer.

element gQuestions/qSemDiff
diagram
type extension of tCommonQuestionProps
children questionText ID additionalInfo helpText leftBound rightBound numOfSteps
attributes
Name Type Use Default Fixed Annotation
optional xs:boolean optional false
documentation
Usually, the user has to answer all questions.
If the "optional"-attribute is set to true, the user is allowed to omit the question.
annotation
documentation
QuestionType: There two opposite adjectives. 
You can use a given number of steps to balance your answer between those adjectives.

element gQuestions/qSemDiff/leftBound
diagram
type xs:string
annotation
documentation
That's the adjective displayed on the left side.

element gQuestions/qSemDiff/rightBound
diagram
type xs:string
annotation
documentation
That's the adjective displayed on the right side.

element gQuestions/qSemDiff/numOfSteps
diagram
type restriction of xs:positiveInteger
facets
minInclusive 2
maxInclusive 25
annotation
documentation
The number of radiobuttons to be created.

element gQuestions/qSelect
diagram
type extension of tCommonQuestionProps
children questionText ID additionalInfo helpText selectSet
attributes
Name Type Use Default Fixed Annotation
optional xs:boolean optional false
documentation
Usually, the user has to answer all questions.
If the "optional"-attribute is set to true, the user is allowed to omit the question.
alignSideBySide xs:boolean optional true
documentation
when set to "true", the iems are aligned horizintally instad of vertically.
multiSelect xs:boolean optional false
documentation
This attribute indicates weather to use radio buttons (single select) or check boxes (multi select).
annotation
documentation
QuestionType: You can select one between multiple, differnt items.

element gQuestions/qSelect/selectSet
diagram
children sItem
annotation
documentation
Contains the selectable Items.

element gQuestions/qSelect/selectSet/sItem
diagram
annotation
documentation
Thats a item to be displayed.

element gQuestions/qFreetext
diagram
type extension of tCommonQuestionProps
children questionText ID additionalInfo helpText
attributes
Name Type Use Default Fixed Annotation
optional xs:boolean optional false
documentation
Usually, the user has to answer all questions.
If the "optional"-attribute is set to true, the user is allowed to omit the question.
enableMultiLine xs:boolean optional true
documentation
when enabling this, there will be a text area in which the user can insert multiple lines of text
annotation
documentation
QuestionType: A user-defined free text is used as an answer.

element gQuestions/qAgreeStatement
diagram
type extension of tCommonQuestionProps
children questionText ID additionalInfo helpText
attributes
Name Type Use Default Fixed Annotation
optional xs:boolean optional false
documentation
Usually, the user has to answer all questions.
If the "optional"-attribute is set to true, the user is allowed to omit the question.
enableDontKnow xs:boolean optional true
documentation
When enabled, there will be a 3rd option named "don't know".
annotation
documentation
Question: Special form of UniversalStatement-Question. 
The user can choose between 3 options of agreement and disagreement.
Optionally, you can enable a "don't know"-answer.

element gQuestions/qUniversalStatement
diagram
type extension of tCommonQuestionProps
children questionText ID additionalInfo helpText statementSet
attributes
Name Type Use Default Fixed Annotation
optional xs:boolean optional false
documentation
Usually, the user has to answer all questions.
If the "optional"-attribute is set to true, the user is allowed to omit the question.
annotation
documentation
QuestionType: The user can choose between different answer-sets. In each set, there are several answer-items to choose.

element gQuestions/qUniversalStatement/statementSet
diagram
children leftText rightText setItems
annotation
documentation
Defines a statement-set. That is a set of items grouped by an common topic  / name.

element gQuestions/qUniversalStatement/statementSet/leftText
diagram
type xs:string
annotation
documentation
The left-displayed text of the actual statement-set.

element gQuestions/qUniversalStatement/statementSet/rightText
diagram
type xs:string
annotation
documentation
The left-displayed text of the actual statement-set.

element gQuestions/qUniversalStatement/statementSet/setItems
diagram
children sItem
annotation
documentation
Contains the Items of the set.

element gQuestions/qUniversalStatement/statementSet/setItems/sItem
diagram
annotation
documentation
Thats a item to be displayed.

element gQuestions/mText
diagram
type xs:string
annotation
documentation
TextComment: This is a textblock wich can be paced between questions. Its actually formatted like a question, but only contains text.

element gQuestions/qLickertQuest
diagram
type extension of tCommonQuestionProps
children questionText ID additionalInfo helpText scala subQuestions
attributes
Name Type Use Default Fixed Annotation
optional xs:boolean optional false
documentation
Usually, the user has to answer all questions.
If the "optional"-attribute is set to true, the user is allowed to omit the question.
annotation
documentation
Experimental. Don't use.

element gQuestions/qLickertQuest/scala
diagram
children scalaItem

element gQuestions/qLickertQuest/scala/scalaItem
diagram
type xs:string

element gQuestions/qLickertQuest/subQuestions
diagram
children subQuestion

element gQuestions/qLickertQuest/subQuestions/subQuestion
diagram
type xs:string

group gSelectItems
diagram
children sItem
used by
element tqStatement/statementSet/setItems
annotation
documentation
itemlist used for select-questions and statement-questions.

element gSelectItems/sItem
diagram
children value label

element gSelectItems/sItem/value
diagram
type xs:string
annotation
documentation
Thats the value of the this item.

element gSelectItems/sItem/label
diagram
type xs:string
annotation
documentation
A single selectable item.
For each item, an individual radio-button is created.
Thats the displayed text.

group qpageStructure
diagram
children block blockReference
used by
element gquestionaireStructure/page
annotation
documentation
This is the structure of a page.

element qpageStructure/block
diagram
type tBlock
children name intro outro visibility blockID questions
attributes
Name Type Use Default Fixed Annotation
questionColumnWidth xs:integer optional 50
documentation
defines the width in % of the column containing the question.
annotation
documentation
A block definies a grouped set of questiones.
The questions will appear visually grouped in the questionaire and should refer to the same topic.

element qpageStructure/blockReference
diagram
type tBlockReference
children referenceID newName
annotation
documentation
NOT WORKING. WILL BE IMPLEMENTED IN FUTURE RELEASE.A "blockReference" takes an existing block and redisplays it with other names / parameters.
A block is referable if it has an unique ID.

complexType tBlock
diagram
children name intro outro visibility blockID questions
used by
element qpageStructure/block
attributes
Name Type Use Default Fixed Annotation
questionColumnWidth xs:integer optional 50
documentation
defines the width in % of the column containing the question.
annotation
documentation
Type of the block-tag.
The block-tag encapsulates a set of different questions and groups them to an unit. 


element tBlock/name
diagram
type xs:string
annotation
documentation
This is the name of the block.
The name is displayed on top of the block.

element tBlock/intro
diagram
type xs:string
annotation
documentation
This is the text displayed at beginning of the block.

element tBlock/outro
diagram
type xs:string
annotation
documentation
This is the text diplayed at the end of the block.

element tBlock/visibility
diagram
type xs:string
annotation
documentation
Experimental. Don't know what to do with this. This should somehow describe the visibility-filter.

element tBlock/blockID
diagram
type xs:ID
annotation
documentation
This is used to refer blocks internally and for "blockReference", then you have to enter UNIQUE ID in this tag.Value has to fit NCName definition ![ NCName ::=  (Letter | '_') (NCNameChar)* ]

element tBlock/questions
diagram
children basicQuestion qYesNo qSemDiff qSelect qFreetext qAgreeStatement qUniversalStatement mText qLickertQuest
annotation
documentation
this tag nests the question of the tag.

complexType tBlockReference
diagram
children referenceID newName
used by
element qpageStructure/blockReference
annotation
documentation
Type of the blockReference-tag.

element tBlockReference/referenceID
diagram
type xs:IDREF
annotation
documentation
The ID of the refered block.

element tBlockReference/newName
diagram
type xs:string
annotation
documentation
The new name which should be used instead of the original name of the refered block.

complexType tCommonQuestionProps
diagram
children questionText ID additionalInfo helpText
used by
elements gQuestions/basicQuestion gQuestions/qAgreeStatement gQuestions/qFreetext gQuestions/qLickertQuest gQuestions/qSelect gQuestions/qSemDiff gQuestions/qUniversalStatement gQuestions/qYesNo
attributes
Name Type Use Default Fixed Annotation
optional xs:boolean optional false
documentation
Usually, the user has to answer all questions.
If the "optional"-attribute is set to true, the user is allowed to omit the question.
annotation
documentation
It defines the common structure of all questions.

element tCommonQuestionProps/questionText
diagram
type xs:string
annotation
documentation
This is the text which is displayed.

element tCommonQuestionProps/ID
diagram
type xs:ID
annotation
documentation
Thats the unique question ID (has to start with a aplha-character).
The question-ID describes the questions name in the evaluation.

element tCommonQuestionProps/additionalInfo
diagram
type xs:string
annotation
documentation
Don't know. Let's see what to do with this...

element tCommonQuestionProps/helpText
diagram
type xs:string
annotation
documentation
Contains some further information concerning the question.
Can be displayed if user wishes so.

complexType tqFreeText
diagram
used by
element gQuestions/basicQuestion/qbasicFreetext
annotation
documentation
Questiontype: Freetext-Question. This question can be answered with any text the user wants. Can be used for comments.

complexType tqNumeric
diagram
children minValue maxValue
used by
element gQuestions/basicQuestion/qbasicNumeric
annotation
documentation
Questiontype: Numeric-Question. This question creates a editbox for entering a numeric value.

element tqNumeric/minValue
diagram
type xs:integer
annotation
documentation
The minimal, valid value.
If this tag is not used, there will be no lower limit.

element tqNumeric/maxValue
diagram
type xs:integer
annotation
documentation
The maximum, valid value.
If this tag is not used, there will be no upper limit.

complexType tqSelect
diagram
annotation
documentation
Questiontype: Select-Question. There are several answeres predefined. The user can choose between them.

complexType tqSemDiff
diagram
annotation
documentation
Questiontype: SemanticDifferential-Question. This question takes two adjectives and the user can vote in given steps between them.

complexType tqStatement
diagram
children statementSet
used by
element gQuestions/basicQuestion/qbasicStatement
annotation
documentation
Questiontype: Statement-Question. The user can choose between various answer-sets. In each set, there are different answer-items.

element tqStatement/statementSet
diagram
children leftText rightText setItems
annotation
documentation
Defines a statement-set. That is a set of items grouped by an common topic  / name.

element tqStatement/statementSet/leftText
diagram
type xs:string
annotation
documentation
The left-displayed text of the actual statement-set.

element tqStatement/statementSet/rightText
diagram
type xs:string
annotation
documentation
The left-displayed text of the actual statement-set.

element tqStatement/statementSet/setItems
diagram
children sItem
annotation
documentation
Contains the Items of the set.

complexType tquestionaire
diagram
children name description author date styleSheet questionaireForm
used by
element questionaire
annotation
documentation
Type of the questionaire-tag. Contains necesarry info for the current questionaire.

element tquestionaire/name
diagram
type xs:string
annotation
documentation
Describes the name of the actual questionaire.

element tquestionaire/description
diagram
type xs:string
annotation
documentation
This contains the description of the questionaire which is displayed on top of the questionaire-form.

element tquestionaire/author
diagram
children firstname name email
annotation
documentation
The name of the author who created the questionaire.

element tquestionaire/author/firstname
diagram
type xs:string
annotation
documentation
first name of author.

element tquestionaire/author/name
diagram
type xs:string
annotation
documentation
name of the author.

element tquestionaire/author/email
diagram
type xs:string
annotation
documentation
the email. 

element tquestionaire/date
diagram
type xs:date
annotation
documentation
The date of the questionaires creation.

element tquestionaire/styleSheet
diagram
type xs:string
annotation
documentation
This defines the css stylesheet which should be used. StyleSheets have to be locates in the qjsp base directory.

element tquestionaire/questionaireForm
diagram
type extension of tquestionaireForm
children page
annotation
documentation
This tag contains the strukture of the questionaire.

complexType tquestionaireForm
diagram
used by
element tquestionaire/questionaireForm
annotation
documentation
Type of the questionaireform-tag.
Here, the structure of the questionaire ist defined.
A questionaire can contain an arbitary number of blocks.

complexType tqYesNo
diagram
annotation
documentation
Questiontype: Yes-No-Question. That's a question which you can answer with yes or no.