====== 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 [[item_entry|Items]], [[attachment_entry|Attachments]] and [[item_group_entry|Item Groups]] (which themselves contain Items). 

Note: User permissions might be restricted by [[security_edit_forms|Form permissions]], [[security_edit_banks|Bank permissions]] or the record being [[concepts#Record Locking|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 [[general_navigation_tree|tree]] on the left and a work/preview area on the right.

{{:examlayoutexam.png?600|}}

=== Language ===
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.

===== Exam =====
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 [[stats_terminology#instance|Instances]] or to export the Exam.

==== Instances ====
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.

=== Select and Instance ===
An Instance drop down selector allows the user to select the Instance they want to view/maintain.

=== Create a new instance ===
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.

=== Delete an Instance ===
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.

==== Export Exam ====
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|Item Import]] file.  This means the export file can be created, modified, and then reimported.

==== Exam Context Menu ====
Right-clicking the Exam node opens the Exam context menu.

{{:examlayoutexamcontext.png?600|}}

=== Add Section ===
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.

{{:examlayouteditsection.png?600|}}

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 [[general_navigation_richtexteditor|rich text editor]].|
|External ID|Used to link to systems outside Item Writing.|
|Enabled|Default is True (checked). FIXME| 
|Visible|Default is True (checked). FIXME| 
|Restart Item Number|If checked, when building [[exam_document|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 [[Calculations#Scaled Scoring|Scaled Scoring]] for more.


=== Add Attachment === 
Opens an Attachment Selection dialog.  Here, the user can select one or more Attachments to add to the Exam.

{{:examlayoutaddattachment.png?600|}}

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 [[general_navigation_grids#Selecting Records|here]].

Note: Attachments available for linking are dependant on the Status of the Attachment and Status of the Exam in the banks.  See [[concepts#Status and Substatus|Status and Substatus]] for more.

===== Section =====
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.

==== Section Context Menu ====
Right-clicking the Section node opens the Section context menu.

{{:examlayoutsectioncontext.png?600|}}

=== Add Section ===
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.

=== Edit Section ===
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.

=== Add Attachment ===
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.

=== Add Item ===
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|Item Entry]] grid has an advanced filter option (in blue).  See [[Item_entry|Item Entry]] for more.

{{:examlayoutadditem.png?600|}}

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 [[general_navigation_grids#Selecting Records|here]].

Note: Items available for linking are dependant on the Status of the Item and Status of the Exam in the banks.  See [[concepts#Status and Substatus|Status and Substatus]] for more.

=== Add Item Group ===
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.

{{:examlayoutaddgroup.png?600|}}

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.

{{:examlayoutaddgroupadded.png?600|}}

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

=== Remove ===
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 ===
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.

{{:examlayoutsectionsort.png?600|}}

===== Attachment =====
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 ====
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

{{:examlayout:attachmentcontainer.set.png?400|}}

=== Sorting ===
Attachments and Items can be sorted by their containers. You can find the sort steps [[exam_edit_layout#sorting1|here]].

==== Attachment Context Menu ====
Right-clicking the Attachment node opens the Attachment context menu.

{{:examlayoutaddattachmentcontext.png?600|}}

=== Edit Attachment ===
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.

{{:examlayoutaddattachmentedit.png?600|}}

=== Remove ===
Removes the Attachment from the Exam layout.  

=== View ===
Navigates the user to a read-only [[attachment_entry|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.

===== Item Group =====
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.

==== Item Group Context Menu ====
Right-clicking the Item Group node opens the Item Group context menu.

{{:examlayoutgroupcontext.png?600|}}

=== Remove ===
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.

=== View ===
Navigates the user to a read-only [[item_group_entry|Item Group Entry]] tool.  Here, the user can view all meta and information about the Item Group.

=== Sort ===
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.

===== Item =====
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 ====
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.

{{:examlayout:itemdescription.png?400|}}

==== Item Container ====
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

{{:examlayout:itemcontainer.set.png?400|}}

=== Sorting ===
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

{{:examlayout:itemcontainer.sort.png?400|}}

Select Group ID (see red highlight) and click the Apply Sort button

{{:examlayout:itemcontainer.sortfield.png?400|}}

The items in the Exam Layout tree view will now appear sorted by the Container, where the container is surrounded by square ([]) brackets.

{{:examlayout:itemcontainer.sortresult.png?200|}}
==== Item Context Menu ====
Right-clicking the Item node opens the Item context menu.

{{:examlayoutitemcontext.png?600|}}

=== Switch Version ===
Opens an Item selector that only has other [[concepts#versioning|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 [[concepts#Status and Substatus|Status and Substatus]] for more.

=== Replace ===
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 [[concepts#Status and Substatus|Status and Substatus]] for more.

=== Remove ===
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.

=== View ===
Navigates the user to a read-only [[item_entry|Item Entry]] tool.  Here, the user can view all meta and information about the Item.

=== View Item Group ===
Group Items have an additional option to View Item Group.  This navigates the user to a read-only [[item_group_entry|Item Group Entry]] tool.  Here, the user can view all meta and information about the Item Group.


===== Drag and Drop =====
The user can resequence objects on the Exam Layout tree via [[general_navigation_tree|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.
==== Tab Strip ====
The tab strip at the top of the page allows the user to go back to the Exam entry grid [[exam_entry|Selection]], to the [[exam_edit_General|General]] page, to the [[exam_edit_pass|Pass]] page, to the [[exam_edit_notes|Notes and Custom]] page, to the [[exam_edit_notes|Notes]] page or [[exam_document|Document]] page.  Audit will navigate to the [[audit|Audit page]] and displays Audit information for the selected record.

==== Alternate Versions ====
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 [[concepts#Versioning|Versioning]] for more.