VERA Item Table Specs (see schema id for version) documentation

Data specs on tasks and items in assessments in education.

Go to the Schema section of this document and select one schema. Expand all nodes and explore.

Go to item-table to learn more about VERA data structures.

Schemas

object [Item table dataset]

uid: item-table-dataset@vera-standard@1.0

Data structure to unite all data for a subject.

objectType

required

string

must match: ^[A-Za-z_]+$

Identifier and version of the object spec

"vera-item-table@1.0"

subject

required

string

Refers to VERA-Projekt (VERA3 or VERA8) and to subject (mathematics, German, English, French)

"V3MA"
"V3DE"
"V8MA"
"V8DE"
"V8EN"
"V8FR"

"V3MA"
"V8DE"

yearOfApplication

integer

yearOfTryout

integer

publisher

required

string

Instituion responsible for the content.

"IQB - Institut zur Qualitätsentwicklung im Bildungswesen"

created

string

Date and time of creating these data.

"06.06.2024 17:32"

required

array<object [Task]>

List of tasks

object [Task]

uid: task@vera-standard@1.0

Data structure to describe a task as part of an assessment in education.

required

string

must match: ^[A-Za-z_]+$

Identifier for task

"M0139m"
"G38847A_v2"

label

required

string

Short internal name. Used in Lists and for filenames.

"Würfel2"
"Radiointerview"

title

required

string

Use this title in booklets.

"Ein toller Ausflug"
"Wer ist Adalbert Schnupf?"

subject

required

string

Refers to VERA-Projekt (VERA3 or VERA8) and to subject (mathematics, German, English, French)

"V3MA"
"V3DE"
"V8MA"
"V8DE"
"V8EN"
"V8FR"

"V3MA"
"V8DE"

array<object [Metadata Entry]>

List of metadata

object [Metadata Entry]

uid: metadata-entry@vera-standard@1.0

Data structure to describe an entry in a list of metadata of an object.

key

string

must match: ^[A-Z_]+$

Identifier for Metadata-Entry

"d3_comp"
"m3_comp_level"

anyOf

Value for Metadata-Entry; can be a simple value or a reference to a vocabulary

"es3"
"1997"
"6"
[L3,L2]

array<string>

Items:

string

Or to:

string

Additional properties are allowed.

yearOfTryout

integer

yearOfApplication

integer

Additional properties are allowed.

required

array<object [Item]>

List of items

object [Item]

uid: item@vera-standard@1.0

Data structure to describe an item as part of an assessment in education.

required

string

must match: ^[A-Za-z_]+$

Identifier for item

"M0139mli"
"G38847A02a"

taskId

required

string

must match: ^[A-Za-z_]+$

Items are always part of a task.

"M_U_234122"
"K992"

array<object [Metadata Entry]>

List of metadata

object [Metadata Entry]

uid: metadata-entry@vera-standard@1.0

Data structure to describe an entry in a list of metadata of an object.

key

string

must match: ^[A-Z_]+$

Identifier for Metadata-Entry

"d3_comp"
"m3_comp_level"

anyOf

Value for Metadata-Entry; can be a simple value or a reference to a vocabulary

"es3"
"1997"
"6"
[L3,L2]

array<string>

Items:

string

Or to:

string

Additional properties are allowed.

array<object>

Parameters for analyses of the item if used in assessments

object

key

required

string

"FREQUENCY_PRIMARY"
"FREQUENCY_GRADE9"
"FREQUENCY_GRADE10"
"FREQUENCY_HIGH_SCHOOL"
"FREQUENCY_NON_HIGH_SCHOOL"
"LOGIT"
"EDUCATIONAL_STANDARD_METRIC"

isGlobal

boolean

There are (sometimes) two metrics: one refers to all domains (global), the other to only one domain (default: true).

reliability

string

"FULL"
"LIMITED"
"NONE"
"NOT_AVAILABLE"

value

required

number

Additional properties are allowed.

required

array<object [Test-Modul]>

List of modules

object [Test-Modul]

uid: test-module@vera-standard@1.0

Data structure to describe an instrument (i.e. a module or a booklet) in assessments in education (sequence of tasks/items).

required

string

must match: ^[A-Za-z_-]+$

Identifier for module

"V3-2024_MA-THB2"
"24-V8-FR-HV-BM"

label

string

subject

required

string

Refers to VERA-Projekt (VERA3 or VERA8) and to subject (mathematics, German, English, French)

"V3MA"
"V3DE"
"V8MA"
"V8DE"
"V8EN"
"V8FR"

"V3MA"
"V8DE"

yearOfApplication

integer

required

array<object>

non-empty

All tasks of the module

object

required

string

numberInModule

required

integer

array<object>

All items to be included in module

object

required

string

numberInModule

required

integer

numberInTask

required

integer

subTask

string

Additional properties are allowed.

required

array<array<object>>

List of booklets

Items:

array<object>

uid: booklet@vera-standard@1.0

Lists modules for the booklet.

object

string

must match: ^[A-Za-z_/.]+$

Identifier for booklet

"V3-2024_DE-Lesen-THB"

required

array<string>

non-empty

Items:

string

Additional properties are allowed.

required

array<array<object>>

List of vocabs

Items:

array<object>

uid: vocab@vera-standard@1.0

List of possible metadata entries for an object.

object

key

required

string

must match: ^[A-Za-z_/.]+$

Identifier for Metadata-Entry

"de8_ma8_requ"
"ma3_domain"

label

string

required

array<object>

non-empty

object

key

required

string

label

string

Additional properties are allowed.

object [Task]

uid: task@vera-standard@1.0

Data structure to describe a task as part of an assessment in education.

required

string

must match: ^[A-Za-z_]+$

Identifier for task

"M0139m"
"G38847A_v2"

label

required

string

Short internal name. Used in Lists and for filenames.

"Würfel2"
"Radiointerview"

title

required

string

Use this title in booklets.

"Ein toller Ausflug"
"Wer ist Adalbert Schnupf?"

subject

required

string

Refers to VERA-Projekt (VERA3 or VERA8) and to subject (mathematics, German, English, French)

"V3MA"
"V3DE"
"V8MA"
"V8DE"
"V8EN"
"V8FR"

"V3MA"
"V8DE"

array<object [Metadata Entry]>

List of metadata

object [Metadata Entry]

uid: metadata-entry@vera-standard@1.0

Data structure to describe an entry in a list of metadata of an object.

key

string

must match: ^[A-Z_]+$

Identifier for Metadata-Entry

"d3_comp"
"m3_comp_level"

anyOf

Value for Metadata-Entry; can be a simple value or a reference to a vocabulary

"es3"
"1997"
"6"
[L3,L2]

array<string>

Items:

string

Or to:

string

Additional properties are allowed.

yearOfTryout

integer

yearOfApplication

integer

Additional properties are allowed.

object [Item]

uid: item@vera-standard@1.0

Data structure to describe an item as part of an assessment in education.

required

string

must match: ^[A-Za-z_]+$

Identifier for item

"M0139mli"
"G38847A02a"

taskId

required

string

must match: ^[A-Za-z_]+$

Items are always part of a task.

"M_U_234122"
"K992"

array<object [Metadata Entry]>

List of metadata

object [Metadata Entry]

uid: metadata-entry@vera-standard@1.0

Data structure to describe an entry in a list of metadata of an object.

key

string

must match: ^[A-Z_]+$

Identifier for Metadata-Entry

"d3_comp"
"m3_comp_level"

anyOf

Value for Metadata-Entry; can be a simple value or a reference to a vocabulary

"es3"
"1997"
"6"
[L3,L2]

array<string>

Items:

string

Or to:

string

Additional properties are allowed.

array<object>

Parameters for analyses of the item if used in assessments

object

key

required

string

"FREQUENCY_PRIMARY"
"FREQUENCY_GRADE9"
"FREQUENCY_GRADE10"
"FREQUENCY_HIGH_SCHOOL"
"FREQUENCY_NON_HIGH_SCHOOL"
"LOGIT"
"EDUCATIONAL_STANDARD_METRIC"

isGlobal

boolean

There are (sometimes) two metrics: one refers to all domains (global), the other to only one domain (default: true).

reliability

string

"FULL"
"LIMITED"
"NONE"
"NOT_AVAILABLE"

value

required

number

Additional properties are allowed.

object [Test-Modul]

uid: test-module@vera-standard@1.0

Data structure to describe an instrument (i.e. a module or a booklet) in assessments in education (sequence of tasks/items).

required

string

must match: ^[A-Za-z_-]+$

Identifier for module

"V3-2024_MA-THB2"
"24-V8-FR-HV-BM"

label

string

subject

required

string

Refers to VERA-Projekt (VERA3 or VERA8) and to subject (mathematics, German, English, French)

"V3MA"
"V3DE"
"V8MA"
"V8DE"
"V8EN"
"V8FR"

"V3MA"
"V8DE"

yearOfApplication

integer

required

array<object>

non-empty

All tasks of the module

object

required

string

numberInModule

required

integer

array<object>

All items to be included in module

object

required

string

numberInModule

required

integer

numberInTask

required

integer

subTask

string

Additional properties are allowed.

array<object>

uid: booklet@vera-standard@1.0

Lists modules for the booklet.

object

string

must match: ^[A-Za-z_/.]+$

Identifier for booklet

"V3-2024_DE-Lesen-THB"

required

array<string>

non-empty

Items:

string

Additional properties are allowed.

object [Metadata Entry]

uid: metadata-entry@vera-standard@1.0

Data structure to describe an entry in a list of metadata of an object.

key

string

must match: ^[A-Z_]+$

Identifier for Metadata-Entry

"d3_comp"
"m3_comp_level"

anyOf

Value for Metadata-Entry; can be a simple value or a reference to a vocabulary

"es3"
"1997"
"6"
[L3,L2]

array<string>

Items:

string

Or to:

string

Additional properties are allowed.

array<object>

uid: vocab@vera-standard@1.0

List of possible metadata entries for an object.

object

key

required

string

must match: ^[A-Za-z_/.]+$

Identifier for Metadata-Entry

"de8_ma8_requ"
"ma3_domain"

label

string

required

array<object>

non-empty

object

key

required

string

label

string

Additional properties are allowed.

VERA Item Table Specs (see schema id for version)

Operations

SEND iqb_data_structures

Examples

Schemas