Changes between Version 3 and Version 4 of SetupDev3

Timestamp:

2013-01-03T00:20:00Z (11 years ago)

Author:

michael

Comment:

adding/importing students

SetupDev3

@@ -160 +160 @@
  5. Late Penalty
   * To check whether it is implemented for the evaluation, click on "(Show / Hide late penalty policy)".
+
+=== Instructors ===
+Instructors are responsible for importing student into iPeer, and creating and scheduling evaluations. The have many options and tools; these will be covered in the next sections.
+
+==== New to iPeer? ====
+If you're an instructor that just started to use iPeer, this is 
+After your account has been created by an administrator, you are ready to login and use iPeer.
+ * You should login with the username and password provided by your admin. 
+ * If you are at UBC, please note that CWL login ''does not'' work for instructor accounts. In iPeer, CWL is meant for students only.
+Next is a list of steps for new Instructors. To get your courses up and running, you should:
+ 1. First, create a course!
+ 2. Then, add students to your course, either one-by-one, or all at once using a CSV file.
+ 3. Assign your students into groups.
+You would then be ready to create evaluations for your students to complete, which is done like this: 
+ 1. Create an Evaluation. There are 3 types available, and each evaluation can be re-used many times.
+ 2. Create an Evaluation Event. This will give the evaluation to the students to complete, once.
+ 3. After the due date, look at the Evaluation Event results, or export them into a CSV file.
+
+All of these steps are described in detail in the sections bellow
+
+==== Courses ====
+All objects in iPeer have some connection with courses. Courses contain student lists, group lists, and evaluation events.
+
+===== Creating a Course =====
+[[Image(add_course.png, 240px,  align=right, border=3)]]  
+[[Image(course_index.png, 240px,  align=right, border=3)]]
+To create a course:
+ 1. Click on the courses tab.
+ 2. Click "Add a course", just like in the image on the right
+ 3. Enter a course name. This is best done as [Department] [Course#] [Section#], so for example:
+  * ENGL 112 102, meaning this is English course number 112, section 102.
+ 4. Enter a course Title, like:
+  * Academic Writing
+ 5. Select the instructor(s) of the course. To select multiple instructors hold "ctrl" or "command" key.
+ 6. Select the department the course belongs to. This will allow admins to help troubleshoot.
+ 7. Enter a homepage for the course, with a URL starting with !http:// or !https://
+ 8. 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.
+
+===== Course Maintenance =====
+If you ever wish to edit the information you entered when creating your course, you can do this from the courses tab:
+ 1. Click on the courses tab.
+ 2. Right click on the course and select "Edit Course" on the menu.
+ 3. Edit any information you choose, and save it by clicking the "Update Course" Button.
+
+You 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:
+ 1. Clicking on the courses tab.
+ 2. Right click on the course and select "Delete Course" on the menu.
+ 3. Confirm that you intend to delete the course by clicking on the OK button.
+ 4. The course is now deleted.
+
+==== Course Home Screen ====
+Most functionality is accessed from a course's home screen. You can manage students, groups, and evaluation events from the home screen. To activate it:
+ 1. Click on the courses tab.
+ 2. Click on your course's name or title links.
+Details of what is done at the home screen are found in the next few sections.
+
+==== Students ====
+Adding students to your courses can be done in 2 ways, and these are explained bellow:
+===== Adding Students one by one =====
+This 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
+ 1. Go to a course's home page.
+ 2. Click on "Add Student"
+ 3. Enter a student's data.
+  * note: Username (Student #), First Name, Last Name are all required. Email is not required.
+ 4. 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.
+  * Note, that recording a password is not necessary if you are at UBC, since the students can use CWL to login to iPeer.
+  * Click on Save & Add Another to add more students. Then, repeat from step 3. for all the students in the class.
+
+===== Adding Students via CSV file =====
+To add many students as once, you can create a CSV file in the following format:
+
+Each line represents a new student, and the column order is the following:
+{{{
+Username, First Name,Last Name, Student#, Email (optional), Password (optional)
+}}}
+The username should be the same as the student number.
+{{{
+22928030, Sam, Badhan, 22928030, sam@server.com, password123
+78233046, Jamille, Borromeo, 78233046, jb@server.com, pass5323123
+39577051, Jordon, Cheung, 39577051, jc@server.com, psaswdrcD23  
+68000058, David, Cliff,  68000058,  dc@server.com, password123
+}}}
+If you wish to leave the Email Column out, just empty that column out, leaving the comma, for example:
+{{{
+22928030, Sam, Badhan, 22928030,, password123
+78233046, Jamille, Borromeo, 78233046,, pass5323123
+39577051, Jordon, Cheung, 39577051,, psaswdrcD23  
+68000058, David, Cliff,  68000058,, password123
+}}}
+Note the double-comma between the student number, and the password.
+ 
+This 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:
+ * Comma character as the separator. 
+ * No quotes in rows or columns.
+
+When the CSV file is ready, do the following to access the student import form.
+ 1. Go to a course's home page.
+ 2. Click on "Import Students"
+
+[[Image(imported_students.png, 240px,  align=right, border=3)]]   
+[[Image(import_students.png, 240px,  align=right, border=3)]]
+Follow the steps below to upload your CSV to iPeer.
+ 1) Select the file to import, click on the '''Browse...''' button and select the file from your computer.
+ 2) Select the course to import into:
+   * 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.
+ 3) 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. 
+     
+==== Groups ====
+[[Image(documentation-groupCreationManual.png, 240px,  align=right, border=3)]] 
+After students are imported, groups should be created. The manual was to create groups is recommended
+===== Manual Group Creation =====
+This can be done manually (quick and simple for small to medium sized classes, maybe up to 50 students).
+ 1. Go to a course's home page.
+  * If the "Groups" menu is hidden, unhide it by clicking "show/hide" link to its right.
+ 2. Click on "Create Group (Manual)". This will open the group creation window.
+ 3. There are 2 list of students, one full of your class students on the left, and one empty on the right.
+  * See figure to the right for a screen-shots and pointers '''---->'''
+  * The students on the left are your unassigned class students, that are waiting to be assigned into groups.
+  * The students on the right are already in the group you are creating (and since this is a new group, this list is empty!)
+ 4. Add students to this group. You could do any on the following bellow.
+  * Select one student at a time from the left list, and click the "Assign >>"  button. This will add the student to the group. Or you could...
+  * Select more than on student by holding the Control key while clicking on students, then clicking the "Assign >>"  button. This would transfer all the selected students to the group
+  * A combination of the above methods. Ex: Select and Add 2 students at a time, then repeat 3 times to make a group of 6.
+ 5. If you added a student by mistake, you could remove them from the group by selecting the student from the right list, and clicking on "Remove".
+ 6. When you are done adding students to the group, please:
+  * Enter a group number for these students
+  * Enter a group name for these students
+  * Click "Add Group" on the bottom of the page
+ 7. Repeat this process for all the groups in you class.
+
+===== Importing group list from CSV file =====
+This method is suited to grouping students in very large classes. It involves a similar process to importing students from a CSV file above.
+
+You should first prepare a CSV file in the following format:
+The column order is
+{{{
+Student#, Group#, Team Name
+}}}
+And the file contents is like:
+{{{
+29978037, 1, Team A
+29978063, 1, Team A
+29978043, 2, Team B
+29978051, 2, Team B
+}}}
+
+Please ensure that all the students listed have already been created in iPeer, and added to the class.
+
+Just like for the student import procedure, this 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:
+ * Comma character as the separator. 
+ * No quotes in rows or columns.
+
+Once this file is prepared, you are ready to import it into iPeer.
+
+ 1. Go to a course's home page.
+  * If the "Groups" menu is hidden, unhide it by clicking "show/hide" link to its right.
+ 2. Click on "Create Group (Manual)". This will open the group creation window.
+ 3. On the bottom of the page, there is a line stating Import Groups From Text (.txt) or CSV File (.csv) '''[+]''' Click on the orange [+] on the right of the page to continue.
+
+All you need to do now is just follow the instruction for importing the file:
+ 1) Please select a CSV file to import:
+   * Click "Browse..." and find the CSV file you created.
+ 2) Select the course to import into:
+   * Be sure to select the right course to import, since the list will likely not have your courses selected by default.
+ 3) Click the button bellow to create the Groups:
+   * After you are sure everything is set up correctly, click on import. This will process the file, and take you to the group listing for your course. The group creation process is now complete.
+
+==== Evaluations ====
+
+Evaluations can be created at any time in iPeer. There are 3 general types of Evaluations, all have their benefits and drawbacks.
+
+===== Simple Evaluations =====
+[[Image(documentation-simpleEvalExample1.png, 240px, align=right, border=3)]]  
+Simple evaluations let a student distribute a set number of points among her or his teammates, and comment on their score for each teammate. See the screen shot to the left.[[br]]
+This type of evaluation is the easiest to set up by instructors and do by students, taking the least time. However, it rates students as a whole, and does not ask specific questions about their team contributions.
+
+To see a screen cast of how to create a simple evaluation and assign it to student groups, see:
+{{{
+#!html
+<a href="http://ipeerdev.olt.ubc.ca/img/wizard/Simple.swf" target="_blank">Screen cast about creating Simple Evaluations and their evaluation events.</a>
+}}}
+
+The following instructions are a little more up to date.[[br]]
+To create a simple evaluation:
+ 1. Click on the Evaluation Tools, tab, then, on the right, the Add Simple Evaluation link in orange. This will make the "Add Simple Evaluation
+ form appear.
+ 2. On this form, please enter
+  * Evaluation Name (required)
+  * Description, if you like
+  * Base Point Per Member - recommended values are between 10 and 100. 
+ 3. Click "Save" button to create the evaluation
+
+Remember to create an "Evaluation Event" when you are done! Otherwise your students won't see the your evaluation.[[br]]
+You can create as many "evaluation events" for your Evaluation as you like (for example, one event for each class assignment in your class).[[br]]
+Read about [#point1 Evaluation Event]s here.
+
+===== Rubric Evaluations =====
+[[Image(documentation-rubricEvalExample1.png, 240px, align=right, border=3)]]
+
+To see a screen cast of how to create a Rubric and assign it to student groups, see raw-attachment:Rubric.swf
+{{{
+#!html
+<a href="http://ipeerdev.olt.ubc.ca/img/wizard/Rubric.swf" target="_blank">Screen cast about creating Rubrics and their evaluation events.</a>
+}}}
+The following instructions are a little more up to date.[[br]]
+To create a Rubric evaluation:
+ 1. Click on the Evaluation Tools, tab, then, under the Rubrics section, on the right,Add Rubric link in orange. This will make the "Add Rubric" Form Appear.
+ 2. There are 2 parts to the Rubric Add form. On this part, please enter:
+  * Evaluation Name (required)
+  * Levels Of Mastery (LOM):
+   * This sets the number of performance levels for students in each category. For example:
+   * 3 LOMs would mean a student could have been { Poor, Average, Good }
+   * 5 LOMs would mean a student could have been { Very Poor, Poor, Average, Good, Very Good}.
+  * Number of Criteria - the number of aspects to rate the student by, so for example:
+   * "Participated in meetings", "Handed in work on time", "Co-operated with team" would make 3 criteria.
+  * Rubric Availability - choose "private" by default, or "public" only if you would like other instructors to be able to use this rubric.
+ 3. Click "Next" to proceed to the next form. In this screen, you will choose the categories, and the performance levels (Levels of Mastery).
+ 4. You will see a rubric preview:
+  * If you wish, fill in or change any LOM General comments on the top row of the preview (like poor, average, good, etc...) The students will see these LOM's in the same way when evaluating their team members.
+  * Fill in or Change any Criteria in the first column on the (like "Participated in Team Meetings", "Was Helpful and Co-operative", etc...). These are the categories the students will rate each other on.
+ 5. When you are done, click the "Add Rubric" button, near the top of the page. This will add the rubric to your list!
+
+Remember to create an "Evaluation Event" when you are done! Otherwise your students won't see the your evaluation.[[br]]
+You can create as many "evaluation events" for your Evaluation as you like (for example, one event for each class assignment in your class).[[br]]
+Read about [#point1 Evaluation Event]s here.
+
+===== Mixed Evaluations =====
+[[Image(documentation-mixedEvalExample1.png, 240px,  align=right, border=3)]] 
+
+To see a screen cast of how to create a Mixed Evaluation and assign it to student groups, see raw-attachment:Mixed.swf
+{{{
+#!html
+<a href="http://ipeerdev.olt.ubc.ca/img/wizard/Mixed.swf" target="_blank">Screen cast about creating Mixed Evaluations and their evaluation events.</a>
+}}}
+The following instructions are a little more up to date.[[br]]
+To create a Mixed Evaluation:
+ 1. Click on the Evaluation Tools, tab, then, under the Mixed Evaluation section, on the right, Add Mixed Evaluaton link in orange. This will make the "Add Mixed Evaluation" Form Appear.
+ 2. There are 2 parts to the Mixed Evaluation Add form. On this part, please enter:
+  * Mixed Evaluation name.
+  * Number of Lickert Questions (how many Rubric-like questions will this evaluation have).
+  * Number of pre-Fill Text Questions (how many short answer questions will the evaluation have).
+  * Level of Scale - is just like the Level of Mastery for the Rubrics. Enter the total number of performance levels a student can have for each question.
+  * Mixed Evaluation Availability - choose "private" by default, or "public" only if you would like other instructors to be able to use this Mixed Evaluation.
+ 3. Click next. This will take you to the next part of this form, where you can see and edit a preview of your Mixed Evaluation
+  * For Lickert Scales (section 1), enter a question for each question number. Bellow each Rubric-like question is are Descriptors for each level of scale. You can change these, if you like.
+  * For short-answer questions (Section 1), Fill in the question prompt, and any instructions you like. Select between single line of text, or multiple-lined, longer answers.
+ 4. After you are finished creating the evaluation, should click the "Add Mix Evaluation" button, on either the top of the bottom of the page.
+
+Remember to create an "Evaluation Event" when you are done! Otherwise your students won't see the your evaluation.[[br]]
+You can create as many "evaluation events" for your Evaluation as you like (for example, one event for each class assignment in your class).[[br]]
+Read about [#point1 Evaluation Event]s bellow.
+[=#point1]
+==== Events ====
+[[Image(documentation-AddEvent.png, 240px,  align=right, border=3)]] 
+Before an evaluation can be taken, an evaluation event is added.
+
+An evaluation event includes the following information:
+ * Which evaluation is to be complete.
+  * Which type (Simple, Rubric, or Mixed)
+  * Which specific evaluation.
+ * The time window when the evaluation can be submitted.
+ * The due date for the event.
+  * (although students can still submit after the due date, their submissions are marked "late").
+ * Whether students are required to complete written comments on evaluations, or if the comments are optional.
+ * Whether students should evaluate themselves along with the rest of their team.
+
+You can create as many evaluation events for each evaluation as you'd like. This is like having the same, consistent evaluation for many assignments in your class.
+
+To create an Evaluation Event:
+ 1. Go to a course's home page.
+  * If the "Evaluation Events" menu to the right is hidden, unhide it by clicking "show/hide" link to its right.
+ 2. Click on "Add Event". This will open the Add event menu.
+ 3. Fill in: 
+  * Event title and Event Description
+  * Evaluation format and name:
+   * Select the format of your created evaluation
+   * After, select the Name of your evaluation for this event.
+  * Select !Yes/No for Self-Evaluation
+  * Select !Yes/No Require Student Comments
+  * Select the dates for this event. Clicking on the little calendar icon besides the while input fields allows you to select the date from small calendar pop-up window.
+   * The Due date - all evaluation submitted after this date will be marked late. (this date must be between Release FROM and TO dates)
+   * Release From date - releases
+
+A single evaluation can be completed many times, and the results of each event are saved in iPeer.
+
+==== Evaluation Results ====
+
+When students submit their evaluations, the instructors can view the results. This can be done at any time after the release date, even if only some results are in.
+
+===== Viewing =====
+To view the results on an evaluation:
+ 1. Go to your course's homepage. This can be done by
+  * Clicking on the Courses Tab.
+  * Finding your course, and clicking on its title.
+ 2. On the Home page, look for section called "Evaluation Events".
+  * This section in on the top right. If its contents is hidden, click on the "show/hide" link. There should be 2 options underneath, list and export. 
+ 3. Click "List Evaluation Events/Results". A list of the evaluation events for the course will show up.
+ 4. Find the evaluation of interest, and click on "Results" under "View" column. A list of all the groups will show up.
+ 5. Now, by clicking on each of the groups' names, see which group members submitted their evaluation and when. To see the evaluation results, click on the magnifier-glass icon for beside a group's name. The results will look different depending on which type of evaluation this is.
+   * Simple Evaluations - show the individual and average scores for all  students. Comments are shown bellow as well, just click on each student's name to see the evaluation comments
+   * Rubric Evaluations - has 2 views: Basic and Detail (select between them by clicking the small (Basic | Detail) on the upper left corner.
+    * '''Basic''' - Shows the averages for all group members.
+    * '''Detail''' - Shows detailed rating in each category, as well as evaluation comments. Just click on each students name on the bottom middle page to show the evaluation scores and comments, just like the students entered them. 
+   * Mixed Evaluations - also has the Basic and Detailed view.
+    * '''Basic''' - view is just like the rubric above, summaries of point-base questions
+    * '''Detail''' - contains comments for all questions, and answers for the short-answer questions.
+
+===== Reset submission =====
+To allow student redo the evaluation, instructor can reset student submission.
+ 1. Go to your course's homepage. This can be done by
+  * Clicking on the Courses Tab.
+  * Finding your course, and clicking on its title.
+ 2. On the Home page, look for section called "Evaluation Events".
+  * This section in on the top right. If its contents is hidden, click on the "show/hide" link. There should be 2 options underneath, list and export. 
+ 3. Click "List Evaluation !Events/Results". A list of the evaluation events for the course will show up.
+ 4. Find the evaluation of interest, and click on "Results" under "View" column. A list of all the groups will show up.
+ 5. Find the group of interest, and right click anywhere on the row. A context menu will show up.
+ 6. Click on "View Submission". The group member list will show up in a popup window.
+ 7. Check the checkbox under "RE-release Evaluation?" column for the student evaluation that need to be reset.
+ 8. Click on "Re-release Selected Evaluation" button at the bottom.