データ グリッド

このチュートリアルでは、データ グリッド コンポーネントを作成および使用する方法をステップ バイ ステップで説明します。データをデータ グリッドに渡してリアルタイム更新し、情報を抽出する方法を学びます。このチュートリアルでは、データ グリッドへのデータ入力に CSV ファイルを使用します。

このオートメーションでは、学生の名前と試験結果の CSV レコードを使用してフォームに表示し、試験結果とそれに対応するステータス (「合格」または「不合格」) をリアルタイムで更新することができます。また、オートメーションでは、レコードの抽出とコンソールへの出力をトリガーできます。

1. 新しいフォームを作成します。この例では、GataGrid という名前を付けます。

   1. フォーム内にデータ グリッド コンポーネントを追加します。

   2. フォームに渡す CSV ファイルの各列に対応するコンポーネントを追加します。

      この例では、 テキスト フィールド (fullName)、 チェックボックス (seniorYear)、 ドロップダウン リスト (examResults) を追加します。

      

      注:

      コンポーネント のプロパティ名 では大文字と小文字が区別されるため、CSV ファイルの列名およびデータ テーブルの列名と正確に一致する必要があります。

   3. さらに、データ グリッド内に [Status] という名前のテキスト フィールドを追加します。これはフォームの更新に使用されます。

   4. データ グリッドの外にボタンを追加します。このボタンは、データ グリッドの抽出をトリガーします。

      

2. Main ワークフローに以下のアクティビティを追加し設定します。

   1. CSV を読み込み - データ グリッド用のデータを含む CSV ファイルを入力します。出力の CSV ファイルを格納する DataTable 型変数を作成します。

      この例では、dataGridDataTable という名前を付けます。

   2. フォームに戻り、データ グリッド コンポーネント のプロパティ名 を、サブステップ a で作成した DataTable 型変数として設定し、出力 CSV ファイルを保存します。この例では、[ プロパティ名 ] を「 dataGridDataTableに設定します。

   3. フォームを表示 - DataGrid フォームを選択し、データ テーブルからデータ グリッドにデータを渡します。

   4. Arguments ディクショナリで、dataGrid 引数に System.Data.DataTable 型と方向 (In) のエントリを追加し、値を dataGridDataTableに設定します。

      キー	入力	方向	値 (Value)
      dataGrid (データ グリッドのプロパティ名)	System.Data.DataTable	In	dataGridTable

   5. ローカル トリガーを実行 - プロジェクト内のすべてのトリガーを有効化します。

3. FieldChangedTrigger という名前のトリガー ワークフローを作成します。このワークフローは、学生のステータスを試験結果に従って「合格」または「不合格」に設定します。

   1. [フォーム トリガー アクティビティ]を追加し、[examResults] フィールドが変更されたときのイベントを設定します。

   2. [データ テーブルを構築] アクティビティを追加して、トリガーの起動時に DataGrid の値が保存されるデータ テーブルを作成します。

      出力変数に editedDataTable という名前を付けます。

   3. [ フォームの値を取得 ] アクティビティを追加して、サブステップ b ( [editedDataTable]) で作成したデータ テーブルにデータ グリッドを取得します。

   4. 各試験結果を反復処理するために [ 繰り返し (各行 )] アクティビティを追加し、それに応じて [ Status ] フィールドを設定します。サブステップ b (editedDataTableで作成したデータテーブルを [ データ テーブル ] フィールドに入力します。

   5. [繰り返し (各行)] アクティビティの本体に [条件分岐 (if)] アクティビティを追加し、条件を CurrentRow("examResults").ToString="f"に設定します。

      値では大文字と小文字が区別されることに注意してください。これが、条件内で大文字の「F」ではなく小文字の「f」を使用した理由です。

      

   6. [Then] の本体に [代入] アクティビティを追加して、試験結果が F の場合に生徒のステータスを「不合格」として割り当てます。

      保存先	保存する値
      CurrentRow("status")	"failed"

   7. [Else] の本体に [代入] アクティビティを再度追加します。試験結果が F でない場合は学生のステータスが「合格」となるようにするためです。

      保存先	保存する値
      CurrentRow("status")	"passed"

   8. [繰り返し (各行)] アクティビティの外に [フォームの値を設定] アクティビティを追加して、更新したデータ グリッドをフォームに渡します。[ キー ] フィールドで、 dataGrid を [種類] System.Data.DataTable とともに使用し、値を editedDataTableに設定します。

      キー	入力	値 (Value)
      dataGrid	System.Data.DataTable	editedDataTable

4. extract clicked という名前のトリガー ワークフローを作成します。このワークフローはデータ グリッドを抽出し、String として CSV 形式で出力します。

   1. [フォーム トリガー アクティビティ]を追加し、[extract] ボタンがクリックされるときのイベントを設定します。

   2. [ フォームの値を取得 ] アクティビティを追加し、データ グリッドをデータ テーブルに抽出します。Arguments ディクショナリに Type System.Data.DataTable の dataGrid のエントリを追加し、[値] を outputに設定します。

      dataGrid	System.Data.DataTable	output

   3. [ データ テーブルを出力 ] アクティビティを追加し、抽出したデータ グリッドを CSV 形式の文字列として出力します。[データ テーブル] フィールドに、サブステップ b でデータ グリッドの抽出に使用した変数 (output) を入力します。出力コンソールにログインする String 型変数を [テキスト] フィールドに入力します

   4. [メッセージをログ] アクティビティを追加して、抽出したデータ グリッドを出力します。

   5. [ローカル トリガーを停止] アクティビティを追加してフォームを閉じ、実行を停止します (抽出後にフォームを操作しない場合)。

   以下の図は、フォームが表示されているときにデータを更新するとどうなるかを示しています。

   

ワークフローの例

この手順に従ってチュートリアルをご自身で試してみるには、こちらのサンプル ワークフローをご覧ください。