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
.
1 2 3 4 5 6 |
name |
A name for the QualificationType. This is visible to workers. It cannot be modified by |
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 |
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 |
test.duration |
An optional time (in seconds) indicating how long workers have to complete the test. |
validate.test |
A logical specifying whether the |
validate.answerkey |
A logical specifying whether the |
auto |
A logical indicating whether the Qualification is automatically granted to workers who request it. Default is |
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 |
... |
Additional arguments passed to |
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
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | ## 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)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.