Prev Next

QualificationRequest

Description

The QualificationRequest data structure represents a request a user has made for a Qualification.

The QualificationRequest data structure is used as a response element for the following operations:

Sample: GetQualificationRequests

The following example of a QualificationRequest data structure could be returned by the GetQualificationRequests operation. This operation returns the requests for Qualifications of a Qualification type to the author of the type. The author will use these Qualification requests to grant the Qualifications using the GrantQualification operation. 

<QualificationRequest>
  <QualificationRequestId>789RVWYBAZW00EXAMPLE951RVWYBAZW00EXAMPLE</QualificationRequestId>
  <QualificationTypeId>789RVWYBAZW00EXAMPLE</QualificationTypeId>
  <SubjectId>AZ3456EXAMPLE</SubjectId>
  <Test>
    &lt;QuestionForm&gt;
      [XML-encoded question data]
    &lt;/QuestionForm&gt;
  </Test>
  <Answer>
    &lt;QuestionFormAnswers&gt;
      [XML-encoded answer data]
    &lt;/QuestionFormAnswers&gt;
  </Answer>
  <SubmitTime>2005-12-01T23:59:59Z</SubmitTime>
</QualificationRequest>

Elements

The QualificationRequest structure may contain the following elements.

NameDescriptionValue
QualificationRequestId

The ID of the Qualification request, a unique identifier generated when the request was submitted. The Qualification type author retrieves these IDs using the GetQualificationRequests operation.

A valid Qualification request ID

QualificationTypeId

The ID of the Qualification type the user is requesting, as returned by CreateQualificationType.

A valid Qualification type ID

SubjectId

The ID of the user requesting the Qualification. This ID corresponds to the WorkerId returned with assignment results when the user performs a HIT.

A valid user ID

Test

The contents of the Qualification test that was presented to the user, if the type has a test and the user has submitted answers. This value is identical to the QuestionForm associated with the Qualification type at the time the user requests the Qualification.

A Qualification request includes a copy of the test as it appeared at the time the Qualification was requested. The test for a Qualification type can be changed at any time (using the UpdateQualificationType operation), so this allows you to know for sure which test the user saw.

This value is an XML data structure. See the QuestionForm data structure for more information.

XML data for the answer, a QuestionForm data structure

Answer

The user's answers for the Qualification type's test, if the type has a test and the user has submitted answers.

This value is an XML data structure. See the QuestionFormAnswers data structure for more information.

XML data for the answer, a QuestionFormAnswers data structure

SubmitTime

The date and time the Qualification request had a status of Submitted.

This is either the time the user submitted answers for a Qualification test, or the time the user requested the Qualification if the Qualification type does not have a test.

A dateTime in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z

Prev Copyright Information Next