Documentation

The QualificationType data structure represents a Qualification type, a description of a property of a Worker that must match the requirements of a HIT for the Worker to be able to accept the HIT. The type also describes how a Worker can obtain a Qualification of that type, such as through a Qualification test.

See: newQualificationType smart constructor.

Create a value of QualificationType with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:creationTime:QualificationType', qualificationType_creationTime - The date and time the Qualification type was created.

$sel:testDurationInSeconds:QualificationType', qualificationType_testDurationInSeconds - The amount of time, in seconds, given to a Worker to complete the Qualification test, beginning from the time the Worker requests the Qualification.

$sel:qualificationTypeStatus:QualificationType', qualificationType_qualificationTypeStatus - The status of the Qualification type. A Qualification type's status determines if users can apply to receive a Qualification of this type, and if HITs can be created with requirements based on this type. Valid values are Active | Inactive.

$sel:answerKey:QualificationType', qualificationType_answerKey - The answers to the Qualification test specified in the Test parameter.

$sel:test:QualificationType', qualificationType_test - The questions for a Qualification test associated with this Qualification type that a user can take to obtain a Qualification of this type. This parameter must be specified if AnswerKey is present. A Qualification type cannot have both a specified Test parameter and an AutoGranted value of true.

$sel:qualificationTypeId:QualificationType', qualificationType_qualificationTypeId - A unique identifier for the Qualification type. A Qualification type is given a Qualification type ID when you call the CreateQualificationType operation.

$sel:name:QualificationType', qualificationType_name - The name of the Qualification type. The type name is used to identify the type, and to find the type using a Qualification type search.

$sel:keywords:QualificationType', qualificationType_keywords - One or more words or phrases that describe theQualification type, separated by commas. The Keywords make the type easier to find using a search.

$sel:autoGranted:QualificationType', qualificationType_autoGranted - Specifies that requests for the Qualification type are granted immediately, without prompting the Worker with a Qualification test. Valid values are True | False.

$sel:autoGrantedValue:QualificationType', qualificationType_autoGrantedValue - The Qualification integer value to use for automatically granted Qualifications, if AutoGranted is true. This is 1 by default.

$sel:description:QualificationType', qualificationType_description - A long description for the Qualification type.

$sel:isRequestable:QualificationType', qualificationType_isRequestable - Specifies whether the Qualification type is one that a user can request through the Amazon Mechanical Turk web site, such as by taking a Qualification test. This value is False for Qualifications assigned automatically by the system. Valid values are True | False.

$sel:retryDelayInSeconds:QualificationType', qualificationType_retryDelayInSeconds - The amount of time, in seconds, Workers must wait after taking the Qualification test before they can take it again. Workers can take a Qualification test multiple times if they were not granted the Qualification from a previous attempt, or if the test offers a gradient score and they want a better score. If not specified, retries are disabled and Workers can request a Qualification only once.

The date and time the Qualification type was created.

The amount of time, in seconds, given to a Worker to complete the Qualification test, beginning from the time the Worker requests the Qualification.

The status of the Qualification type. A Qualification type's status determines if users can apply to receive a Qualification of this type, and if HITs can be created with requirements based on this type. Valid values are Active | Inactive.

The answers to the Qualification test specified in the Test parameter.

The questions for a Qualification test associated with this Qualification type that a user can take to obtain a Qualification of this type. This parameter must be specified if AnswerKey is present. A Qualification type cannot have both a specified Test parameter and an AutoGranted value of true.

A unique identifier for the Qualification type. A Qualification type is given a Qualification type ID when you call the CreateQualificationType operation.

The name of the Qualification type. The type name is used to identify the type, and to find the type using a Qualification type search.

One or more words or phrases that describe theQualification type, separated by commas. The Keywords make the type easier to find using a search.

Specifies that requests for the Qualification type are granted immediately, without prompting the Worker with a Qualification test. Valid values are True | False.

The Qualification integer value to use for automatically granted Qualifications, if AutoGranted is true. This is 1 by default.

A long description for the Qualification type.

Specifies whether the Qualification type is one that a user can request through the Amazon Mechanical Turk web site, such as by taking a Qualification test. This value is False for Qualifications assigned automatically by the system. Valid values are True | False.

The amount of time, in seconds, Workers must wait after taking the Qualification test before they can take it again. Workers can take a Qualification test multiple times if they were not granted the Qualification from a previous attempt, or if the test offers a gradient score and they want a better score. If not specified, retries are disabled and Workers can request a Qualification only once.