CSC/ECE 517 Fall 2016/E1680. Improve survey functionality

From Expertiza_Wiki
Jump to navigation Jump to search

Introduction to Expertiza

The Expertiza project is software to create reusable learning objects through peer review. It also supports team projects, and the submission of almost any document type, including URLs and wiki pages. Expertiza is an open source project and is based on “Ruby on Rails” framework. Expertiza facilitates easy creation of assignments and a list of topics for the same. Expertiza, in other words, gives a very simple web interface for assignment management for both the students as well as instructors.

Problem Statement

Overview

Expertiza should be able to distribute surveys to the users. The survey can be one of the following: 1. Course survey (all the participants of the course can take it). 2. Global survey (all the users in Expertiza can take it).
The survey can also be targeted (the admin can specify a group of people who will receive this survey).
The three kinds of surveys in this project are:

  • 1. survey_questionnaire.rb
  • 2. global_survey_questionnaire.rb
  • 3. course_evaluation_questionnaire.rb.

Constraints

  • Survey questionnaire should be a subclass of questionnaire.
  • The creation, editing, filling in, and checking that all the questions have been answered survey should be similar to the procedure used for other types of questionnaires (e.g. peer-review questionnaires).
  • There should be a page to see the distribution of results for any question.
  • We should use the same controller method to take the survey as to fill in the peer-review, namely, response_controller.
  • We should use the same code to display the existing survey responses as to display the responses in peer reviews.
  • For each course or assignment, the admin/instructor should be able to create a survey and have some (or all) of the participants receive the survey.
  • When a user is assigned to take part in a survey, a survey_participant record should be created for that user in the participants table.

Files to be modified:

Controllers

  • app/controllers/survey_deployment_controller.rb
  • app/controllers/statistics_controller.rb
  • app/controllers/course_evaluation_controller.rb
  • app/controllers/survey_controller.rb

Models

  • app/models/global_survey_questionnaire.rb
  • app/models/survey_questionnaire.rb
  • app/models/survey_deployment.rb
  • app/models/metasurvey.rb
  • app/helpers/survey_helper.rb
  • app/models/survey_participant.rb
  • app/models/survey_response.rb
  • app/helpers/survey_response_helper.rb

Views

  • app/views/survey_deployment/
  • app/views/statistics/
  • app/views/survey_response/
  • app/views/survey


Proposed Design

In our design we have three kinds of survey-

  • survey_questionnaire
  • global_survey_questionnaire
  • course_evaluation_questionnaire

These models should be made as subclasses of the class survey. By using the concept of polymorphism, survey is made a subclass of survey_questionnaire as

many kinds of survey_questionnaire can exist and by using polymorphism, the code can be made more efficient. Survey_questionnaire is then a subclass of

questionnaire. Complete refactoring is needed as the existing code is inefficient.

Distribution of results

  • There will be a page to see the distribution of results for any question (e.g., how many people answered “1”, how many answered “2”, etc.).
  • This page will not only be designed for surveys, but also for other types of questionnaires (E.g. this view be able to show the score distribution for a question in other types of questionnaires, no matter whether it is a survey question like “how much do you like the course?” or a peer-review question like “how well did the author test the code?”)


Proposed Implementation

The required page for this implementation would look like this:


  • Our page to see the distribution of results for any question would render a similar Bar graph
  • showing the no of people who answered a choice amongst the options.
  • The vertical axis would show the no of people.
  • The horizontal axis will show the possible answers to the question.
  • To implement this in Expertise we can use JQPlot Rails or some other graph plotting plugin.
The JQuery code might look like

  • We will have to integrate the Jquery plugin and create a .erb file in views which will have similar
  • Jquery code to render a bar graph based on the data provided.


Adding Participants to the survey:

  • Instructor or admin both can add survey for any course or assignment
  • The creator would be able to select the participants based on the scope of the survey, that is, all the students or all the Expertiza users or specific group of people.

Adding all the global questionnaire questions:

  • There would be a generic set of questions which will be included in global_survey_questionnaire.
  • These questions will be by default added to every survey the user creates.
  • But, creator will be able to omit them with one ‘checkbox’ button (Or, we can have specific selections for each of the questions to be included).
  • Or, there can be option of separating the global survey and course survey. The quiz taker will take the global survey first and then the course survey.

Adding the data to database:

  • For each participant added by the creator of the survey, a database entry would be made in participant table along with appropriate details.