Verona Interfaces Specification "Editor" 4.4.0 documentation

Verona Interfaces Specification "Editor" 4.4.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 script-tag with metadata. The syntax and structure of this data are described here.

Operations

SEND 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:
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 NOT allowed.
Examples
{ "metadata": "string" }

This example has been generated automatically.
RECEIVE voeStartCommand
Start Command
The application sends parameters for editing the unit and commands the start of user interaction.

Operation IDvoeStartCommand
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.

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
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).

role
string
Specifies the access level of the editing person ('super' = maximal)

Allowed values:
"guest"
"commentator"
"developer"
"maintainer"
"super"
Additional properties are NOT allowed.
Additional properties are NOT 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", "role": "guest" } }

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

Operation IDvoeDefinitionChangedNotification
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.

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 [variable info for coding]>
Variable data help to prepare the processing of answers (coding scheme).

object [variable info for coding]
uid: variable-list@iqb-standard@1.1
id
required
string
must match: ^[0-9a-zA-Z_]+$
Identifier for the variable

alias
string
must match: ^[0-9a-zA-Z_]+$
Alternative identifier for the variable

type
required
string
Data type of the variable value

Allowed values:
"string"
"integer"
"number"
"boolean"
"attachment"
format
string
Data type format

Allowed values:
"text-selection"
"image"
"capture-image"
"audio"
"ggb-file"
"non-negative"
"latex"
"math-ml"
"math-table"
"ggb-variable"
""
multiple
boolean
Can the value be of type Array?

Default value:false
nullable
boolean
Can the value be null?

Default value:false
array<object>
List of possible values

object
value
required
string | number | boolean
label
string
Additional properties are NOT allowed.
array<string>
Labels of the positions if the value is of type array

Items:
string
valuesComplete
boolean
Are the given values all possible values?

Default value:false
page
string
Page of the unit, on which the variable is located.

Additional properties are NOT allowed.
array<object>
Files to provide or services to keep accessible during the presentation of the unit.

object
id
required
string
type
required
string
Allowed values:
"file"
"service"
Additional properties are NOT allowed.
array<object>
Files to provide or services to keep accessible to enable the editing of the unit.

object
id
required
string
type
required
string
Allowed values:
"file"
"service"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Examples
{ "sessionId": "idk8ur5jf9ru5jk", "timeStamp": "2019-08-24T14:15:22Z", "unitDefinition": "string", "unitDefinitionType": "iqb-scripted@1.4.0", "variables": [ { "id": "string", "alias": "string", "type": "string", "format": "text-selection", "multiple": false, "nullable": false, "values": [ { "value": "string", "label": "string" } ], "valuePositionLabels": [ "string" ], "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
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
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).

role
string
Specifies the access level of the editing person ('super' = maximal)

Allowed values:
"guest"
"commentator"
"developer"
"maintainer"
"super"
Additional properties are NOT allowed.
object
id
required
string
type
required
string
Allowed values:
"file"
"service"
Additional properties are NOT allowed.
object [variable info for coding]
uid: variable-list@iqb-standard@1.1
id
required
string
must match: ^[0-9a-zA-Z_]+$
Identifier for the variable

alias
string
must match: ^[0-9a-zA-Z_]+$
Alternative identifier for the variable

type
required
string
Data type of the variable value

Allowed values:
"string"
"integer"
"number"
"boolean"
"attachment"
format
string
Data type format

Allowed values:
"text-selection"
"image"
"capture-image"
"audio"
"ggb-file"
"non-negative"
"latex"
"math-ml"
"math-table"
"ggb-variable"
""
multiple
boolean
Can the value be of type Array?

Default value:false
nullable
boolean
Can the value be null?

Default value:false
array<object>
List of possible values

object
value
required
string | number | boolean
label
string
Additional properties are NOT allowed.
array<string>
Labels of the positions if the value is of type array

Items:
string
valuesComplete
boolean
Are the given values all possible values?

Default value:false
page
string
Page of the unit, on which the variable is located.

Additional properties are NOT allowed.

Verona Interfaces Specification "Editor" 4.4.0

Operations

SEND voeReadyNotification

Examples

This example has been generated automatically.

RECEIVE voeStartCommand

Examples

This example has been generated automatically.

SEND voeDefinitionChangedNotification

Examples

This example has been generated automatically.

Schemas