FinancialForce データをR で分析

CData JDBC Driver for FinancialForceで標準的なR 関数とお好みの開発環境を使って、 FinancialForce を分析。



Pure R スクリプトおよび 標準SQL を使って、R およびJava をインストール可能なあらゆるマシン上でFinancialForce にアクセス。CData JDBC Driver for FinancialForce とRJDBC package を使って、R でリモートFinancialForce data を利用できます。CData Driver を使うことで、業界が認めた基準で書かれたドライバーを活用して、オープンソースでポピュラーなR 言語のデータにアクセスできます。この記事では、ドライバーを使ってFinancialForce にSQL クエリを実行する方法、および標準R 関数を呼び出してFinancialForce をビジュアライズする方法について説明します。

R をインストール

マルチスレッドのMicrosoft R Open を実行すること、またはBLAS/LAPACK ライブラリにリンクされたオープン R を実行することによって、マルチスレッドおよびマネージドコードから利益を得られたドライバーのパフォーマンスにマッチできます。ここでは、Microsoft R Open 3.2.3 を使用します。CRAN レポジトリのJan. 1, 2016 snapshot からパッケージをインストールするために事前設定されています。このsnapshot は再現性を保証します。

RJDBC パッケージをロード

ドライバーを使うにはRJDBC パッケージをダウンロードします。RJDBC パッケージをインストールしたら、次のコードを入力してパッケージをロードします。

library(RJDBC)

JDBC データソースとしてFinancialForce に接続

下記の情報を使いFinancialForce にJDBC データソースとして接続します。

  • Driver Class:cdata.jdbc.financialforce.FinancialForceDriver に設定。
  • Classpath:Driver JAR の場所を設定します。デフォルトではインストールディレクトリの[lib]サブフォルダです。

dbConnect やdbSendQuery のようなDBI 関数は、R にデータアクセスコードを書くための統一インターフェースを提供します。

driver <- JDBC(driverClass = "cdata.jdbc.financialforce.FinancialForceDriver", classPath = "MyInstallationDir\lib\cdata.jdbc.financialforce.jar", identifier.quote = "'")

これで、DBI 関数を使ってFinancialForce に接続しSQL クエリを実行する準備が整いました。dbConnect 関数を使ってJDBC 接続を初期化します。一般的なJDBC 接続文字列は次のとおりです。

conn <- dbConnect(driver,"User=myUser;Password=myPassword;Security Token=myToken;")

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 FinancialForce.com.
  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.

スキーマ Discovery

ドライバーはFinancialForce API をリレーショナルデータベース、ビュー、ストアドプロシージャとしてモデルします。次のコードを使ってテーブルリストを検出します。

dbListTables(conn)

SQL クエリの実行

dbGetQuery 関数を使ってFinancialForce API がサポートするすべてのSQL クエリを実行できます:

account <- dbGetQuery(conn,"SELECT BillingState, Name FROM Account WHERE Industry = 'Floppy Disks'")

次のコマンドを使って、結果を[data viewer]ウィンドウで見ることができます。

View(account)

FinancialForce Data をプロット

CRAN レポジトリで利用可能なあらゆるデータ初期化パッケージを使ってFinancialForce を分析する準備が整いました。ビルトインバーのplot 関数を使って簡単なバーを作成できます。

par(las=2,ps=10,mar=c(5,15,4,2)) barplot(account$Name, main="FinancialForce Account", names.arg = account$BillingState, horiz=TRUE)
 
 
ダウンロード