Ready to get started?

Learn more about the CData JDBC Driver for Xero or download a free trial:

Download Now

Xero Data をR で分析

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



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

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 データソースとしてXero に接続

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

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

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

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

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

conn <- dbConnect(driver,"")

To connect, set the Schema connection property in addition to any authentication values. Xero offers authentication for private applications, public applications, and partner applications. You will need to set the XeroAppAuthentication property to PUBLIC, PRIVATE, or PARTNER, depending on the type of application configured. To connect from a private application, you will additionally need to set the OAuthAccessToken, OAuthClientId, OAuthClientSecret, CertificateStoreType, CertificateStore, and CertificateStorePassword.

To connect from a public or partner application, you can use the embedded OAuthClientId, OAuthClientSecret, and CallbackURL, or you can register an app to obtain your own OAuth values.

See the "Getting Started" chapter of the help documentation for a guide to authenticating to Xero.

スキーマ Discovery

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

dbListTables(conn)

SQL クエリの実行

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

items <- dbGetQuery(conn,"SELECT Name, SUM(QuantityOnHand) FROM Items GROUP BY Name")

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

View(items)

Xero Data をプロット

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

par(las=2,ps=10,mar=c(5,15,4,2)) barplot(items$QuantityOnHand, main="Xero Items", names.arg = items$Name, horiz=TRUE)
 
 
ダウンロード