ManyToManyLookup編集

ManyToManyLookupEditコンポーネントは、Dataverseレコード間の多対多(N:N)関係を管理するためのインライン自動補完エディタを提供します。現在関連付けられたレコードをチップとして表示し、ユーザーはフォームから離れることなく関連付けを検索・追加・削除できます。

仕組み

コンポーネントを RecordContext に入れ、 RelationshipNameを指定します。このコンポーネントは関連するテーブルを自動的に解決し、関連するレコードを読み込み、新しい関連付けを追加するための検索可能なオートコンプリートドロップダウンを提供します。

React

Blazor

見解

関連レコードの検索に利用可能なビューを ViewIds と DefaultViewId で制御してください。ビューの列はドロップダウンに表示され、ユーザーが正しいレコードを特定できるようになっています。ビューが指定されていない場合は、関連テーブルのデフォルトの公開ビューが使用されます。

React

Blazor

検証

関連レコード数に制約を設けるために、 MinimumNumberOfItems と MaximumNumberOfItems を活用してください。最小値を設定すると、自動的にフィールドが必須と表示されます。

React

Blazor

貯蓄

変更はアソシエイトおよび解除の保留中として追跡されます。親 MainContext が保存されると、これらのリクエストは他のレコード変更とともにトランザクション保存操作に含まれます。

React

Blazor

例

以下の例は、多対多の関係に結びついた基本的な ManyToManyLookupEdit を示しています。

Reactの例

ブレイザーの例

React TypeScript

Razor

地域

高度な検索

設定オプション

以下の操作方法を使って、 ReadOnly、 Disabled、 MinimumNumberOfItems、 MaximumNumberOfItems のプロパティを探検してください。

Reactの例

ブレイザーの例

React TypeScript

Razor

読み取り専用ですか?

障害者?

ミン

マックス

地域

活動地域

非活性領域

高度な検索

反応してください

ブレイザー

ManyToManyLookupEdit クラス

パラメータ

名称	種類	デフォルト	概要
`ChildContent`	RenderFragment?		コンポーネントの子コンテンツ
`Context`	MainContext?		この編集者を登録するカスケーディングコンテキストで、協調したセーブ操作に対応します。
`DefaultViewId`	Guid?		関連レコードを閲覧する際にデフォルトでどのビューを使うべきかを指定します。
`Description`	string?		説明はツールチップに表示されます。
`Disabled`	bool?		エディターを無効にすべきか。
`DisplayLabelWhenAvailable`	bool	True	ラベルが可能であれば表示するかどうかを明記しています。
`DisplayTooltipWhenAvailable`	bool	True	ツールチップが表示されるかどうかを指定します。
`DisplayValidationErrorMessage`	bool	True	コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか?
`IsDirty`	bool	False	まだ保存されていない保留中のアソシエーション変更や離脱の変更があるかどうかを示す値が付与されます。
`IsVisible`	bool	True	エディターは見えますか?
`Label`	string?		編集者用のラベルとして表示されるテキスト。
`MaximumNumberOfItems`	int?		選択可能な関連レコードの最大数。
`MaxRecordsReturned`	int	20	Dataverseで関連レコードを検索する際の最大レコード数。
`MinimumNumberOfItems`	int?		編集者が有効とみなされるために選択しなければならない最低限の関連レコード数。
`ReadOnly`	bool?		エディターは読み取り専用であるべきです。
`RelationshipName`*	string		この編集者が管理しているDataverseの多対多関係名です。
`Required`	bool?		価値が求められるかどうか。
`ViewIds`	List<Guid>?		関連レコードの閲覧に利用可能なビューの制限;空の場合はデフォルトの公開ビューが使われます。

名称: ChildContent

種類: RenderFragment?

概要: コンポーネントの子コンテンツ

名称: Context

種類: MainContext?

概要: この編集者を登録するカスケーディングコンテキストで、協調したセーブ操作に対応します。

名称: DefaultViewId

種類: Guid?

概要: 関連レコードを閲覧する際にデフォルトでどのビューを使うべきかを指定します。

名称: Description

種類: string?

概要: 説明はツールチップに表示されます。

名称: Disabled

種類: bool?

概要: エディターを無効にすべきか。

名称: DisplayLabelWhenAvailable

種類: bool

デフォルト: True

概要: ラベルが可能であれば表示するかどうかを明記しています。

名称: DisplayTooltipWhenAvailable

種類: bool

デフォルト: True

概要: ツールチップが表示されるかどうかを指定します。

名称: DisplayValidationErrorMessage

種類: bool

デフォルト: True

概要: コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか?

名称: IsDirty

種類: bool

デフォルト: False

概要: まだ保存されていない保留中のアソシエーション変更や離脱の変更があるかどうかを示す値が付与されます。

名称: IsVisible

種類: bool

デフォルト: True

概要: エディターは見えますか?

名称: Label

種類: string?

概要: 編集者用のラベルとして表示されるテキスト。

名称: MaximumNumberOfItems

種類: int?

概要: 選択可能な関連レコードの最大数。

名称: MaxRecordsReturned

種類: int

デフォルト: 20

概要: Dataverseで関連レコードを検索する際の最大レコード数。

名称: MinimumNumberOfItems

種類: int?

概要: 編集者が有効とみなされるために選択しなければならない最低限の関連レコード数。

名称: ReadOnly

種類: bool?

概要: エディターは読み取り専用であるべきです。

名称: RelationshipName*

種類: string

概要: この編集者が管理しているDataverseの多対多関係名です。

名称: Required

種類: bool?

概要: 価値が求められるかどうか。

名称: ViewIds

種類: List<Guid>?

概要: 関連レコードの閲覧に利用可能なビューの制限;空の場合はデフォルトの公開ビューが使われます。

方法

名称	パラメータ	種類	概要
`GetRequests`		List<OrganizationRequest>	現在の選択を永続化させるために実行しなければならない保留中の `Requests.OrganizationRequest` 操作(アソシエイトおよびデアソシエイト)を返します。
`GetValidationErrors`		List<string>	現在の選択に関する検証エラーを返します。最小および最大アイテム数ルールの違反も含まれます。
`RefreshAsync`	bool forceRefresh	Task	グリッドに提供されたデータソースから現在のデータを再取得しレンダリングするよう指示します。
`ResetState`		void	保留中の関連付けおよび解消の変更をすべてクリアし、エディターを最後に保存した状態にリセットします。
`Validate`		bool	現在の選択が設定された最小および最大アイテム数の制約を満たした場合に true を返します。

名称: GetRequests

種類: List<OrganizationRequest>

概要: 現在の選択を永続化させるために実行しなければならない保留中の Requests.OrganizationRequest 操作(アソシエイトおよびデアソシエイト)を返します。

名称: GetValidationErrors

種類: List<string>

概要: 現在の選択に関する検証エラーを返します。最小および最大アイテム数ルールの違反も含まれます。

名称: RefreshAsync

パラメータ: bool forceRefresh

種類: Task

概要: グリッドに提供されたデータソースから現在のデータを再取得しレンダリングするよう指示します。

名称: ResetState

種類: void

概要: 保留中の関連付けおよび解消の変更をすべてクリアし、エディターを最後に保存した状態にリセットします。

名称: Validate

種類: bool

概要: 現在の選択が設定された最小および最大アイテム数の制約を満たした場合に true を返します。