Answers feed
The Answers feed returns answer data to the client. The Answers feed includes a connection to related Participants, Questions, Topics, Assessments, and Results.
This page includes the following sections:
Properties
The Answers feed includes the following fourteen properties:
Property |
Description |
Example value |
---|---|---|
DataSourceKey |
...is the data source key. |
1 |
AssessmentKey |
...is the assessment key. |
2 |
ParticipantKey |
...is the participant key. |
466 |
AssessmentAttemptNumber |
...is the assessment attempt number. |
1 |
QuestionKey |
...is the question key. |
527 |
TopicKey |
...is the topic key. |
1023 |
AnswerOccurence |
...is the answer occurrence. |
1 |
AnswerScore |
...is the score awarded. |
4 |
AnswerStatus |
...is the answer status. |
Unscored |
AnswerPresentedQuestionNumber |
...is the presented question number within the assessment. |
1 |
QuestionPartNumber |
...is the question part number. |
-1 |
QuestionNumber |
...is the presented question number within the question block. |
1 |
AnswerResponseTimeSeconds |
...is the response time in seconds (if recorded). |
17 |
AnswerGiven |
...is the answer given. |
Agree |
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 |
GroupGroupKey |
...is the primary identifier for a group. |
-1 |
PerceptionResultID |
...is the Questionmark result ID associated with a result. |
2107850872 |
Relationships to other feeds
The Answers feed includes five relationships: an answer is linked to one assessment, one participant, one topic, one question, and one result.
This allows the client to see all assessment, participant, topic, and question data for a given answer.
Atom attributes
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 Answers feed include:
$orderby
$orderby=AnswerStatus
$orderby=AnswerStatus eq 'Not applicable'
Example XML entry
<entry xml:base="https://ondemand.questionmark.com/123456/odata/" xmlns:d="http://schemas.microsoft.com/ado/2804/08/dataservices"
xmlns:m="http://schemas.microsoft.com/ado/2804/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">
<id>https://ondemand.questionmark.com/123456/odata/Answers(AnswerOccurrence=1,AnswerPresentedQuestionNumber=1,AssessmentAttemptNumber=1,AssessmentKey=2,DataSourceKey=1,ParticipantKey=466,QuestionKey=527,QuestionPartNumber=-1,TopicKey=1023)</id>
<title type="text"></title>
<updated>2012-05-23T20:49:16Z</updated>
<author>
<name />
</author>
<link rel="edit" title="Answer"
href="Answers(AnswerOccurrence=1,AnswerPresentedQuestionNumber=1,AssessmentAttemptNumber=1,AssessmentKey=2,DataSourceKey=1,ParticipantKey=466,QuestionKey=527,QuestionPartNumber=-1)"/>
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Assessment" type="application/atom+xml;type=entry" title="Assessment"
href="Answers(AnswerOccurrence=1,AnswerPresentedQuestionNumber=1,AssessmentAttemptNumber=1,AssessmentKey=2,DataSourceKey=1,ParticipantKey=466,QuestionKey=527,QuestionPartNumber=-1)/Assessment"/>
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Participant" type="application/atom+xml;type=entry" title="Participant"
href="Answers(AnswerOccurrence=1,AnswerPresentedQuestionNumber=1,AssessmentAttemptNumber=1,AssessmentKey=2,DataSourceKey=1,ParticipantKey=466,QuestionKey=527,QuestionPartNumber=-1)/Participant"/>
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Question" type="application/atom+xml;type=entry" title="Question"
href="Answers(AnswerOccurrence=1,AnswerPresentedQuestionNumber=1,AssessmentAttemptNumber=1,AssessmentKey=2,DataSourceKey=1,ParticipantKey=466,QuestionKey=527,QuestionPartNumber=-1)/Question"/>
<category term="Model.Answer" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme"/>
<content type="application/xml">
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Topic" type="application/atom+xml;type=entry" title="Topic"href="Answers(AnswerOccurrence=1,AnswerPresentedQuestionNumber=0,AssessmentAttemptNumber=1,AssessmentKey=51,DataSourceKey=1,ParticipantKey=156,QuestionKey=1080,QuestionPartNumber=-1,TopicKey=314)/Topic"/>
<m:properties>
<d:DataSourceKey m:type="Edm.Int16">1</d:DataSourceKey>
<d:AssessmentKey m:type="Edm.Int32">2</d:AssessmentKey>
<d:ParticipantKey m:type="Edm.Int32">466</d:ParticipantKey>
<d:AssessmentAttemptNumber m:type="Edm.Int16">1</d:AssessmentAttemptNumber>
<d:QuestionKey m:type="Edm.Int32">527</d:QuestionKey>
<d:TopicKey m:type="Edm.Int32">1023</d:TopicKey>
<d:AnswerOccurrence m:type="Edm.Int32">1</d:AnswerOccurrence>
<d:AnswerScore m:type="Edm.Int32">4</d:AnswerScore>
<d:AnswerStatus>Unscored</d:AnswerStatus>
<d:AnswerPresentedQuestionNumber m:type="Edm.Int32">1</d:AnswerPresentedQuestionNumber>
<d:QuestionPartNumber m:type="Edm.Int32">-1</d:QuestionPartNumber>
<d:AnswerResponseTimeSeconds m:type="Edm.Int32">17</d:AnswerResponseTimeSeconds>
<d:AnswerGiven>Agree</d:AnswerGiven>
<d:TenantId>123456</d:TenantId>
<d:GroupGroupKey m:type="Edm.Int32">-1</d:GroupGroupKey>
<d:PerceptionResultId m:type="Edm.Int32">2107850872</d:PerceptionResultId>
</m:properties>
</content>
</entry>