windowsforms-12006-controls-and-libraries-pivot-grid-getting-started-bind-a-pivot-grid-to-an-olap-cube.md
A cube is a multidimensional structure defined by its measures and dimensions. A cube’s measure can be bound to a data field in the PivotGridControl, while a dimension can be bound to a column, filter, or row field. This tutorial contains step-by-step instructions on how to bind the Pivot Grid to an existing OLAP (OnLine Analytical Processing) cube.
Run Microsoft Visual Studio and create a new Windows Forms App (.NET Framework) project.
Specify the project’s name and location in the New Project wizard.
Drag the PivotGridControl item from the DX.25.2: Data & Analytics toolbox group onto the form.
Note
The control’s PivotGridOptionsData.DataProcessingEngine property is set to Optimized when you drop the Pivot Grid from the toolbox. When the Pivot Grid uses the Optimized calculation engine, data is calculated on the client side, except data from the OLAP and server-mode data sources.
Open the Pivot Grid’s smart tag menu and click Dock in Parent Container to let the Pivot Grid fill the entire window’s client area.
Click the smart tag icon displayed in the top-right corner of the Pivot Grid to invoke the popup PivotGridControl Tasks window.
Select the Data Source Wizard item.
Select the OLAP Cube technology and click Next in the invoked wizard.
Select ADOMD.NET as the data provider and click Next.
Specify the Server Name as https://demos.devexpress.com/Services/OLAP/msmdpump.dll and select the MSOLAP provider. Then, click the Retrieve Schema button.
Make sure that the following parameters are specified:
|
Option
|
Value
|
Description
| |
Provider
|
MSOLAP
|
Identifies the data provider to be used. The “MSOLAP“ string identifies the latest version of the OLE DB provider.
| |
Server Name
|
https://demos.devexpress.com/Services/OLAP/msmdpump.dll
|
Specifies either the name of a server that runs an instance of Microsoft SQL Server Analysis Services (SSAS), the path to a cube file, or the path to a data pump.
| |
Catalog Name
|
Adventure Works DW Standard Edition
|
Specifies a data catalog that contains cubes.
| |
Cube Name
|
Adventure Works
|
Specifies the name of a cube that supplies OLAP data.
|
The image below demonstrates the configured settings of the OLAP connection. Click Finish to close the wizard.
Create fields that correspond to specific measures and dimension levels of the cube in PivotGridControl.
Click the smart tag icon and then click Run Designer… in the popup window.
Use the Add Field button to add Pivot Grid fields and specify their properties in the invoked PivotGrid Designer.
Create a Pivot Grid field and set its properties to the following values:
DataBindingValue: Data Source ColumnColumnNameValue: [Customer].[Country].[Country]AreaIndexValue: 0AreaValue: RowArea
Create a Pivot Grid field and set its properties to the following values:
DataBindingValue: Data Source ColumnColumnNameValue: [Customer].[City].[City]AreaIndexValue: 1AreaValue: RowArea
Create a Pivot Grid field and set its properties to the following values:
DataBindingValue: Data Source ColumnColumnNameValue: [Date].[Fiscal].[Fiscal Year]AreaIndexValue: 0AreaValue: ColumnArea
Create a Pivot Grid field and set its properties to the following values:
DataBindingValue: Data Source ColumnColumnNameValue: [Date].[Fiscal].[Fiscal Quarter]AreaIndexValue: 1AreaValue: ColumnArea
Create a Pivot Grid field and set its properties to the following values:
DataBindingValue: Data Source ColumnColumnNameValue: [Measures].[Internet Sales Amount]AreaIndexValue: 0AreaValue: DataArea
The image below shows the result.
Close the designer. Pivot grid fields are now arranged as follows:
Run the project to see the result.
View Example: How to Connect a Pivot Grid to an OLAP Data Source in Code
See Also