Exam Edit Layout

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:

• Clone an Instance. Cloning an Instance copies the current Instance with all items in the same sequence.
• Scramble an Instance. Scrambling an Instance copies the current instance but randomizes the sequence of Items on the Exam.

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.

Right-clicking the Exam node opens the Exam context menu.

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.

Right-clicking the Section node opens the Section context menu.

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:

• Sort By Attachment - will arrange the Items by linked Attachments. That way all items with the same linked Attachments are kept together.
• Sort By Reference - will arrange the Items by linked References. That way all items with the same linked References are kept together.
• Custom Sort - opens an Exam Object Sort dialog. Here, the User can select up to three Item fields on which to sort, either ascending or descending. Once options are selected, click the Apply Sort button to apply the sort to the section.

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

• left-click on an attachment in the Layout tree view
• navigate to the Item Container field (outlined in red) and select a numeric container value from the dropdown list
• click the Save button immediately below the Item Container field
• the Layout treeview will be updated to show the attachment has been added to the Item Container, where the container is surrounded with square ([) brackets

To remove an item from an Attachment Container

• left-click on an item in the Layout tree view
• navigate to the Item Container field (outlined in red) and select a numeric container value from the dropdown list
• click the Remove button immediately below the Item Container field
• the Layout treeview will be updated to show the item is no longer a member of the Item Container

Attachments and Items can be sorted by their containers. You can find the sort steps here.

Right-clicking the Attachment node opens the Attachment context menu.

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.

Right-clicking the Item Group node opens the Item Group context menu.

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:

• left-click on an item in the Layout tree view
• navigate to the Item Description field (outlined in red) and enter the descriptive text
• click the Save button immediately below the Item Description field
• the Layout treeview will be updated to show the 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

• left-click on an item in the Layout tree view
• navigate to the Item Container field (outlined in red) and select a numeric container value from the dropdown list
• click the Save button immediately below the Item Container field
• the Layout treeview will be updated to show the item has been added to the Item Container, where the container is surrounded with square ([) brackets

To remove an item from an Item Container

• left-click on an item in the Layout tree view
• navigate to the Item Container field (outlined in red) and select a numeric container value from the dropdown list
• click the Remove button immediately below the Item Container field
• the Layout treeview will be updated to show the item is no longer a member of the 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.

Right-clicking the Item node opens the Item context menu.

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.

• Exam node cannot be moved. it is always at the root of the tree.
• Section nodes cannot be dragged into another Section. They can only be positioned before or after each other.
• Attachment nodes can have no objects dragged onto them. Objects can be dragged before or after Attachment nodes.
• Attachment nodes cannot be dragged into an Item Group.
• Items can only be dragged inside a Section. They cannot be dragged to the Exam or dragged into an Item Group. Items can be dragged from one Section to another Section but only if multiple Instances do not exist.
• Item Groups can only be dragged inside a Section. They cannot be dragged to the Exam or dragged into another Item Group. Item Groups can be dragged from one Section to another Section but only if multiple Instances do not exist.
• Group Items cannot be dragged outside the Item Group. If their parent Item Group does not support Randomize Sort, then Group items cannot be resequenced.

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.