編集グリッド

[編集グリッド] コントロールでは、表形式レコードのリスト表示、編集、ページネーション、検索が可能です。

全般

• データ ソース - グリッド内で編集するデータのソースです。Data Service エンティティや Orchestrator プロセスなどの AppsDataSource 型のオブジェクトを参照する必要があります。

  データ ソースを取得すると、グリッドはデータ列を自動的に検出します。各列の [その他] アイコンをクリックすると、次のプロパティに移動します。

  • 名前 - 列ヘッダーの表示名です。

  • ソース - 参照されるエンティティのフィールドです。

  • 編集モード ビュー - 列の操作方法を決定します。

    [編集モード ビュー] オプション	説明
    テキストボックス	列内のセルは [テキストボックス] コントロールとして機能します。
    日付の選択	列内のセルは [日付の選択] コントロールとして機能します。
    チェックボックス	列内のセルは [チェックボックス] コントロールとして機能します。
    ドロップダウン	列内のセルは [ドロップダウン] コントロールとして機能します。
    複数選択	列内のセルは [複数選択ドロップダウン] コントロールとして機能します。

  • 非表示 - true の場合、実行時に列が非表示になります。

  • 編集可能 - false の場合、列の内容を読み取り専用としてマークします。

• 新しい列を追加 - プラス記号「+」アイコンをクリックして、データに新しい列を追加します。

• 非表示 - true の場合、実行時にコントロールが非表示になります。

• 編集可能 - false の場合、コントロールを読み取り専用としてマークします。

• 行を追加 - true の場合、アプリ ユーザーが実行時に新しい行を追加できます。false の場合、ユーザーは新しい行を追加できません。

• 行を削除 - true の場合、アプリ ユーザーに行の削除を許可します。false の場合、ユーザーは行を削除できません。

• 検索 - オンの場合、組み込みの検索機能が表示されます。

イベント

• 選択した行 - 行を選択したときの動作を設定します。

• 行を追加 - 行が追加された際の挙動を設定します。

• 行を修正 - 行が修正された際の挙動を設定します。

• 行を削除 時 - 行が削除された際の挙動を設定します。

注:

更新、追加、または編集操作のエラーを表示するには、次の構文を使用します。

<PageName>.<ControlName>.<RuleName>.Error.Message

たとえば、MainPage.EmployeeDetailsGrid.UpdateEntityRecord.Error.Message です。

スタイル

• コントロールの配置 - 既定では、親の配置を継承します。親とは異なる配置を設定することもできます。既定の親の配置に戻すには、現在優先されているオプションの選択を解除します。

  注: 配置は、親に対して選択したレイアウト ([縦方向]/[横方向]) によって異なります。

• 背景色 - [グリッド ヘッダー] と [グリッド本体] の背景色です。

• 枠線 - コントロールの枠線です。枠線の太さ、色、半径を設定できます。

• フォント - 列のヘッダーと列の本文のテキスト両方のフォント属性 (フォント ファミリ、サイズ、色、スタイル (太字、斜体、下線) など) です。既定では、このコントロールの直接の親コンテナーのフォント ファミリが継承されます。その場合、フォントに「Inherited」と表示されます。

• マージン - コントロールのマージンです。既定では 4px のマージンが設定されています。[上/下] および [左/右] のプロパティがそれぞれ組み合わされています。これらのプロパティの組み合わせは、[マージン] セクションの右側にある [リンク] ボタンをクリックして解除できます。

• サイズ - コントロールの幅と高さです。既定では、サイズは [auto] に設定されています。最小値または最大値を設定するには、3 点リーダー メニューのアイコン (...) をクリックします。コントロールのサイズがオプションよりも小さい場合は、スクロール バーが表示されます。

VB のプロパティ

• SelectedItem (T) - アプリ ユーザーによって現在選択されている項目を参照します。

• DataSource (ListSource of T) - コントロールで利用可能なデータを参照します。

• NewItem (T) - [行を追加] オプションによって作成される項目を参照します。[行を追加] 済みのイベントで使用されます。

• Hidden (Boolean) - コントロールの [非表示] プロパティを参照します。

• 編集可能 (Boolean) - コントロールの [編集可能] プロパティを参照します。

• 行を追加 (Boolean) - コントロールの [行を追加] プロパティを参照します。

• 行を削除 (Boolean) - コントロールの [行を削除] プロパティを参照します。

• 検索 (Boolean) - コントロールの [検索] プロパティを参照します。

• RowIndex (Integer) - 更新操作や削除操作の対象となる列内の項目を参照します。

重要:

このプロパティは、データセット全体がメモリ内にあるプロセスの連携に使用します。

[編集グリッド] コントロールを持つエンティティを使用する

以下の例は、エンティティを [編集グリッド] コントロールにバインドし、コントロールとエンティティ固有のルールを使用して CRUD 操作を実行する方法を示しています。

使用されるエンティティは "Employee" と呼ばれ、以下のフィールドがあります。

• 名前

• 年齢

• dateOfBirth

• Gender

• チーム (Team)

• Date of Joining

• IsFullTime

• スキル

エンティティ レコードを表示する

1. 新しい VB アプリを作成し、Employee エンティティをアプリに追加します。
2. [編集グリッド] コントロールをアプリに追加します。
3. [編集グリッド] コントロールの [データ ソース] フィールドで、[クエリ ビルダー] を使用して Employee エンティティを選択します。コントロールの列に、エンティティのフィールドが自動的に入力されます。
4. すべての列で、[編集モード ビュー] ドロップダウンが以下のように正しいデータ型に設定されていることを確認します。

   オプション	説明
   dateOfBirth	日付の選択
   年齢	テキストボックス
   名前	テキストボックス
   Gender	ドロップダウン
   チーム (Team)	ドロップダウン
   Date of Joining	日付の選択
   IsFullTime	チェックボックス
   スキル	複数選択

   Gender と Team は、エンティティのチョイス セットです。これらの列に対して [編集モード ビュー] で [ドロップダウン] を選択すると、[リストのソース] と [列] の 2 つの新しいプロパティが表示されます。
5. チョイス セットのオプションを取得するには、以下の手順を実行します。
   1. [リストのソース] フィールドでは、以下の構文を使用します。

      GetChoiceSet("Choiceset Name")

      たとえば、Gender 列と Team 列の場合、[リストのソース] フィールドで以下の構文が指定されている必要があります。

      • Gender - GetChoiceSet("Gender")

      • Team - GetChoiceSet("Team")

   2. [列] フィールドに「"Name"」を書き込みます。
      

   スキルは、複数選択が可能なエンティティのチョイス セットです。これらの列に対して [編集モード ビュー] で [複数選択] を選択すると、[リストのソース] と [列] の 2 つの新しいプロパティが表示されます。

6. Gender や Team の場合と同様に Skills 列を設定します。
7. [編集グリッド] コントロールの [イベント] タブに移動します。
8. [行を追加] 済みのイベントに対して、次のルールを作成します。
   1. [エンティティ レコードを作成] ルールを追加します。
   2. [レコードを作成するエンティティを選択します。] で、Employee エンティティを選択します。
   3. [設定する値] フィールドで、以下を更新します。

      • Name プロパティ - MainPage.EditGrid.NewItem.Name

      • Date of Joining プロパティ - MainPage.EditGrid.NewItem.Dateofjoining

      • Age プロパティ - MainPage.EditGrid.NewItem.Age

      • Gender プロパティ - MainPage.EditGrid.NewItem.Gender

      • Team プロパティ - MainPage.EditGrid.NewItem.Team

      • IsFullTime プロパティ - MainPage.EditGrid.NewItem.Isfulltime

      • Skills プロパティ - MainPage.EditGrid.NewItem.Skills

9. [行を修正] イベントに対して、次のルールを作成します。
   1. [エンティティ レコードを更新] ルールを追加します。
   2. [レコードを更新するエンティティを選択します。] で、Employee エンティティを選択します。
   3. [エンティティ レコード ID] に、以下の式を書き込みます。

      MainPage.EditGrid.SelectedItem.Id

   4. [設定する値] フィールドで、以下を更新します。

      • Name プロパティ - MainPage.EditGrid.SelectedItem.Name

      • Date of Joining プロパティ - MainPage.EditGrid.SelectedItem.Dateofjoining

      • Age プロパティ - MainPage.EditGrid.SelectedItem.Age

      • Gender プロパティ - MainPage.EditGrid.SelectedItem.Gender

      • Team プロパティ - MainPage.EditGrid.SelectedItem.Team

      • IsFullTime プロパティ - MainPage.EditGrid.SelectedItem.Isfulltime

      • Skills プロパティ - MainPage.EditGrid.SelectedItem.Skills

10. [行を削除] イベントに対して、次のルールを作成します。
    1. [エンティティ レコードを削除] ルールを追加します。
    2. [削除するエンティティ レコードを選択] で [Employee] エンティティを選択します。
    3. [エンティティ レコード ID] に、以下の式を書き込みます。

       MainPage.EditGrid.SelectedItem.Id

11. アプリをプレビューして、[編集グリッド] のさまざまな機能 (ページネーション、検索、新しい行の追加、行の更新、行の削除など) を使用できます。

[編集グリッド] コントロール内のリレーションシップの使用

[編集グリッド] コントロールで Relationship 型のエンティティ フィールドを使用するには、以下の手順を実行します。

1. [編集モード ビュー] フィールドで、リレーションシップ フィールドを [ドロップダウン] として設定します。
2. 後続の [リストのソース] プロパティで、以下の式を使用します。

   Fetch(of <entity_name>)(Nothing, Nothing, Nothing, Nothing, New ExpansionFieldOption(){addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})

3. 後続の [列] プロパティで、"Name" を書き込みます。
4. エンティティ関連のルール (例: [エンティティ レコードを作成]、[エンティティ レコードを更新]、[エンティティ レコードを削除]) では、リレーションシップ フィールドの ID を以下のように渡します。

   MainPage.EditGrid.SelectedItem.<entity_name>.Id

複雑なデータを AppsDataSource に変換する

データ テーブルまたは複雑なデータ型を AppsDataSource に変換するには、データ テーブルを変数に保存してから、.ToListSource メソッドを使用してデータをデータ テーブルから AppsDataSource に変換します。

1. データを DataTable 型の変数に保存します。たとえば、変数に「dt」という名前を付けます。
2. [表] コントロールの [データ ソース] フィールドで、以下の式を使用します。

   dt.ToListSource()

一般的に、複雑なオブジェクトは以下の構文を使用して AppsDataSource に変換できます。

Processes.ALLDATATYPES.out_datatable.ToListSource()