Getting Started with the Graph Report Item
This guide shows how to add the Telerik Reporting Graph report item to reports and use it to create the major supported Chart types.
After the completion of this guide, you will be able to render different Chart types within a Graph report item.
Adding the Graph
Depending on the Report Designer tool you are using, the Graph provides the following approaches for including it in your report:
- Adding the Graph with the Graph Wizard of the Standalone Report Designer
- Adding or directly inserting the Graph with the Visual Studio Report Designer
Using the Standalone Report Designer
To add a Graph item to your report when working with the Standalone Report Designer, run a new Bar
, Column
, Area
, Line
, Pie
, Scatter
, or Others
Chart Wizard, or use the ribbon tools:
- From the ribbon bar, open the Insert tab and select the desired Chart type. As a result, the Graph will be placed in the center of the selected container.
- Follow the steps indicated by the Graph Wizard.
- When you finish with the prompts, a new Graph report item of the type you selected will appear on the design surface.
Using the Visual Studio Report Designer
To add a Graph item to your report when working with the Visual Studio Report Designer, run the Graph Wizard:
- Open the Visual Studio toolbox. From the Telerik Reporting tab, select Graph Wizard.
- Click the design surface where you want to position the upper-left corner of the Graph. As a result, the Graph Wizard will open.
- Follow the steps indicated by the Graph Wizard.
- When you finish with the prompts, a new Graph report item will appear on the design surface.
The Visual Studio Report Designer tool also provides an option for directly inserting the Graph into your report. With this approach, the user is fully responsible for the Graph configuration. The following section explains the required settings.
The Graph is a data item and cannot be added to Page Sections
Configuring the Graph Properties
After you have added the Graph report item to your report, you can manually configure its properties by following common steps that are valid for all supported chart types.
- Open the Properties grid which displays all Graph properties. Through the grid, you can manually configure and reconfigure all Graph properties and customize the displayed chart type.
-
Set the DataSource property to one of the available Data Source components.
To visualize its data, the Graph requires you to provide a DataSource and bind it to the desired data set. You will use the AdventureWorks sample database which requires an SqlDataSource component that will connect to the database and fetch the requested data in run-time through the specified
DataProvider
. The data provider will use theConnectionString
for connecting, and execute the Query or Stored Procedure assigned to theSelectCommand
property to get the data.Now use the default
SqlClient Data Provider
with the named connection stringTelerik.Reporting.Examples.CSharp.Properties.Settings.TelerikConnectionString
from the demo reports that is preset in the the configuration file of your designer. -
Create the chart type you require. Depending on the specific charts you will create, you need to use different SQL Queries that are provided in the dedicated articles. The reason for this is that each Chart type is suitable for displaying different types of data, hence the different database columns that will fit better to different Charts.
For the specific instructions for creating the chart you require, use the following step-by-step guides:
Next Steps
- Graph Structure and Elements
- Supported Chart Types
- Graph Class API Reference
- Demo Page for Telerik Reporting
- Knowledge Base Section