Submit a request
Submit a request

Using and Configuring the Activity Editor Mode

The Activity Editor is a feature for creating, managing, searching and previewing Activities.

An Activity is a collection of Items with a configuration, which can be rendered as an assessment.  


Try out the Activity Editor in the demo.

 

Items can be added to the activity by clicking 'Find Items', which takes you to another screen, similar to the Item List, where you can search for Items to be added. Note that only Items with status published will be returned in the result set. 
The search page can be configured via the activity_edit.item_search init option.

The order in which the Items appear in the list is the order in which they will be shown in the test (unless Shuffle Items option is on), and so Items can be reordered via drag and drop.

 

Items Tab

activity-editor-items.png

 

Find Items Screen

activity-editor-find-items.png

 

The Player tab holds the configuration for the Assess Player. 

Some common assess settings can be easily set here. These simple fields correspond to the settings in the Assess API as below: Templates for the player ("Player templates") are used to configure the regions, and label bundle of the Assess Player.
There are three preconfigured templates, and custom ones can be added by passing an array of objects to the init option activity_edit.player_templates. See an example configuration below

Note: Selecting one of the options updates the JSON (in Source tab). Thus, if, for some reason, the template is not passed in the init options, but was previously selected for an activity, the configuration data will still show in the source, but no option will be selected in the list.

 

To change the default selected template when a new Activity is created, use the init option activity_edit.default_player_template.

To only show custom templates, or only one of the defaults for example, you can pass an array of template references to the init option activity_edit.enabled_player_templates.

Example Preconfigured Player Templates list:

activity-editor-player-templates.png

 

The example code below shows configuring a new player template, which defines a custom Regions object, a label bundle to show the assessment player text in German, and configuration to only show one of the standard templates, and the newly defined custom player template in the list.

"enabled_player_templates": [
    "e883731f-6fb8-43b3-992b-14f53cdf8350",
    "some-unique-reference"
],
"default_player_template": "some-unique-reference",
"player_templates": [
    {
        "reference": "some-unique-reference",
        "name": "Regions with German Label Bundle",
        "regions": {
        "top-left": [
            {
                "type": "title_element"
            },
            {
                "type": "timer_element",
                "countdown_option": true
            }
        ],
        "left": [
            {
                "type": "save_button"
            },
            {
                "type": "fullscreen_button"
            },
            {
                "type": "separator_element"
            },
            {
                "type": "accessibility_button"
            },
            {
                "type": "calculator_button"
            },
            {
                "type": "verticaltoc_element"
            },
            {
                "type": "masking_button"
            },
            {
                "type": "next_button"
            },
            {
                "type": "previous_button"
            }
        ],
        "items": [
            {
                "type": "slider_element",
                "scrollable_option": false,
                "warning_on_change_option": false
            },
            {
                "type": "progress_element"
            }
        ],
        "bottom-right": [
            { "type": "next_button" },
            {
                "type": "previous_button"
            },
            {
                "type": "pause_button",
                "position": "right"
            },
            {
                "type": "itemcount_element"
            }
        ]
        },
        "labelBundle": {
            "accessibility": "Zugänglichkeit",
            "assessmentTimeExpired": "Die Zeit ist abgelaufen.",
            "calculator": "Taschenrechner",
            "close": "schließen",
            "configuration": "Konfiguration",
            "confirm": "Ja",
            "contactAdministrator": "Kontakt",
            "continue": "Fortsetzen",
            "decline": "Nein",
            "elapsedTime": "Verstrichen",
            "fullScreen": "Vollbild",
            "introItemMessage": "Drücken sie 'Start', wenn Sie bereit sind",
            "nextButtonLabel": "Nächster",
            "pause": "Pause",
            "play": "Abspielen",
            "previousButtonLabel": "Bisherige",
            "quit": "Verlassen",
            "reachedLastItem": "Das ist das ende.",
            "save": "Speichern",
            "saveButtonLabel": "Speichern",
            "saveInProgress": "Speichern...",
            "saving": "Speichern..",
            "startTest": "Beginne die Bewertung",
            "submit": "Einreichen",
            "submitButtonLabel": "Einreichen",
            "testPaused": "Pausiert"
        }
    }
],
            

 

In the preview mode, there are 2 tabs. List, and Player. The tabs differ by the rendering_type which the Items API is initialized in. 
Player tab is the view which the student will see (rendering_type: assess) and the List tab is there for easy viewing of all the Items without having to render the additional assessment assets. 
Note that the List mode actually renders using rendering_type: inline.

By default, Item references are not shown in preview mode, so one must refer back to the Item list to know what the reference of the Item which is shown was. In most use cases the Item reference is not important, however, in some there are (E.g. reviewing Items, if a problem is found, the Item reference is required in order to fix it) and so it's possible to turn on Item References in order to make it quick to check reference. 
To do this, one must set the init option activity_edit.activity_preview.item.reference.show to true as in the code example below.

 

"activity_preview": {
    "item": {
        "reference": {
            "show": true
        }
    }
},
        

 

That will show the Item references above the displayed Item, as shown in the screenshots below.

 

Player View

activity-editor-item-refs-2.png

  

List View

activity-editor-item-refs-1.png

Was this article helpful?
0 out of 0 found this helpful