各製品の資料を入手。
詳細はこちら →Paylocity Driver の30日間無償トライアルをダウンロード
30日間の無償トライアルへ製品の詳細
Paylocity JDBC Driver
相談したい
Paylocity のAccounts、Envelopes、Folders データに連携するJava アプリケーションを素早く、簡単に開発できる便利なドライバー。
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for Paylocity は、ColdFusion のrapid development tools を使ってPaylocity への接続をシームレスに統合します。この記事では、ColdFusion でPaylocity に連携しPaylocity テーブルをクエリする方法を説明します。
下記の手順に従ってPaylocity データソースを作成し、ColdFusion アプリケーションへの連携を可能にします。
ドライバーのJAR および.lic ファイルを、インストールディレクトリから C:\ColdFusion10\cfusion\wwwroot\WEB-INF\lib にコピーします。
ドライバーのJAR およびlicense はインストールディレクトリの［lib］サブフォルダに配置されています。
ドライバーをデータソースとして追加：
ColdFusion Administrator インターフェースで［Data & Services］ノードを展開し、［Data Sources］>［Add New Data Source］をクリックします。ダイアログが表示されたら、以下のプロパティを入力します。
JDBC Driver のプロパティ設定:
JDBC URL：JDBC URL に接続プロパティを入力。JDBC のURL は以下で始まり jdbc:paylocity: 次に、セミコロン区切りでname=value ペアの接続プロパティを入力します。以下は一般的なJDBC URL です：
jdbc:paylocity:OAuthClientID=YourClientId;OAuthClientSecret=YourClientSecret;RSAPublicKey=YourRSAPubKey;Key=YourKey;IV=YourIV;
Paylocity への接続を確立するには以下を設定します。
このプロパティは、Insert およびUpdate ステートメントを実行するために必須です。この機能が無効になっている場合は必須ではありません。
Paylocity は、RSA 復号化を使用してAES 鍵を復号化します。
これはオプションのプロパティで、IV の値が指定されていない場合、ドライバーは内部でキーを生成します。
OAuth を使用してPaylocity で認証する必要があります。OAuth では認証するユーザーにブラウザでPaylocity との通信を要求します。詳しくは、ヘルプドキュメントのOAuth セクションを参照してください。
Pay Entry API はPaylocity API の他の部分と完全に分離されています。個別のクライアントID とシークレットを使用し、アカウントへのアクセスを許可するにはPaylocity から明示的にリクエストする必要があります。 Pay Entry API を使用すると、個々の従業員の給与情報を自動的に送信できます。 Pay Entry API によって提供されるものの性質が非常に限られているため、CData では個別のスキーマを提供しないことを選択しましたが、UsePayEntryAPI 接続プロパティを介して有効にできます。
UsePayEntryAPI をtrue に設定する場合は、CreatePayEntryImportBatch、MergePayEntryImportBatch、Input_TimeEntry、およびOAuth ストアドプロシージャのみ利用できることに注意してください。 製品のその他の機能を使用しようとするとエラーが発生します。また、OAuthAccessToken を個別に保存する必要があります。これは、この接続プロパティを使用するときに異なるOAuthSettingsLocation を設定することを意味します。
［Actions］ カラムのCData Paylocity データソースを有効にして、接続をテストできます。ステータスがOK になったら、Paylocity データソースを使うことができます。
下記の手順に従って、Paylocity の基準に合ったレコードをクエリし、結果をHTML テーブルに出力する簡単なアプリケーションを作成します。
新規ColdFusion markup ファイルでクエリを定義：C:\ColdFusion10\cfusion\wwwroot directory for ColdFusion の.cfm ファイルに次のコードを入力：
<cfquery name="PaylocityQuery" dataSource="CDataPaylocity">
SELECT * FROM Employee
</cfquery>
Note：CData JDBC Drivers は、cfqueryparam エレメントを使ってパラメータ化されたクエリもサポートします。例：
<cfquery name="PaylocityQuery" dataSource="CDataPaylocity">
SELECT * FROM Employee WHERE EmployeeId = <cfqueryparam>1234</cfqueryparam>
</cfquery>
CFTable を使ってHTML にテーブルを出力：
<cftable
query = "PaylocityQuery"
border = "1"
colHeaders
colSpacing = "2"
headerLines = "2"
HTMLTable
maxRows = "500"
startRow = "1"/>
<cfcol header="<b>FirstName</b>" align="Left" width=9 text="#FirstName#"></cfcol>
<cfcol header="<b>LastName</b>" align="Left" width=8 text="#LastName#"></cfcol>
</cftable>
コードを実行してグリッドを表示します。
HTML 部分を含む以下のフルコードが利用できます。
<html>
<head><title>Hello World</title></head>
<body>
<cfoutput>#ucase("hello world")#</cfoutput>
<cfquery name="PaylocityQuery" dataSource="CDataPaylocity">
SELECT * FROM Employee
</cfquery>
<cftable
query = "PaylocityQuery"
border = "1"
colHeaders
colSpacing = "2"
headerLines = "2"
HTMLTable
maxRows = "500"
startRow = "1">
<cfcol header="<b>FirstName</b>" align="Left" width=9 text="#FirstName#"></cfcol>
<cfcol header="<b>LastName</b>" align="Left" width=8 text="#LastName#"></cfcol>
</cftable>
</body>
</html>
