SnapLogic でSAP SuccessFactors を外部サービスに連携

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

SnapLogic はintegration Platform-as-a-Service（iPaaS）であり、ユーザーはノーコードでデータ連携フローを作成できます。CData JDBC ドライバと組み合わせることで、ユーザーはSnapLogic ワークフローからSAP SuccessFactors を含む250を超えるSaaS、ビッグデータ、NoSQL データソースのリアルタイムデータに接続できます。

組み込みの最適化されたデータ処理によって、CData JDBC Driver はリアルタイムSAP SuccessFactors のデータを高速に扱えます。プラットフォームがSAP SuccessFactors に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をSAP SuccessFactors に直接プッシュし、サポートされていない操作（主にSQL 関数とJOIN 操作）は組み込みSQL エンジンを利用してクライアント側で処理します。組み込みの動的メタデータクエリを使用すると、ネイティブデータソース型を使用してSAP SuccessFactors のデータを操作することができます。

SnapLogic からSAP SuccessFactors に接続する

SnapLogic からSAP SuccessFactors のデータに接続するには、CData SAP SuccessFactors JDBC Driver をダウンロードしてインストールします。インストール画面に従ってください。インストールが完了すると、インストール先のディレクトリ（デフォルトでは、C:/Program Files/CData/CData JDBC Driver for SAPSuccessFactors/lib）にJAR ファイルが作成されます。

SAP SuccessFactors JDBC Driver をアップロードする

インストール後、JDBC JAR ファイルをSnapLogic 内のディレクトリ（例えば、projects/Jerod Johnson）にManager タブからアップロードします。

接続を設定する

JDBC Driver がアップロードされると、SAP SuccessFactors への接続を作成できます。

1. Designer タブに移動します。
2. Snaps から「JDBC」を展開して、「Generic JDBC - Select」snap をdesigner にドラッグします。
3. Add Account をクリック（または既存のものを選択）して、「Continue」をクリックします。
4. 次のフォームでは、JDBC 接続プロパティを設定します。
   • JDBC JARs 以下にアップロードしたJAR ファイルを追加します。
   • JDBC Driver Class をcdata.jdbc.sapsuccessfactors.SAPSuccessFactorsDriver に設定します。

   • JDBC URL をSAP SuccessFactors JDBC Driver 用のJDBC 接続文字列に設定します。例えば、

     jdbc:sapsuccessfactors:User=username;Password=password;CompanyId=CompanyId;Url=https://api4.successfactors.com;RTK=XXXXXX;

     です。

     NOTE： RTK は評価版もしくは製品版のキーです。詳しくは、CData のサポートチームにご連絡ください。

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

     JDBC URL の作成の補助として、SAP SuccessFactors JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

     java -jar cdata.jdbc.sapsuccessfactors.jar

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

     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 に設定。
     
5. 接続プロパティの入力後、「Validate」、そして「Apply」をクリックします。

SAP SuccessFactors のデータを読み込む

接続を検証、適用後に開くフォームで、クエリを設定します。

• Schema name を"SAPSuccessFactors" に設定します。
• Table name を、スキーマ名を使用したSAP SuccessFactors 用のテーブルに設定します。例えば、"SAPSuccessFactors"."ExtAddressInfo" です（ドロップダウンを使用して利用可能なテーブルの全リストを確認できます）。
• テーブルから、使用したい項目ごとにOutput fields を追加します。

Generic JDBC - Select snap を保存します。

接続とクエリを設定したら、snap の終端部分（以下のハイライト部分）をクリックしてデータをプレビューします。

結果が期待どおりのものであることを確認したら、他のsnap を追加してSAP SuccessFactors のデータを別のエンドポイントに渡すこともできます。

SAP SuccessFactors のデータを外部サービスにパイプ

本記事では、データをGoogle Spreadsheet にロードします。他のあらゆるサポートされているsnap が使用でき、Generic JDBC snap を他のCData JDBC ドライバと利用してデータを外部サービスに移すこともできます。

1. まず、「Worksheet Writer」snap を"Generic JDBC - Select" snap の終端部分にドロップします。
2. Google Sheets に接続するアカウントを追加します。
3. Worksheet Writer snap を、SAP SuccessFactors のデータをGoogle Spreadsheet に書き込むよう設定します。

これで、接続済みのパイプラインを実行してSAP SuccessFactors からデータを抽出し、Google Spreadsheet にプッシュできます。

外部データをSAP SuccessFactors にパイプ

上述のように、JDBC Driver for SAPSuccessFactors をSnapLogic から使用してデータをSAP SuccessFactors に書き込むことができます。まずは、Generic JDBC - Insert またはGeneric JDBC - Update snap をダッシュボードに追加します。

1. 既存の「Account」（接続）を選択するか、新しく作成します。
2. クエリの設定。
   • Schema name を"SAPSuccessFactors" に設定します。
   • Table name をスキーマ名を使用したSAP SuccessFactors のテーブルに設定します。例えば、"SAPSuccessFactors"."ExtAddressInfo"（ドロップダウンを使用して利用可能な全テーブルの一覧を確認できます）。
   
3. Generic JDBC - Insert/Update snap を保存します。

これで、SAP SuccessFactors にデータを書き込んだり、新しいレコードを挿入したり、既存のレコードを更新するsnap が設定できました。

詳細情報と無償評価版

CData JDBC Driver for SAPSuccessFactors を使えば、SAP SuccessFactors のデータを外部サービスに連携するためのパイプラインをSnapLogic で作成できます。SAP SuccessFactors への接続に関する詳細については、CData のSAP SuccessFactors 連携ページを参照してください。30日の無償評価版をダウンロードして今すぐ使い始めましょう。