RapidMiner からSAP SuccessFactors データに連携

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

この記事では、CData JDBC Driver for SAPSuccessFactors をRapidMiner のプロセスと簡単に統合する方法を示します。この記事では、CData JDBC Driver for SAPSuccessFactors を使用してSAP SuccessFactors をRapidMiner のプロセスに転送します。

RapidMiner のSAP SuccessFactors にJDBC Data Source として接続する

以下のステップに従ってSAP SuccessFactors へのJDBC 接続を確認できます。

1. SAP SuccessFactors 用の新しいデータベースドライバーを追加します。［Connections］->［Manage Database Drivers］とクリックします。
2. 表示されるウィザードで［Add］ボタンをクリックし、接続に名前を入力します。
3. JDBC URL のプレフィックスを入力します。 jdbc:sapsuccessfactors:
4. インストールディレクトリのlib サブフォルダにあるcdata.jdbc.sapsuccessfactors.jar ファイルにパスを入力して下さい。
5. ドライバークラスを入力します。 cdata.jdbc.sapsuccessfactors.SAPSuccessFactorsDriver
6. 新しいSAP SuccessFactors 接続を作成します。［Connections］->［Manage Database Connections］とクリックします。
7. 接続の名前を入力します。
8. データベースシステムの場合は、以前構成したSAP SuccessFactors ドライバーを選択します。
9. Host ボックスで接続文字列を入力します。

   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 に設定。

   ビルトイン接続文字列デザイナ

   JDBC URL の構成については、SAP SuccessFactors JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

   java -jar cdata.jdbc.sapsuccessfactors.jar

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

   以下は一般的な接続文字列です。

   User=username;Password=password;CompanyId=CompanyId;Url=https://api4.successfactors.com;
10. 必要であればユーザー名とパスワードを入力します。

プロセス内の様々なRapidMiner オペレーターとのSAP SuccessFactors 接続を使用できます。SAP SuccessFactors を取得するには、［Operators］ビューから［Retrieve］をドラッグします。 ［Retrieve］オペレータを選択した状態で、［repository entry］の横にあるフォルダアイコンをクリックして［Parameters］ビューで取得するテーブルを定義できます。表示されるRepository ブラウザで接続ノードを展開し、目的のサンプルセットを選択できます。

最後に、［Retrieve］プロセスから結果に出力をワイヤリングし、プロセスを実行してSAP SuccessFactors を確認します。