Informatica Cloud で Paylocity のデータ を連携

Informatica Cloud は、クラウド上で抽出、変換、ロード（ETL）タスクを実行できるツールです。Cloud Secure Agent と CData JDBC Driver for Paylocity を組み合わせることで、Informatica Cloud から直接 Paylocity のデータ にリアルタイムでアクセスできます。本記事では、Cloud Secure Agent のダウンロードと登録、JDBC ドライバーを介した Paylocity への接続、そして Informatica Cloud のプロセスで使用可能なマッピングの作成方法をご紹介します。

Informatica Cloud Secure Agent

JDBC ドライバー経由で Paylocity のデータ に接続するには、Cloud Secure Agent をインストールします。

1. Informatica Cloud の Administrator ページに移動します
2. Runtime Environments タブを選択します
3. 「Download Secure Agent」をクリックします
4. Install Token をメモしておきます
5. クライアントマシンでインストーラを実行し、ユーザー名と Install Token を使って Cloud Secure Agent を登録します

NOTE: Cloud Secure Agent のすべてのサービスが起動するまでに、しばらく時間がかかる場合があります。

Paylocity JDBC Driver への接続

Cloud Secure Agent のインストールと起動が完了したら、JDBC ドライバーを介して Paylocity に接続する準備が整いました。

Secure Agent マシンへの JDBC ドライバーの追加

1. Secure Agent マシンの以下のディレクトリに移動します：

   %Secure Agent installation directory%/ext/connectors/thirdparty/

2. 設定するマッピングの種類に応じて、フォルダを作成しドライバーの JAR ファイル（cdata.jdbc.paylocity.jar）を追加します。

   マッピングの場合は、以下のフォルダを作成してドライバーの JAR ファイルを追加します：

   informatica.jdbc_v2/common

   アドバンスドモードのマッピングの場合は、以下のフォルダも作成してドライバーの JAR ファイルを追加します：

   informatica.jdbc_v2/spark

3. Secure Agent を再起動します。

Informatica Cloud での Paylocity への接続

• Connection Name: 接続に名前を付けます（例：CData Paylocity Connection）
• Type:「JDBC_V2」を選択します
• Runtime Environment: Secure Agent をインストールしたランタイム環境を選択します
• JDBC Driver Class Name: JDBC ドライバークラス名を入力します：cdata.jdbc.paylocity.PaylocityDriver
• JDBC Connection URL: Paylocity の JDBC URL を設定します。URL は以下のようになります：
  
  

  jdbc:paylocity:OAuthClientID=YourClientId;OAuthClientSecret=YourClientSecret;RSAPublicKey=YourRSAPubKey;Key=YourKey;IV=YourIV;

  Paylocity への接続を確立するには以下を設定します。

  • RSAPublicKey：Paylocity アカウントでRSA 暗号化が有効になっている場合は、Paylocity に関連付けられたRSA キーを設定。

    このプロパティは、Insert およびUpdate ステートメントを実行するために必須です。この機能が無効になっている場合は必須ではありません。

  • UseSandbox：サンドボックスアカウントを使用する場合はTrue に設定。
  • CustomFieldsCategory：Customfields カテゴリに設定。これは、IncludeCustomFields がtrue に設定されている場合は必須です。デフォルト値はPayrollAndHR です。
  • Key：Paylocity の公開鍵で暗号化されたAES 共通鍵（base 64 エンコード）。これはコンテンツを暗号化するためのキーです。

    Paylocity は、RSA 復号化を使用してAES 鍵を復号化します。
    これはオプションのプロパティで、IV の値が指定されていない場合、ドライバーは内部でキーを生成します。

  • IV：コンテンツを暗号化するときに使用するAES IV（base 64 エンコード）。これはオプションのプロパティで、Key の値が指定されていない場合、ドライバーは内部でIV を生成します。

  OAuth

  OAuth を使用してPaylocity で認証する必要があります。OAuth では認証するユーザーにブラウザでPaylocity との通信を要求します。詳しくは、ヘルプドキュメントのOAuth セクションを参照してください。

  Pay Entry API

  Pay Entry API はPaylocity API の他の部分と完全に分離されています。個別のクライアントID とシークレットを使用し、アカウントへのアクセスを許可するにはPaylocity から明示的にリクエストする必要があります。 Pay Entry API を使用すると、個々の従業員の給与情報を自動的に送信できます。 Pay Entry API によって提供されるものの性質が非常に限られているため、CData では個別のスキーマを提供しないことを選択しましたが、UsePayEntryAPI 接続プロパティを介して有効にできます。

  UsePayEntryAPI をtrue に設定する場合は、CreatePayEntryImportBatch、MergePayEntryImportBatch、Input_TimeEntry、およびOAuth ストアドプロシージャのみ利用できることに注意してください。 製品のその他の機能を使用しようとするとエラーが発生します。また、OAuthAccessToken を個別に保存する必要があります。これは、この接続プロパティを使用するときに異なるOAuthSettingsLocation を設定することを意味します。

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

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

      java -jar cdata.jdbc.paylocity.jar
      

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

  
• Username: プレースホルダー値を設定します（Paylocity はユーザー名を必要としないため）
• Password: プレースホルダー値を設定します（Paylocity はパスワードを必要としないため）

Paylocity のデータ のマッピングを作成

Paylocity への接続を設定したら、Informatica の任意のプロセスで Paylocity のデータ にアクセスできます。以下の手順では、Paylocity から別のデータターゲットへのマッピングを作成する方法を説明します。

1. Data Integration ページに移動します
2. New.. をクリックし、Mappings タブから Mapping を選択します
3. Source Object をクリックし、Source タブで Connection を選択し、Source Type を設定します
4. 「Select」をクリックして、マッピングするテーブルを選択します
5. Fields タブで、マッピングする Paylocity テーブルのフィールドを選択します
6. Target オブジェクトをクリックし、Target ソース、テーブル、フィールドを設定します。Field Mapping タブで、ソースフィールドをターゲットフィールドにマッピングします。

マッピングの設定が完了すると、Informatica Cloud でサポートされている任意の接続先と Paylocity のデータ のリアルタイム連携を開始できます。CData JDBC Driver for Paylocity の30日間無償トライアルをダウンロードして、Informatica Cloud で Paylocity のデータ の活用を今すぐ始めましょう。