SSIS を使ってUKG Pro HCM のデータをSQL Server にインポート
SQL Server に基幹業務データのバックアップを保管しておくことは、ビジネス上のセーフティネットとなります。また、ユーザーはSQL Server のバックアップデータからレポーティングや分析を簡単に行うことができます。
ここでは、SQL サーバー SSIS ワークフロー内でCData SSIS Tasks for API を使用して、UKG Pro HCM のデータをMicrosoft SQL Server データベースに転送する方法を説明します。
Components の追加
開始するには、新しいUKG Pro HCM ソースとSQL Server ADO.NET 転送先を新しいデータフロータスクに追加します。
新しいコネクションマネジャーを作成
以下のステップに従って、接続マネジャーでUKG Pro HCM 接続プロパティを保存します。
- Connection Manager ウィンドウで、右クリックで［New Connection］ を選択します。Add SSIS Connection Manager ダイアログが表示されます。
- ［Connection Manager type］メニューでAPI を選択します。CData UKG Pro HCM Connection Manager が表示されます。
- 接続プロパティを構成します。
まず、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 Source の構成
以下のステップに従って、UKG Pro HCM の抽出に使用するクエリを指定します。
- UKG Pro HCM ソースをダブルクリックしてソースコンポーネントエディタを開きます。
- ［Connection Manager］メニューで、以前作成した接続マネジャーを選択します。
- データの書き出しに使用するクエリを指定します。例：
SELECT UserId, UserName FROM UserDetails WHERE UserStatus = 'A'
- UKG Pro HCM Source コントロールを閉じて、ADO.NET Destination に接続します。
SQL Server Destination を構成する
以下のステップに従って、UKG Pro HCM をロードするSQL サーバーテーブルを指定します。
- ADO.NET Destination を選択して、新しい接続を追加します。接続するサーバーおよびデータベースの情報を入力。
- Data access モードメニューで、［table or view］を選択します。
- ［Table Or View］メニューで、設定するテーブルまたはビューを選択します。
- ［Mappings］画面で必要なプロパティを設定します。
プロジェクトの実行
プロジェクトを実行できるようになりました。SSIS Task の実行が完了すると、データベースにUKG Pro HCM のデータが入力されます。
