Paylocity のデータを（CData Connect 経由の）Tableau Desktop でビジュアライズ

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Tableau は企業がデータを使用して問題を解決する方法を変革するビジュアル分析プラットフォームです。CData Connect （またはConnect Server）と組み合わせることで、Tableau 内のリアルタイムPaylocity のデータに簡単にアクセスできます。この記事では、Paylocity の仮想MySQL データベースを作成し、Tableau でその仮想データベースに接続して、簡単なチャートを作成する方法を説明します。

Paylocity のデータの仮想MySQL データベース

CData Connect は、シンプルなポイントアンドクリックインターフェースを使用してデータソースに接続し、API を生成します。

1. Connect にログインし、「CONNECTIONS」をクリックします。
2. ［Available Data Sources］から［Paylocity］を選択します。
3. Paylocity に接続するために必要な認証プロパティを入力します。

   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 を設定することを意味します。

4. ［ Test Database］をクリックします。
5. ［Permission］->［ Add］とクリックし、適切な権限を持つ新しいユーザー(または既存のユーザー) を追加します。

仮想データベースが作成されたら、Tableau Desktop からPaylocity に接続できるようになります。

Tableau Desktop でリアルタイムPaylocity のデータをビジュアライズ

以下のステップでは、CData Connect で仮想Paylocity のデータベースに接続し、データから簡単なビジュアライゼーションを構築する方法の概要を説明します。

1. Tableau を開き、［Connect］->［To a Server］と進んだ先の［MySQL］をクリックします。
2. 接続ウィザードで、CData Connect インスタンスの値を入力し、［Sign In］をクリックします。
   • Server：Connect インスタンスのアドレス
   • Port：Connect インスタンス用のMySQL エンドポイントのポート（デフォルト：8006）
   • Database：Paylocity のデータ用に構成した仮想データベース
   • Username & Password：CData Connect ユーザーの資格情報
3. 新しく作成したデータベースと、ビジュアライズするテーブルを選択します。（必要に応じて結合されたテーブルの関係を定義します。）
4. ［Dimensions and Measures］を選択して、ビジュアライゼーションを構成します。

オンプレミスのアプリケーションからPaylocity のデータへのSQL アクセス

この時点で、Tableau Desktop ワークブックからリアルタイムPaylocity への、直接接続が有効になります。新しいビジュアライゼーションの作成やダッシュボードの構築などを行うことができます。Tableau などのデスクトップアプリケーションから、250 以上のSaaS、Big Data、NoSQL ソース（Paylocity を含む）のデータにSQL でアクセスする方法については、CData Connect ページを参照するか、無料トライアルをダウンロードしてください。