QualificationRequest

Description

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

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

• GetQualificationRequests

Elements

The QualificationRequest structure can contain the elements described in the following table:

Name	Description	Required
QualificationRequestId	The ID of the Qualification request, a unique identifier generated when the request was submitted. Type: String Default: None	No
QualificationTypeId	The ID of the Qualification type the Worker is requesting, as returned by the CreateQualificationType operation. Type: String Default: None	No
SubjectId	The ID of the Worker requesting the Qualification. This ID corresponds to the WorkerId returned with assignment results when the Worker performs a HIT. Type: String Default: None	No
Test	The contents of the Qualification test that was presented to the Worker, if the type has a test and the Worker has submitted answers. This value is identical to the QuestionForm associated with the Qualification type at the time the Worker requests the Qualification. Type: a QuestionForm data structure Default: None	No
Answer	The Worker's answers for the Qualification type's test contained in a QuestionFormAnswers document, if the type has a test and the Worker has submitted answers. If the Worker does not provide any answers, Answer may be empty. Type: a QuestionFormAnswers data structure Default: None	No
SubmitTime	The date and time the Qualification request had a status of Submitted. This is either the time the Worker submitted answers for a Qualification test, or the time the Worker requested the Qualification if the Qualification type does not have a test. Type: a dateTime structure in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z Default: None	No

Example

The following example shows a QualificationRequest data structure returned by the GetQualificationRequests operation. This operation returns the requests for Qualifications of a Qualification type to the owner of the type.

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