Differences

This shows you the differences between two versions of the page.

--- exam_edit_layout [2017/03/21 10:35]
steveclarke [Item Context Menu]
+++ exam_edit_layout [2018/10/23 10:45] (current)
mikecable [Attachment Container]
@@ Line 53: / Line 53: @@
 |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_naivgation_richtexteditor|rich text editor]].|
+|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|
@@ Line 137: / Line 137: @@
 ===== 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 ====
@@ Line 176: / Line 196: @@
 ===== 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 meta like title and status.
+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.
@@ Line 193: / Line 255: @@
 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 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.
+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_group_entry|Item Group Entry]] tool.  Here, the user can view all meta and information about the Item Group.
+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.
+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.