データ グリッド

このチュートリアルでは、データ グリッド コンポーネントを作成および使用する方法をステップ バイ ステップで説明します。データをデータ グリッドに渡してリアルタイム更新し、情報を抽出する方法を学びます。このチュートリアルでは、データ グリッドへのデータ入力に 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 ディクショナリに、型が System.Data.DataTable で方向が In の引数 dataGrid のエントリを追加し、値を 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. [繰り返し (各行)] アクティビティの外に [フォームの値を設定] アクティビティを追加します。このアクティビティは、更新されたデータ グリッドをフォームに返します。[キー] フィールドで、[型] が System.Data.DataTable の dataGrid を使用し、値を editedDataTable に設定します。

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

4. extract clicked という名前のトリガー ワークフローを作成します。このワークフローはデータ グリッドを抽出し、String として CSV 形式で出力します。
   1. [フォーム トリガー アクティビティ]を追加し、[extract] ボタンがクリックされるときのイベントを設定します。
   2. データ グリッドをデータ テーブルに抽出するために、[フォームの値を取得] アクティビティを追加します。[型] が System.Data.DataTable の dataGrid に対するエントリを Arguments ディクショナリに追加し、[値] を output に設定します。

      dataGrid	System.Data.DataTable	output

   3. 抽出した データ グリッドを文字列として CSV 形式で出力する [データ テーブルを出力] アクティビティを追加します。[データ テーブル] フィールドに、サブステップ b でデータ グリッドを抽出するために使用した変数 (output) を入力します。[テキスト] フィールドに、[出力] コンソールにログ記録する String 型変数を入力します。
   4. [メッセージをログ] アクティビティを追加して、抽出したデータ グリッドを出力します。
   5. [ローカル トリガーを停止] アクティビティを追加してフォームを閉じ、実行を停止します (抽出後にフォームを操作しない場合)。

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

ワークフローの例

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