The Exam Edit Layout is used to control the selection and sequence of Items on the Exam as well as the maintenance of Exam Sections and Attachment sizing and positioning. The Exam is composed of Sections that contain Items, Attachments and Item Groups (which themselves contain Items).
Note: User permissions might be restricted by Form permissions, Bank permissions or the record being locked.
User permission might also be restricted due to multiple Instances of the Exam existing or Registrant responses existing for the Exam. When an Exam has an alternate Instance, manipulation of the Items linked to the Exam is restricted as all Instances must contain the same Items. When an Exam already has responses records for the Registrants it means the Exam has been written by the registrants and modifying the Exam at this point will leave the Exam different to that presented to the Registrants.
The Exam Edit Layout pages consists of an Exam Layout tree on the left and a work/preview area on the right.
Item Writing supports multiple languages of Item and Exam text. Using the Language drop down selector the user can view alternate language previews of Items and Attachments as well as maintain different Section titles and descriptions.
When an Exam is first created, it consists of only an Exam Node. Clicking on the Exam Node in the Exam layout tree populates the work/preview area to the right with options to maintain Instances or to export the Exam.
Instance Maintenance allows the User to maintain different Instances (Forms) of the Exam. An Instance is a different sequence of the Items on the Exam. Items can be rearranges within the Sections of the Exam.
An Instance drop down selector allows the user to select the Instance they want to view/maintain.
There are two ways a new Instance can be created:
To Clone an Instance, click the Create New Instance button. To Scramble an Instance, check the Scramble Items on New Instance check box, then click the Create New Instance button.
Only the last Instance can be deleted. This means if there is Instance 1, 2 and 3 for an Exam, only Instance 3 can be deleted. This is to ensure contiguous Instances. Instance 1 cannot be deleted.
To Delete an Instance, select the last Instance from the Instance drop down selector. Then, click the Delete Instance button.
Exporting an Exam creates a .csv (comma separated values) file of all the Items linked to the Exam in the sequence they appear on the Exam. The export file is in the same format as the Item Import file. This means the export file can be created, modified, and then reimported.
Adds a new Section to the Exam layout. Sections can only be added to the Exam node and cannot be nested. Clicking Add Section opens a Section Edit window.
Once changes are made, click the Update button in the bottom right of the Edit Section window to update changes. Note: this does not save the changes to the database. this can only be done with the Save button on the Exam Layout page. To cancel changes, click the X in the top right corner of the Edit Section window.
Field | Description |
---|---|
Language | In the top right of the Edit Section window (in blue) there is Language drop down selector. Item Writing supports multiple languages for Item and Exam text. using the drop down selector allows the user to view/maintain alternate language text for the Section's title and description. |
Title | The title of the Section that appears in the Exam Layout tree, on reports and the Exam Document. (maximum 255 characters) |
Description | A rich text description of the Section. See rich text editor. |
External ID | Used to link to systems outside Item Writing. |
Enabled | Default is True (checked). |
Visible | Default is True (checked). |
Restart Item Number | If checked, when building Exam Documents the Item sequence restarts at 1 at the start of each Section. |
Pass Mark | The minimum value required to pass the Section. Used in conjunction with Pass Type. |
Pass Type | Possible values are Value Percent (candidate score as a percent is compared to Pass Mark as a percent) or Value Raw (candidates point total is compared to Pass Mark. Default is Value Raw. |
Round Type | Affects whether Candidate's Section score is rounded. The four round modes are: None (default) which does not round the score Round which rounds to the nearest whole number (.5 rounding to nearest even number) Ex 50.1 → 51, 51.5 → 52, 52.5 → 52 Round Up which always rounds up to the next whole number Ex 61.1 → 62 Round Down which always rounds dow to the previous whole number Ex 71.9 → 71 |
Weighting | Multiplier that gets applied to the Section score. Example: Registrant achieves 30 points in the section. Weighting = 0.5. Section score = 15 (30 * 0.5) |
Max Value | Capped score for the Section. On some Sections it is possible to achieve more points across the Items in the Section then the Max Score of the section. Max Value caps the Registrant score. Example: Candidate achieves 11 points in a Section across all its Items, but the Max Value=10. Registrants Section score = 10. |
Section Must Pass | If checked, the Registrant must pass the Section (based on Pass Mark, Pass Type) in order to Pass the Exam. |
Raw Cut Score | Used in Scaled Scoring. |
Alternate Mean | Used in TScore calculation for Exam TScore. If 0, calculated Exam Mean is used. Default 0 |
Alternate Stdev | Used in TScore calculation for Exam TScore. If 0, calculated Exam Standard Deviation is used. Default 0 |
See Scaled Scoring for more.
Opens an Attachment Selection dialog. Here, the user can select one or more Attachments to add to the Exam.
Select one or more Attachments from the grid, then click the Add Selected button. The Attachment Selector will close and the linked Attachments will appear in the Exam Layout tree. To learn more about selecting records click here.
Note: Attachments available for linking are dependant on the Status of the Attachment and Status of the Exam in the banks. See Status and Substatus for more.
Clicking on a Section Node in the Exam layout tree populates the work/preview area to the right with a preview of the Section title and description.
Adds a new Section to the Exam layout. Sections can only be added to the Exam node and cannot be nested. Clicking Add Section opens a Section Edit window. This functions identically to the Exam → Add Section described above.
This will edit the clicked Section. Editing the Section opens a Section edit window as described in Exam → Add Section above. Once changes are made, click the Update button in the bottom right of the Edit Section window to update changes. Note: this does not save the changes to the database. this can only be done with the Save button on the Exam Layout page. To cancel changes, click the X in the top right corner of the Edit Section window.
Opens an Attachment Selection dialog. Here, the user can select one or more Attachments to add to the Section. This is similar to the Exam → Add Attachment except the Attachment is added a child node to the selected Section. If there are already child nodes within the Section then the Attachment is appended to the end of the Section.
Opens an Item Selection dialog. Here, the user can select one or more Items to add to the Section. The Item Selector, like the Item Entry grid has an advanced filter option (in blue). See Item Entry for more.
Item selection supports two modes. One is selecting the specific Items to add. Select one or more Items from the grid, then click the Add Selected button (in red). The Item Selector will close and the linked Items will appear in the Exam Layout tree. The other is a random selection method. The User can filter the Item selection by various criteria. Then by entering a number in the Random Count box and clicking Select Random they can randomly select from the filtered Items available in the grid. If they select more than what is available, then they will select all available records.
To learn more about selecting records click here.
Note: Items available for linking are dependant on the Status of the Item and Status of the Exam in the banks. See Status and Substatus for more.
Depending on item Writing configuration, Add Item Group works one of two ways.
The first way it can work is an Item Group selector dialog is opened. Here the user selects among available Groups to add to the Exam.
The second way in an Item selector dialog is opened and only Items that are in an Item group are available for selection. Otherwise it works similar to Add Item described above.
When Group Items are added to the Exam, a Group node is added to the tree and all of the Items in that group are added as children of the Group node.
Group Item Notes
Group Items cannot be moved outside of the parent Group node. Other objects such as Sections, Items and Exams cannot be moved into the Group. Depending on Group properties Randomize Sort and Allow Partial Selection (see {Item_Group_edit|Item Group]]) resequencing or deleting Group Items within the group may be restricted.
Removes the Section and all of its children (Items, Attachments, Groups) from the Exam layout.
Note: Edits and removes are only done in memory. The change is not committed to the database until the Save button in the bottom right corner of the Exam layout page is clicked.
Sort allows for sorting of the Items within the selected Section. There are three options:
Clicking on an Attachment Node in the Exam layout tree populates the work/preview area to the right with a preview of the Attachment Image, size and placement and various meta like title and description.
Attachment Container is an inline modifier where the text will be reflected on the Exam Layout tree view. Additionally attachments contained in the same container 'number' can be sorted and kept together.
To add an item to an Item Container
To remove an item from an Attachment Container
Attachments and Items can be sorted by their containers. You can find the sort steps here.
Opens Edit Attachment dialog. Here, the user can control the position of the Attachment (left, center, right), its height (in pixels), width (in pixels) and Orientation (if checked, rotates image 90 degrees right). To update the changes click the Update button.
Removes the Attachment from the Exam layout.
Navigates the user to a read-only Attachment Entry tool. Here, the user can view all meta and information about the Attachment.
Note: edits and removes are only done in memory. The change is not committed to the database until the Save button in the bottom right corner of the Exam layout page is clicked.
Clicking on an Item Group Node in the Exam layout tree populates the work/preview area to the right with a preview of the Item Group header text, meta like title and description.
Removes the Item Group and all of its children (Items) from the Exam layout.
Note: removes are only done in memory. The change is not committed to the database until the Save button in the bottom right corner of the Exam layout page is clicked.
Navigates the user to a read-only Item Group Entry tool. Here, the user can view all meta and information about the Item Group.
Sort allows for sorting of the Items within the selected Item Group. This requires the Group to allow Randomize Sort. See Section → Sort described above.
Clicking on an Item node in the Exam layout tree populates the work/preview area to the right with a preview of the Item text, and metadata like title and status.
Item description is an inline modifier where the text will be reflected on the Exam Layout tree view. To create item description text:
To remove the Item Description text, follow the above steps, delete the text in the Item Description field, then click the Save button immediately below the Item Description field.
Item Container is an inline modifier where the text will be reflected on the Exam Layout tree view. Additionally items contained in the same container 'number' can be sorted and kept together.
To add an item to an Item Container
To remove an item from an Item Container
Items and attachments can be sorted by container.
Right-click on an item or attachment in the Exam Layout tree fiew and select Sort –> Sort by Custom
Select Group ID (see red highlight) and click the Apply Sort button
The items in the Exam Layout tree view will now appear sorted by the Container, where the container is surrounded by square ([]) brackets.
Opens an Item selector that only has other Versions of the current Item.
Note: Items available for linking are dependant on the Status of the Item and Status of the Exam in the banks. See Status and Substatus for more.
Removes the selected Item from the Exam Layout tree and opens an Item selector. Here, the user can select a single Item to replace the Item they removed. The newly selected Item takes the place, in sequence, of the removed Item.
Note: Items available for linking are dependant on the Status of the Item and Status of the Exam in the banks. See Status and Substatus for more.
Removes the Item from the Exam layout.
Note: Removes, switches and replaces are only done in memory. The change is not committed to the database until the Save button in the bottom right corner of the Exam layout page is clicked.
Navigates the user to a read-only Item Entry tool. Here, the user can view all meta and information about the Item.
Group Items have an additional option to View Item Group. This navigates the user to a read-only Item Group Entry tool. Here, the user can view all meta and information about the Item Group.
The user can resequence objects on the Exam Layout tree via drag and drop. There are certain restrictions.
The tab strip at the top of the page allows the user to go back to the Exam entry grid Selection, to the General page, to the Pass page, to the Notes and Custom page, to the Notes page or Document page. Audit will navigate to the Audit page and displays Audit information for the selected record.
If there are multiple versions of the Exam, the user can navigate amongst them using the Select Version drop down in the blue info bar. See Versioning for more.