Pipedrive のデータをDevExpress Data Grid にデータバインドする。

Pipedrive 用の CData ADO.NET プロバイダーをDevExpress Windows Forms とWeb コントロールとともに使用し、Pipedrive をチャートに入力します。

加藤龍彦
デジタルマーケティング

最終更新日:2022-01-31

この記事で実現できるPipedrive 連携のシナリオ

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Pipedrive 用の CData ADO.NET プロバイダーはサードパーティーコントロールで使うことのできる通常のADO.NET データベースアクセスコンポーネントを実装しています。データバインドするための通常のADO.NET プロセスに従うことで、UI コントロールから実データへの双方向アクセスを可能にします。 この記事では、CData を使ってDevExpress Windows Forms とウェブコントロールにデータバインドする方法を説明します。ここでは、最新のデータを表示するチャートにデータバインドします。

Pipedrive 接続プロパティの取得・設定方法

Pipedrive には、接続および認証する2つの方法があります。Basic およびOAuth です。

Basic 認証

Basic 認証で認証するには:
  1. API トークンを取得します。
    1. Pipedrive ポータルを開きます。
    2. ページ右上のアカウント名をクリックします。Pipedrive はドロップダウンリストを表示します。
    3. 会社設定 -> Personal Preferences -> API -> Generate Token に移動します。
    4. 生成されたAPI トークンの値を記録します。また、CompanyDomain を控えておきます。これは、PipeDrive ホームページのURL に表示されます。(これは会社の開発者用サンドボックスのURL です。)
  2. 次の接続プロパティを設定します。
    • APIToken:取得したAPI トークンの値。
    • CompanyDomain:開発者サンドボックスURL のCompanyDomain
    • AuthSchemeBasic
  3. 承認されたユーザー名とパスワードでログインします。

API トークンはPipedrive ポータルに保存されます。これを取得するには、会社名をクリックし、ドロップダウンリストを使用して会社設定 -> Personal Preferences -> API に移動します。

OAuth 認証

ユーザー名やパスワードへのアクセスを保有していない場合や、それらを使いたくない場合にはOAuth ユーザー同意フローを使用します。認証方法については、ヘルプドキュメントの「OAuth 認証」セクションを参照してください。

Windows Forms コントロール

下のコードでは、Pipedrive でDevExpress のチャートに追加する方法を説明します。PipedriveDataAdapter はチャートコントロールのSeries プロパティにバインドします。コントロールのDiagram プロパティはx 軸とy 軸をカラム名として定義します。

using (PipedriveConnection connection = new PipedriveConnection( "AuthScheme=Basic;CompanyDomain=MyCompanyDomain;APIToken=MyAPIToken;")) { PipedriveDataAdapter dataAdapter = new PipedriveDataAdapter( "SELECT PersonName, UserEmail FROM Deals WHERE Value > 50000", connection); DataTable table = new DataTable(); dataAdapter.Fill(table); DevExpress.XtraCharts.Series series = new DevExpress.XtraCharts.Series(); chartControl1.Series.Add(series); DataTable table = new DataTable(); series.ValueDataMembers.AddRange(new string[] { "UserEmail" }); series.ArgumentScaleType = DevExpress.XtraCharts.ScaleType.Qualitative; series.ArgumentDataMember = "PersonName"; 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 コントロール

下のコードではPipedrive でDevExpress Web を操作するための設定方法を説明します。PipedriveDataAdapter はチャートのSeries プロパティにバインドします。Diagram プロパティはx 軸とy 軸をカラム名として定義します。 using DevExpress.XtraCharts; using (PipedriveConnection connection = new PipedriveConnection( "AuthScheme=Basic;CompanyDomain=MyCompanyDomain;APIToken=MyAPIToken;")) { PipedriveDataAdapter PipedriveDataAdapter1 = new PipedriveDataAdapter("SELECT PersonName, UserEmail FROM Deals WHERE Value > 50000", connection); DataTable table = new DataTable(); PipedriveDataAdapter1.Fill(table); DevExpress.XtraCharts.Series series = new Series("Series1", ViewType.Bar); WebChartControl1.Series.Add(series); DataTable table = new DataTable(); series.ValueDataMembers.AddRange(new string[] { "UserEmail" }); series.ArgumentScaleType = ScaleType.Qualitative; series.ArgumentDataMember = "PersonName"; 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.)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。