View source for CSC/ECE 517 Spring 2014/E1412-Creating Custom Rubric-updated

Custom rubrics have been added to the [http://expertiza.ncsu.edu/ Expertiza] project starting the Spring semester of 2012.<br>
E1412-Rubric Specialization has been implemented in Spring semester of 2014. In this project, we rearrange questions based on response count received for each question. Section 'Rearranging of questions based on response count' explains how grouping of questions while creating custom rubric will affect this rearrangement.
== Introduction ==
With custom rubrics you can create your own rubrics using five different types of questions: checkboxes, text fields, text areas, file upload boxes, and drop-down selectors.  For each question you select the question type and a list of parameter, some of which are optional.  Each different set a parameters is separated by the double colon (::).  Some parameters may also have a subset of parameters.  These are separated by a single vertical bar (|).
== Tables ==
Your question can we organized into a table.  There are some restrictions however.  The questions in a table must all be of the same type and must be in the same section.  You can have a table without a title but you still need to leave an empty parameter in the set of parameters (::::).   When inputting questions you must go column by column, top to bottom.  The table parameters will always be the last three parameters of a question.  Currently you can organize checkboxes, text areas, and drop-downs into tables.
The following is one way to have a table of checkboxes with no table title.  It is a two by two table.
*section::::tableHeader1|tableHeader2::1|2|1|2
*section::::tableHeader1|tableHeader2::2|2|1|2
*section::::tableHeader1|tableHeader2::1|2|2|2
*section::::tableHeader1|tableHeader2::2|2|2|2
== Text Fields == 
With text fields you, are able combine them together with some text as a separator to create different types of questions.  The following is a way to arrange two text fields.  This could be used to represent a period of time.  Such as: “The sources are from ____ through ____”.
*Sources::5::through::1|2
*Sources::5::through::2|2
== File Uploads ==
Each file upload question will have the following text prepended to question.
<p><b><font color='red' size ="4">WARNING!!</font> You must save your review
    <font size="3"><u>BEFORE</u></font> you upload a file. Any text that has not been saved
    <font size="3"><u>WILL BE LOST</u></font> when you click on the Upload File link.
    </b>To save your review, click Save Review at the bottom of this page.
    <font size="2"><i>(If you forget to save before uploading a file, you should be able to recover your text by hitting the back button twice.)</i></font></p>
== Ratings ==
<p>Ratings consist of 2 parts, a drop down with the global score range values for the questionnaire, and a text area allowing the review to explain the given score</p>
<p>Ratings are the only questions that can have a weighted score.  They are also the only question where advice can be added.</p>
<p>They are differentiated as such:</p>
*dropdown - section::1|2
*textarea - section::2|2
== Parameter Definitions ==
*section – this parameter allows the questions to be grouped into sections that can easily be expanded and collapsed to organize and navigate
*size – this parameter allows you to customize the dimensions of a text area or the length of a text field.  If no value is provided, default values are used
*tabletitle – a title above your table of questions
*tableheader- option column headers for a table
*curr_col_ques – the current question in the column
*max_col_ques – total number of questions in the current column
*curr_col – the column in which the question will reside
*max_col – the maximum number of columns in the table
*separator – a value to separate text fields. 
*ddvalue – the vales to be represented in the dropdown
== Question Parameters == 
*<span style="color:#FF0000">Red - Required</span>
*<span style="color:#008000">Green - Optional</span>
*<span style="color:#0000FF">Blue- Optional, but required if using this feature</span>
===Checkbox===
*<span style="color:#FF0000">section</span>::<span style="color:#008000">tableTitle</span>::<span style="color:#008000">tableHeader1|tableHeader2</span>::<span style="color:#0000FF">curr_col_ques|max_col_ques|curr_col|max_col</span>
===TextField===
*<span style="color:#FF0000">section</span>::<span style="color:#008000">size</span>::<span style="color:#0000FF">separator1|separator2</span>::<span style="color:#0000FF">curr_ques|max_ques</span>
===TextArea===
*<span style="color:#FF0000">section</span>::<span style="color:#008000">size</span>::<span style="color:#008000">tableTitle</span>::<span style="color:#008000">tableHeader1|tableHeader2</span>::<span style="color:#0000FF">curr_col_ques|max_col_ques|curr_col|max_col</span>
===UploadFile===
*<span style="color:#FF0000">section</span>
===DropDown===
*<span style="color:#FF0000">section</span>::<span style="color:#FF0000">ddValue1|ddValue2</span>::<span style="color:#008000">tableTitle</span>::<span style="color:#008000">tableHeader1|tableHeader2</span>::<span style="color:#0000FF">curr_col_ques|max_col_ques|curr_col|max_col</span>
== Rearranging of questions based on response count ==
In project E1412-Rubric Specialization, we rearrange questions in a rubric within the accordion panel and also rearrange panels based on responses received for each question. The questions with least number of responses are moved up in the rubric display to reviewer to get more responses for these questions.
<br><br>
To keep the relative order of questions fixed (for example: for ratings, the dropdown and comments textbox should appear together i.e. their relative ordering should not change based on different response counts), we need to specify the parameters curr_col_ques|max_col_ques as 1|2 for first question in the grouping while 2|2 for second one. For more than 2 questions, use similar logic and set max_col_ques according to total questions grouped together. In this case, we assign response count of the primary question to rest of the questions in the group. This ensures their relative order does not change after rearrangement.