2.1.1 Test object

A test object represents a test that has been defined for one or more users. Inherits from the 2.1.1 Playable object.

Fields

Field Type Description
type
required
String constant Reflects the playable type, which is always TEST to tests. Inherited from 2.1.1 Playable.
id
required
String The unique identifier for this test. Inherited from 2.1.1 Playable.

Example value: gDCIpKnMSA-JIFiQxPh31g
name
required
String The name (title) of the test. Inherited from 2.1.1 Playable.

Example value: European geography test
tags
optional
List of 2.1.1 Tag objects An optional list of tags to aid searching for this test. Inherited from 2.1.1 Playable.
icon
required
2.1.1 Media object The icon that represents this test. If no specific icon is defined, a fallback icon is used. Inherited from 2.1.1 Playable.
cover
optional
2.1.1 Media object An optional cover image to display at the start of the test. Inherited from 2.1.1 Playable.
creator
required
2.1.1 Actor object The creating user of organization. Inherited from 2.1.1 Playable.
created
required
Date The date and time this test was created (defined). Inherited from 2.1.1 Playable.
locale
optional
String A locale code for the content of this test. Inherited from 2.1.1 Playable.

Example value: en_US
compatibility
optional
2.1.1 Compatibility object An optional indication of Player compatibility customized for the calling player. Inherited from 2.1.1 Playable.
affordances
optional
List of strings Inherited from 2.1.1 Playable.
reception
optional
2.1.1 Reception object Inherited from 2.1.1 Playable.
license
optional
2.1.1 License object Inherited from 2.1.1 Playable.
drills List of 2.1.1 Drill objects The source drills for this test.
direction String constant The question direction.

Possible values:
  • BIDIRECTIONAL (default)
  • PRODUCTIVE
  • RECEPTIVE
style String constant The question style.

Possible values:
  • MULTIPLE_CHOICE
  • OPEN_ENDED
instructions 2.1.1 MarkupText object An optional instruction test that is shown to the testee before commencing the test.
disclosure
optional
List of strings The disclosure defines what test results the user will see after finishing the test.

Possible values:
  • OVERALL_SCORE
  • COMPONENT_SCORES
  • CORRECTIONS
  • FEEDBACK
columns List of strings The names of the question columns used in the test.
questions List of integers The sum of this list represents the total number of questions in the test.
weights List of integers Indicates how questions from each source drill are weighted in the overall score.
testResults List of 2.1.1 TestResult objects
maxTestsPerUser Integer Denotes the maximum number of attempts per testee. Absence of this value means that ther is no limit.
subject String The test subject.
timeLimit
optional
ISO Duration The maximum duration of a test attempt. It is formatted as an ISO-8601 duration.
questionCollector 2.1.1 QuestionCollector object Represents the way test questions are collected.
imageMaps List of 2.1.1 ImageMap objects An optional list of image maps if hot spot questions are included in this test.
allowQuestionNavigation Boolean Whether navigating from question to question (back and forth) is allowed.
allowUnansweredQuestions Boolean Whether it is allowed to submit the test with not all questions answered.
testScoreTransformers List of 2.1.1 TestScoreTransformer objects Indicates how the raw (internal) score is to be represented to users.