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

詳細情報をご希望ですか?

無償トライアル:

ダウンロードへ

製品の詳細情報へ:

DocuSign ADO.NET Provider

DocuSign のAccounts、Envelopes、Folders データに連携する.NET アプリケーションを素早く、簡単に開発できる便利なドライバー。



標準ADO.NET プロシージャを使ってデータバインドして、Visual Studio ツールボックスのコントロールから DocuSign との双方向接続を実現。この記事ではVisual Studio のグラフィカルアプローチと、ほんの数行のコードでデータバインドをする方法を説明します。

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

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

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

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

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

  1. Windows Forms プロジェクトでは、チャートコントロールをツールボックスからフォーム上にドラグ&ドロップします。チャートプロパティのデータセクションで DataSource を選択し、メニューからプロジェクトデータソースの追加を選択します。
  2. 出てくるデータソース構成ウィザードでデータベース -> データセットを選択します。
  3. データ接続ステップで、「新しい接続」をクリックします。
  4. データ接続の選択ダイアログで、「変更」をクリックして、CData DocuSign データソースを選択して、接続プロパティを入力します。下は代表的な接続文字列ですです。:

    OAuthClientId=MyClientId; OAuthClientSecret=MyClientSecret; CallbackURL=http://localhost:33333;

    DocuSign への接続には以下の接続プロパティを設定します:

    • UseSandbox: UseSandbox は現在のユーザーアカウントがサンドボックスかそうでないかを示します。デフォルトはfalse です。サンドボックスアカウントがある場合はTrue に設定します。
    • AccountId (optional): 認証が成功すると自動的に設定されます。 または、複数のAccount Id にアクセスできる場合は、接続文字列で手動で設定できます。アカウントId を取得するには、UserInfo ビューをクエリします。

    DocuSign への認証

    DocuSign はOAuth 認証標準を利用しています。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得しなければなりません。認証方法については、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

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

DataBind

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

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

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

コード Walk-through

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

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

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

DocuSignConnection conn = new DocuSignConnection("OAuthClientId=MyClientId; OAuthClientSecret=MyClientSecret; CallbackURL=http://localhost:33333; "); DocuSignCommand comm = new DocuSignCommand("SELECT DocumentId, DocumentName FROM Documents WHERE DocumentName = 'TPSReport'", conn); DocuSignDataAdapter da = new DocuSignDataAdapter(comm); DataSet dataset = new DataSet(); da.Fill(dataset); chart1.DataSource = dataset; chart1.Series[0].XValueMember = "DocumentId"; chart1.Series[0].YValueMembers = "DocumentName"; // Insert code for additional chart formatting here. chart1.DataBind();