Differences

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

--- item_edit_text_edit [2017/03/15 15:07]
steveclarke
+++ item_edit_text_edit [2017/03/20 11:35] (current)
steveclarke [Track Changes]
@@ Line 1: / Line 1: @@
 ===== Item Edit Text Edit =====
-The Item value edit page allows users to edit value information for an Item record.  Value information for items primarily applies to essay/constructed response [[concepts#Item Types|type Items]].  Once changes are made the user can click the **Save** button in the bottom right hand corner to commit changes to the database.  Note: User rights might be restricted by [[security_edit_forms|Form rights]], [[security_edit_banks|Bank rights]] or the record being [[concepts#Record Locking|locked]].
+The Item Edit Text Edit page allows the user the ability to Edit the Title and Text of the Item along with setting which options are correct and the point values associated with them.  Once changes are made the user can click the **Save** button in the bottom right hand corner to commit changes to the database and close the Tet Edit page.  Click **Cancel** button to undo all edits and close the Text Edit page.
-{{:itemeditvalue.png?600|}}
+Note: Though edits are preserved in memory on this page so that the user can edit the stem than options, the changes are not committed to the database until the **Save** button is clicked.
+Note 2: User permissions might be restricted by [[security_edit_forms|Form permissions]], [[security_edit_banks|Bank permissions]] or the record being [[concepts#Record Locking|locked]].
-==== Item Fields ====
+{{:itemedittextedit.png?600|}}
-^ Field ^ Description ^
-| Item ID | Will populate automatically when the Item is created. Unique identifier of the Item. |
+==== Editing Text and Options ====
-| Item Value Max| Essay/constructed response type Items have point values entered for the candidate scores.  This is the maximum acceptable point value for this item.  Example: and essay Item out of 15 points would have 15 as its Value Max.|
+Editing text is done by using the rich text editor (in yellow).  To start editing, click on the editor which will then display the editor tool bars.  Clcik for more on [[general_navigation_radeditor|Rich Text Editor]].
-| Item Value Default| Default score if not otherwise entered by mark entry or scan process.  Default value is 0.|
-| Weighting| Multiplier that is applied to the Candidate's Item score.  Typically this is used to Scale Item scores to a common denominator.|
+Th Item itself is comprised of a stem (generally the question) and a set of options (each of the possible answers to the Item question text).  To select the stem or one of the options to edit, click the respective node in the **Select item Element** tree (in orange).
-| Item Time| Used in online testing (FIXME link).  Controls the maximum time (in minutes) the candidate can take to answer the item.|
-| Item Pass| The minimum value required to pass the Item.|
+{{:itemedittexteditoption.png?600|}}
-| Item Pass Type| Possible values are Value Percent (candidate score as a percent is compared to Item Pass as a percent) or Value Raw (candidates point total is compared to Item Pass. Default is Value Raw.|
-| Item Round Type|Affects whether Candidate's Item 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 1.1 → 1, 1.5 → 2, 2.5 → 2 \\ Round Up which always rounds up to the next whole number Ex 1.1 → 2 \\ Round Down which always rounds dow to the previous whole number Ex 1.9 → 1|
+=== Options ===
-| Item Must Pass| If checked, any Exam that uses this Item requires the Candidate to pass this item or they fail the Exam.  Default false (unchecked)|
+When editing Item Options, there are additional controls (in pink) exposed to modify the value for the option, whether it can scramble or is a distractor.
-|Alternate Values If Skipped| Item Writing supports up to 5 sets of answer key values.  If Skipped 1-5 is the default value if the Candidate did not respond to a Multiple choice option.  Typical use is for assigning a penalty (eg -0.5) for skipping an Item.|
+^Field^Description^
-|Alternate Other| Item Writing supports up to 5 sets of answer key values.  Other 1-5 is the default value for selecting an option if the option does not otherwise have its value specified.|
+|Value|The points awarded to a registrant for selecting this option.  The value can be a decimal number.  it can be worth 0 points.  it can also be a negative value to penalize Registrant for guessing.|
+|Correct|Indicates the option is correct.  All QtyCorrect type stats are based on whether the option is correct or not.  Even if an option has a value, it is not considered correct unless it is flagged as correct.|
+|Scramble|Future use for option scrambling.|
+|Distractor|Informational in that it does not affect calculations. Of value to users who specifically want to track the outcome of a single option.|
+=== Is Dichotomous? ===
+The **Is Dichotomous?** checkbox (in purple) controls whether the item is Dichotomous.  Dichotomous items can only have 1 correct option worth 1 point and all other options are incorrect and worth 0.  Checking the **Is Dichotomous?** checkbox means that when any option is flagged as correct it automatically sets the value to 1 point and all other options become incorrect and their value is set to 0 points.  For Likert scaled Items, make sure **Is Dichotomous?** is unchecked so that each option can have its own value and correct/incorrect state.
+==== Text Preview ====
+The user can show/hide the Item preview which displays the Item stem and option text formatted.  It also displays any linked or embedded [[attachment_entry|Attachment]] images.  This area can be shown or hidden to save on screen real estate by using the **Show/Hide Preview** check box (in blue).  The user can also refresh the preview display by clicking the **Refresh Preview** button.
+{{:itemedittextedithidepreview.png?600|}}
+==== Track Changes ====
+Item Writing supports a [[concepts#track changes|Track Changes]] feature that uses additional markup to highlight areas of changed text on the Item or Option text.  This additional markup is preserved with the Item text until such time as the changes are accepted.  Only systems with the track Changes functionality implemented have these options available.
+In screen shot above, the stem text of the Item has Track Changes mark up.  Once the changes are accepted (using the **Accept Changes** button (in green) the additional mark up is removed.
+{{:itemedittexteditaccepted.png?600|}}
-==== Tab Strip ====
-The tab strip at the top of the page allows the user to go back to the Item entry grid [[item_entry|Selection]], to the [[item_edit_general|Item Edit General]] page, to the [[item_edit_text|Item Edit Text]] page, to the [[item_edit_competency|Item Edit Competency]] page, to the [[item_edit_reference|Item Edit Reference]] page, to the [[item_edit_attachment|Item Edit Attachment]] page, to the [[item_edit_stats|Item Edit Statistics]] page or [[usage|Usage]] page.  Note: depending on system configuration not all options are available.
-==== Alternate Versions ====
-If there are multiple versions of the Item, the user can navigate amongst them using the **Select Version** drop down in the blue info bar.  See [[concepts#Versioning|Versioning]] for more.