フォームのサブグリッド プロパティにアクセスして構成する

このトピックは、Dynamics 365 Customer Engagement (on-premises) に適用されます。 このトピックの Power Apps バージョンについては、以下を参照してください。 モデル駆動型アプリのメイン フォーム用サブグリッドのプロパティの概要

レコードまたはグラフの一覧を表示するフォーム上のサブグリッドを構成することができます。 一覧ではなくグラフを表示するには、ディスプレイタブのグラフのみを示しますを選択します。

ソリューション エクスプローラーで、サブグリッドのプロパティにアクセスすることができます。 コンポーネントエンティティを展開してから、目的のエンティティを展開してフォームを選択します。 フォームの一覧で、種類がメインのフォームを開きます。 次に、挿入タブで、サブグリッドを選択してサブグリッドのプロパティを表示します。

サブグリッドのプロパティ。

Tab キー プロパティ 内容
表示方法 件名 必須: スクリプト内でサブグリッドが参照されたとき使用される一意の名前。 名前には、英数字とアンダースコアのみを使用できます。
ラベル 必須: ユーザーに表示されるサブグリッドのローカライズ可能なラベル。
フォームでラベルを表示する ラベルをフォームに表示するかどうか。 これは検索ボックスを表示するを有効した場合に必要です。 また、パネル ヘッダーに色を付けることを選択可能です。
レコード 2 種類のオプションから選択します。

- 関連レコードのみ: サブグリッドには、現在のレコードに関連していたレコードのみが表示されます。
- すべてのレコードの種類: サブグリッドでは、既定のビューでフィルター処理されたレコードを表示します。または、ビュー セレクターが有効になっている場合は、ユーザーが選択するビューを表示します。

選択したオプションは、リストの表示コントロールの動作に影響します。 詳細情報: リストの表示動作
エンティティ レコードに選んだオプションによって、次のいずれかのビューを表示します。

- 関連レコードのみ: かっこ内の関連付けを定義するエンティティの検索フィールドの名前を持つ、このエンティティに関連するエンティティの一覧を示します。
- すべてのレコードの種類: すべてのエンティティの一覧。
既定のビュー 既定で適用されるビューを選択します。 セレクターを参照プロパティを使用して、他のビューを何も有効にしない場合。 これは唯一のビューです。

編集ボタンを使用して、既定ビューを編集のために開きます。 新規ボタンを使用して、このサブグリッドに使用する新しいビューを作成します。
検索ボックスを表示する 検索ボックスを表示します。 このオプションを選択するとフォームでラベルを表示するのオプションが必要です。
表示インデックス 従来のフォーム を使用するフォームのみが表示インデックスをサポートします。

リストでアルファベット順のインデックスを使用可能にする場合は、このチェック ボックスをオンにします。 これにより、特定の文字または数字で始まるレコードにジャンプできます。
ビュー セレクター 次の 3 つのオプションがあります。

- オフ: 既定ビューのみを使用できます。
- すべてのビューを表示: ユーザーがビューを選択できます。
- 選択されたビューを表示: カーソルと Ctrl キーを使用して、表示する使用可能なビューを選択します。
既定のグラフ グラフのみ表示するが選択されている場合、表示するグラフを選択します。
グラフのみ表示する レコードのリストではなく、グラフが表示されます。
グラフの選択項目を表示する グラフのみ表示するが選択されている場合、ユーザーはさまざまなグラフを選択できます。
使用可否 電話でセクションを使用可能かどうか指定します。
形式 レイアウト コントロールが使用する列数を指定してください

サブグリッドを含むセクションに複数の列があるとき、フィールドがセクションにある列の数まで占めるように設定できます。
行数 サブグリッド ページに表示されるレコード数を決定します。
空き領域を使用する 注: このプロパティは、従来の Web クライアントでのみ機能します。 これによる統一インターフェイスへの影響はありません。

自動拡張して、使用可能なスペースを広げます が選択されている場合、フォームは 2 つのレコード分のスペースを許可し、レコード数が増えるにつれスペースを拡張します。 数字が レコード数 を超えると、ユーザーは他のページに移動して、レコードを表示できます。

自動拡張して、使用可能なスペースを広げる が選択されていない場合、フォームは 行数 によって定義されたレコード数分のスペースを提供し、ユーザーは追加のページに移動して、そのほかのレコードを表示できます。
コントロール コントロール コントロールの追加を選択して、Web、電話またはタブレット PC に用いるラジオ ボタンを選択します。

従来のフォーム を使用するフォームでは、サブグリッド上で実行される操作はリボンで使用することができます。 開発者は、これらのアクションの動作をカスタマイズするか、またはリボンをカスタマイズして追加のアクションを追加できます。

更新されたフォーム を使用するフォームでは、サブグリッドの操作はサブグリッドの近くに置かれているためアクセスが容易です。 ただし、コマンド バーにはユーザー定義アクションを追加でません。 開発者はリボンを編集して残りの 3 種類のアクション (一覧を表示、レコードを追加、削除) を変更できます。

リストの表示動作

更新されたフォーム でフォームの一覧を表示する場合、各サブグリッドには右上隅に ビューを開く ボタン ビューを開く ボタン。 が表示されます。エンティティもフォーム エディターのナビゲーション領域に含まれるエンティティの 1 つとして表示されます。 このボタンを選択すると、ビューが開きます。 動作は、レコードプロパティに選択したオプションに応じて異なります。

関連レコードのみを選択すると、ビューが同じウィンドウで関連ビューの 1 つを使用して開きます。 フォームに戻るには、[戻る] ボタンを使用するかナビゲーション バーの現在のレコードのプライマリ名の値を選択します。

すべてのレコードの種類を選択すると、ビューは新しいウィンドウで開かれます。

レコードの動作を追加する

更新されたフォーム を使用するフォームにリストを表示するとき、各サブグリッドの右上隅にレコードの追加 ボタン 追加ボタン。 が表示されます。 このボタンを選択すると、レコードを追加することができます。 この動作は、レコードプロパティに選択したオプションによって、また検索が活動レコードであるかどうかによって異なります。

関連レコードのみを選択すると、既定で、既存のレコードを追加します。 既存レコードを検索するインライン検索がまず表示されます。 これにより、重複レコードを作成することを防げます。 既存レコードが見つからない場合は、新規のオプションを選択できます。 新しいレコードを作成すると、関連付けで定義されるフィールドのマッピングが適用されます。 詳細情報: エンティティ フィールドのマップ

すべてのレコードの種類を選択すると、既定で、新しいレコードを追加します。 簡易作成フォームがターゲット エンティティにある場合、それが表示されます。 ない場合、既定のエンティティのメイン フォームが表示されます。

サブグリッドに活動が表示される場合、ユーザーはまず活動の種類を選択する必要があり、それから"新規レコードを追加する"動作が表示されます。

レコードの削除動作

サブグリッド内でレコードを選択するときは、行の右側に削除ボタン サブリストの削除アイコン。 が表示されます。 この削除アクションの動作は、現在のエンティティとの関連付けの種類によって異なります。

サブグリッドが 1:N (1 対多数) の関連付けを使用する場合、一般的なレコードの削除動作とは、レコードを削除する前に確認ダイアログを示すことです。

サブグリッドがN:N (多対多) の関連付けを使用すると、2 種類のレコードに関係する関連付け (または交差) エンティティのレコードは確認なしで削除され、レコードはそのサブグリッドでは表示されなくなります。 しかし、表示されていたレコードは削除されません。

関連項目

メイン フォームとそのコンポーネントの使用