mturk HIT QuestionForm

An mturk HIT QuestionForm is an XML-like data structure within an mturk HIT data structure that can define question tasks.

• Context:
  • It can (typically) one (or more) mturk HIT QuestionForm Overview Elements.
  • It can (typically) one (or more) mturk HIT QuestionForm Question Elements.
• See: mturk HIT.

---

---

References

2015

• http://docs.aws.amazon.com/AWSMechTurk/latest/AWSMturkAPI/ApiReference_QuestionFormDataStructureArticle.html#ApiReference_QuestionFormDataStructureArticle-questionform-structure
  • QUOTE: The top-most element of the QuestionForm data structure is a QuestionForm element. This element contains optional Overview elements and one or more Question elements. There can be any number of these two element types listed in any order. The following example structure has an Overview element and a Question element followed by a second Overview element and Question element — all within the same QuestionForm.

<QuestionForm xmlns="[the QuestionForm schema URL]">
 <Overview>
   [...]
 </Overview>
 <Question>
   [...]
 </Question>
 <Overview>
   [...]
 </Overview>
 <Question>
   [...]
 </Question>
 [...]
</QuestionForm>

2014

• http://docs.aws.amazon.com/AWSMechTurk/latest/AWSMturkAPI/ApiReference_QuestionFormDataStructureArticle.html
  • QUOTE: The QuestionForm data format describes one or more questions for a HIT, or for a Qualification test. It contains instructions and data Workers use to answer the questions, and a set of one or more form fields, which are rendered as a web form for a Worker to fill out and submit.

    A QuestionForm is a string value that consists of XML data. This XML data must conform to the QuestionForm schema. All elements in a QuestionForm belong to a namespace whose name is identical to the URL of the QuestionForm schema document. See WSDL and Schema Locations for the location of this schema. ...

    Example
    The following is an example of a complete QuestionForm data structure. Remember that to pass this structure in as a value of a parameter to an operation, XML characters must be escaped as character entities. (See Using XML Parameter Values for more information.)

<QuestionForm xmlns="[the QuestionForm schema URL]">
 <Overview>
   <Title>Game 01523, "X" to play</Title>
   <Text>
     You are helping to decide the next move in a game of Tic-Tac-Toe.  The board looks like this:
   </Text>
   <Binary>
     <MimeType>
       <Type>image</Type>
       <SubType>gif</SubType>
     </MimeType>
     <DataURL>http://tictactoe.amazon.com/game/01523/board.gif</DataURL>
     <AltText>The game board, with "X" to move.</AltText>
 </Binary>
   <Text>
     Player "X" has the next move.
   </Text>
 </Overview>
 <Question>
   <QuestionIdentifier>nextmove</QuestionIdentifier>
   <DisplayName>The Next Move</DisplayName>
   <IsRequired>true</IsRequired>
   <QuestionContent>
     <Text>
       What are the coordinates of the best move for player "X" in this game?
     </Text>
   </QuestionContent>
   <AnswerSpecification>
     <FreeTextAnswer>
       <Constraints>
         <Length minLength="2" maxLength="2" />
       </Constraints>
       <DefaultText>C1</DefaultText>
     </FreeTextAnswer>
   </AnswerSpecification>
 </Question>
 <Question>
   <QuestionIdentifier>likelytowin</QuestionIdentifier>
   <DisplayName>The Next Move</DisplayName>
   <IsRequired>true</IsRequired>
   <QuestionContent>
     <Text>
       How likely is it that player "X" will win this game?
     </Text>
   </QuestionContent>
   <AnswerSpecification>
     <SelectionAnswer>
       <StyleSuggestion>radiobutton</StyleSuggestion>
       <Selections>
         <Selection>
           <SelectionIdentifier>notlikely</SelectionIdentifier>
           <Text>Not likely</Text>
         </Selection>
         <Selection>
           <SelectionIdentifier>unsure</SelectionIdentifier>
           <Text>It could go either way</Text>
         </Selection>
         <Selection>
           <SelectionIdentifier>likely</SelectionIdentifier>
           <Text>Likely</Text>
         </Selection>
       </Selections>
     </SelectionAnswer>
   </AnswerSpecification>
 </Question>
</QuestionForm>

---