Name
API to get a list of the possible answers of a question in a quiz.
Availability
Adobe Connect 9.4
Description
This API returns a list of all of the possible answers for a question in a quiz, including the response selection item and its description. You can also filter the responses to focus on a particular response.
Request URL
https://example.com/api/xml?action=report-asset-response-info&sco-id={sco-id}&asset-type=output&interaction-id={question-id}
Parameters
|
|
Type |
Required |
Description |
|
sco-id |
BIGINT |
Yes |
SCO ID of a training. |
|
asset-type |
String |
Yes |
Type of the asset data to return. It accepts the type ‘output’. |
|
interaction-id |
BIGINT |
Yes |
Filters by a specific question ID (Interaction ID). An interaction is a combination of one question and all of the possible answers. |
Filters
You can filter or sort the response on any element or attribute it contains.
|
Name |
Type |
Required |
Description |
|
filter-definition |
Value |
No |
A filter to filter specific items from a response and reduce the volume of the response. |
Response structure
<?xml version="1.0" encoding="utf-8" ?>
<results>
<status code="ok" />
<report-asset-responses>
<response interaction-id="{question-id}" display-seq="{sequence order of response}">
<response>{response order}</response>
<description>{response text}</description>
</response>
</report-asset-responses>
</results>
Response values
This API returns the event message with the run time fields resolved and substituted with actual values.
|
Element |
Attribute |
Type |
Description |
|
results |
|
|
All results that the action returns. |
|
status |
|
|
The status of a response. |
|
|
code |
|
A code indicating the response status. |
|
report-asset-responses |
|
|
Information about all of the individual response values. |
|
response |
|
|
Information about one particular response. |
|
|
interaction-id |
BIGINT |
The ID of a particular question in the quiz. |
|
|
display-seq |
|
The sequence number of a particular question in the quiz. |
|
response |
|
|
The response of a question. Typically, for multiple-choice questions, the response is simply the order of options, for example ‘A’ and for true-false questions, the response is the text True or False. |
|
description |
|
|
The actual text of a response. Typically, for multiple-choice questions, the response is the text the user chooses and for true-false questions, the response is the text True or False. |
Sample request
https://example.com/api/xml?action=report-asset-response-info&sco-id=24702&asset-type=output&interaction-id=20705
Sample response
<?xml version="1.0" encoding="utf-8" ?>
<results>
<status code="ok" />
<report-asset-responses>
<response interaction-id="20705" display-seq="1">
<response>A</response>
<description>War of 1812</description>
</response>
<response interaction-id="20705" display-seq="2">
<response>B</response>
<description>Civil War</description>
</response>
<response interaction-id="20705" display-seq="3">
<response>C</response>
<description>The Great War</description>
</response>
<response interaction-id="20705" display-seq="4">
<response>D</response>
<description>Korean War</description>
</response>
</report-asset-responses></results>