GetQuestionCorrectAnswer

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

This method returns the correct answer of a question. The method can also be used to return the correct answer for a specific question revision as recorded in the repository. If no revision is identified in the input parameters when this method is called the latest revision is returned automatically. This method also only returns a correct answer if the question has a maximum score greater than 0.

The table below provides details behind the logic used in this method to find the correct answers and the question types it is compatible with.

Question type Logic used Example of returned data

Knowledge Matrix

A correct answer is reported only if each outcome that scores 1 point or greater references one choice matching one option

<Answer>France: Paris, Germany: Berlin, US: New York, UK: London, Spain: Madrid</Answer>

<Outcome>0, 1, 3, 4</Outcome>

Matching

A correct answer is reported only if each outcome that scores 1 point or greater references one choice matching one option

<Answer>France = Paris, UK = London, Germany = Berlin, US = Washington</Answer>

<Outcome>right</Outcome>

Multiple Choice

A correct answer is only reported if all outcomes that are scored achieve 1 point or greater and reference a single choice

<Answer>Delhi</Answer>

<Outcome>1 Delhi</Outcome>

Multiple Response

A correct answer is only reported if all outcomes that are scored 1 point or greater reference a single choice to be selected or a series of choices with AND

<Answer>a. psychoanalysis</Answer>

<Outcome>0 a. psychoanalysis </Outcome>

Numeric

A correct answer is reported only if there is only one choice, there is one outcome that scores highest and it has a single condition of a choice matching a number (not within range)

<Answer>30.0</Answer>

<Outcome>right</Outcome>

Pull-down List

A correct answer is reported only if each outcome that scores 1 point or greater references one choice matching one option

<Answer>Chandighar: Haryana, Mumbai: Maharastra, Bangalore: Karnataka, Hyderabad: Andhra Pradesh</Answer>

<Outcome>0, 2, 3, 4</Outcome>

Select a Blank

A correct answer is reported only if there is only one outcome scoring 1 point or more.

<Answer>The capital of Canada is Ottawa</Answer>

<Outcome>right</Outcome>

True/False

A correct answer is only reported if all outcomes that are scored achieve 1 point or greater and reference a single choice

<Answer>True</Answer>

<Outcome>0 True</Outcome>

Yes/No

A correct answer is only reported if all outcomes that are scored achieve 1 point or greater and reference a single choice

<Answer>Yes</Answer>

<Outcome>0 Yes</Outcome>

If a Question_ID or a revision number is not valid or correctly entered an error message is returned. Using this method against any of the following question types will also return an error message:

  • Adobe Flash
  • Adobe Captivate
  • Drag & Drop
  • Hotspot
  • Essay
  • Explanation
  • File upload
  • Fill in the Blanks
  • Likert Scale
  • Ranking
  • Spoken Response
  • Survey Matrix
  • Text Match

A SOAP fault will be returned if a database error occurs.

Available in:
  • Version 4.4 with Service Pack 3
  • Version 5.1 +

Parameters

Input name Description Data type Optional field?

Question_ID

The unique question ID of a question

String

N

Revision

The revision version of the question you would like to retrieve the answer for (if no revision parameters are supplied the latest revision is automatically retrieved)

Integer

Y

Response

Output name Description Data type

Answer

The correct answer for the question specified in Question_ID

String

Outcome

The outcome that identifies the correct answer/answers as stored in the Perception repository

String

Troubleshooting

Please refer to the following page for any error codes that are displayed when using this method.

Appendix - Error codes