Help
Sample Scenario

The following example shows the interaction between BrainHoney and an adaptive assessment engine. The adaptive assessment engine acts as a homework manager that continues to ask questions until the student completes two questions correctly.

Each student action is shown with BrainHoney's accompanying Request Parameters to the adaptive assessment engine and the adaptive assessment engine's Response Data. The request parameters and response data are formatted and indented for readability. The requests are signed using OAuth, but for brevity and readability, only the first request shows the individual OAuth parameters, even though they are included with each request.

Although this example does not require it, an adaptive assessment engine may call DLAP to get additional information and to adapt and personalize the student's assessment. For example, it can call DLAP to get additional questions to return for the student or to get the student's scores on other assessments. The adaptive assessment engine must use its own DLAP credentials to establish the DLAP session.

Start

The users starts the assessment, which has four existing questions.

Request Parameters
action=start
enrollmentid=533356
itemid=WZEFC
questionlist=
<submission type="attempt">
  <submission partid="0" type="question">
    <attemptquestion id="719f6a9abd7545528890fa1292da4bdb" version="1">
	  <attemptpossible>1</attemptpossible>
	  <attemptchoice id="1" />
	  <attemptchoice id="3" />
	  <attemptchoice id="2" />
	</attemptquestion>
  </submission>
  <submission partid="1" type="question">
    <attemptquestion id="dcbccaf3b13140ee9754b54b458b542e" version="1">
	  <attemptpossible>1</attemptpossible>
	  <attemptchoice id="3" />
	  <attemptchoice id="2" />
	  <attemptchoice id="1" />
	  </attemptquestion>
  </submission>
  <submission partid="2" type="question">
    <attemptquestion id="852d183696914786b38404866c88a82c" version="1">
	  <attemptpossible>1</attemptpossible>
	  <attemptchoice id="3" />
	  <attemptchoice id="2" />
	  <attemptchoice id="1" />
	</attemptquestion>
  </submission>
  <submission partid="3" type="question">
    <attemptquestion id="661f1d30a7fa4a82b9a6acd53e0cc338" version="1">
	  <attemptpossible>1</attemptpossible>
	  <attemptchoice id="1" />
	  <attemptchoice id="2" />
	  <attemptchoice id="3" />
	</attemptquestion>
  </submission>
</submission>
submission=<submission type="attempt" />
response=<response type="none" />
submissionid=
state=
oauth_version=1.0
oauth_nonce=ca64cae205904edfa15865d915938794
oauth_timestamp=1306538769
oauth_signature_method=HMAC-SHA1
oauth_consumer_key=MyKey
oauth_callback=about%3ablank=
oauth_signature=4PWPgq7x8LVlAq6M3n8OWOm7gxw%3d
Response Data

Show the first question and the next button.

<response display="question" partid="0">
<buttons>
<button action="next"/>
</buttons>
<state>1</state>
</response>
Next

The users answers the first question correctly.

Request Parameters
action=next
enrollmentid=533356
itemid=WZEFC
questionlist=[SAME AS ABOVE]
submission=
<submission type="attempt" seconds="8">
  <submission partid="0" type="question">
    <answer>1</answer>
    <attemptquestion id="719f6a9abd7545528890fa1292da4bdb" version="1">
    <attemptpossible>1</attemptpossible>
    <attemptchoice id="1" />
    <attemptchoice id="3" />
    <attemptchoice id="2" />
    </attemptquestion>
  </submission>
</submission>
response=
<response type="none" pointscomputed="1" pointspossible="1">
  <response type="submission" foreignid="0" pointscomputed="1" pointspossible="1" />
</response>
submissionid=0
state=1
oauth_...[SIMILAR TO ABOVE]
Response Data

Show the second question and the next button.

<response display="question" partid="1">
<buttons>
<button action="next"/>
</buttons>
<state>2</state>
</response>
Next

The users answers the second question incorrectly.

Request Parameters
action=next
enrollmentid=533356
itemid=WZEFC
questionlist=[SAME AS ABOVE]
submission=
<submission type="attempt" seconds="12">
  <submission partid="0" type="question">
    <answer>1</answer>
    <attemptquestion id="719f6a9abd7545528890fa1292da4bdb" version="1">
    <attemptpossible>1</attemptpossible>
    <attemptchoice id="1" />
    <attemptchoice id="3" />
    <attemptchoice id="2" />
    </attemptquestion>
  </submission>
  <submission partid="1" type="question">
    <answer>2</answer>
    <attemptquestion id="dcbccaf3b13140ee9754b54b458b542e" version="1">
      <attemptpossible>1</attemptpossible>
      <attemptchoice id="3" />
      <attemptchoice id="2" />
      <attemptchoice id="1" />
    </attemptquestion>
  </submission>
</submission>
response=
<response type="none" pointscomputed="1" pointspossible="2">
  <response type="submission" foreignid="0" pointscomputed="1" pointspossible="1" />
  <response type="submission" foreignid="1" pointscomputed="0" pointspossible="1" />
</response>
submissionid=1
state=2
oauth_...[SIMILAR TO ABOVE]
Response Data

Show the third question and the next button.

<response display="question" partid="2">
<buttons>
<button action="next"/>
</buttons>
<state>3</state>
</response>
Next

The users answers the third question correctly.

Request Parameters
action=next
enrollmentid=533356
itemid=WZEFC
questionlist=[SAME AS ABOVE]
submission=
<submission type="attempt" seconds="17">
  <submission partid="0" type="question">
    <answer>1</answer>
    <attemptquestion id="719f6a9abd7545528890fa1292da4bdb" version="1">
      <attemptpossible>1</attemptpossible>
      <attemptchoice id="1" />
      <attemptchoice id="3" />
      <attemptchoice id="2" />
    </attemptquestion>
  </submission>
  <submission partid="1" type="question">
    <answer>2</answer>
    <attemptquestion id="dcbccaf3b13140ee9754b54b458b542e" version="1">
      <attemptpossible>1</attemptpossible>
      <attemptchoice id="3" />
      <attemptchoice id="2" />
      <attemptchoice id="1" />
    </attemptquestion>
  </submission>
  <submission partid="2" type="question">
     <answer>3</answer>
     <attemptquestion id="852d183696914786b38404866c88a82c" version="1">
       <attemptpossible>1</attemptpossible>
       <attemptchoice id="3" />
       <attemptchoice id="2" />
       <attemptchoice id="1" />
     </attemptquestion>
  </submission>
</submission>
response=
<response type="none" pointscomputed="2" pointspossible="3">
  <response type="submission" foreignid="0" pointscomputed="1" pointspossible="1" />
  <response type="submission" foreignid="1" pointscomputed="0" pointspossible="1" />
  <response type="submission" foreignid="2" pointscomputed="1" pointspossible="1" />
</response>
submissionid=2
state=3
oauth_...[SIMILAR TO ABOVE]
Response Data

Assessment is done. Go to review page. This is the final request for this student's assessment.

<response display="done"/>
See Also
Adaptive Assessment API Request Parameters Response Data Sample Code