Assignment

Description

The Assignment data structure represents a single assignment of a HIT to a Worker. The assignment tracks the Worker's efforts to complete the HIT, and contains the results for later retrieval.

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

• GetAssignment

• GetAssignmentsForHIT

Elements

The Assignment structure can contain the following elements.

Name	Description	Required
AssignmentId	A unique identifier for the assignment Type: String Default: None	No
WorkerId	The ID of the Worker who accepted the HIT. Type: String Default: None	No
HITId	The ID of the HIT Type: String Default: None	No
AssignmentStatus	The status of the assignment Type: String Valid Values: Submitted | Approved | Rejected Default: None	No
AutoApprovalTime	If results have been submitted, AutoApprovalTime is the date and time the results of the assignment results are considered Approved automatically if they have not already been explicitly approved or rejected by the Requester. This value is derived from the auto-approval delay specified by the Requester in the HIT. This value is omitted from the assignment if the Worker has not yet submitted results. Type: a dateTime structure in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z. Default: None	No
AcceptTime	The date and time the Worker accepted the assignment. Type: a dateTime structure in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z. Default: None	No
SubmitTime	If the Worker has submitted results, SubmitTime is the date and time the assignment was submitted. This value is omitted from the assignment if the Worker has not yet submitted results. Type: a dateTime structure in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z. Default: None	No
ApprovalTime	If the Worker has submitted results and the Requester has approved the results, ApprovalTime is the date and time the Requester approved the results. This value is omitted from the assignment if the Requester has not yet approved the results. Type: a dateTime structure in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z. Default: None	No
RejectionTime	If the Worker has submitted results and the Requester has rejected the results, RejectionTime is the date and time the Requester rejected the results. Type: a dateTime structure in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z. Default: None. This value is omitted from the assignment if the Requester has not yet rejected the results.	No
Deadline	The date and time of the deadline for the assignment. This value is derived from the deadline specification for the HIT and the date and time the Worker accepted the HIT. Type: a dateTime structure in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z. Default: None	No
Answer	The Worker's answers submitted for the HIT contained in a QuestionFormAnswers document, if the Worker provides an answer. If the Worker does not provide any answers, Answer may contain a QuestionFormAnswers document, or Answer may be empty. Type: a QuestionFormAnswers data structure Default: None	No
RequesterFeedback	The feedback string included with the call to the ApproveAssignment operation or the RejectAssignment operation, if the Requester approved or rejected the assignment and specified feedback. Type: String Default: None. This field is not returned with assignment data by default. To request this field, specify a response group of AssignmentFeedback. For information about response groups, see Common Parameters.	No

Example

The following example shows an Assignment data structure returned by the GetAssignmentsForHIT operation. The GetAssignmentsForHIT operation returns zero or more Assignment elements for a Reviewable HIT.

<Assignment>
  <AssignmentId>123RVWYBAZW00EXAMPLE456RVWYBAZW00EXAMPLE</AssignmentId>
  <WorkerId>AZ3456EXAMPLE</WorkerId>
  <HITId>123RVWYBAZW00EXAMPLE</HITId>
  <AssignmentStatus>Submitted</AssignmentStatus>
  <Deadline>2005-12-01T23:59:59Z</Deadline>
  <AcceptTime>2005-12-01T12:00:00Z</AcceptTime>
  <SubmitTime>2005-12-07T23:59:59Z</SubmitTime>
  <Answer>
    &lt;QuestionFormAnswers&gt;
      [XML-encoded Answer data]
    &lt;/QuestionFormAnswers&gt;
  </Answer>
</Assignment>