SAS でCData ODBC Driver for Paylocity を使用

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

SAS は、高度なアナリティクス、多変量解析、BI、データ管理、予測分析のためのソフトウェアです。SAS とCData ODBC Driver for Paylocity を合わせて使うことで、SAS からリアルタイムPaylocity データへデータベースライクにアクセスできるようになり、レポーティング、分析能力を向上できます。本記事では、SAS でPaylocity のライブラリを作成し、リアルタイムPaylocity に基づいたシンプルなレポートを作成します。

CData ODBC ドライバーは、ドライバーに組み込まれた最適化されたデータ処理により、SAS でリアルタイムPaylocity データを送受信する場合に圧倒的なパフォーマンスを提供します。SAS からPaylocity に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をPaylocity に直接プッシュし、組み込みSQL エンジンを利用して、サポートされていない操作（一般的にはSQL 関数とJOIN 操作）をクライアント側で処理します。組み込みの動的メタデータクエリを使用すると、SAS でPaylocity を簡単にビジュアライズおよび分析できます。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

1. Paylocity をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
2. 多様なアプリケーション、ツールにPaylocity データを連携
3. ノーコードでの手軽な接続設定
4. 標準 SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてPaylocity の接続を設定、2.SAS 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとPaylocity への接続設定

まずは、本記事右側のサイドバーからPaylocity ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

以下は、Paylocity に接続するための情報と、Windows およびLinux 環境でDSN を構成するためのステップです。

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

DSN を構成する際に、Max Rows プロパティを定めることも可能です。これによって返される行数を制限するため、ビジュアライゼーション・レポートのデザイン時のパフォーマンスを向上させるのに役立ちます。

Windows

未指定の場合は、初めにODBC DSN（data source name）で接続プロパティを指定します。ドライバーのインストールの最後にアドミニストレーターが開きます。Microsoft ODBC Data Source Administrator を使用して、ODBC DSN を作成および構成できます。

Linux

Linux 環境にCData ODBC Driver for Paylocity をインストールする場合、ドライバーのインストールによりシステムDSN が事前定義されます。システムデータソースファイル(/etc/odbc.ini) を編集し、必要な接続プロパティを定義することで、DSN を変更できます。

/etc/odbc.ini

これらの構成ファイルの使用に関する具体的な情報については、ヘルプドキュメントを参照してください。

SAS でPaylocity ライブラリを作成

CData ODBC Driver for Paylocity に基づくライブラリを追加することで、SAS でPaylocity に接続します。

1. SAS を開き、［Explorer］ペインで［Libraries］を展開します。
2. ［Active Libraries］ウィンドウで右クリックし、［New］を選択します。
3. ライブラリに名前を付け（odbclib）、Engine としてODBC を選択し、ライブラリをセッション間で保持する場合は［Enable at startup］をクリックします。
4. Data Source を以前構成したDSN に設定し、［OK］をクリックします。

Paylocity クエリからビューを作成

SAS は、ローコードのポイントアンドクリッククエリツールを使用するか、PROC SQL とカスタムSQL クエリのプログラムを使うことで、データのクエリをネイティブにサポートします。SAS でビューを作成すると、ビューがクエリされるたびに定義クエリが実行されます。これは、レポート、チャート、分析について常にリアルタイムPaylocity データにクエリを実行することを意味します。

クエリツールの使用

1. SAS で［Tools］->［Query］と進みます。
2. データをプルするテーブルソースとテーブルを選択し、［OK］をクリックします。
3. カラムを選択し、右クリックしてフィルタリング、順序付け、グループ化などを追加します。
4. ［SQL Query Tool］ウィンドウを右クリックして［Show Query］を選択し、［Create View］をクリックして、クエリの結果を含むローカルビューを作成します。ビューに名前を付け、［OK］ をクリックします。

PROC SQL の使用

1. SAS で、［Editor］ウィンドウに移動します。
2. PROC SQL を使用してデータをクエリし、ローカルビューを作成します。
   Note：このステップにより、［Work］ライブラリにビューが作成されます。オプションとして、create view ステートメントでライブラリを指定できます。

   proc sql;
     create view employee_view as
     select 
       firstname, 
       lastname 
     from 
       odbclib.employee 
     where 
       EmployeeId = '1234';
   quit;
   

3. ［Run］->［Submit］とクリックしてクエリを実行し、ローカルビューを作成します。

SAS のPaylocity データに関するレポートまたはビジュアライズ

ローカルビューを作成すると、パワフルなSAS 機能を使用してPaylocity データをレポート、ビジュアライズ、またはその他の方法で分析できます。PROC PRINT を使用して簡単なレポートを印刷し、PROC GCHART を使用してデータに基づいた基本的なグラフを作成しましょう。

HTML を印刷

1. SAS で、［Editor］ウィンドウに移動します。
2. PROC PRINT を使用してPaylocity Employee データのHTML レポートを印刷します。

   proc print data=employee;
     title "Paylocity Employee Data";
   run;
   

チャートを印刷

1. SAS で、［Editor］ウィンドウに移動します。
2. PROC GCHART を使用してEmployee データのチャートを作成します。

   proc gchart data=employee;
     pie firstname / sumvar=lastname
         value=arrow
         percent=arrow
         noheading
         percent=inside plabel=(height=12pt)
         slice=inside value=none
         name='EmployeeChart';
   run;
   

Paylocity からSAS へのデータ連携には、ぜひCData ODBC ドライバをご利用ください

このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。

CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。