Verona Interfaces Specification "Editor" 4.2.0 documentation

Verona Interfaces Specification "Editor" 4.2.0

This is one part of the Verona Online Assessment Standards. All messages are sent via the postMessage function of the html page. The editor takes the page root of its parent as target (parent.window), and the application binds the function call to the iframe element of the editor. Most important, the message body carries as first parameter the operationId of the message. The html page MUST contain a

Operations

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

Operation IDvoeReadyNotification
Accepts the following message:
voeReadyNotification
object
metadata
required
string
Via this property, the editor sends the stringified metadata object defined 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 voeStartCommand
Start Command
The application sends parameters for editing the unit and commands the start of user interaction.

Operation IDvoeStartCommand
Accepts the following message:
voeStartCommand
application/json
object
sessionId
required
string
uid: SessionIdString
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.

unitDefinition
string
format: byte
The definition of the unit (if given) to be edited.

unitDefinitionType
string
This lets the editor the unit definition format know. This might avoid UI mess after getting old definitions.

object
uid: EditorConfig
directDownloadUrl
string
After starting the editor and loading the unit definition, 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 editor can download this resource by itself without further interaction with the host frontend. The property directDownloadUrl provides the url for download. The editor 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", "unitDefinition": "iqb-scripted::1.4.0 title::Testscript Title2??Hilfetext2 multiple-choice::mc_var1::1::Multiple Choice Feld: ::Choice1##Choice2##Choice3??Hilfetext1 drop-down::dd_var1::1::Dropdown Feld: ::Choice1##Choice2##Choice3??Hilfetext1 checkbox::check_var1::0::Ja klick mal! if-start::dd_var1::1 input-text::java::sap oxa if-else input-text::java_22::sap oxa U text::NOT Choice1 if-end", "unitDefinitionType": "iqb-scripted@1.4.0", "editorConfig": { "directDownloadUrl": "https://www.iqb-studio.de/download/iskeid-34e845-didmmemdkek" } }

This example has been generated automatically.
SUB voeDefinitionChangedNotification
Definition Changed Notification
The definition of the unit has changed.

Operation IDvoeDefinitionChangedNotification
Accepts the following message:
voeDefinitionChangedNotification
application/json
object
sessionId
required
string
uid: SessionIdString
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.

unitDefinition
required
string
format: byte
To be stored.

unitDefinitionType
required
string
In order to understand the definition outside the editor, the type of the definition should be known. This helps to select a suitable player to run the unit.

array<object>
uid: https://w3id.org/iqb/responses/variable-list/variable-list.json
Data structure produced by verona editors, consumed by schemer etc.

id
required
string
must match: ^[0-9a-zA-Z_]+$
Identifier for the variable

type
required
string
Value type

Allowed values:
"string"
"integer"
"number"
"boolean"
"attachment"
format
string
More specification for value type

Allowed values:
"text-selection"
"image"
"capture-image"
"audio"
"ggb-file"
"ggb-variable"
"non-negative"
"latex"
"math-ml"
"math-table"
multiple
boolean
If true, this variable can hold an array of values.

Default value:false
nullable
boolean
If true, this variable can hold null as value.

Default value:true
array<object>
List of all known possible values with labels if given.

Default value:[]
required
oneOf
Adheres to:
boolean
Or to:
number
Or to:
string
label
string
array<string>
If value is of type array, there might be a fixed array length with fixed labelled positions.

Default value:[]
Items:
string
non-empty
valuesComplete
boolean
If true, there is not other possible value except the listed ones.

Default value:false
page
string
must match: ^[0-9a-zA-Z_]*$
Identifier of the page the variable is located on.

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

id
required
string
type
required
string
Allowed values:
"file"
"service"
array<object>
Files to provide or services to keep accessible to enable the editing 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", "unitDefinition": "string", "unitDefinitionType": "iqb-scripted@1.4.0", "variables": [ { "id": "string", "type": "string", "format": "text-selection", "multiple": false, "nullable": true, "values": [], "valuePositionLabels": [], "valuesComplete": false, "page": "string" } ], "dependenciesToPlay": [ { "id": "GeoGebra.itcr.zip", "type": "file" } ], "dependenciesToEdit": [ { "id": "GeoGebra.itcr.zip", "type": "file" } ] }

This example has been generated automatically.

Schemas

SessionIdString
string
uid: SessionIdString
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
uid: EditorConfig
directDownloadUrl
string
After starting the editor and loading the unit definition, 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 editor can download this resource by itself without further interaction with the host frontend. The property directDownloadUrl provides the url for download. The editor extends this url by an url separator "/" and the resource ID (uri-encoded if needed).

Additional properties are allowed.
object
uid: Dependency
id
required
string
type
required
string
Allowed values:
"file"
"service"
Additional properties are allowed.
array<object>
uid: https://w3id.org/iqb/responses/variable-list/variable-list.json
Data structure produced by verona editors, consumed by schemer etc.

id
required
string
must match: ^[0-9a-zA-Z_]+$
Identifier for the variable

type
required
string
Value type

Allowed values:
"string"
"integer"
"number"
"boolean"
"attachment"
format
string
More specification for value type

Allowed values:
"text-selection"
"image"
"capture-image"
"audio"
"ggb-file"
"ggb-variable"
"non-negative"
"latex"
"math-ml"
"math-table"
multiple
boolean
If true, this variable can hold an array of values.

Default value:false
nullable
boolean
If true, this variable can hold null as value.

Default value:true
array<object>
List of all known possible values with labels if given.

Default value:[]
required
oneOf
Adheres to:
boolean
Or to:
number
Or to:
string
label
string
array<string>
If value is of type array, there might be a fixed array length with fixed labelled positions.

Default value:[]
Items:
string
non-empty
valuesComplete
boolean
If true, there is not other possible value except the listed ones.

Default value:false
page
string
must match: ^[0-9a-zA-Z_]*$
Identifier of the page the variable is located on.

Verona Interfaces Specification "Editor" 4.2.0

Operations

SUB voeReadyNotification

Examples

This example has been generated automatically.

PUB voeStartCommand

Examples

This example has been generated automatically.

SUB voeDefinitionChangedNotification

Examples

This example has been generated automatically.

Schemas