R から JDBC 経由でDynamics CRMののデータを分析

Jerod Johnson
Jerod Johnson
Senior Technology Evangelist
CData JDBC Driver for Dynamics CRM を使って、お好みの開発環境と標準的な R 関数でDynamics CRM のデータを分析できます。

R と Java がインストールされている環境であれば、純粋な R スクリプトと標準的な SQL を使用してDynamics CRM のデータにアクセスできます。CData JDBC Driver for Dynamics CRM と RJDBC パッケージを使えば、R からリモートのDynamics CRM のデータを操作できます。CData Driver を使用することで、業界で実績のある標準規格に準拠したドライバーを活用し、人気のオープンソース言語 R でデータにアクセスできます。この記事では、ドライバーを使ってDynamics CRMに SQL クエリを実行し、標準的な R 関数を呼び出してDynamics CRM のデータを可視化する方法を説明します。

Dynamics CRM データ連携について

CData は、Microsoft Dynamics CRM のライブデータへのアクセスと統合を簡素化します。お客様は CData の接続機能を以下の目的で活用しています：

  • Dynamics CRM 2011+ サービスおよび Dynamics CRM Online のデータの読み取りと書き込みができます。
  • カスタマイズ可能なキャッシュと、インテリジェントなクエリ集約・分離により、Dynamics CRM のネイティブ機能を拡張できます。
  • Azure Active Directory、Azure マネージド サービス ID 認証情報、クライアントシークレットまたは証明書を使用した Azure サービスプリンシパルなど、さまざまな方法で Dynamics CRM に安全に認証できます。

CData のお客様は、データをデータウェアハウスにレプリケートしたい場合（他のデータソースと併せて）や、Microsoft エコシステム内のお気に入りのデータツール（Power BI、Excel など）または外部ツール（Tableau、Looker など）からライブ Dynamics CRM データを分析したい場合など、さまざまな理由で当社の Dynamics CRM 接続ソリューションを使用しています。


はじめに


R のインストール

マルチスレッドとマネージドコードによるドライバーのパフォーマンス向上を最大限に活かすには、マルチスレッド対応の Microsoft R Open を使用するか、BLAS/LAPACK ライブラリとリンクされたオープンソース R を使用します。この記事では Microsoft R Open 3.2.3 を使用しています。このバージョンは、2016年1月1日時点の CRAN リポジトリのスナップショットからパッケージをインストールするように事前設定されており、再現性が確保されています。

RJDBC パッケージの読み込み

ドライバーを使用するには、RJDBC パッケージをダウンロードしてください。 RJDBC パッケージをインストールしたら、以下のコードでパッケージを読み込みます。 

library(RJDBC)

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

Dynamics CRMに JDBC データソースとして接続するには、以下の情報が必要です。

  • Driver Class: cdata.jdbc.dynamicscrm.DynamicsCRMDriver に設定します。
  • Classpath: ドライバー JAR ファイルの場所を設定します。デフォルトでは、インストールフォルダの lib サブフォルダです。

dbConnect や dbSendQuery などの DBI 関数は、R でデータアクセスコードを記述するための統一されたインターフェースを提供します。以下のコードで、CData JDBC Driver for Dynamics CRM に JDBC リクエストを行う DBI ドライバーを初期化します。 

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

これで DBI 関数を使用してDynamics CRMに接続し、SQL クエリを実行できます。dbConnect 関数で JDBC 接続を初期化します。

Dynamics CRM 接続プロパティの取得・設定方法

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 の設定だけで接続することができます。

組み込みの接続文字列デザイナー

JDBC URL の構築には、Dynamics CRM JDBC Driver に組み込まれている接続文字列デザイナーが便利です。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

java -jar cdata.jdbc.dynamicscrm.jar

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

以下は、一般的な JDBC 接続文字列を含む dbConnect 呼び出しの例です。

conn <- dbConnect(driver,"jdbc:dynamicscrm:User=myuseraccount;Password=mypassword;URL=https://myOrg.crm.dynamics.com/;CRM Version=CRM Online;")

スキーマの検出

このドライバーは、Dynamics CRM API をリレーショナルテーブル、ビュー、ストアドプロシージャとしてモデル化します。以下のコードでテーブルの一覧を取得できます。 

dbListTables(conn)

SQL クエリの実行

dbGetQuery 関数を使用して、Dynamics CRM API でサポートされている任意の SQL クエリを実行できます。 

account <- dbGetQuery(conn,"SELECT Contact.FirstName, SUM(Account.NumberOfEmployees) FROM Contact, Account GROUP BY Contact.FirstName")

以下のコマンドで、結果をデータビューアウィンドウに表示できます。 

View(account)

Dynamics CRM のデータのプロット

これで、CRAN リポジトリで利用可能なデータ可視化パッケージを使ってDynamics CRM のデータを分析できます。組み込みのバープロット関数でシンプルな棒グラフを作成できます。 

par(las=2,ps=10,mar=c(5,15,4,2))
barplot(account$NumberOfEmployees, main="Dynamics CRM Account", names.arg = account$FirstName, horiz=TRUE)

はじめる準備はできましたか？

Dynamics CRM Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

Dynamics CRM Icon Dynamics CRM JDBC Driver お問い合わせ

潜在顧客、連絡先、営業案件、アカウントなどのMicrosoft Dynamics CRM アカウントデータを組み込んだパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。

この記事の内容

関連記事