JRuby からBlackbaud FE NXT にデータ連携

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

Blackbaud FE NXT のデータにJDBC で接続

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

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

Blackbaud Financial Edge NXT はOAuth 認証標準を利用しています。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得する必要があります。

認証方法についての詳細は、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

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

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

java -jar cdata.jdbc.financialedgenxt.jar

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

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

jdbc:financialedgenxt:SubscriptionKey=MySubscriptionKey;

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

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

require 'java'
require 'rubygems'
require 'C:/Program Files/CData/CData JDBC Driver for FinancialEdgeNXT 2018/lib/cdata.jdbc.financialedgenxt.jar'

url = "jdbc:financialedgenxt:SubscriptionKey=MySubscriptionKey;"
conn = java.sql.DriverManager.getConnection(url)
stmt = conn.createStatement
rs = stmt.executeQuery("SELECT AccountId, AccountNumber FROM Accounts")
while (rs.next) do
  puts rs.getString(1) + ' ' + rs.getString(2)
end

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

jruby -S FinancialEdgeNXTSelect.rb

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