RAD Studio Data Explorer で UKG Pro WFM のデータ を表示

Embarcadero RAD Studio は、Delphi および C++Builder アプリケーション用の開発環境を提供します。CData ODBC ドライバ for UKG Pro WFM を使用すると、RAD Studio 内からリアルタイムUKG Pro WFM のデータにアクセスでき、データをテーブル、ビュー、ストアドプロシージャとして抽象化してUKG Pro WFM のデータの取得が可能です。この記事では、Data Explorer を使用して UKG Pro WFM に接続する方法を説明します。

UKG Pro WFM への接続を設定

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して、ODBC DSN を作成・設定できます。

まず、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 の認証情報で再認証し、新しいアクセストークンを取得する必要があります。

Data Explorer を使用して UKG Pro WFM のデータ に接続

CData FireDAC Components for UKG Pro WFM と新しい VCL フォームアプリケーションを利用して、UKG Pro WFM のデータ を表示するシンプルなアプリケーションを作成できます。

1. RAD Studio で Data Explorer を開き、FireDAC を展開します。
2. Data Explorer で ODBC Data Source ノードを右クリックします。
3. ［新しい接続の追加］ をクリックします。
4. 接続の名前を入力します。
5. 表示される FireDAC Connection Editor で、DataSource プロパティに UKG Pro WFM 用 ODBC DSN の名前を設定します。
6. Data Explorer に戻り、この接続のビューを展開します。

7. 新しい VCL フォームアプリケーションを作成し、ビュー（例: Employees）をフォームにドラッグします。

   
8. フォーム上の EmployeesView オブジェクトを選択し、Active プロパティを true に設定します。

9. オブジェクトを右クリックし、［ビジュアルにバインド］ を選択して、すべて（*）を新しいコントロール（TStringGrid）にリンクします。

   

10. TStringGrid をフォームに配置し、アプリケーションを実行して Employees データを確認します。

    

関連記事

RAD Studio、Delphi、C++ Builder で CData ODBC ドライバを使用するその他の記事は以下をご覧ください。

• C++Builder で UKG Pro WFM のデータ にコントロールをデータバインド
• Delphi で UKG Pro WFM のデータ にコントロールをデータバインド
• UKG Pro WFM のデータ 用のシンプルな VCL アプリケーションを構築