CData Connect Cloud を経由してPower BI Service でPaylocity データをリアルタイムでビジュアライズ

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

Power BI を使えば、データを美しいビジュアルに可視化したり、重要な情報を整理してダッシュボード化できます。CData Connect Cloud と組み合わせると、ビジュアライゼーションやダッシュボードでの使用のためにPaylocity データにアクセスできます。この記事では、CData Connect を使用してPaylocity のリアルタイム接続を作成し、Paylocity データをPower BI に接続してPaylocity データに関するレポートをPower BI で作成する方法を説明します。

CData Connect Cloud とは？

CData Connect Cloud は、以下のような特徴を持ったクラウド型のリアルタイムデータ連携製品です。

• SaaS やクラウドデータベースを中心とする150種類以上のデータソース
• BI、アナリティクス、ETL、ローコードツールなど30種類以上のツールやアプリケーションから利用可能
• リアルタイムのデータ接続に対応。データの複製を作る必要はありません
• ノーコードでシンプルな設定

詳しくは、こちらの製品資料をご確認ください。

Connect Cloud からPaylocity に接続する

1. Connect Cloud にログインし、 Add Connection をクリックします。
2. Add Connection パネルから「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. Create & Test をクリックします。
5. Edit Paylocity Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

接続が構成されたら、Power BI からPaylocity に接続できるようになります。

Connect Cloud Power BI コネクタをインストールする

バージョン: 2.112.603.0 (2022年12月)以降のバージョンのPower BI Desktop では、すでにCData Connect Cloud 用のMicrosoft 認定コネクタがPower BI Desktop に含まれています。Power BI Desktop で最初のデータセット設定が必要です。従来まではPower BI Desktop からデータソースの更新毎にデータセットを手動でパブリッシュもしくはオンプレミスGateway での定期リフレッシュが必要でした。今回のPower BI 提供のCData Connect 向けコネクタでは、一度Power BI Desktop からデータセットをパブリッシュした後のデータ更新はPower BI サービス（クラウド）上で実施できる点がポイントです！　では、「データを取得」から「オンラインサービス」カテゴリを選び、「CData Connect Cloud」を選択します。

それより前のPower BI Desktop をご利用の場合には、CData Connect Cloud Power BI コネクタ をダウンロードしインストールします。インストールが完了すると、CData Connect Cloud を経由してPower BI のデータに接続できるようになります。

Paylocity テーブルをクエリ

以下のステップに従って、Paylocity データをレポートにプルするクエリを作成します。

「Power BI Desktop」を開いて「Get Data」->「Online Services」->「CData Connect Cloud」と進み、「Connect」をクリックします。 「Sign-in」をクリックしCData Connect Cloud のアカウントで認証します。
1. サインイン後「Connect」をクリックします。
2. 「Navigator」ダイアログでテーブルを選択します。
3. 「Load」をクリックしPower BI からPaylocity データの接続を確立します。

Paylocity データをビジュアライゼーションを作成する

Power BI にデータを接続した後、「Fields」ペインのフィールドをキャンバスにドラッグすることで、「Report」ビューでデータビジュアライゼーションを作成できます。チャートタイプと、ビジュアライズするディメンションとメジャーを選択します。

Power BI サービス（クラウド）から最新のPaylocity データに更新

ここからが2022年12月以降の認定コネクタの最大のキモになります。発行したPower BI サービスで使用できるPaylocity データを使ったレポートのデータをPower BI 側から最新のデータに更新が可能です。まずは右上のメニュー から「データセットの表示」をクリックします。

まずは、データソースであるCData Connect Cloud にアクセスする資格を設定する必要がありますので、「ファイル」→「設定」をクリックします。レポートで使用しているデータセットをワークスペースから選択し、「データソースの資格情報」を開き、「資格情報を編集」の文字をクリックします。

クリックすると再度CData Connect Cloud へのサインインを求められます。

1. 認証方法：OAuth2 を選択
2. このデータソースのプライバシーレベルの設定：適切なレベルを設定

「サインイン」ボタンをクリックして、CData Connect Cloud のユーザー名とパスワードでサインインします。

これで、Power BI サービスからConnect Cloud 経由でPaylocity データソースを最新の状態に更新することができます。「更新」→「今すぐ更新」をクリックするとデータを更新できます。このように簡単にPower BI サービス（クラウド）側から外部データソースであるPaylocity のデータをリアルタイムで更新して分析利用することができました。

データアプリケーションからPaylocity データへのリアルタイムアクセス

CData Connect Cloud を使用してPower BI からPaylocity データへの直接接続ができるようになりました。これで、Paylocity を複製せずにより多くのデータをインポート、新しいビジュアライゼーションやレポートを作成することができます。

オンプレミスのBI やレポート、ETL、その他のデータアプリケーションから、250を超えるSaaS、ビッグデータ、NoSQL ソース（Paylocity を含む）への直接のSQL データアクセスを取得するには、CData Connect ページにアクセスして無償トライアルを開始できます。