MicroStrategy Desktop でCData JDBC Driver を使ってPaylocity に接続する

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

MicroStrategy は、データ主導のイノベーションを可能にする、モビリティプラットフォームです。MicroStrategy をCData JDBC Driver for Paylocity とペアリングすると、MicroStrategy からリアルタイムPaylocity へのデータベースのようなアクセスが得られ、レポート機能と分析機能が拡張されます。この記事では、MicroStrategy Desktop にデータソースとしてPaylocity を追加し、Paylocity の簡単なヴィジュアライゼーションを作成する方法について説明します。

CData JDBC ドライバーは、ドライバーに組み込まれた最適化されたデータ処理により、MicroStrategy でリアルタイムPaylocity と対話するための比類のないパフォーマンスを提供します。MicroStrategy からPaylocity に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をPaylocity に直接プッシュし、組み込みSQL エンジンを利用して、サポートされていない操作(一般的にはSQL 関数とJOIN 操作) をクライアント側で処理します。組み込みの動的メタデータクエリを使用すると、ネイティブのMicroStrategy データタイプを使用してPaylocity を視覚化および分析できます。

MicroStrategy Desktop を使用してPaylocity データに接続および視覚化する

MicroStrategy エンタープライズ製品のPaylocity に接続するだけでなく、MicroStrategy Desktop のPaylocity に接続することもできます。以下のステップに従って、JDBC を使用してPaylocity をデータセットとして追加し、Paylocity の視覚化とレポートを作成します。

1. MicroStrategy Desktop を開き、新しいドシエを作成します。
2. データセットパネルで［New Data］をクリックし、［Databases］を選択して［Import Option］として［Select a Table］を選択します。
3. 新しいデータソースを追加し、DSN レスデータソースオプションを選択します。
4. ［Database］メニューで［Generic］を、［Version］メニューで［Generic DBMS］を選択します。
5. リンクをクリックして接続文字列を表示し、接続文字列を選択して編集します。［Driver］メニューで［MicroStrategy Cassandra ODBC Driver］を選択します。(MicroStrategy では、JDBC を介してインターフェースするために認定ドライバーが必要です。実際のドライバーは使用されません。)
6. 接続文字列を以下のように設定し、［OK］をクリックします。
   • JDBC キーワードを接続文字列に追加します。
   • MSTR_JDBC_JAR_FOLDER をJDBC ドライバーJAR ファイルのパスに設定します。(C:\Program Files\CData JDBC Driver for Paylocity\lib\ on Windows.)
   • DRIVER をドライバークラスであるcdata.jdbc.paylocity.PaylocityDriver に設定します。
   • URL をPaylocity のJDBC URL に設定し、必要な接続プロパティを設定します。

     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 ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

     java -jar cdata.jdbc.paylocity.jar

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

     JDBC URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

   以下は一般的な接続文字列です。

   JDBC;MSTR_JDBC_JAR_FOLDER=PATH\TO\JAR\;DRIVER=cdata.jdbc.paylocity.PaylocityDriver;URL={jdbc:paylocity:OAuthClientID=YourClientId;OAuthClientSecret=YourClientSecret;RSAPublicKey=YourRSAPubKey;Key=YourKey;IV=YourIV;};
7. 新しいデータソースを右クリックし、［Edit catalog］オプションを選択します。
8. SQL ステートメントをSELECT * FROM SYS_SCHEMAS に編集し、JDBC ドライバーからメタデータを読み取ります。
9. 新しいデータソースを選択し、使用可能なテーブルを表示します。テーブルを表示するには、［Available Tables］セクションの検索アイコンを手動でクリックする必要がある場合があります。
10. テーブルをペインにドラッグしてインポートします。 Noteライブ接続を作成するため、テーブル全体をインポートしてMicroStrategy 製品に固有のフィルタリングおよび集計機能を利用できます。
11. ［Finish］をクリックし、ライブに接続するオプションを選択します。CData JDBC Drivers のネイティブな高性能データ処理のおかげで、効果的なライブ接続が可能です。
12. ビジュアライゼーションと表示するフィールドを選択し、フィルタを適用してPaylocity の新しいビジュアライゼーションを作成します。データタイプは、動的メタデータ検出によって自動的に検出されます。可能な場合、フィルタと集計によって生成された複雑なクエリはPaylocity にプッシュダウンされ、サポートされていない(SQL 関数とJOIN 操作を含み得る) 操作は、ドライバーに埋め込まれているCData SQL エンジンによってクライアント側で管理されます。
13. ドシエの構成が完了したら、［File］->［Save］をクリックします。

MicroStrategy Desktop のCData JDBC Driver for Paylocity を使用すると、Paylocity で安定したビジュアライゼーションとレポートを簡単に作成できます。その他の例については、MicroStrategy Developer のPaylocity に接続 やMicroStrategy Web のPaylocity に接続 などの記事をお読みください。