Questions feed

Applies to the following products: 
Questionmark OnDemand
Questionmark Perception
Applies to the following Perception versions: 
Perception 5.7

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

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:

OData: URI Conventions

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>&lt;Unknown&gt;</d:Type>
<d:Wording>&lt;Unknown&gt;</d:Wording>
<d:Description>&lt;Unknown&gt;</d:Description>
<d:MinimumScore m:type="Edm.Int16">0</d:MinimumScore>
<d:MaximumScore m:type="Edm.Int16">0</d:MaximumScore>
<d:CorrectAnswers>&lt;Unknown&gt;</d:CorrectAnswers>
<d:TenantId>&lt;Not defined&gt;</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.DateTimem:null="true" />
<d:Author>&lt;Unknown&gt;</d:Author>
<d:LastEditedBy>&lt;Unknown&gt;</d:LastEditedBy>
<d:QuestionStatus>&lt;Unknown&gt;</d:QuestionStatus>