Changes between Version 3 and Version 4 of UserDocV3.1

Timestamp:

2013-05-03T21:04:25Z (11 years ago)

Author:

michael

Comment:

--

UserDocV3.1

@@ -267 +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".
  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. 
+
+==== Groups ====
+[[Image(addGroup.png, 240px,  align=right, border=3)]] 
+After students are imported, groups should be created. The manual way 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.
+ 2. Click on "Create Groups (Manual)". 
+ 3. There are 2 list of students, one filled with your students on the left, and one empty on the right.
+  * The students on the left are your students and tutors
+  * Note: the students who are in one or more groups are marked with *.
+  * The students on the right are already in the group you are creating.
+ 4. Add students to the group. You could do this using one of the following ways below.
+  * Select one student at a time from the left list, and click the "Assign >>"  button. This will add the student to the group.
+  * Select more than on student by holding the Control or Command key while clicking on thestudents, 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 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 Identifier, Group Name
+}}}
+And the file contents is like:
+{{{
+29978037, Team A
+29978063, Team A
+29978043, Team B
+29978051, Team B
+}}}
+
+Please ensure that all the students listed have already been created in iPeer, and added to the class. The student identifier you can use are usernames or student numbers but not both.
+
+Similar to 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.
+ 2. Click on "Create Groups (Import)". This will open the group creation window.
+
+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 student identifier you used, whether it is student number or username.
+ 3) 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 below 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.
+
+===== Exporting group list to CSV file =====
+[[Image(exportGroups.png, 240px, align=right, border=3)]]  
+
+To export groups:
+ 1. Go to a course's home page.
+ 2. Click on "Export Groups".
+
+All you need to do now is to fill out the form for exporting the groups:
+ 1) Export as:
+   * Fill in the desired name for the file.
+ 2) Export Group Fields:
+   * Check the desired fields. A minimum of one field must be left checked.
+ 3) Group Selection:
+   * Select the groups you want to export from the Available Groups. 
+   * Click on Assign.
+   * To select multiple groups hold on "shift".
+ 4) Click on Export Group.
+
+==== 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(studentSimpleEval.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 create a simple evaluation:
+ 1. Click on the Evaluation tab, then, on the top of the "My Simple Evaluation" section, the Add Simple Evaluation link.
+ 2. On this form, please enter
+  * Evaluation Name (required)
+  * Description (optional)
+  * Base Point Per Member - recommended values are between 10 and 100. 
+  * Availability - Choose public to share the template with other instructors. If you do not want to share it, choose private.
+ 3. Click "Save" button to create the evaluation
+
+Remember to create an "Evaluation Event" when you are done! Otherwise your students won't see 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(studentRubricEval.png, 240px, align=right, border=3)]]
+
+To create a Rubric evaluation:
+ 1. Click on the Evaluation tab, then, on the top of the "My Rubrics Evaluation" section the Add Rubric link.
+ 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.
+  * Availability - Choose public to share the template with other instructors. If you do not want to share it, choose private.
+ 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 "Save" 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 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(studentMixedEval.png, 240px,  align=right, border=3)]] 
+
+To create a Mixed Evaluation:
+ 1. Click on the Evaluation tab, then, on the top of the "My Mixed Evaluation" section the Add Mixed Evaluaton link.
+ 2. On this form, please enter
+  * Evaluation Name (required)
+  * Availability - Choose public to share the template with other instructors. If you do not want to share it, choose private.
+  * Zero Mark - check to start marks from zero for all Likert questions
+ 3. Add questions to the template. Choose a question type from the drop down menu and press Add.
+  * Enter your question.
+  * Enter the instructions (optional).
+  * Choose to whether to make the question required.
+  * For Lickert Questions, enter the maximum mark and descriptors
+ 4. After you are finished creating the evaluation, should click the "Save" button, at the bottom of the page.
+
+Remember to create an "Evaluation Event" when you are done! Otherwise your students won't see 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 below.
+
+==== Surveys ====
+Surveys can be created to help generate groups using !TeamMaker within iPeer.[[BR]][[BR]]
+To create a Survey Template:
+[[Image(addQuestion.png, 240px,  align=right, border=3)]] 
+[[Image(addSurvey.png, 240px,  align=right, border=3)]] 
+ 1. Click on the Evaluation tab, then, on the top of the "My Surveys" section the Add Survey link.
+ 2. Fill out the desired survey template name and choose a survey template. If you want to create your own survey questions, select "(No Template)".
+ 3. Choose the availability of the survey template. Choose public to share the template with other instructors. If you do not want to share it, choose private.
+ 4. Select Add Survey. You will be redirected to the list of available surveys.
+ 5. Select your survey by clicking on the yellow area around your survey name.
+ 6. Select Edit Questions.
+ 7. Select Add Question.
+ 8. Fill out the form. The Question Types available are Multiple Choice, Choose Any of... (multiple answers), short answer, and long answer.
+ 9. Repeat Steps 7 and 8 for all your questions.
+ 10. You can choose to use questions shared by other instructors by selecting the question from the Template drop down menu and clicking Load.
+ 11. Select Finish.
+
+Remember to create an "Evaluation Event" when you are done! Otherwise your students won't see your survey.[[br]]
+You can create as many "evaluation events" for your Survey as you like.[[br]]
+Read about [#point1 Evaluation Event]s below.
+[=#point1]
+
+==== Events ====
+[[Image(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 type (Simple, Rubric, Survey, or Mix Evaluation)
+  * Which specific evaluation.
+  * The time window when the evaluation can be submitted.
+  * The time window when the evaluation results can be viewed.
+  * 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.
+  * Whether results should be auto-released.
+  * Whether to show a basic or detailed view of the evaluation results.
+  * Whether to set email reminders for submitting evaluations.
+  * Whether a penalty is given for late submissions.
+
+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.
+
+[[Image(eventTimeline.png, 240px,  align=right, border=3)]] 
+
+To create an Evaluation Event:
+ 1. Go to a course's home page.
+ 2. Click on "Add Event".
+ 3. Fill in: 
+  * Event title and Event Description
+  * Evaluation format and name:
+   * Select the format of your created evaluation
+   * After, select the Name of the template for this event.
+  * Select !Enabled/Disabled for Self-Evaluation
+  * Select !Enabled/Disabled for Comments Requirement.
+  * Select !Enabled/Disabled for Auto-releasing evaluation results.
+  * Select !Basic/Detailed for the Student Evaluation Results View. (Basic View only contains averages).
+  * The Due date - all evaluation submitted after this date will be marked late. (this date must be between Release FROM and TO dates)
+  * Select the start and end dates for this event. Clicking on the text field opens a calendar allowing you to select the date
+  * Select the dates for releasing results.
+   * refer to the timeline on the left, for a clearer idea what each date refers to.
+  * Select the number of days interval between each email reminder. The first email is sent at the event's start date. If you do not want email reminders, select Disable.
+  * Select the groups you want to complete the event.
+  * To add penalty for late submission click on Add Penalty. Each time you click on Add Penalty, you can fill out how much to penalize for a specific number of days late. 
+   * Example: '''2''' days '''10'''% deducted
+
+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 of 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 the section called "Evaluation Events".
+ 3. Click "List Evaluation Events". 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 the links under the "Late?" column to see which group members submitted their evaluation and when. To see the evaluation results, click on "Results" under "View" column. The results will look different depending on which type of evaluation this is.
+   * Simple Evaluations - shows the individual and average scores for all students in the group in a table near the top. Comments are shown below as well.
+   * 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 student's name to show the evaluation scores and comments, just like how 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.
+
+===== Exporting to CSV file =====
+[[Image(exportResults.png, 240px,  align=right, border=3)]] 
+To export the results of an evaluation choose one of the two methods below:[[BR]][[BR]]
+METHOD 1
+ 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 the section called "Evaluation Events".
+ 3. Click "Export Evaluation Results".
+ 4. Fill in the form.
+  * Fill in your desired file name. Default: the date
+  * Select the desired evaluation event.
+  * Uncheck the details that are not not wanted. Note: Leave at least one field of each detail group (marked with similarly colored *) checked.
+ 5. Select Export.
+METHOD 2
+ 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 the section called "Evaluation Events".
+ 3. Click "List Evaluation Events".
+ 4. Find the evaluation of interest, and click on "Results" under "View" column. A list of all the groups will show up.
+ 5. On the top left corner, select "Export Evaluations".
+ 6. Fill in the form.
+  * Fill in your desired file name. Default: the date
+  * Uncheck the details that are not not wanted. Note: Leave at least one field of each detail group (marked with similarly colored *) checked.
+ 7. Select Export.
+
+=== Administrators ===
+
+Administrators form the smallest user group. An administrator has instructor capabilities (see above) for all courses and users. The administrator also has the privilege to delete information, which can cause data inconsistency. There are faculty admin accounts available which allows the user to have admin access to all the courses in the departments within their faculty. There is also a super admin account that is used for administration of all users including administrators.  Administrators should be extremely cautious when removing data as it is very easy to cause database inconsistencies.
+ * For example, to remove a student that has been enrolled in a course, and has taken evaluations will likely cause errors when those evaluations are viewed. It is best to leave old users in the database.
+
+==== Account Consolidation ====
+Administrators can now consolidate accounts together. 
+ 1. Click on the Courses Tab.
+ 2. Click on Merge Users.
+ 3. Search for the primary account and secondary account by full name, username, or student number.
+ 4. Select the two accounts you want to consolidate. The primary account is the account you want to keep. On the contrary, the secondary account is the one that would be deleted and have their data transferred to the primary account.
+  * The two accounts must have the same role.
+  * The secondary account cannot be the currently logged in user.
+ 5. Verify the two account's user data.
+  * Note: the merger cannot be reversed.
+ 6. Click merge.
+
+==== Permissions Editor ====
+Super Administrators can change permission levels for different roles in the application.
+ 1. Click on the Admin Tab.
+ 2. Click on Permissions Editor.
+ 3. Search for the permissions you wanted to modify.
+ 4. Click on the permission. 
+ 5. Choose the modification you wanted.
+
+=== FAQs ===
+
+* [wiki:HowToFindCourseId How do I find my course Id]
+
+=== Icons ===
+Below is a description of the icons that are used in the iPeer web application.
+
+[[Image(icon.png)]]
+
+=== Glossary ===
+'''Evaluation Event''':  An evaluation task which is assigned to specific groups of students. An evaluation event must also have an evaluation format, release time (starting and end), result release time, and due date.
+
+'''Evaluation format''': Methods for members of a group to evaluate other members (and possibly themselves). 
+
+'''Rubric evaluation''':  An evaluation format where a matrix is used to rate students according to different levels of mastery (e.g. poor, satisfactory, excellent). Students assess their team members' contributions through answering multiple choice type questions and providing written comments if desired. 
+
+'''Simple Evaluation''':  An evaluation format where members rate other members (possibly themselves) by allocating to each member a portion of a possible mark total (conceptually dividing up money among group members).
+
+'''Mixed Evaluation''': An evaluation format where members rate other members (possibly themselves) by answering questions of different types such as Likert (rubric-like), Score Dropdown (simple evaluation like), short answers, and paragraph answers.