各製品の資料を入手。
詳細はこちら →SAP SuccessFactors のデータをR で分析:JDBC での接続
CData JDBC Driver で標準的なR 関数とお好みの開発環境を使ってSAP SuccessFactors を分析。
最終更新日:2023-09-21
この記事で実現できるSAP SuccessFactors 連携のシナリオ
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for SAPSuccessFactors とRJDBC package を使って、R でリモートSAP SuccessFactors データ を利用できます。CData Driver を使うことで、業界が認めた基準で書かれたドライバーを活用して、オープンソースでポピュラーなR 言語のデータにアクセスできます。この記事では、ドライバーを使ってSAP SuccessFactors にSQL クエリを実行する方法、および標準R 関数を呼び出してSAP SuccessFactors をビジュアライズする方法について説明します。
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 データソースとしてSAP SuccessFactors に接続
下記の情報を使いSAP SuccessFactors にJDBC データソースとして接続します。
- Driver Class:cdata.jdbc.sapsuccessfactors.SAPSuccessFactorsDriver に設定。
- Classpath:Driver JAR の場所を設定します。デフォルトではインストールディレクトリの[lib]サブフォルダです。
dbConnect やdbSendQuery のようなDBI 関数は、R にデータアクセスコードを書くための統一インターフェースを提供します。
driver <- JDBC(driverClass = "cdata.jdbc.sapsuccessfactors.SAPSuccessFactorsDriver", classPath = "MyInstallationDir\lib\cdata.jdbc.sapsuccessfactors.jar", identifier.quote = "'")
これで、DBI 関数を使ってSAP SuccessFactors に接続しSQL クエリを実行する準備が整いました。dbConnect 関数を使ってJDBC 接続を初期化します。一般的なJDBC 接続文字列は次のとおりです。
conn <- dbConnect(driver,"User=username;Password=password;CompanyId=CompanyId;Url=https://api4.successfactors.com;")
Basic 認証またはOAuth with SAML アサーションを使用して、SAP SuccessFactors に認証できます。
Basic 認証
SAP SuccessFactors に正常に認証するには、次のプロパティの値を指定する必要があります。プロバイダーは、Cookie を使用してSAP SuccessFactors によって開かれたセッションを再利用することに注意してください。つまり、セッションを開く最初のリクエストでのみクレデンシャルが使用されます。その後、SAP SuccessFactors から返されたCookie が認証に使用されます。
- Url: Success Factors をホストするサーバーのURL に設定。一部のサーバーがリストされています。SAP support documentation(外部リンク)。
- User: アカウントのユーザー名に設定。
- Password: アカウントのパスワードに設定。
- CompanyId: 会社の一意の識別子に設定。
OAuth 認証
アクセストークンを取得するために使用される、次のプロパティの値を指定する必要があります。
- Url: Success Factors をホストするサーバーのURL に設定。一部のサーバーがリストされています。SAP support documentation(外部リンク)。
- User: アカウントのユーザー名に設定。
- CompanyId: 会社の一意の識別子に設定。
- OAuthClientId: API Center で生成されたAPI Key に設定。
- OAuthClientSecret: SAML アサーションの署名に使用されるX.509 プライベートキー。プライベートキーは、「Registering your OAuth Client Application」でダウンロードした証明書に記載されています。
- InitiateOAuth: GETANDREFRESH に設定。
スキーマ Discovery
ドライバーはSAP SuccessFactors API をリレーショナルデータベース、ビュー、ストアドプロシージャとしてモデルします。次のコードを使ってテーブルリストを検出します。
dbListTables(conn)
SQL クエリの実行
dbGetQuery 関数を使ってSAP SuccessFactors API がサポートするすべてのSQL クエリを実行できます:
extaddressinfo <- dbGetQuery(conn,"SELECT address1, zipCode FROM ExtAddressInfo WHERE city = 'Springfield'")
次のコマンドを使って、結果を[data viewer]ウィンドウで見ることができます。
View(extaddressinfo)
SAP SuccessFactors データ をプロット
CRAN レポジトリで利用可能なあらゆるデータ初期化パッケージを使ってSAP SuccessFactors を分析する準備が整いました。ビルトインバーのplot 関数を使って簡単なバーを作成できます。
par(las=2,ps=10,mar=c(5,15,4,2)) barplot(extaddressinfo$zipCode, main="SAP SuccessFactors ExtAddressInfo", names.arg = extaddressinfo$address1, horiz=TRUE)
