インテリジェントオートメーションRPA、Blue Prism でUKG Pro HCM のデータを連携利用

Blue Prism は2001年にイギリスで創業したBlue Prism 社が提供するエンタープライズ企業向けのロボティック・プロセス・オートメーション（RPA）ツールです。

大きな特徴は「プロセス」と「オブジェクト」という概念で自動化処理を構成していくところが挙げられるでしょう。あらかじめ各種アプリケーションを操作する手続き、振る舞いをオブジェクトとして定義することで、再利用性を高め、全体の開発生産性を向上させています。

このオブジェクトはVBO という名前で各種テンプレート、プリセットが公開されており、初心者でもさまざまなアプリケーションやローカルファイル、サービスなどに接続することが可能になっています。

そんなVBO の中にはODBC 経由でデータベースに接続できるものも提供されており、CData ODBC ドライバと組み合わせることで、CData が対応しているさまざまなデータソースと手軽に連携ができるようになります。

今回の記事ではこのODBC 用のVBO とCData ODBC ドライバを使って、Blue Prism から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.Blue Prism 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

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

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

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


2. 入力後、接続テストが成功すれば設定は完了です。

ODBC 用の VBO を追加する

続いて、ODBC 用のVBO をBlue Prism に追加しましょう。

1. こちらのURLから「Connector for ODBC Utility Blue Prism」が入手できます。

2. 「BPA+Object+-+Data+-+ODBC+v1.0.xml」というXMLファイルがダウンロードできるので、Blue Prism を立ち上げてオブジェクトとしてインポートしましょう。

3. 対象のファイルを選択し「次へ」進みます。

4. インポートが完了すると、以下のようにオブジェクト一覧に「Data - ODBC」が追加されます。

5. これを使って、CData ODBC ドライバへ Blue Prism から簡単に接続できるようになります。

新しいプロセスを作成する

それでは早速自動化のプロセスを作成していきましょう。

1. 「新しいプロセスまたはビジネスオブジェクト」から「プロセス」を選択して、次へ進みます。

2. 任意のプロセス名を入力します。

3. 必要に応じてプロセスの説明を指定して、「終了」をクリックしましょう。

4. これで以下のように初期化されたプロセスが立ち上がります。

ODBC Open 処理を追加する

ODBC の接続処理は以下の3つのプロセスで実施します。実際にデータの操作を実行するのは真ん中の部分ですが、前後の処理が必要になるという点に注意してフローを組みましょう。

• コネクションを確立するためのOpen 処理
• SQL やINSERT 文などを実行するExecute（ExecuteNonQuery）処理
• コネクションを終了するためのClose 処理

まずは「コネクションを確立するためのOpen 処理」を追加します。

1. 「アクション」を画面に配置して設定画面を開きます。

2. ビジネスオブジェクトの一覧から先ほどインポートした「Data - ODBC」を選択しアクションの一覧で「Open」を選択しましょう。
   「Open」アクションは入力パラメータとして「Connection String」を必要とします。ここで先ほど設定したCData ODBC ドライバのDSN 名を「"DSN=CData UKG Pro HCM Source"」といった形式で指定します。

ODBC 経由でデータを取得する処理を追加する

続いてUKG Pro HCM からデータを取得する処理を追加していきましょう。

1. 先ほどと同じように「アクション」を追加し

2. ビジネスオブジェクトの一覧から「Data - ODBC」を選択、アクションの一覧で「Execute」を選択しましょう。Execute ではSQL を指定して、データを取得することができます。

3. なお、SELECT Statement で利用するテーブルやカラムの情報はODBC DSN の「テーブル」タブから確認できます。

4. また、Blue Prism 上で取得した結果を扱えるように、処理結果を変数に格納します。出力タブにある「Results」の変数アイコンをクリックして、出力先の変数を生成し「OK」をクリックしましょう。

ODBC のクローズ処理を追加する

最後にODBC の処理を終了して、接続を開放するためにクローズ処理を追加します。

1. 同じようにアクションを配置し

2. ビジネスオブジェクトの一覧から「Data - ODBC」、アクションの一覧で「Close」を選択しましょう。Close では特に設定するパラメータはありません。

3. 最後にリンクを繋いで、以下のようなプロセスができ上がります。

Excel に保存する処理を追加する

これだけではデータを取得して何も行わないので、Excel ファイルに書き込みを行ってみましょう。「Excel VBO」を使って、後続のフローを作成します。

1. 以下のようなフローで作成しています。

2. 「MS Excel VBO::Write Collection」のアクションで入力パラメータの「Collection」にODBC 経由で取得した「Results」を書き込んでいます。

動作確認

プロセスが完了したら「実行」ボタンをクリックして、実際に動かしてみましょう。

1. 画面左上の実行ボタンをクリックします。

2. 最終的に以下のようなExcel ファイルに書き込みが完了していればOK です。

このようにCData ODBC Driver for API とBlue Prism を組み合わせることで、簡単にUKG Pro HCM のデータを活用したフローを作成することができました。ぜひ、30日の無償評価版 をお試しください。