各製品の資料を入手。
詳細はこちら →Dynamics CRM のデータをR で分析:JDBC での接続
CData JDBC Driver で標準的なR 関数とお好みの開発環境を使ってDynamics CRM を分析。
最終更新日:2023-09-21
この記事で実現できるDynamics CRM 連携のシナリオ
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for DynamicsCRM とRJDBC package を使って、R でリモートDynamics CRM データ を利用できます。CData Driver を使うことで、業界が認めた基準で書かれたドライバーを活用して、オープンソースでポピュラーなR 言語のデータにアクセスできます。この記事では、ドライバーを使ってDynamics CRM にSQL クエリを実行する方法、および標準R 関数を呼び出してDynamics CRM をビジュアライズする方法について説明します。
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 データソースとしてDynamics CRM に接続
下記の情報を使いDynamics CRM にJDBC データソースとして接続します。
- Driver Class:cdata.jdbc.dynamicscrm.DynamicsCRMDriver に設定。
- Classpath:Driver JAR の場所を設定します。デフォルトではインストールディレクトリの[lib]サブフォルダです。
dbConnect やdbSendQuery のようなDBI 関数は、R にデータアクセスコードを書くための統一インターフェースを提供します。
driver <- JDBC(driverClass = "cdata.jdbc.dynamicscrm.DynamicsCRMDriver", classPath = "MyInstallationDir\lib\cdata.jdbc.dynamicscrm.jar", identifier.quote = "'")
これで、DBI 関数を使ってDynamics CRM に接続しSQL クエリを実行する準備が整いました。dbConnect 関数を使ってJDBC 接続を初期化します。一般的なJDBC 接続文字列は次のとおりです。
conn <- dbConnect(driver,"User=myuseraccount;Password=mypassword;URL=https://myOrg.crm.dynamics.com/;CRM Version=CRM Online;")
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 の設定だけで接続することができます。
スキーマ Discovery
ドライバーは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")
次のコマンドを使って、結果を[data viewer]ウィンドウで見ることができます。
View(account)
Dynamics CRM データ をプロット
CRAN レポジトリで利用可能なあらゆるデータ初期化パッケージを使ってDynamics CRM を分析する準備が整いました。ビルトインバーのplot 関数を使って簡単なバーを作成できます。
par(las=2,ps=10,mar=c(5,15,4,2)) barplot(account$NumberOfEmployees, main="Dynamics CRM Account", names.arg = account$FirstName, horiz=TRUE)
