サブグリッド

SubGridコンポーネントは、指定された関係を通じて親レコードに関連するDataverseレコードを表示します。RecordContextの中に配置されなければならず、どの関係を使うかを指定するRelationshipNameパラメータが必要です。

関係の種類

SubGridは1対多(1:N)と多対多(N:N)の関係の両方をサポートしています。コンポーネントは自動的に関係タイプを検出し、それに応じて動作を調整します。

• 1:Nの関係の場合、グリッドは親レコードを参照する関連テーブルのレコードを表示します。NewRecordGridButton、OpenRecordGridButton、DeleteRecordGridButtonなどのツールバーボタンは、関連するレコードの作成、編集、削除に使われます。
• N:Nの関係の場合、グリッドは関連するレコードを表示します。LinkExistingRecordGridButtonやUnlinkExistingRecordGridButtonのようなツールバーボタンは、レコードの関連付けや解除に使われます。作成および削除操作は自動的にアソシエイトおよび解除リクエストに変換されます。

見解

ViewIdsを使ってビューセレクターのドロップダウンで利用可能なビューを指定し、DefaultViewIdで最初に選択したビューを設定します。どちらも提供されていなければ、グリッドは関連するテーブルのすべての公開ビューを自動的に読み込みます。また、CustomViewDefinitionsにインラインのFetchXMLを提供し、コード内で直接ビューを定義することもできます。

ツールバーボタン

Buttonsレンダリングフラグメントを使ってグリッドツールバーにボタンを追加してください。ダイアログの位置付け、ウィザードフォーム、セーブ動作などの詳細な設定オプションについては、グリッドボタンのドキュメントをご覧ください。以下の内蔵ボタンが利用可能です:

• NewRecordGridButton — ダイアログフォームを開き、新しい関連レコード(1:N)を作成する
• OpenRecordGridButton — 選択したレコードを編集するためのダイアログフォームを開く
• DeleteRecordGridButton — 選択されたレコードを削除する
• LinkExistingRecordGridButton — N:N関係で既存レコードを関連付ける
• UnlinkExistingRecordGridButton — N:N関係から選択されたレコードを分離する
• NavigateNewRecordGridButton — URLに移動して新しいレコードを作成する
• NavigateOpenRecordGridButton — 選択したレコードを編集するためにURLへナビゲート

インライン編集

AllowEdit="true"設定トグルを有効にして、ユーザーがインライン編集モードに切り替えられるようにしてください。有効化すると、編集可能な列はグリッド上で直接フォームコントロールとして描画されます。インライン編集は1:Nの関係にのみ対応しています。

ページングと検索

グリッドはページサイズを設定可能なページナビゲーション DefaultItemsPerPage と PageSizesをサポートしています。検索はデフォルトで有効で、 AllowSearch="false"で無効化可能です。