UKG Pro HCM のデータをBoard に連携してビジュアライズを作成

古川えりか
古川えりか
コンテンツスペシャリスト
UKG Pro HCM をBI ツールのBoard にデータ接続して、データソースとする方法。



CData ODBC Driver for API は、ODBC 標準に準拠しており、BI ツールからIDE まで幅広いアプリケーションでUKG Pro HCM への接続を提供します。 この記事では、CPM/BIツールのBoardからUKG Pro HCM に接続、レポートを作成する方法を説明します。

CData ODBC ドライバとは？

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

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

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

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

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

  1. インストール後、ODBCデータソースアドミニストレーターにて［システムDSN］タブをクリックし、CData UKG Pro HCM Source Sys（64bit or 32bit）の接続情報を構成します。（※BoardはシステムDSNのみに対応しています。ユーザーDSNの場合接続できませんので、ご注意ください。）

  2. まず、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）をご参照ください。

    3. Board

Board DB の作成

最初にBoardの接続情報やキューブ等を格納するDBを作成します。

  1. Boardを立ち上げて、任意の接続先へ接続します。
    2. Board
  2. ［Database］タブから［New DB］をクリックします。
    3. Board
  3. 開いたDB作成用ウィンドウにて、任意の［Database name］［Language］［From Year］［To Year］を入力し［OK］をクリックします。
    4. Board

SQL FastTrackを用いたODBCデータソースからのデータロード

次にSQL FastTrackの機能を用いてODBCデータソースから UKG Pro HCM のデータをBoard上にロードします。

  1. ［Database］タブの［SQL FastTrack］をクリックし、Data souceの［New］ボタンをクリックします。
    2. Board
  2. 接続先を設定するためのウィンドウが表示されますので、［OLE-DB Wizard］をクリックします。
    3. Board
  3. 開いたデータリンクプロパティの［プロバイダー］タブから［Microsoft OLE DB Provider for ODBC Drivers］を選択し、［次へ］をクリックします。
    4. Board
  4. ［接続タブ］の［1.データソースを指定します］から事前に設定したODBC DSNを選択し、［3.使用する初期カタログを入力します］に［CData］を入力の上、［OK］をクリックします。
    5. Board
  5. 任意の［Name］を入力し［Save & Connect］をクリックします。
    6. Board
  6. SQL FastTrackの画面に戻った後、［Connect］をクリックします。
    7. Board
  7. Connectをクリック後、Data souce画面左側に UKG Pro HCM のテーブル一覧が表示されます。分析対象とするテーブルをダブルクリックすると、自動的にSQL クエリが記述されます。記述内容を確認の上、［Execute Query］をクリックします。
    8. Board
  8. Execute Queryをクリックすると、テーブルに格納された項目一覧が以下の図のように表示されます。分析で使用したい任意の項目を［Code］［Desc］［Cube］のいずれかにチェックを入れ、Cube/Entityを入力し、Track実行ボタンをクリックします。
    9. Board
  9. 確認ダイアログが表示されますので、［Yes］をクリックします。
    10. Board
  10. SQL FastTrackの機能により、ODBC データソースからデータがロードされ、自動的にEntityとCubeが生成されます。
    11. Board
  11. 以下のダイアログが表示されれば、Boardへのデータロードは完了です。
    12. Board

グラフの作成

ロードしたデータを元に簡単なグラフの作成方法を紹介します。

  1. 最初に各種Screenを格納するためのCapsuleを作成します。［Home］タブを選択し［Capsule］から［New Capsule］をクリックします。
    2. raccoon
  2. 任意の［Capsule Name］を入力し［OK］をクリックします。
    3. raccoon
  3. 続いてScreenを作成するための画面が表示されるため任意の［Screen Name］を入力し［OK］をクリックします。
    4. raccoon
  4. Screenが作成されると、ChartやDataViewを配置することが可能になります。［Charts］から［Chart］を選択し、Screenにドラッグ・アンド・ドロップでChartを配置します。
    5. raccoon
  5. 以下のようにChartを配置後、右クリックメニューで［Layout］をクリックします。
    6. raccoon
  6. LayoutでChart上のValueとして扱う値を指定します。［Data］タブから［Double-click here to create a block］の箇所をダブルクリックします。
    7. raccoon
  7. ［Data Selection］から先程のSQL FastTrackにてCubeの指定をした任意の値を選択し［OK］をクリックします。
    8. raccoon
  8. 続いて［Axes］タブをクリックし、先程指定した値の分析軸とするBy Rowに任意の項目を選択し［OK］をクリックします。
    9. raccoon
  9. 設定完了後、以下のようにグラフが表示されます。
    10. raccoon

このようにAPI 内のデータをAPI を書くことなくBoard上で利用することができるようになります。

はじめる準備はできましたか？

API Driver で UKG Pro HCM のライブデータに接続

UKG Pro HCM に接続

この記事の内容

関連記事