製品をチェック

無償トライアル:

無償トライアルへ

製品の情報と無償トライアルへ:

DocuSign ODBC Driver

DocuSign ODBC Driver を使って、ODBC 接続をサポートするあらゆるアプリケーション・ツールからDocuSign データに連携。

DocuSign にデータベースのようにアクセス - Accounts、Envelopes、Folders にODBC インターフェースで接続。

データ連携でお困りですか？

お問い合わせ

記事の内容

関連記事

PHP からDocuSign にデータ連携。


CData ODBC Driver for DocuSign を使って、PHP アプリケーションからDocuSign にデータ連携。PHP でのODBC ネイティブサポートを活用。

古川えりか
コンテンツスペシャリスト

docusign ロゴ画像

ODBC Driver

odbc ロゴ画像
PHP ロゴ画像

CData ODBC Driver for DocuSign は、PHP アプリケーションからのDocuSign データへの連携を可能にします。本記事では、DocuSign データをPHP のビルトインODBC 機能でクエリを実行する手順を説明します。

DSN の設定

DocuSign に接続するDSN を作成します。

  1. まずODBC DSN に必要な接続プロパティの値を入力します。 組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。 これは、ドライバーのインストール時の最後のステップでも可能です。 Microsoft ODBC データソースアドミニストレータを使用してDSN を作成および設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。

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

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

    DocuSign への認証

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

一般的な接続文字列：

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

ビルトインのデータソースアドミニストレーターでDSN 設定をします。ドライバーのインストールの最後にアドミニストレーターが開きます。ヘルプの「はじめに」でODBC データソースアドミニストレータでDocuSign に接続するDSN の設定方法を参照してください。

DocuSign への接続の確立

odbc_connect を呼び出して、DocuSign への接続を開きます。 odbc_pconnect メソッドでも可能です。コネクションを閉じるには、odbc_close もしくはodbc_close_all を使います。

$conn = odbc_connect("CData ODBC DocuSign Source","user","password");

コネクションはodbc_connect で開かれ、スクリプトが終わると終了します。odbc_pconnect メソッドで開いたコネクションは、スクリプトが終わっても開いたままです。これにより同じクレデンシャルであれば他のスクリプトでコネクションを共有することが可能です:

$conn = odbc_pconnect("CData ODBC DocuSign Source","user","password"); ... odbc_close($conn); //persistent connection must be closed explicitly

エレメントの作成

odbc_prepare を使って、Prepared ステートメントおよびパラメータライズドクエリを作成します。

$query = odbc_prepare($conn, "SELECT * FROM Documents WHERE DocumentName = ?");

クエリの実行

Prepared ステートメントをodbc_execute を使って実行します。

$conn = odbc_connect("CData ODBC DocuSign Source","user","password"); $query = odbc_prepare($conn, "SELECT * FROM Documents WHERE DocumentName = ?"); $success = odbc_execute($query, array('TPSReport'));

Non-Parameterized クエリは、odbc_exec を使います。

$conn = odbc_connect("CData ODBC DocuSign Source","user","password"); $query = odbc_exec($conn, "SELECT * FROM Documents");

結果の処理

odbc_fetch_array ファンクションの結果セット配列としてアクセスします。

$conn = odbc_connect("CData ODBC DocuSign data Source","user","password"); $query = odbc_exec($conn, "SELECT * FROM Documents"); while($row = odbc_fetch_array($query)){ echo $row["DocumentId"] . "\n"; }

odbc_result_all ファンクションで、結果セットをHTML テーブルとして表示します。

$conn = odbc_connect("CData ODBC DocuSign data Source","user","password"); $query = odbc_prepare($conn, "SELECT * FROM Documents WHERE DocumentName = ?"); $success = odbc_execute($query, array('TPSReport')); if($success) odbc_result_all($query);

サンプルクエリのテスト

スタンドアロンのテスト環境をたちあげる簡単な方法はPHP のビルトインテストサーバーを使うことです。手順はこちらです：

  1. PHP の最新版のバイナリのダウンロード。

  2. フォルダにファイルを入れる。

  3. フォルダを開く。

  4. php.ini-development をphp.ini に変更。

  5. ブラウザからテストスクリプトにアクセスするためのコマンドを実行。

    php -S localhost:8000 -t C:\path-to-your-scripts -c C:\path-to-php\php.ini

他のサンプルクエリ

サポートされているSQL の詳細は、ヘルプドキュメントを参照してください。上のサンプルは、PHP community documentation for all ODBC functions のDocuSign に特化したものです。