Questions feed
The Questions feed returns question data to the client. The Questions feed includes a connection to related AssessmentQuestionLinks, Choices, Outcomes, Assessments, Answers, and JTADimensions.
This page includes the following sections:
- Properties
- Relationships to other feeds
- Atom attributes
- Typical OData commands
- Example XML entry
- Default record
Properties
The Questions feed includes the following twenty properties:
Property |
Description |
Example value |
---|---|---|
QuestionKey |
...is the internal question key. |
10 |
PerceptionQuestionMID |
...is the Questionmark question MID. |
1000 |
PerceptionQuestionLID |
...is the Questionmark question LID. |
1183 |
RevisionNumber |
...is the revision number of the question. |
1 |
Type |
...is the question type. |
Multiple Choice |
Wording |
...is the question wording. |
In what year was The Smiths debut album released? |
Description |
...is the description for the question. |
Music trivia question 42 |
MinimumScore |
...is the minimum possible score achievable on the question. |
0 |
MaximumScore |
...is the maximum possible score achievable on the question. |
1 |
CorrectAnswers |
...is the correct answer(s) to the question. |
1984 |
TenantId |
...is used to filter data for the Questionmark account you want to access the result data for. The tenant ID is the customer ID for an OnDemand account; for Perception users, it is the name of the specific shared repository are you trying to access the result data for. It is checked against the supplied credentials. |
123456 |
ParentKey |
...is the parent key (-1 if no parent exists). |
-1 |
CreatedDateUtc |
...is the UTC creation date. |
2010-07-30T11:38:35 |
CreatedDateLocal |
...is the local creation date. |
2010-07-30T11:38:35 |
ModifiedDateUtc |
...is the UTC last modified date. |
2010-07-30T11:38:35 |
ModifiedDateLocal |
...is the local modified date. |
2010-07-30T07:38:35 |
Author |
...is the author of the question. |
renato.pagnani@questionmark.com |
LastEditedBy |
...is the person who last edited the question. |
selam.degefu@questionmark.com |
QuestionStatus |
...is the question status. |
Normal |
Relationships to other feeds
The Questions feed includes six relationships: a participant can be linked to one-or-more outcomes, one-or-more choices, one-or-more assessments (via assessment question links), one-or-more JTA dimensions, and one-or-more answers.
This allows the client to see all outcome, choice, and assessment data for a given question.
Atom attributes
The Atom field <title>
is populated with the question description.
The Atom field <updated>
is populated with the finished time of the batch in which the record was imported.
Typical OData commands
Questionmark's Results API uses the Microsoft implementation of OData and thus supports all the commands found at:
Typical OData commands and examples of these commands that can be applied to the Questions feed include:
$filter
$filter=Wording eq 'Where is Calgary located?'
$filter=QuestionStatus eq 'Beta'
(As shown in the chart here, 'eq
' means 'equal.')
#orderby
$orderby=Author
$orderby=QuestionStatus,RevisionNumber
Example XML entry
<entry xml:base="https://ondemand.questionmark.com/123456/odata/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices"
xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">
<id>https://ondemand.questionmark.com/123456/odata/Questions(10)</id>
<title type="text">Music trivia question 42</title>
<updated>2010-07-30T11:38:35</updated>
<author>
<name />
</author>
<link rel="edit" title="Question" href="Questions(10)"/>
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Outcomes" type="application/atom+xml;type=feed" title="Outcomes"
href="Questions(10)/Outcomes"/>
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Choices" type="application/atom+xml;type=feed" title="Choices"
href="Questions(10)/Choices"/>
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/AssessmentQuestionLinks" type="application/atom+xml;type=feed" title="AssessmentQuestionLinks"
href="Questions(10)/AssessmentQuestionLinks" />
<category term="Model.Question" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme"/>
<content type="application/xml">
<m:properties>
<d:QuestionKey m:type="Edm.Int32">10</d:QuestionKey>
<d:PerceptionQuestionMID m:type="Edm.Int32">1000</d:PerceptionQuestionMID>
<d:PerceptionQuestionLID m:type="Edm.Int32">1183</d:PerceptionQuestionLID>
<d:RevisionNumber m:type="Edm.Int32">1</d:RevisionNumber>
<d:Type>Multiple Choice</d:Type>
<d:Wording>In what year was The Smiths debut album released?</d:Wording>
<d:Description>Music trivia question 42</d:Description>
<d:MinimumScore m:type="Edm.Int16">0</d:MinimumScore>
<d:MaximumScore m:type="Edm.Int16">1</d:MaximumScore>
<d:CorrectAnswers>1984</d:CorrectAnswers>
<d:TenantId>123456</d:TenantId>
<d:ParentKey m:type="Edm.Int32">-1</d:ParentKey>
<d:CreatedDateUtc m:type="Edm.DateTime">2010-07-30T11:38:35</d:CreatedDateUtc>
<d:CreatedDateLocal m:type="Edm.DateTime">2010-07-30T07:38:35</d:CreatedDateLocal>
<d:ModifiedDateUtc m:type="Edm.DateTime">2010-07-30T11:38:35</d:ModifiedDateUtc>
<d:ModifiedDateLocal m:type="Edm.DateTime">2010-07-30T07:38:35</d:ModifiedDateLocal>
<d:Author>renato.pagnani@questionmark.com</d:Author>
<d:LastEditedBy>selam.degefu@questionmark.com</d:LastEditedBy>
<d:QuestionStatus>Normal</d:QuestionStatus>
</m:properties>
</content>
</entry>
Default record
The Questions feed includes a default record that is used in instanceswhen data from certain records does not have an assigned value. If you're creating reports from records in this feed, you will see one more record than you expect, this extra record being the default record. To filter out the default record from any reports you generate, filter to only include records that contain a QuestionKey with a value greater than 0. The default record is:
<d:QuestionKey m:type="Edm.Int32">-1</d:QuestionKey>
<d:PerceptionQuestionMID m:type="Edm.Int32" m:null="true" />
<d:PerceptionQuestionLID m:type="Edm.Int32" m:null="true" />
<d:RevisionNumber m:type="Edm.Int32" m:null="true" />
<d:Type><Unknown></d:Type>
<d:Wording><Unknown></d:Wording>
<d:Description><Unknown></d:Description>
<d:MinimumScore m:type="Edm.Int16">0</d:MinimumScore>
<d:MaximumScore m:type="Edm.Int16">0</d:MaximumScore>
<d:CorrectAnswers><Unknown></d:CorrectAnswers>
<d:TenantId><Not defined></d:TenantId>
<d:ParentKey m:type="Edm.Int32">-1</d:ParentKey>
<d:CreatedDateUtc m:type="Edm.DateTime" m:null="true" />
<d:CreatedDateLocal m:type="Edm.DateTime" m:null="true" />
<d:ModifiedDateUtc m:type="Edm.DateTime" m:null="true" />
<d:ModifiedDateLocal m:type="Edm.DateTime" m:null="true" />
<d:Author><Unknown></d:Author>
<d:LastEditedBy><Unknown></d:LastEditedBy>
<d:QuestionStatus><Unknown></d:QuestionStatus>