Infragistics XamDataGridでUKG Pro HCM のダイナミックグリッドを作成

杉本和也
杉本和也
リードエンジニア
CData ADO.NET Provider とInfragistics XamDataGrid を使用してダイナミックグリッドを構築。



Infragistics WPF UI コントロールを使用すると、デスクトップおよびタッチデバイス用の、最新のMicrosoft Office に着想を得たアプリを構築できます。CData ADO.NET Provider for API と組み合わせると、ライブのUKG Pro HCM にアクセスして動的なグリッド、グラフその他のビジュアライゼーションを構築できます。この記事では、Infragistics XamDataGrid コントロールを使用してVisual Studio でダイナミックグリッドを作成する方法について説明します。

続行するには、Infragistics WPF UI コンポーネントをインストールしてください。こちらから無償トライアルをダウンロードできます。:https://www.infragistics.com/products/wpf

WPF プロジェクトを作成する

VisualStudio を開き、新しいWPF プロジェクトを作成します。

SQL クエリをCData ADO.NET Provider に渡すためのTextBox と、クエリを実行するためのButton を追加します。

Adding a TextBox and Button to the App.

以下は、この時点でのXAML です。


  
    
    

XamDataGrid の追加と構築

初期コントロールを追加した後、アプリにXamDataGrid を追加します。コンポーネントがVisual Studio に表示されます。

Adding the XamDataGrid to the App.

コンポーネントをデザイナーで配置して、TextBox とButton の下に配置し、アプリの境界に接するようにします。

XamDataGrid Placement.

XamDataGrid を配置したら、XAML を編集してXamDataGrid のDataSource 属性を「{Binding}」に設定し、FieldSettings のAllowRecordFiltering とAllowSummaries を「true」に設定します。次に、Button コンポーネントのClick イベントハンドラーとして空のメソッドを追加します。以下は、この時点でのXAML です。


  
    
    

UKG Pro HCM に接続してクエリする

ダイナミックDataGrid を使用してWPG App を構築するための最後のステップとして、リアルタイムUKG Pro HCM のデータに接続し、クエリを実行します。まず、CData ADO.NET Provider への参照をプロジェクトに追加します。(通常、C:\Program Files\CData\CData ADO.NET Provider for API\lib にあります。)

Adding the CData ADO.NET Provider as a Reference (Salesforce is shown.)

次に、プロバイダーを標準のData ライブラリとともに名前空間に追加します。

using System.Data.CData.API;
using System.Data;

最後に、UKG Pro HCM に接続するコードを追加し、TextBox からのテキストを使用してClick イベントハンドラーにクエリします。

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

private void Button_Click(object sender, RoutedEventArgs e)
{
  //connecting to UKG Pro HCM
  string connString = "Profile=C:\profiles\UKGProHCM.apip;AuthScheme=Basic;User=your_username;Password=your_password;ProfileSettings='Host=yourcompany.ultipro.com;CustomerAPIKey=your_customer_api_key';";
  using (var conn = new APIConnection(connString))
  {
    //using the query from the TextBox
    var dataAdapter = new APIDataAdapter(textBox.Text, conn);
    var table = new DataTable();
    dataAdapter.Fill(table);

    //passing the DataRowCollection to the DataContext
    //  for use in the XamDataGrid
    this.DataContext = table.Rows;
  }
}

アプリケーションを実行する

アプリが構築が完了したら、XamDataGrid にUKG Pro HCM のデータを表示する準備が整いました。「Execute」をクリックすると、アプリはUKG Pro HCM に接続し、CData ADO.NET Provider を介してSQL クエリを送信します。

Querying UKG Pro HCM のデータ

リアルタイムUKG Pro HCM のデータがグリッドに表示されます。

Displying UKG Pro HCM データ(Salesforce is shown)

カラム名をヘッダーにドラッグ & ドロップし、データをグループ化します。

Grouping UKG Pro HCM データ(Salesforce is shown)

グループ化とフィルタを追加すると、もとになるSQL クエリがUKG Pro HCM に直接送信されるため、リアルタイムUKG Pro HCM のデータをドリルダウンして特定の必要な情報のみを見つけることができます。

Grouped and filtered UKG Pro HCM データ(Salesforce is shown)

無償トライアルと詳細

この時点で、リアルタイムUKG Pro HCM のデータへのアクセスを持つダイナミックWPF アプリが作成されています。詳細については、CData ADO.NET プロバイダページをご覧ください。30日の無償評価版をダウンロードすれば、Infragistics UI コントロールを使用して構築したアプリでリアルタイムUKG Pro HCM のデータを今すぐ試すことができます。

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

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

UKG Pro HCM に接続