JRuby からDocuSign にデータ連携

製品をチェック

無償トライアル:

ダウンロードへ

製品の詳細情報へ:

DocuSign JDBC Driver

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


リアルタイムDocuSign に連携するシンプルなJRuby アプリケーションを作成します。



JRuby はRuby プログラミング言語の高性能で安定した、完全にスレッド化されたJava 実装です。CData JDBC Driver for DocuSign を使用すると、JRuby からリアルタイムDocuSign へのデータ連携を簡単に実装できます。ここでは、DocuSign に接続し、クエリを実行して結果を表示する簡単なJRuby アプリを作成する方法を説明します。

DocuSign データにJDBC で接続

アプリを作成する前に、JDBC Driver のJAR ファイルのインストール場所をメモします。 (通常はC:\Program Files\CDatat\CData JDBC Driver for DocuSign\libにあります。)

JRuby は、JDBC をネイティブにサポートしているため、簡単にDocuSign に接続してSQL クエリを実行できます。java.sql.DriverManager クラスのgetConnection 関数を使用してJDBC 接続を初期化します。

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

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

DocuSign への認証

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

ビルトイン接続文字列デザイナー

JDBC URL の構成については、DocuSign JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

java -jar cdata.jdbc.docusign.jar

接続プロパティを入力し、接続文字列をクリップボードにコピーします。

以下はDocuSign の一般的なJDBC 接続文字列です。

jdbc:docusign:OAuthClientId=MyClientId; OAuthClientSecret=MyClientSecret; CallbackURL=http://localhost:33333; InitiateOAuth=GETANDREFRESH

DocuSign データへの接続性を持つJRuby アプリを作成

新しいRuby ファイル(例: DocuSignSelect.rb) を作成してテキストエディタで開き、次のコードをファイルにコピーします。

require 'java' require 'rubygems' require 'C:/Program Files/CData/CData JDBC Driver for DocuSign 2018/lib/cdata.jdbc.docusign.jar' url = "jdbc:docusign:OAuthClientId=MyClientId; OAuthClientSecret=MyClientSecret; CallbackURL=http://localhost:33333; InitiateOAuth=GETANDREFRESH" conn = java.sql.DriverManager.getConnection(url) stmt = conn.createStatement rs = stmt.executeQuery("SELECT DocumentId, DocumentName FROM Documents") while (rs.next) do puts rs.getString(1) + ' ' + rs.getString(2) end

ファイルが完成したら、コマンドラインからファイルを実行するだけでJRuby でDocuSign を表示できるようになります。

jruby -S DocuSignSelect.rb

SQL-92 クエリをDocuSign に書き込むと、DocuSign を独自のJRuby アプリケーションに素早く簡単に組み込むことができます。今すぐ無料トライアルをダウンロードしましょう。