DataBind Salesforce Data Cloud Data to the DevExpress Data Grid

The ADO.NET Provider for Salesforce Data Cloud by CData incorporates conventional ADO.NET data access components compatible with third-party controls. You can adhere to the standard ADO.NET data binding procedures to establish two-way access to real-time data through UI controls. This article will demonstrate the utilization of CData components for data binding with DevExpress UI Controls (Windows Forms and Web controls), specifically binding to a chart that visualizes live data.

Salesforce Data Cloud supports authentication via the OAuth standard.

OAuth

Set to OAuth.

Desktop Applications

CData provides an embedded OAuth application that simplifies authentication at the desktop.

You can also authenticate from the desktop via a custom OAuth application, which you configure and register at the Salesforce Data Cloud console. For further information, see Creating a Custom OAuth App in the Help documentation.

Before you connect, set these properties:

• : GETANDREFRESH. You can use to avoid repeating the OAuth exchange and manually setting the .
• (custom applications only): The Client ID assigned when you registered your custom OAuth application.
• (custom applications only): The Client Secret assigned when you registered your custom OAuth application.

When you connect, the driver opens Salesforce Data Cloud's OAuth endpoint in your default browser. Log in and grant permissions to the application.

The driver then completes the OAuth process as follows:

• Extracts the access token from the callback URL.
• Obtains a new access token when the old one expires.
• Saves OAuth values in so that they persist across connections.

For other OAuth methods, including Web Applications and Headless Machines, refer to the Help documentation.

Windows Forms Controls

The code below shows how to populate a DevExpress chart with Salesforce Data Cloud data. The SalesforceDataCloudDataAdapter binds to the Series property of the chart control. The Diagram property of the control defines the x- and y-axes as the column names.

using (SalesforceDataCloudConnection connection = new SalesforceDataCloudConnection(
"InitiateOAuth=GETANDREFRESH;")) {
 SalesforceDataCloudDataAdapter dataAdapter = new SalesforceDataCloudDataAdapter(
 "SELECT [Account ID], [Account Name] FROM Account WHERE EmployeeCount > 250", connection);
 
 DataTable table = new DataTable();
 dataAdapter.Fill(table);
 DevExpress.XtraCharts.Series series = new DevExpress.XtraCharts.Series();
 chartControl1.Series.Add(series);
 series.DataSource = table;
 series.ValueDataMembers.AddRange(new string[] { "[Account Name]" });
 series.ArgumentScaleType = DevExpress.XtraCharts.ScaleType.Qualitative;
 series.ArgumentDataMember = "[Account ID]";
 series.ValueScaleType = DevExpress.XtraCharts.ScaleType.Numerical;
 chartControl1.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False;
 ((DevExpress.XtraCharts.SideBySideBarSeriesView)series.View).ColorEach = true; 
}

👁 The complete code example and the resulting chart.


Web Controls

The code below shows how to populate a DevExpress Web control with Salesforce Data Cloud data. The SalesforceDataCloudDataAdapter binds to the Series property of the chart; the Diagram property defines the x- and y-axes as the column names.

using DevExpress.XtraCharts;

using (SalesforceDataCloudConnection connection = new SalesforceDataCloudConnection(
"InitiateOAuth=GETANDREFRESH;"))
{
 SalesforceDataCloudDataAdapter SalesforceDataCloudDataAdapter1 = new SalesforceDataCloudDataAdapter("SELECT [Account ID], [Account Name] FROM Account WHERE EmployeeCount > 250", connection);
 DataTable table = new DataTable();
 SalesforceDataCloudDataAdapter1.Fill(table);
 DevExpress.XtraCharts.Series series = new Series("Series1", ViewType.Bar);
 WebChartControl1.Series.Add(series);
 series.DataSource = table;
 series.ValueDataMembers.AddRange(new string[] { "[Account Name]" });
 series.ArgumentScaleType = ScaleType.Qualitative;
 series.ArgumentDataMember = "[Account ID]";
 series.ValueScaleType = ScaleType.Numerical;
 ((DevExpress.XtraCharts.SideBySideBarSeriesView)series.View).ColorEach = true;
}

👁 An ASP.NET application created with the ADO.NET Provider and the DevExpress Web Forms control. (Salesforce is shown.)