MotionBoard からUKG Pro HCM のデータに連携してダッシュボードを作成

MotionBoard は、ウイングアーク1st 社が提供する人気のBI ダッシュボードツールです。この記事ではMotionBoard で、UKG Pro HCM のデータをCData Connect を通じてシームレスに統合利用する方法を説明します。

CData Connect AI は、SaaS 型のデータ仮想化プラットフォームです。Salesforce、Dynamics、Zoho CRM、NetSuite、Marketo、kintone など150以上の多様なSaaS にBI ツール、アナリティクス、iPaaS、ノーコード開発プラットフォームからアクセスするための仮想エンドポイントを提供します。連携方法が異なるSaaS をSQL Server 、SQL Server、OData の3種類のインターフェースに仮想化することで、データ連携をシンプルに実現します。

この記事では、UKG Pro HCM のデータを仮想SQL Server エンドポイントして利用してMotionBoard からデータを取得、可視化します。

Connect AI からUKG Pro HCM に接続する

CData Connect AI では、直感的なクリック操作ベースのインターフェースを使ってデータソースに接続できます。

1. Connect AI にログインし、 Add Connection をクリックします。

2. Add Connection パネルから「UKG Pro HCM」を選択します。

3. 必要な認証プロパティを入力し、UKG Pro HCM に接続します。

   まず、Profile 接続プロパティをディスク上の UKGProHCM プロファイルの場所に設定します（例：C:\profiles\UKGProHCM.apip）。次に、ProfileSettings 接続プロパティを UKGProHCM の接続文字列に設定します（以下を参照）。

   UKGProHCM API プロファイル設定

   UKG Pro HCM では、Basic 認証とカスタマー API キーを組み合わせて API へのアクセスを認可します。接続には、UKG Pro HCM の認証情報と、UKG が発行したカスタマー API キーが必要です。

   認証するには、以下の接続プロパティを設定します。

   • AuthScheme：Basic に設定します。
   • User：UKG Pro HCM のユーザー名に設定します。
   • Password：UKG Pro HCM のパスワードに設定します。
   • ProfileSettings：以下の項目をセミコロン区切りで指定します。
     • Host：UKG Pro HCM テナントのホスト名（例：yourcompany.ultipro.com）。
     • CustomerAPIKey：UKG のカスタマー API キー。各 API 呼び出しで US-CUSTOMER-API-KEY リクエストヘッダーとして渡されます。

   カスタマー API キーの入手方法については、UKG Pro HCM の管理者にお問い合わせいただくか、UKG Developer Portal（https://developer.ukg.com）をご参照ください。

   
4. Create & Test をクリックします。

パーソナルアクセストークンの追加

MotionBoard への接続には、パスワードの代わりとしてパーソナルアクセストークンを利用します。セキュアなアクセス管理を実現するには、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. Connect AI アプリの右上にある歯車アイコンをクリックします。
2. Settings ページで「Access Tokens」タブに移動し、 Create PAT をクリックします。
3. PAT の名前を入力して Create をクリックします。

4. パーソナルアクセストークンは作成時にしか表示されないため、コピーして安全に保存してください。

MotionBoard からUKG Pro HCM のデータに接続してダッシュボードを作成

MotionBoardの「システム設定 → 接続/認証 → 外部接続」から新しい外部接続を作成します。接続先タイプはSQL Server を選択します。

• 外部接続名：任意（例：CDataConnect）
• 接続先タイプ：SQL Server
• 中継サービス：使用しない

外部接続の基本情報タブにて以下内容をセットします。

• 外部接続名：任意（例：CDataConnect）
• 接続先タイプ：SQL Server
• 接続先タイプ：SQL Server 4.0(JDBC)
• 中継サービス：使用しない
• サーバー名：tds.cdata.com
• ポート : 14333
• データベース名 : 先ほどConnect AI で作成した接続先データソース名(例：UKG Pro HCM1)
• ユーザー名 : Connect AI のユーザー名（メールアドレス）
• パスワード : パーソナルアクセストークン

基本情報エリアの最下部に「接続確認」ボタンをクリックして外部接続の確認が取れることを確認します。

「データソース」タブを開き、UKG Pro HCM 内のテーブルが一覧に表示されることを確認できます。ここまで確認できたら「保存」ボタンで外部接続定義を保存して閉じます。

「ボード新規作成」から新しいボードを作成します。

アイテムウィザードのDS1の接続先に上記の外部接続定義で作成した接続（本例では Cdata Connect）を選択します。次に、左側のデータベースにUKG Pro HCM のテーブルリストが表示されますので、使用するテーブルを選択します。右側にDealsテーブル内のデータがプレビューされます。

ウィザードを次に進み、作成するアイテムにチャートを選択して、「次へ」をクリックします。データソース エディタが起動します。左側の項目一覧から可視化したい項目を行項目・列項目・集計項目にセットします。もうRDB やCSV などのデータソースを扱う場合と同じ操作でビジュアライズを作成できます。あとは、おすすめチャートから適切なチャート種類を選択します。

まとめ

このように、CData Connect AI を経由することで、API 側の複雑な仕様を意識せずにMotionBoard でデータを可視化できます。他にも多くのデータソースに対応するCData Connect AI の詳細をこちらからご確認ください。