CSC/ECE 517 Fall 2016/E1650. Sort instructor views alphabetically by default

Purpose

The purpose of given topic is to sort the Instructor views on the basis of Reviewer's Last Name (by default) without refreshing the existing page.
Current Model:

• Currently Instructor can view the Reports in non-decreasing sorted value of an 'Average Overall Volume' for the Reviewer. However ,instructor does not have any option to sort the list manually.
• Hence, we are adding a functionality to instructor's view of reviewers' list that can sort the list as per his/her choice

Functional Requirements and Solution

• Functional Requirement:

Instructor should be able to sort the Reports according to the Reviewer's Last Name in either descending or ascending order.
Instructor should be able to sort Reports according to the Average Volume in either descending or ascending order.

• Our solution:

Instructor will be able to sort the review reports according to the reviewer's last name and an average Volume in either descending or ascending order as per the choice

We are using a JavaScript library TableSorter [1] for sorting the elements in the instructor view's table. TableSorter provides support for both kinds of ordering - ascending or descending.

Implementation

Introduction to TableSorter

Implementation of sorting algorithm for Instructor views using 'TableSorter'. TableSorter is a jQuery plugin for turning a standard HTML table with table-head and table-body tags into a sortable table without reloading the existing page. TableSorter can parse and sort many data types linked with the table column.

Requirements for Tablesorter

To integrate the table sorter into any view two things are needed:

i) Include a gem in Gemfile

gem 'jquery-tablesorter'

ii) Including jQuery-tablesorter in app/assets/javascripts/application.js

//= require jquery-tablesorter

The above code loads only the core-widgets.

Sorting on Reviewer's Name

TableSorter is applied to the table which needs to be sorted.For example , in the below code table sorter is applied to the "myTable" id.

• Added in _review_report.html.erb

<script>
 $(function () {
    $("#myTable").tablesorter({
      sortList: [[0,0]],
      headers: {
        4: {
        sorter: 'customParser'
      }
    }
    });
  })
</script>

Sorting on Metric's Avg. Vol

• Added in _review_report.html.erb

Custom parser script is created to sort the table according to 'Average overall volume'. It accepts a string that contains a string containing numeric value (percentage) on the basis of which the table should be sorted. It firsts splits and tokenize the data according to space and function return required value which should be sorted.

<script>
  $.tablesorter.addParser({
    id: "customParser",
    is: function (stringValue) {
      return false;
    },
    format: function (stringValue) {
      var stringNumericPart = stringValue.split(" ");
      var numericValue = parseInt(stringNumericPart[2],10);
      return numericValue ;
    },
    type: 'numeric'
  });
</script>

Testing

As we are working on view, so we have given the style for the table. By this we can test its performance over any browser.

• Added in _review_report.html.erb

<style>
  th.tablesorter-headerAsc{
    background-image: url(<%= asset_path("up-arrow.png") %>);
    background-size: 15px 15px;
    background-repeat: no-repeat;
    background-position: center right;
    padding-right: 15px;
  }

  th.tablesorter-headerDesc{
    background-image: url(<%= asset_path("down-arrow.png") %>);
    background-size: 15px 15px;
    background-repeat: no-repeat;
    background-position: center right;
    padding-right: 15px;
  }

  th.sorter-true.tablesorter-headerUnSorted{
    background-image: url(<%= asset_path("sort.png") %>);
    background-size: 15px 7px;
    background-repeat: no-repeat;
    background-position: center right;
    padding-right: 15px;

  }

</style>

Test Results

Below is the screenshot for the above given style:

References

1. GitHub Link: TableSorter