CreateQualificationType: Create QualificationType
In cloudyr/MTurkR: R Client for the MTurk Requester API

Description Usage Arguments Details Value Author(s) References See Also Examples

Create a QualificationType. This creates a QualificationType, but does not assign it to any workers. All characteristics of the QualificationType (except name and keywords) can be changed later with UpdateQualificationType.

CreateQualificationType(name, description, status, keywords = NULL, 
                        retry.delay = NULL, test = NULL, answerkey = NULL, 
                        test.duration = NULL,
                        validate.test = FALSE, validate.answerkey = FALSE,
                        auto = NULL, auto.value = NULL,
                        verbose = getOption('MTurkR.verbose', TRUE), ...)

`name`	A name for the QualificationType. This is visible to workers. It cannot be modified by `UpdateQualificationType`.
`description`	A longer description of the QualificationType. This is visible to workers. Maximum of 2000 characters.
`status`	A character vector of “Active” or “Inactive”, indicating whether the QualificationType should be active and visible.
`keywords`	An optional character string containing a comma-separated set of keywords by which workers can search for the QualificationType. Maximum 1000 characters. These cannot be modified by `UpdateQualificationType`.
`retry.delay`	An optional time (in seconds) indicating how long workers have to wait before requesting the QualificationType after an initial rejection. If not specified, retries are disabled and Workers can request a Qualification of this type only once, even if the Worker has not been granted the Qualification.
`test`	An optional character string consisting of a QuestionForm data structure, used as a test a worker must complete before the QualificationType is granted to them.
`answerkey`	An optional character string consisting of an AnswerKey data structure, used to automatically score the test, perhaps as returned by `GenerateAnswerKey`.
`test.duration`	An optional time (in seconds) indicating how long workers have to complete the test.
`validate.test`	A logical specifying whether the `test` parameter should be validated against the relevant MTurk schema prior to creating the QualificationType (operation will fail if it does not validate, and will return validation information). Default is `FALSE`.
`validate.answerkey`	A logical specifying whether the `answerkey` parameter should be validated against the relevant MTurk schema prior to creating the QualificationType (operation will fail if it does not validate, and will return validation information). Default is `FALSE`.
`auto`	A logical indicating whether the Qualification is automatically granted to workers who request it. Default is `NULL` meaning `FALSE`.
`auto.value`	An optional parameter specifying the value that is automatically assigned to workers when they request it (if the Qualification is automatically granted).
`verbose`	Optionally print the results of the API request to the standard output. Default is taken from `getOption('MTurkR.verbose', TRUE)`.
`...`	Additional arguments passed to `request`.

A function to create a QualificationType. Active QualificationTypes are visible to workers and to other requesters. All characteristics of the QualificationType, other than the name and keywords, can later be modified by UpdateQualificationType. Qualifications can then be used to assign Qualifications to workers with AssignQualification and invoked as QualificationRequirements in RegisterHITType and/or CreateHIT operations.

createqual() is an alias.

A data frame containing the QualificationTypeId and other details of the newly created QualificationType.

Thomas J. Leeper

API Reference

GetQualificationType

DisposeQualificationType

UpdateQualificationType

SearchQualificationTypes

## Not run: 
# Create 
qual1 <- CreateQualificationType(name="Worked for me before",
           description="This qualification is for people who have worked for me before",
           status = "Active",
           keywords="Worked for me before")
DisposeQualificationType(qual1$QualificationTypeId)

## End(Not run)

## Not run: 
# QualificationType with test and answer key
qf <- paste0(readLines(system.file("qualificationtest1.xml", package = "MTurkR")), collapse="")
qa <- paste0(readLines(system.file("answerkey1.xml", package = "MTurkR")), collapse="")
qual1 <- CreateQualificationType(name = "Qualification with Test",
           description = "This qualification is a demo",
           test = qf,
           answerkey = qa, # optionally, use AnswerKey
           status = "Active",
           keywords = "test, autogranted")
DisposeQualificationType(qual1$QualificationTypeId)

## End(Not run)