New to Telerik Reporting? Download free 30-day trial

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:

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:

  1. 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.
  2. Follow the steps indicated by the Graph Wizard.
  3. 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:

  1. Open the Visual Studio toolbox. From the Telerik Reporting tab, select Graph Wizard.
  2. Click the design surface where you want to position the upper-left corner of the Graph. As a result, the Graph Wizard will open.
  3. Follow the steps indicated by the Graph Wizard.
  4. 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.

<blockquote class='note'><p>The Graph is a <a href="/reporting/designing-reports/connecting-to-data/data-items/overview">data item</a> and cannot be added to <a href="/reporting/report-items/report-item/page-headers-footers">Page Sections</a></p></blockquote>

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.

  1. 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.

  2. 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 the ConnectionString for connecting, and execute the Query or Stored Procedure assigned to the SelectCommand property to get the data.

    Now use the default SqlClient Data Provider with the named connection string Telerik.Reporting.Examples.CSharp.Properties.Settings.TelerikConnectionString from the demo reports that is preset in the the configuration file of your designer.

  3. 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

See Also

In this article