ManyToManyLookupEdit

Le ManyToManyLookupEdit composant fournit un éditeur d’autocomplétion en ligne pour gérer les relations plusieurs-à-plusieurs (N :N) entre les enregistrements Dataverse. Il affiche les enregistrements actuellement associés sous forme de puces et permet aux utilisateurs de rechercher, d’ajouter et de supprimer des associations sans avoir à s’éloigner du formulaire.

Comment ça fonctionne

Placez le composant dans un RecordContext et spécifiez le RelationshipName. Le composant résout automatiquement la table associée, charge les enregistrements associés et fournit une liste déroulante d’autocomplétion consultable pour ajouter de nouvelles associations.

React

Blazor

Vues

Utiliser ViewIds et DefaultViewId contrôler les vues disponibles pour la recherche dans les documents liés. Les colonnes de la vue sont affichées dans le menu déroulant pour aider les utilisateurs à identifier le bon enregistrement. Si aucune vue n’est spécifiée, la vue publique par défaut pour le tableau correspondant est utilisée.

React

Blazor

Validation

Utiliser MinimumNumberOfItems et MaximumNumberOfItems faire respecter des contraintes sur le nombre d’enregistrements associés. Définir un minimum marque automatiquement le champ comme requis.

React

Blazor

Sauvetage

Les changements sont suivis comme des demandes d’associés et de dissociation en attente. Lorsque le parent MainContext est sauvegardé, ces requêtes sont incluses dans l’opération de sauvegarde transactionnelle aux côtés de tout autre changement d’enregistrement.

React

Blazor

Exemple

L’exemple suivant montre une borne de base ManyToManyLookupEdit à une relation de plusieurs.

Exemple de réaction

Exemple de Blazor

Régions

React TypeScript

Razor

Configuration Options

Utilisez les commandes ci-dessous pour explorer les ReadOnlypropriétés, Disabled, MinimumNumberOfItems, et MaximumNumberOfItems les propriétés.

Exemple de réaction

Exemple de Blazor

Lecture seule ?

Handicapé ?

Min

Max

Régions

React TypeScript

Razor

Réagir

Blazor

ManyToManyLookupEdit Classe

Paramètres

Nom	Type	Par défaut	Description
`ChildContent`	RenderFragment?		Contenu enfant du composant
`Context`	MainContext?		Contexte en cascade qui enregistre cet éditeur pour des opérations de sauvegarde coordonnées.
`DefaultViewId`	Guid?		Précise quelle vue doit être utilisée par défaut lors de la navigation des enregistrements associés.
`Description`	string?		Description à afficher dans l’infobulle.
`Disabled`	bool?		Si l’éditeur est désactivé.
`DisplayLabelWhenAvailable`	bool	True	Précise s’il faut afficher une étiquette si disponible.
`DisplayTooltipWhenAvailable`	bool	True	Précise s’il faut afficher une infobulle si disponible.
`DisplayValidationErrorMessage`	bool	True	Un message d’erreur de validation doit-il s’afficher lorsque le composant échoue à la validation ?
`IsDirty`	bool	False	Obtient une valeur indiquant s’il y a des modifications d’association ou de dissociation en attente qui n’ont pas encore été sauvegardées.
`IsVisible`	bool	True	L’éditeur est-il visible ?
`Label`	string?		Le texte doit être affiché comme une étiquette pour l’éditeur.
`MaximumNumberOfItems`	int?		Nombre maximal d’enregistrements connexes pouvant être sélectionnés.
`MaxRecordsReturned`	int	20	Nombre maximal d’enregistrements retournés depuis Dataverse lors de la recherche d’enregistrements associés.
`MinimumNumberOfItems`	int?		Nombre minimum d’enregistrements liés à sélectionner pour que l’éditeur soit considéré comme valide.
`ReadOnly`	bool?		L’éditeur devrait-il être en lecture seule ?
`RelationshipName`*	string		Le nom de relation multi-à-nombre Dataverse que cet éditeur gère.
`Required`	bool?		Si la valeur est requise.
`ViewIds`	List<Guid>?		Limites des vues disponibles pour la navigation dans les dossiers associés ; s’il est vide, la vue publique par défaut est utilisée.

Nom: ChildContent

Type: RenderFragment?

Description: Contenu enfant du composant

Nom: Context

Type: MainContext?

Description: Contexte en cascade qui enregistre cet éditeur pour des opérations de sauvegarde coordonnées.

Nom: DefaultViewId

Type: Guid?

Description: Précise quelle vue doit être utilisée par défaut lors de la navigation des enregistrements associés.

Nom: Description

Type: string?

Description: Description à afficher dans l’infobulle.

Nom: Disabled

Type: bool?

Description: Si l’éditeur est désactivé.

Nom: DisplayLabelWhenAvailable

Type: bool

Par défaut: True

Description: Précise s’il faut afficher une étiquette si disponible.

Nom: DisplayTooltipWhenAvailable

Type: bool

Par défaut: True

Description: Précise s’il faut afficher une infobulle si disponible.

Nom: DisplayValidationErrorMessage

Type: bool

Par défaut: True

Description: Un message d’erreur de validation doit-il s’afficher lorsque le composant échoue à la validation ?

Nom: IsDirty

Type: bool

Par défaut: False

Description: Obtient une valeur indiquant s’il y a des modifications d’association ou de dissociation en attente qui n’ont pas encore été sauvegardées.

Nom: IsVisible

Type: bool

Par défaut: True

Description: L’éditeur est-il visible ?

Nom: Label

Type: string?

Description: Le texte doit être affiché comme une étiquette pour l’éditeur.

Nom: MaximumNumberOfItems

Type: int?

Description: Nombre maximal d’enregistrements connexes pouvant être sélectionnés.

Nom: MaxRecordsReturned

Type: int

Par défaut: 20

Description: Nombre maximal d’enregistrements retournés depuis Dataverse lors de la recherche d’enregistrements associés.

Nom: MinimumNumberOfItems

Type: int?

Description: Nombre minimum d’enregistrements liés à sélectionner pour que l’éditeur soit considéré comme valide.

Nom: ReadOnly

Type: bool?

Description: L’éditeur devrait-il être en lecture seule ?

Nom: RelationshipName*

Type: string

Description: Le nom de relation multi-à-nombre Dataverse que cet éditeur gère.

Nom: Required

Type: bool?

Description: Si la valeur est requise.

Nom: ViewIds

Type: List<Guid>?

Description: Limites des vues disponibles pour la navigation dans les dossiers associés ; s’il est vide, la vue publique par défaut est utilisée.

Méthodes

Nom	Paramètres	Type	Description
`GetRequests`		List<OrganizationRequest>	Retourne les opérations en attente `Requests.OrganizationRequest` (associer et dissocier) qui doivent être exécutées pour perdurer la sélection courante.
`GetValidationErrors`		List<string>	Des erreurs de validation de retour pour la sélection en cours, y compris des violations des règles de nombre minimum et maximum d’articles.
`RefreshAsync`	bool forceRefresh	Task	Demande à la grille de récupérer et de rendre les données courantes de la source de données fournie.
`ResetState`		void	Efface tous les changements d’association et de dissociation en attente, réinitialisant l’éditeur à son dernier état sauvegardé.
`Validate`		bool	Retour vrai lorsque la sélection courante satisfait les contraintes de nombre minimum et maximal d’éléments configurées.

Nom: GetRequests

Type: List<OrganizationRequest>

Description: Retourne les opérations en attente Requests.OrganizationRequest (associer et dissocier) qui doivent être exécutées pour perdurer la sélection courante.

Nom: GetValidationErrors

Type: List<string>

Description: Des erreurs de validation de retour pour la sélection en cours, y compris des violations des règles de nombre minimum et maximum d’articles.

Nom: RefreshAsync

Paramètres: bool forceRefresh

Type: Task

Description: Demande à la grille de récupérer et de rendre les données courantes de la source de données fournie.

Nom: ResetState

Type: void

Description: Efface tous les changements d’association et de dissociation en attente, réinitialisant l’éditeur à son dernier état sauvegardé.

Nom: Validate

Type: bool

Description: Retour vrai lorsque la sélection courante satisfait les contraintes de nombre minimum et maximal d’éléments configurées.