RPA AutoMate でPaylocity のデータを連携利用

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

AutoMate はHelpSystems 社が提供するRPA ツールです。700項目の自動化機能と15種類の自動実行トリガーが選択可能であるためあらゆるシーンを自動化することが可能です。

また、データベースにODBC経由で接続できるアクションが含まれており、CData ODBC Driverと組み合わせることでCData が対応しているさまざまなデータソースとノーコードで連携ができるようになります。

この記事では、AutoMate と CData ODBC ドライバを使って、Paylocity に連携するタスクを作成します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持った製品です。

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

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

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

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

1. まずODBC DSN に必要な接続プロパティの値を入力します。 組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。 これは、ドライバのインストール時の最後のステップでも可能です。 Microsoft ODBC データソースアドミニストレータを使用して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 を設定することを意味します。

2. 入力後、接続テストが成功すれば設定は完了です。

AutoMate でタスクを作成する

それでは AutoMate でタスクを作成していきましょう。

1. タスク アドミニストレーターを起動し新規タスクを作成します。
2. 任意のタスク名を入力して、次へ進みます。
3. トリガーを追加し、タスクビルダーを起動します。「タスクビルダーを開始する」をクリックします。

AutoMate でPaylocity へのDB 接続を構成

続いて AutoMate でODBC への接続構成を行います。

1. ODBC 接続は「データベース」のアクションを使って構成していきます。
2. まずは接続を確立します。「SQL 接続を開く」アクションをドラッグアンドドロップで配置しましょう。
3. プロパティの「接続」で接続設定をします。「接続の構築」をクリックします。
4. 接続するプロバイダーを選択します。「Microsoft OLE DB Provider for ODBC Drivers」を選択します。
5. データソースを指定します。接続設定は完了です。

Paylocity のデータをAutoMate で扱う

接続セッションの構成が完了したら、実際にデータを読み取るアクションを設定しましょう。

1. SQL クエリでデータを取得するため「SQL クエリ」アクションを配置します。
2. 「SQL クエリ」アクション では「SQL ステートメント」に対してSQL を入力して、データを取得することができます。
3. 取得したデータを後続ステップで利用するため、データセットを作成します。
4. CSV に出力して取得データを確認します。

作成したタスクの動作を確認する

それでは作成したタスクを実際に動かしてみましょう。

1. タスクは画面上にある「実行」で手動実行が可能です。
2. 処理の完了は画面下の出力から確認できます。
3. 指定したCSV ファイルを開きます。正常にPaylocity のデータを元にしたCSV ファイルが生成されていました。