Ruby でFinancialForce データ連携アプリを構築





FinancialForce ODBC Driver

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

FinancialForce データにデータベースと同感覚でアクセスして、FinancialForce のInvoices、Expenses、Accounts など多様なデータに使い慣れたODBC インターフェースで双方向連携。

Ruby でODBC 経由でFinancialForce に接続して、モダンなクラウド連携アプリを開発。

CData ODBC Driver for FinancialForce を使うと、簡単にRuby アプリケーションにリアルタイムFinancialForce データを連携・統合できます。 Tこの記事では、FinancialForce] データにリアルタイムに連携するRuby アプリケーションを構築して、クエリを実行し、結果を表示してみます。

FinancialForce データのODBC 接続を設定

通常はCData ODBC Driver のインストール後にODBC DSN 接続ウィザードが立ち上がり、設定を行うことができます。 もしODBC DSN 接続が未済の場合には、Microsoft ODBC データソースアドミニストレータでODBC DSN を作成および設定することができます。

There are several authentication methods available for connecting to FinancialForce: login credentials, SSO, and OAuth.

Authenticating with a Login and Token

Set the User and Password to your login credentials. Additionally, set the SecurityToken. By default, the SecurityToken is required, but you can make it optional by allowing a range of trusted IP addresses.

To disable the security token:

  1. Log in to FinancialForce and enter "Network Access" in the Quick Find box in the setup section.
  2. Add your IP address to the list of trusted IP addresses.

To obtain the security token:

  1. Open the personal information page on
  2. Click the link to reset your security token. The token will be emailed to you.
  3. Specify the security token in the SecurityToken connection property or append it to the Password.

Authenticating with OAuth

If you do not have access to the user name and password or do not want to require them, use the OAuth user consent flow. See the OAuth section in the Help for an authentication guide.

Connecting to FinancialForce Sandbox Accounts

Set UseSandbox to true (false by default) to use a FinancialForce sandbox account. Ensure that you specify a sandbox user name in User.

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

FinancialForce データに連携するRuby アプリケーションの作成

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

#connect to the DSN require 'DBI' cnxn = DBI.connect('DBI:ODBC:CData FinancialForce Source','','') #execute a SELECT query and store the result set resultSet = cnxn.execute("SELECT BillingState, Name FROM Account WHERE Industry = 'Floppy Disks'") #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 で FinancialForce データが接続できるようになります。簡単にコマンドラインからファイルを叩いて接続を確認してみましょう。:

ruby FinancialForceSelect.rb FinancialForce へのSQL-92 企画のSQL を使って、Ruby に簡単にFinancialForce を連携できます。是非、トライアルで試してみてください。