Verona Inferfaces Specification "Schemer" 2.0.0 documentation

Verona Inferfaces Specification "Schemer" 2.0.0

This is one part of the Verona Online Assessment Standards. All messages are sent via the postMessage function of the html page. The schemer takes the page root of its parent as target (parent.window), and the application binds the function call to the iframe element of the schemer. Most important, the message body carries as first parameter the operationId of the message. The html page MUST contain a script-tag with metadata. The syntax and structure of this data are described here.

Operations

SUB vosReadyNotification
Ready Notification
The schemer announces that it's code is loaded and initialized so the communication can start.

Operation IDvosReadyNotification
Accepts the following message:
object
metadata
required
string
Via this property, the schemer sends the stringified metadata object definied as json-ld in the header of the html file. See here for more information.

Additional properties are allowed.
Examples
{ "metadata": "string" }

This example has been generated automatically.
PUB vosStartCommand
Start Command
The application sends parameters for editing the coding scheme and commands the start of user interaction.

Operation IDvosStartCommand
Accepts the following message:
application/json
object
sessionId
required
string
The session id flags all communication. If a message has no or empty session id, it's not processed. The session id is unique and was generated by the application. Any simple algorithm would work. The session id helps to link the correct unit with the data of the message. Using the id of the editor hosting html element is less reliable, because the element could be reused with another unit.

codingScheme
string
format: byte
The coding scheme (if given) to be edited.

codingSchemeType
string
This lets the schemer the coding scheme format know. This might avoid UI mess after getting old schemes.

array<object>
Data of variables from unit definition. These variables represent the states of controls during assessment and form the basis of all coding. We call these variables 'base variables'.

id
required
string
label
string
page
string
The location of the value source if available.

object
directDownloadUrl
string
After starting the schemer and loading the scheme, it might be necessary to load additional code or data from the server. This data is identified by an resource ID (usually a file name). The schemer can download this resource by itself without further interaction with the host frontend. The property directDownloadUrl provides the url for download. The schemer extends this url by an url separator "/" and the resource ID (uri-encoded if needed).

Additional properties are allowed.
Additional properties are allowed.
Examples
{ "sessionId": "idk8ur5jf9ru5jk", "codingScheme": "<CodingScheme> <Variable id=\"text-field_2\" label=\"text-field_2\"> <RuleBased> <Transform>DATE_TO_ISO</Transform> </RuleBased> <Code code=\"1\" score=\"11\" label=\"111\"> <Rule method=\"MATCH\"> <Parameter>2021-12-04</Parameter> </Rule> </Code> <Code code=\"2\" score=\"22\" label=\"222\"> <Rule method=\"MATCH\"> <Parameter>2022-12-04</Parameter> </Rule> </Code> </Variable> </CodingScheme>", "codingSchemeType": "iqb@1.0", "variables": [ { "id": "ME3491a", "label": "Part of item 3 b)", "page": "Part of item 3 b)" } ], "schemerConfig": { "directDownloadUrl": "https://www.iqb-supercoder.de/download/iskeid-34e845-didmmemdkek" } }

This example has been generated automatically.
SUB vosSchemeChangedNotification
Scheme Changed Notification
The coding scheme of the unit has changed.

Operation IDvosSchemeChangedNotification
Accepts the following message:
application/json
object
sessionId
required
string
The session id flags all communication. If a message has no or empty session id, it's not processed. The session id is unique and was generated by the application. Any simple algorithm would work. The session id helps to link the correct unit with the data of the message. Using the id of the editor hosting html element is less reliable, because the element could be reused with another unit.

timeStamp
required
string
format: date-time
Ensures, that later arriving states are ignored.

codingScheme
required
string
format: byte
To be stored.

codingSchemeType
required
string
In order to understand the coding scheme outside the schemer, the type of the scheme should be known. This helps to select a suitable coder to run coding.

array<object>
List of all variables from coding scheme including derived variables. Reading this might be important even for base variables, because as part of the coding scheme, a label can be given for all variables.

id
required
string
label
string
page
string
The location of the value source if available.

array<object>
Files to provide or services to keep accessible during the coding of responses to the items of the unit.

id
required
string
type
required
string
Allowed values:
"file"
"service"
Additional properties are allowed.
Examples
{ "sessionId": "idk8ur5jf9ru5jk", "timeStamp": "2019-08-24T14:15:22Z", "codingScheme": "string", "codingSchemeType": "iqb@1.0", "variables": [ { "id": "ME3491a", "label": "Part of item 3 b)", "page": "Part of item 3 b)" } ], "dependenciesToCode": [ { "id": "https://short-answer-supercoder.iqb-berlin.de", "type": "file" } ] }

This example has been generated automatically.

Schemas

SessionIdString
string
The session id flags all communication. If a message has no or empty session id, it's not processed. The session id is unique and was generated by the application. Any simple algorithm would work. The session id helps to link the correct unit with the data of the message. Using the id of the editor hosting html element is less reliable, because the element could be reused with another unit.
object
id
required
string
label
string
page
string
The location of the value source if available.

Additional properties are allowed.
object
id
required
string
type
required
string
Allowed values:
"file"
"service"
Additional properties are allowed.
object
directDownloadUrl
string
After starting the schemer and loading the scheme, it might be necessary to load additional code or data from the server. This data is identified by an resource ID (usually a file name). The schemer can download this resource by itself without further interaction with the host frontend. The property directDownloadUrl provides the url for download. The schemer extends this url by an url separator "/" and the resource ID (uri-encoded if needed).

Additional properties are allowed.

Verona Inferfaces Specification "Schemer" 2.0.0

Operations

SUB vosReadyNotification

Examples

This example has been generated automatically.

PUB vosStartCommand

Examples

This example has been generated automatically.

SUB vosSchemeChangedNotification

Examples

This example has been generated automatically.

Schemas