Pivot Example

With this example we will try to explain and build pivot grid. We hope it will be clear, so that more user can have idea what is happen. Now - lets do first with the data.

Data

Let’s say that we have a table with sales data with the following fields:

  • category name
  • product name
  • country
  • totalprice
  • quantity

This can be seen on the picture below:

This grid view is achieved with jqGrid with the following code:

jQuery(document).ready(function(){	
 
	jQuery("#grid").jqGrid(
	{
		url : "data.json",
		loadonce: true,
		colModel : [
			{ name: "CategoryName"},
			{ name: "ProductName" },
			{ name: "Country"},
			{ name: "Price", "formatter": 'number', align: "right"},
			{ name: "Quantity", formatter:'integer', align:"right"}
		],
		datatype:"json",
		width: 700,
		rowNum : 10,
		pager: "#pager",
		caption: "Grid"
	});
});

The data is obtained from Northwind database with the following SQL:

SELECT 
    c.CategoryName, 
    b.ProductName, 
    e.Country, 
    SUM( a.Quantity * a.UnitPrice ) AS Price,
    SUM(a.Quantity) AS Quantity 
FROM 
    order_details a, 
    products b, 
    categories c, 
    orders d, 
    customers e
WHERE 
    a.ProductID = b.ProductID
    AND b.CategoryID = c.CategoryID
    AND a.OrderID = d.OrderID
    AND d.CustomerID = e.CustomerID
    AND (e.Country = 'UK' OR e.Country = 'USA')
GROUP BY 
    a.ProductID, 
    e.Country

The JSON response from the server obtained via ajax ( the option url:“data.json”) has the following structuure:

{"rows":[
{"CategoryName":"Beverages","ProductName":"Steeleye Stout","Country":"UK","Price":"1008.0000","Quantity":"65"},
{"CategoryName":"Beverages","ProductName":"Laughing Lumberjack Lager","Country":"USA","Price":"140.0000","Quantity":"10"},
{"CategoryName":"Beverages","ProductName":"Lakkalik","Country":"USA","Price":"2160.0000","Quantity":"120"},
...
]}

Let say that your boss want to know the sales for the categories and products for the given countries.
Of course this can be achieved with another SQL query, but … your provider does not allow you to add new query or to chenge the existing one. What to do?
You can use the jqPivotGrid for this purpose without to make changes to the server side responses. Let see how to do this.

Options settings

Looking into the boss task we can see that the categories and products are fields which will be used in our grid. This data is “static” and we should tell jqPivotGrid this. This is achieved with xDimension option:

...
xDimension : [
   {
       dataName: 'CategoryName',
       label : 'Category',
       width : 90
   }, {
       dataName: 'ProductName',
       label: 'Product',
       width: 90
   }
]

With this setting we tell jqPivotGrid that the data will be grouped first by Category and then by Product.
These fields should be taken from the JSON response which names are CategoryName and ProductName (see the JSON response above).

Next we should tell jqPivotGrid which field is the country field. With this setting we will generate dynamic columns (yDimension).
Seen into the source data this is the Country field. Now the settings should be:

...
yDimension : [
   {
      dataName: 'Country'
   }
]

Now the missed part is which fields we should actually summarize? This is achieved with the aggregates option using the fields Price and Quantity.

aggregates : [
	{
           member : 'Price', 
           aggregator : 'sum', 
           width:50,
           label:'Sum'
        }, {
           member : 'Quantity', 
           aggregator : 'sum', 
           width:50,
           label:'Qty'
        }
]

The missed settings are how we can make sumaries on columns and rows. This of cource is achieved with two line of code -
rowTotal : true and
colTotal: true

The final code with jqGrid setting is:

<script type="text/javascript">
jQuery(document).ready(function(){	
 
	jQuery("#grid").jqGrid('jqPivot', 
	"data1.json",
	// pivot options
	{
		xDimension : [
                   {dataName: 'CategoryName', label : 'Category', width: 90}, 
                   {dataName: 'ProductName', label : 'Product', width:90}
                ],
		yDimension : [
                   {dataName: 'Country'}
                ],
		aggregates : [
			{member : 'Price', aggregator : 'sum', width:50, label:'Sum'},
			{member : 'Quantity', aggregator : 'sum', width:50, label:'Qty'}
		],
		rowTotals: true
		colTotals : true
 
	}, 
	// grid options
	{
		width: 700,
		rowNum : 10,
		pager: "#pager",
		caption: "Amounts and quantity by category and product"
	});
});
</script>
  </head>
  <body>
...
     <table id='grid'></table>
     <div id='pager'></div>
...
   </body>
</html>

The final result can look like this


Personal Tools
;