シーオーリポーツ 帳票クリエータでUKG Pro HCM のデータを利用した帳票を作成
シーオーリポーツ 帳票クリエータは株式会社エイチ・オー・エスが提供する帳票作成ツールです。GUI ベースで各種データソースと紐付いた帳票を作成することが可能です。
この記事では、シーオーリポーツ 帳票クリエータとCData ODBC ドライバを使って、シーオーリポーツ 帳票クリエータでUKG Pro HCM のデータを利用した帳票を作成する方法を紹介します。
CData ODBC ドライバとは?
CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。
- UKG Pro HCM をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
- 多様なアプリケーション、ツールにUKG Pro HCM のデータを連携
- ノーコードでの手軽な接続設定
- 標準 SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてUKG Pro HCM の接続を設定、2.シーオーリポーツ側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとUKG Pro HCM への接続設定
まずは、本記事右側のサイドバーからAPI ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
- ODBC DSN に必要な接続プロパティの値を入力します。 組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。 これは、ドライバのインストールじの最後のステップでも可能です。 Microsoft ODBC データソースアドミニストレータを使用してDSN を作成および設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。
まず、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)をご参照ください。
- 入力後、接続テストが成功すれば設定は完了です。
フォームの作成
最初にデータをマッピングするためのベースとなるフォームを作成します。
- まず、帳票クリエータ フォームエディタを立ち上げます。
- 今回は単純に一覧を表示する帳票を作成するので、右ナビゲーションからリストフィールドをフォーム上に配置します。
- 以下のようにフォームを作成後、保存を実行し、任意のフォルダにフォームを保存します。
マッピングの作成
次に帳票クリエータ マッピングツールを使って、事前に作成したフォームにUKG Pro HCM のデータをマッピングします。
- 帳票クリエータ マッピングツールを立ち上げます。
- マッピングツールの左上のリボンから「新規作成」をクリックします。
- 設定ファイル新規作成ウィザードが開始されるので、各種情報を任意の値で入力し、「参照」ボタンから先ほどのフォームを指定します。
- 次に任意の出力設定を入力し「完了」をクリックします。
- 「引き続き、レコードセットの編集を行いますか?」というダイアログが表示されるので「はい」をクリックします。
- このダイアログでCData ODBC ドライバからのデータ取得設定を行っていきます。「新しいデータソースでレコードセットを作成する」の中から「データベース」を選択し、「次へ」をクリックすると
- データ取得実行時のSQL とODBC Datasource に接続するための各種プロパティ入力画面が表示されるので、下記のとおり入力を行います。
- 以下のような形で入力できればOKです。「次へ」をクリックします。
- この画面で先ほど入力したSQL を元にしたデータ取得結果のプレビューを確認できます。内容を確認し、問題がなければ「次へ」をクリックします。
- 以上でレコードセットの作成が完了します。
- 作成完了後、右ナビゲーションに作成されたレコードセットのカラム一覧が表示されます。
- それでは実際に各カラムをマッピングしていきたいと思います。なお、フォームで事前に作成していたリストはそのままだと各セルが独立してしまっているため、一覧表示を行う仕様になっていません。事前に対象のリストを選択し「明細リストに設定」を実行しておきましょう。
- 以下のように、「上から下」の明細リストとして設定します。
- 明細リストとして設定すると、各行に対してレコードセットをマッピングすることができるようになります。ドラッグアンドドロップで、レコードセットから各カラムを紐づけます。
- これでフォームとデータセットのマッピングが完了です。
プレビュー
それでは実際にどのように表示されるかプレビューを実行してみます。
- リボンから「プレビュー」をクリックします。
- 以下のようにプレビュー画面に切り替わり、UKG Pro HCM からデータが取得できていることが確認できました。
おわりに
このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをシーオーリポーツからコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。
CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。