TopicScores feed

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

The TopicScores feed returns topic score data to the client. The TopicScores feed includes a connection to related TopicsParticipants, and Assessments.

This page includes the following sections:


The TopicScores feed includes the following ten properties:



Example value

AssessmentKey the assessment key related to the topic score.


AssessmentAttemptNumber the assessment attempt number related to the topic score.


ParticipantKey the participant key related to the topic score.


DataSourceKey the data source key related to the topic score.


Score the topic score.


TopicMaximumScore the maximum possible topic score.


TopicPercentageScore the percent topic score.


TopicQuestionCount the number of questions in the topic.


TopicKey the topic key related to the topic score.


TenantID 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.


Relationships to other feeds

The TopicScores feed includes two relationships: a topic score is linked to one topic, to one participant, and to one assessment.

This allows the client to see the topic, participant, and assessment for a given topic score.

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:

OData: URI Conventions

Typical OData commands and examples of these commands that can be applied to the TopicScores feed include:


$filter=Topic.TopicName eq '[some topic name]'

(As shown in the chart here, 'eq' means 'equal.')






Example XML entry

<entry xml:base="" xmlns:d=""xmlns:m="" xmlns="">
<title type="text"></title>
<name />
<link rel="edit" title="TopicScore" href="TopicScores(AssessmentAttemptNumber=1,AssessmentKey=-1,DataSourceKey=1,ParticipantKey=110,TopicKey=224)"/>
<link rel="" type="application/atom+xml;type=feed" title="Topic" href="
<link rel="" type="application/atom+xml;type=feed" title="Participant"
<link rel="" type="application/atom+xml;type=feed" title="Assessment"
<category term="Model.TopicScore" scheme=""/>
<content type="application/xml">
<d:AssessmentKey m:type="Edm.Int32">-1</d:AssessmentKey>
<d:AssessmentAttemptNumber m:type="Edm.Int16">1</d: AssessmentAttemptNumber>
<d:ParticipantKey m:type="Edm.Int32">110</d: ParticipantKey>
<d:DataSourceKey m:type="Edm.Int16">1</d: DataSourceKey>
<d:Score m:type="Edm.Int32">0</d:Score>
<d:TopicMaximumScore m:type="Edm.Int32">10</d:TopicMaximumScore>
<d:TopicPercentageScore m:type="Edm.Double">90</d:TopicPercentageScore>
<d:TopicQuestionCount m:type="Edm.Int32">10</d:TopicQuestionCount>
<d:TopicKey m:type="Edm.Int32">224</d:TopicKey>