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

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`	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`.	No

Example

The following example shows an Assignment data structure returned by the GetAssignmentsForHIT operation. The GetAssignmentsForHIT operaton 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>