DataBind TimeCamp Data to the DevExpress Data Grid

The CData API Driver for ADO.NET 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.

Start by setting the Profile connection property to the location of the TimeCamp Profile on disk (e.g. C:\profiles\TimeCamp.apip). Next, set the ProfileSettings connection property to the connection string for TimeCamp (see below).

TimeCamp API Profile Settings

TimeCamp uses token-based authentication. To obtain an API Token:

1. Log in to your TimeCamp account at https://app.timecamp.com
2. Click your profile avatar in the top-right corner
3. Select Profile Settings
4. Copy the API token shown at the bottom of the page

After obtaining your API Token, set the following connection properties:

• AuthScheme: Set this to APIKey.

Set the following in the ProfileSettings connection property:

• APIKey: Set this to your TimeCamp API token.

Windows Forms Controls

The code below shows how to populate a DevExpress chart with TimeCamp data. The APIDataAdapter 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 (APIConnection connection = new APIConnection(
"Profile=C:\profiles\TimeCamp.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_token';")) {
  APIDataAdapter dataAdapter = new APIDataAdapter(
  "SELECT UserId, Email FROM GroupUsers WHERE GroupId = '12345'", 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[] { "Email" });
  series.ArgumentScaleType = DevExpress.XtraCharts.ScaleType.Qualitative;
  series.ArgumentDataMember = "UserId";
  series.ValueScaleType = DevExpress.XtraCharts.ScaleType.Numerical;
  chartControl1.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False;
  ((DevExpress.XtraCharts.SideBySideBarSeriesView)series.View).ColorEach = true;                              
}

Web Controls

The code below shows how to populate a DevExpress Web control with TimeCamp data. The APIDataAdapter 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 (APIConnection connection = new APIConnection(
"Profile=C:\profiles\TimeCamp.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_token';"))
{
  APIDataAdapter APIDataAdapter1 = new APIDataAdapter("SELECT UserId, Email FROM GroupUsers WHERE GroupId = '12345'", connection);
  DataTable table = new DataTable();
  APIDataAdapter1.Fill(table);
  DevExpress.XtraCharts.Series series = new Series("Series1", ViewType.Bar);
  WebChartControl1.Series.Add(series);
  series.DataSource = table;
  series.ValueDataMembers.AddRange(new string[] { "Email" });
  series.ArgumentScaleType = ScaleType.Qualitative;
  series.ArgumentDataMember = "UserId";
  series.ValueScaleType = ScaleType.Numerical;
  ((DevExpress.XtraCharts.SideBySideBarSeriesView)series.View).ColorEach = true;
}