Visual Studio でチャートコントロールと Salesforce をデータバインド

データバインドによって、UI コントロールからデータに接続できます。 CData ADO.NET Provider for Salesforce を使って、Visual Studio 上でWindows Forms およびWeb Forms とSalesforce をデータバインドできます。この記事で、Salesforce を、ウィザードから変更をリアルタイムで反映するチャートにデータバインドする方法を説明します。 Code Walk-through セクションではチャートはほんの10行のコードで作成します。

チャートへのデータバインド

データバインドは３つのステップから構成されます。コントロールのインスタンス作成、データソースの設定、最後にデータバインドです。

接続を設定してデータベースオブジェクトを選択

下の手続きにより、データソース構成ウィザードを使ってチャートコントロールとSalesforce との接続を作成します。ウィザード上でデータバインドをするSalesforce エンティティを使います。

1. Windows Forms プロジェクトでは、チャートコントロールをツールボックスからフォーム上にドラグ＆ドロップします。チャートプロパティのデータセクションで DataSource を選択し、メニューからプロジェクトデータソースの追加を選択します。
2. 出てくるデータソース構成ウィザードでデータベース -> データセットを選択します。
3. データ接続ステップで、「新しい接続」をクリックします。

4. データ接続の選択ダイアログで、「変更」をクリックして、CData Salesforce のデータソースを選択して、接続プロパティを入力します。下は代表的な接続文字列ですです。:

   User=username;Password=password;SecurityToken=Your_Security_Token;

   Salesforce 接続プロパティの設定方法

   埋め込みOAuth（UI でのログイン）による接続設定

   それでは、Salesforce への接続について説明していきましょう。最も簡単な方法として、Salesforce にログインする際と同様にUI 上からログインするだけで接続設定が完了します（埋め込みOAuth）。この方法をご利用になる場合は、「Salesforce への接続」をクリックしてください。

   標準認証の設定

   埋め込みOAuth 以外の方法を利用する場合、以下の3つの認証方式をご利用いただけます。標準的な認証方式では、以下の情報が必要となります。

   • ユーザー名
   • パスワード
   • セキュリティトークン

   セキュリティトークンの取得方法については、セキュリティトークン取得手順をご確認ください。

   OAuth 認証の設定

   ユーザー名とパスワードによる認証がご利用いただけない（避けたい）場合は、OAuth 認証をお使いいただけます。

   SSO（シングルサインオン）の設定

   最後に、IDプロバイダー経由でのシングルサインオンをご利用になる場合は、以下のプロパティを設定してください。

   • SSOProperties
   • SSOLoginUrl
   • TokenUrl

   より詳細な設定手順については、ヘルプドキュメントの「はじめに」セクションをご確認ください。


5. 使用するデータソースオブジェクトを選択します。例は Account テーブルです。

DataBind

データソースの追加とデータベースオブジェクトを選択したら、チャートにオブジェクトをバインドします。この例では、X軸に Industry をY軸に AnnualRevenue を設定します。

1. チャートプロパティで、Series プロパティをクリックし、Series コレクション エディター を開きます。
2. Series プロパティでX軸、Y軸に設定するカラムを選択します：XValueMember および YValueMember プロパティにメニューからカラムを選びます。

チャートはこれでSalesforce にデータバインドされました。チャートを実行して最新のデータを表示させましょう。

コード Walk-through

Salesforce へのデータバインドはほんの数行のコードのみが必要で、３つの簡単なステップで完了できます。

1. Salesforce に接続します。
2. SalesforceDataAdapter を作成して、クエリを作成し、結果を入れるデータセットを作成します。
3. 結果セットとチャートをデータバインドします。

下に完全なコードを示します:

SalesforceConnection conn = new SalesforceConnection("User=username;Password=password;SecurityToken=Your_Security_Token;");
SalesforceCommand comm = new SalesforceCommand("SELECT Contact.Name, SUM(Account.AnnualRevenue) FROM Contact, Account GROUP BY Contact.Name", conn);
SalesforceDataAdapter da = new SalesforceDataAdapter(comm);
DataSet dataset = new DataSet();
da.Fill(dataset);

chart1.DataSource = dataset;
chart1.Series[0].XValueMember = "Industry";
chart1.Series[0].YValueMembers = "AnnualRevenue";
// Insert code for additional chart formatting here.
chart1.DataBind();