Changes between Version 2 and Version 3 of UserDocV3.1


Ignore:
Timestamp:
2013-05-03T18:30:37Z (11 years ago)
Author:
michael
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • UserDocV3.1

    v2 v3  
    4949These evaluations were already completed. Example:
    5050
    51 ||'''Event'''||'''Viewable Start / End'''||'''Group'''||'''Course'''||'''Due Date'''||'''Date Submitted'''||
    52 ||Evaluation 1||2013-01-01 00:00:00||Unnamed||COMP 101 101||Tues,Jan 1,2012 12:00 am||2012-11-23 12:24:51||
     51||'''Event'''||'''Result Available / End'''||'''Group'''||'''Course'''||'''Due Date'''||'''Date Submitted'''||
     52||Evaluation 1||2013-01-01 00:00:00||Unnamed||COMP 101 101||Tues, Jan 1,2012 12:00 am||2012-11-23 12:24:51||
    5353
    5454If the "Viewable Start / End" date is coloured
     
    6262These evaluations have expired and have not been completed. Example:
    6363
    64 ||'''Event'''||'''Viewable Start / End'''||'''Group'''||'''Course'''||'''Due Date'''||
    65 ||Evaluation 3||2013-01-01 00:00:00||Unnamed||COMP 101 101||Tues,Dec 25,2012 12:00 am||
     64||'''Event'''||'''Result Available / End'''||'''Group'''||'''Course'''||'''Due Date'''||
     65||Evaluation 3||2013-01-01 00:00:00||Unnamed||COMP 101 101||Tues, Dec 25,2012 12:00 am||
    6666
    6767If the name of the event is a link, results are viewable
     
    7272
    7373||'''Event'''||'''Course'''||'''Due Date'''||'''Due In / Late By'''||
    74 ||Survey 1||COMP 101 101||Tues,Jan 8,2013 12:00 pm||6 days||
     74||Survey 1||COMP 101 101||Tues, Jan 8,2013 12:00 pm||6 days||
    7575
    7676To complete a survey, just click on its title. So, to complete the above survey, you would click on "Survey 1".
     
    8181
    8282||'''Event'''||'''Course'''||'''Due Date'''||'''Date Submitted'''||
    83 ||Survey 2||COMP 101 101||Tues,Jan 1, 2013 12:00 pm||2012-12-25 11:37:17||
     83||Survey 2||COMP 101 101||Tues, Jan 1, 2013 12:00 pm||2012-12-25 11:37:17||
    8484
    8585The name of the event is a link to the answers submitted.
     
    8787==== Filling out Evaluations ====
    8888
    89 There are 3 types of evaluations in iPeer: Simple Evaluations, Rubrics, and Mixed evaluations.
     89There are 3 types of evaluations in iPeer: Simple Evaluations, Rubrics, and Mixed Evaluations.
    9090After clicking on an evaluation name, the selected evaluation will open.
    9191
    9292===== Simple Evaluations =====
    93 [[Image(simple_evaluation.png, 240px, align=right, border=3)]] 
     93[[Image(studentSimpleEval.png, 240px, align=right, border=3)]] 
    9494Simple evaluations are the most basic evaluation types in iPeer. They consist of a set number of points to distribute among your team members.
    9595The following instructions appear on the evaluation page itself:
     
    112112   * Check that you entered all the comments that you like, or are required to.
    113113  * If the Submit button is grayed out, something is likely missing. Check the comments and total number of real points once again.
    114  6. (Show / Hide late penalty policy)
     114 6. The evaluation can be repeatedly submitted until ''date''.
     115  * Resubmissions are allowed until the date and time specified.
     116 7. (Show / Hide late penalty policy)
    115117  * If the evaluation has a late penalty, details can be found here.
    116118  * If there are no late penalty, "No penalty is specified for this evaluation" will appear.
     119
     120===== Rubric Evaluations =====
     121[[Image(studentRubricEval.png, 240px, align=right, border=3)]] 
     122In Rubric Evaluations, you will rate your team members on different aspects of their performance.
     123 * For example, if one of your teammates participates very well in meetings, but is late turning-in assignments, you could rate them separately on these categories.
     124Each category has a score, and comment.
     125 * Filling out the score is required. Make sure to set a score for each category (the lowest score is selected by default, and your teammate probably deserves more!)
     126 * Comments may or may not be required, depending on your instructor's wishes. When writing comments, please be thorough, respectful and descriptive.
     127All you teammate's forms will be arranged in a "accordion"-type interface. This means that each member's evaluation is folded-up. Here's an example with 4 teammates:
     128||Group Member Wilma || - || (click to expand) ||
     129||Group Member Fred  || - || (click to expand) ||
     130||Group Member Betty || - || (click to expand) ||
     131||Group Member Barny || - || (click to expand) ||
     132 1. Your first teammate's evaluation will be shown already.
     133 2. Please fill out that first team mate's evaluation, and save it!
     134  * If you don't save each part as you fill it out, the information could be lost when you move on to the next teammate. Always be sure you saved.
     135 3. When you click another teammate's name, their evaluation forms will unfold. You can now complete the evaluation and Save it. Please complete each teammate's evaluation in this way.
     136  * You may freely go back and forth between your teammates, but if you modify anything for a teammate, please save their section before moving on.
     137  * When you save a section, the accordion interface will show your first teammate's evaluation form again. This is a known iPeer issue - please select your next teammate manually for now.
     138 4. When you have finished rating and commenting on all your teammates, submit the evaluation!
     139  * If the Submit button is disabled, some of the evaluations have not been complete. You should:
     140   * Check that you have completed the evaluations for everyone.
     141   * If your instructor requires comments, check all the input fields (blank-white areas) for your teammates are filled. There's a comment for each teammate's category, and a general comment about each teammate.
     142 5. Late Penalty
     143  * To check whether it is implemented for the evaluation, click on "(Show / Hide late penalty policy)".
     144 6. The evaluation can be repeatedly submitted until the date and time specified in the instruction.
     145
     146===== Mixed Evaluations =====
     147[[Image(studentMixedEval.png, 175px,  align=right, border=3)]] 
     148Mixed evaluations may have different question types that include Likert questions (rubric-like),
     149short answers, long answers, and Score Dropdown (simple evaluation like).
     150 1. Evaluate your team mates by answering the questions below their name.
     151 2. All required questions are marked with a red *.
     152 3. You can save your evaluation by clicking on the Submit button at the bottom of the page. Your answers would be saved; however the evaluation would not be submitted until all the required questions are answered.
     153  * Note: If the evaluation has a Score Dropdown question, the evaluation cannot be saved or submitted before all the points are distributed among the members
     154 4. After you have filled out all the required questions, you can fill submit the evaluation by clicking on the Submit button.
     155 5. The evaluation can be repeatedly submitted until the date and time specified in the instruction.
     156  * Note: Resubmissions can only be made if all required questions are answered. 
     157 6. Late Penalty
     158  * To check whether it is implemented for the evaluation, click on "(Show / Hide late penalty policy)".
     159
     160=== Instructors ===
     161Instructors are responsible for importing student into iPeer, and creating and scheduling evaluations. There are many options and tools; these will be covered in the next sections.
     162
     163==== New to iPeer? ====
     164If you're an instructor that just started to use iPeer, this is how you can get started.
     165After your account has been created by an administrator, you are ready to login and use iPeer.
     166 * You should login with the username and password provided by your admin.
     167 * If you are at UBC, please note that CWL login ''does not'' work for instructor accounts. In iPeer, CWL is meant for students only.
     168Next is a list of steps for new Instructors. To get your courses up and running, you should:
     169 1. First, create a course!
     170 2. Then, add students to your course, either one-by-one, or all at once using a CSV file.
     171 3. Assign your students into groups.
     172You would then be ready to create evaluations for your students to complete, which is done like this:
     173 1. Create an Evaluation. There are 3 types available, and each evaluation can be re-used many times.
     174 2. Create an Evaluation Event. This will give the evaluation to the students to complete, once.
     175 3. After the due date, look at the Evaluation Event results, or export them into a CSV file.
     176
     177All of these steps are described in detail in the sections bellow.
     178
     179==== Courses ====
     180All objects in iPeer have some connection with courses. Courses contain student lists, group lists, and evaluation events.
     181
     182===== Creating a Course =====
     183[[Image(addCourse.png, 240px,  align=right, border=3)]] 
     184[[Image(courseIndex.png, 240px,  align=right, border=3)]]
     185To create a course:
     186 1. Click on the courses tab.
     187 2. Click "Add Course", just like in the image on the right
     188 3. Enter a course name. This is best done as [Department] [Course#] [Section#], so for example:
     189  * ENGL 112 102, meaning this is English course number 112, section 102.
     190 4. Enter a course Title, like:
     191  * Academic Writing
     192 5. Select the instructor(s) of the course. Click "Add Instructor".
     193 6. Select the tutor(s) of the course. Click "Add Tutor".
     194 7. Select the department the course belongs to. This will allow admins to help troubleshoot. To select multiple departments hold "ctrl" or "command" key.
     195 8. Enter a homepage for the course, with a URL starting with !http:// or !https://
     196 9. Click Save. A course list will show up, and you can select your new course to start adding students. To do this, click on the course's name or title.
     197
     198===== Course Maintenance =====
     199If you ever wish to edit the information you entered when creating your course, you can do this from the courses tab:
     200 1. Click on the courses tab.
     201 2. Right click on the course and select "Edit Course" on the menu.
     202 3. Edit any information you choose, and save it by clicking the "Update Course" Button.
     203
     204You may also delete your own courses. Please be warned: deleting a course also removes all students from that course, their responses to evaluations for that course, and any evaluation events. If you are absolutely, positively sure that you want to delete a course, this is done by:
     205 1. Clicking on the courses tab.
     206 2. Right click on the course and select "Delete Course" on the menu.
     207 3. Confirm that you intend to delete the course by clicking on the OK button.
     208 4. The course is now deleted.
     209
     210==== Course Home Screen ====
     211Most functionality is accessed from a course's home screen. You can manage students, groups, and evaluation events from the home screen. To activate it:
     212 1. Click on the courses tab.
     213 2. Click on your course's name or title links.
     214Details of what is done at the home screen are found in the next few sections.
     215
     216==== Students ====
     217Adding students to your courses can be done in 2 ways, and these are explained bellow:
     218===== Adding Students one by one =====
     219This method is best for classes with few (10-20) students. Each student is entered manually via iPeer form. For larger classes, it may be better to assemble a CSV form, as described in the next section
     220 1. Go to a course's home page.
     221 2. Click on "Add Student"
     222 3. Enter the student's username. If
     223   i. a duplicate username error appears, click on "here" to enrol the student.
     224   ii. no duplicate username error appears, enter the student's data.
     225    * Note: Username, First Name, Last Name are all required. Email is not required.
     226    * Click Save to add the student, the student password will now be randomly generated and printed near the top of the interface. Please record this password, and give it to this student so that they can login.
     227    * Note, that recording a password is not necessary if you are at UBC, since the students can use CWL to login to iPeer.
     228    * Click on Save & Add Another to add more students. Then, repeat from step 3. for all the students in the class.
     229
     230===== Adding Students via CSV file =====
     231To add many students as once, you can create a CSV file in the following format:
     232
     233Each line represents a new student, and the column order is the following:
     234{{{
     235Username, First Name,Last Name, Student#, Email (optional), Password (optional)
     236}}}
     237{{{
     23822928030, Sam, Badhan, 22928030, sam@server.com, password123
     23978233046, Jamille, Borromeo, 78233046, jb@server.com, pass5323123
     24039577051, Jordon, Cheung, 39577051, jc@server.com, psaswdrcD23 
     24168000058, David, Cliff,  68000058,  dc@server.com, password123
     242}}}
     243If you wish to leave the Email Column out, just empty that column out, leaving the comma, for example:
     244{{{
     24522928030, Sam, Badhan, 22928030,, password123
     24678233046, Jamille, Borromeo, 78233046,, pass5323123
     24739577051, Jordon, Cheung, 39577051,, psaswdrcD23 
     24868000058, David, Cliff,  68000058,, password123
     249}}}
     250Note the double-comma between the student number, and the password.
     251 
     252This type of file should be created in a text editor, like Notepad. You could also create this file with a spreadsheet editor like !OpenOffice Calc, or Microsoft Excel, but make sure you set the CSV export settings correctly when saving the file:
     253 * Comma character as the separator.
     254 * No quotes in rows or columns.
     255
     256When the CSV file is ready, do the following to access the student import form.
     257 1. Go to a course's home page.
     258 2. Click on "Import Students"
     259
     260[[Image(importedStudents.png, 240px,  align=right, border=3)]]   
     261[[Image(importClassList.png, 240px,  align=right, border=3)]]
     262Follow the steps below to upload your CSV to iPeer.
     263 1) Select the file to import, click on the '''Browse...''' button and select the file from your computer.
     264 2) Select the course to import into:
     265   * Make sure to choose the right course to import the students into. This will not always be set to your current course, so please check this field before importing.
     266 3) If you would like to update your current class list in iPeer (eg. remove students not in your new list and enrol new students in your list), check off "Update Class".
     267   * If you prefer to only add the new students from your new list and not remove students that are not in your new list, don't check off "Update Class".
     268 4) Once ready, press Import button to import the students. The next screen will display a summary of the students that were imported. Look over the data to check that the import process completed successfully.