CData ODBC Driver for Dynamics CRM を使うと、簡単にRuby アプリケーションにリアルタイムDynamics CRM データを連携・統合できます。
Tこの記事では、Dynamics CRM] データにリアルタイムに連携するRuby アプリケーションを構築して、クエリを実行し、結果を表示してみます。
Dynamics CRM データのODBC 接続を設定
通常はCData ODBC Driver のインストール後にODBC DSN 接続ウィザードが立ち上がり、設定を行うことができます。
もしODBC DSN 接続が未済の場合には、Microsoft ODBC データソースアドミニストレータでODBC DSN を作成および設定することができます。
Dynamics CRM では、インスタンスごとに接続文字列の設定が必要です。
Authentication セクションでは、有効なDynamics CRM のUser、Password の入力、およびDynamics CRM Server Organization root のURL を設定します。さらに、CRMVersion プロパティに、'CRM2011+' もしくは'CRMOnline' を設定します。IFD コンフィグレーションもサポートされていますので、InternetFacingDeployment をTRUE に設定してください。
また、Security Token Service（STS）、もしくはAD FS エンドポイントをSTSURL プロパティに設定することもできます。 この値はGetSTSUrl ストアドプロシージャで取得できます。
Office 365 ユーザーはデフォルトSTS URL にCRMVersion の設定だけで接続することができます。
Ruby および必要なGem のインストール
If you do not have Ruby installed, refer to the Ruby インストールページ.
Ruby をインストールしたら、次にruby-dbi、dbd-odbc、ruby-odbc gems をインストールします:
gem install dbi
gem install dbd-odbc
gem install ruby-odbc
Dynamics CRM データに連携するRuby アプリケーションの作成
Ruby ファイル (例: DynamicsCRMSelect.rb) を作成し、テキストエディタで開きます。ファイルに次のコードをコピーします:
#connect to the DSN
require 'DBI'
cnxn = DBI.connect('DBI:ODBC:CData DynamicsCRM Source','','')
#execute a SELECT query and store the result set
resultSet = cnxn.execute("SELECT Contact.FirstName, SUM(Account.NumberOfEmployees) FROM Contact, Account GROUP BY Contact.FirstName")
#display the names of the columns
resultSet.column_names.each do |name|
print name, "\t"
end
puts
#display the results
while row = resultSet.fetch do
(0..resultSet.column_names.size - 1).each do |n|
print row[n], "\t"
end
puts
end
resultSet.finish
#close the connection
cnxn.disconnect if cnxn
これで、Ruby で Dynamics CRM データが接続できるようになります。簡単にコマンドラインからファイルを叩いて接続を確認してみましょう。:
ruby DynamicsCRMSelect.rb
Dynamics CRM へのSQL-92 企画のSQL を使って、Ruby に簡単にDynamics CRM を連携できます。是非、トライアルで試してみてください。