SnapLogic を使用して UKG Pro WFM を外部サービスと連携
SnapLogic は、ノーコードでデータ連携フローを作成できる iPaaS（Integration Platform as a Service）です。CData JDBC Driver と組み合わせることで、UKG Pro WFM を含む250を超える SaaS、ビッグデータ、NoSQL ソースのリアルタイムデータに SnapLogic ワークフローからアクセスできます。
CData JDBC Driver は、最適化されたデータ処理機能を内蔵しており、リアルタイム UKG Pro WFM のデータ とのやり取りにおいて比類ないパフォーマンスを発揮します。外部ツールから複雑な SQL クエリが発行されると、ドライバーはフィルタや集計などのサポートされている SQL 操作を UKG Pro WFM に直接プッシュし、サポートされていない操作（多くの場合、SQL 関数や JOIN 操作）は内蔵の SQL エンジンを使用してクライアント側で処理します。動的なメタデータクエリ機能により、ネイティブデータ型を使用して UKG Pro WFM のデータ を操作できます。
SnapLogic から UKG Pro WFM に接続
SnapLogic から UKG Pro WFM のデータ に接続するには、CData UKG Pro WFM JDBC Driver をダウンロードしてインストールします。インストールウィザードに従って進めてください。インストールが完了すると、JAR ファイルはインストールディレクトリ（デフォルトでは C:/Program Files/CData/CData API Driver for JDBC/lib）に配置されます。
UKG Pro WFM JDBC Driver のアップロード
インストール後、Manager タブから SnapLogic 内の場所（例：projects/Jerod Johnson）に JDBC JAR ファイルをアップロードします。
接続の設定
JDBC Driver をアップロードしたら、UKG Pro WFM への接続を作成します。
- Designer タブに移動します
- Snaps から「JDBC」を展開し、「Generic JDBC - Select」snap をデザイナーにドラッグします
- Add Account をクリック（または既存のアカウントを選択）し、「Continue」をクリックします
- 次のフォームで、JDBC 接続プロパティを設定します：
- JDBC JARs に、先ほどアップロードした JAR ファイルを追加します
- JDBC Driver Class を cdata.jdbc.api.APIDriver に設定します
JDBC URL を UKG Pro WFM JDBC Driver の JDBC 接続文字列に設定します。例：
jdbc:api:Profile=C:\profiles\UKGProWFM.apip;AuthScheme=OAuthPassword;ProfileSettings='Host=yourcompany.mykronos.com;User=your_username;Password=your_password;';OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;RTK=XXXXXX;
注意：RTK はトライアルキーまたは製品キーです。詳細についてはサポートチームまでお問い合わせください。
組み込みの接続文字列デザイナー
JDBC URL の構築には、UKG Pro WFM JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
java -jar cdata.jdbc.api.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
まず、Profile 接続プロパティをディスク上の UKGProWFM プロファイルの場所に設定します（例：C:\profiles\UKGProWFM.apip）。次に、ProfileSettings 接続プロパティを UKGProWFM の接続文字列に設定します（以下を参照）。
UKGProWFM API プロファイル設定
UKG Pro Workforce Management では、OAuth 2.0 の Resource Owner Password Credentials グラント（grant_type=password）を使用して API へのアクセスを認可します。一般的な OAuth ベースのプロファイルとは異なり、ブラウザでのリダイレクトや認可コードのステップはありません。ドライバーが UKG Pro WFM のユーザー名、パスワード、クライアント ID、クライアントシークレットを使って、直接アクセストークンを取得します。
認証するには、以下の接続プロパティを設定します。
- AuthScheme：OAuthPassword に設定します。
- Host：UKG Pro Workforce Management のデータセンター/テナントのホスト名に設定します（例：yourcompany.mykronos.com）。プロトコル（https://）や末尾のスラッシュは含めないでください。
- OAuthClientId：UKG Pro Workforce Management の OAuth アプリケーションに発行されたクライアント ID に設定します。
- OAuthClientSecret：UKG Pro Workforce Management の OAuth アプリケーションに発行されたクライアントシークレットに設定します。
- User：UKG Pro Workforce Management のユーザー名に設定します。
- Password：UKG Pro Workforce Management のパスワードに設定します。
アクセストークンは https://{Host}/api/authentication/access_token から取得します。UKG Pro Workforce Management が発行するリフレッシュトークンの有効期限は7日間です。リフレッシュトークン自体の期限切れによってトークンの更新に失敗した場合、ドライバーは User/Password の認証情報で再認証し、新しいアクセストークンを取得する必要があります。
- 接続プロパティを入力したら、「Validate」をクリックし、「Apply」をクリックします
UKG Pro WFM のデータ の読み取り
接続の検証と適用後に開くフォームで、クエリを設定します。
- Schema name を「API」に設定します
- Table name を UKG Pro WFM のテーブルに設定します。スキーマ名を使用して、例：「API」.「Employees」（ドロップダウンで利用可能なテーブルの一覧を確認できます）
- テーブルから使用する各項目の Output fields を追加します
Generic JDBC - Select snap を保存します。
接続とクエリを設定したら、snap の末尾をクリックしてデータをプレビューします（下図でハイライト表示）。
結果が期待通りであることを確認したら、追加の snap を使用して UKG Pro WFM のデータ を別のエンドポイントに送信できます。
UKG Pro WFM のデータ を外部サービスにパイプ
この記事では、データを Google スプレッドシートに読み込みます。サポートされている任意の snap を使用するか、別の CData JDBC Driver と Generic JDBC snap を使用して、外部サービスにデータを移動できます。
- 「Worksheet Writer」snap を「Generic JDBC - Select」snap の末尾にドロップします。
- Google Sheets に接続するためのアカウントを追加します
- Worksheet Writer snap を設定して、UKG Pro WFM のデータ を Google スプレッドシートに書き込みます
これで、完全に設定されたパイプラインを実行して、UKG Pro WFM からデータを抽出し、Google スプレッドシートにプッシュできます。
詳細情報と無料トライアル
CData API Driver for JDBC を使用することで、SnapLogic で UKG Pro WFM のデータ を外部サービスと連携するパイプラインを作成できます。UKG Pro WFM への接続の詳細については、CData API Driver for JDBC ページをご覧ください。CData API Driver for JDBC の30日間無料トライアルをダウンロードして、今すぐお試しください。