Partager via


Propriétés et actions de contrôle ModelDrivenFormIntegration

Les applications canevas intégrées dans les formulaires basés sur un modèle contiennent un contrôle supplémentaire nommé ModelDrivenFormIntegration. Ce contrôle permet de transmettre des données contextuelles entre le formulaire basé sur un modèle de l’hôte et l’application canevas intégrée.

Important

Pour pouvoir interagir avec le ModelDrivenFormIntegration contrôle, l’application canevas doit être créée en sélectionnant Personnaliser sur les propriétés du contrôle d’application canevas pour le formulaire piloté par modèle à l’aide du concepteur de formulaires classique. Pour plus d'informations, voir : Incorporer une application canvas à l'aide du mode classique

Cet article explique les propriétés et les actions disponibles sur le ModelDrivenFormIntegration contrôle. Ce contrôle est disponible pour le personnaliser dans Power Apps Studio lorsque vous créez les applications canevas à l'aide de l'interface utilisateur des propriétés des contrôles de l'application canevas dans le concepteur de formulaires classique.

modcontrôle d'intégration de formulaire piloté par modèle dans Power Apps Studio

Propriété ou action Description
DataSource Doit être définie sur la source de données connectée à la table parent du formulaire hôte basé sur un modèle.
Défini automatiquement lors de l’intégration d’une nouvelle application canevas. Lors de l’intégration d’une application canevas existante, la source de données ModelDrivenFormIntegration peut être configurée à partir de l’arborescence de l’application canevas.
La valeur de DataSource doit toujours faire référence à la table du formulaire dans lequel l’application est incorporée. La valeur ne doit en aucun cas être filtrée ou modifiée.
Élément Propriété en lecture seule qui permet à l’application canevas intégrée d’accéder à la ligne depuis le formulaire hôte basé sur un modèle.
Par exemple, pour obtenir la valeur d’une colonne avec le nom numérodecompte et nom d’affichage Numéro de compte, vous pouvez utiliser ModelDrivenFormIntegration.Item.accountnumber ou ModelDrivenFormIntegration.Item.’Account Number’.
OnDataRefresh La formule de cette propriété est évaluée lorsque le formulaire hôte basé sur un modèle enregistre les données.
Utilisez-la pour actualiser la source de données connectée à la table parent du formulaire hôte basé sur un modèle et pour effectuer d’autres actions comme définir ou mettre à jour des variables.
Par exemple, la définir sur la formule ci-dessous réactualisera la source de données Compte et définira une variable intitulée CurrentAccountNumber sur la valeur de la colonne Numéro de compte de la ligne en cours.
Refresh(Accounts) ; Set(CurrentAccountNumber, ModelDrivenFormIntegration.Item.'Account Number')
L’action OnDataRefresh ne doit être utilisée que pour actualiser les données dans l’application canevas intégrée. Nous vous déconseillons d’utiliser l’action OnDataRefresh pour enregistrer les modifications dans l’application canevas intégrée. Informations complémentaires : Enregistrement de données une application canevas intégrée
RefreshForm Actualise les données sur le formulaire d’hôte basé sur un modèle.
Consultez la rubrique Exécuter les actions prédéfinies sur le formulaire hôte pour en savoir plus.
SaveForm Enregistre les données sur le formulaire d’hôte basé sur un modèle.
Consultez la rubrique Exécuter les actions prédéfinies sur le formulaire hôte pour en savoir plus.
NavigateToMainForm Fait accéder le formulaire d’hôte basé sur un modèle à un formulaire principal et affiche la ligne spécifiée.
Consultez la rubrique Exécuter les actions prédéfinies sur le formulaire hôte pour en savoir plus.
NavigateToView Fait accéder le formulaire d’hôte basé sur un modèle à une vue.
Consultez la rubrique Exécuter les actions prédéfinies sur le formulaire hôte pour en savoir plus.
OpenQuickCreateForm Ouvre le formulaire de création rapide par défaut d’une table.
Consultez la rubrique Exécuter les actions prédéfinies sur le formulaire hôte pour en savoir plus.
Données Propriété en lecture seule utilisée par la structure pour envoyer certaines données principales depuis le formulaire hôte basé sur un modèle vers l’application canevas intégrée.
N’utilisez pas cette propriété. Utilisez l’élément pour accéder à la ligne depuis le formulaire hôte basé sur un modèle.

Les données de contrôle ModelDrivenFormIntegration ne sont pas disponibles au démarrage de l’application

Il n'est pas garanti que la propriété ModelDrivenFormIntegration.Item soit peuplée de données au démarrage de l'application. L’application doit être conçue pour attendre ces données à l’aide d’une expression telle que !IsBlank(ModelDrivenFormIntegration.Item), ou l’application doit récupérer explicitement l’enregistrement à l’aide d’une expression comme LookUp(Accounts, Account = GUID(First(ModelDrivenFormIntegration.Data).ItemId)).

Voir aussi

Incorporer une application canevas dans un formulaire basé sur un modèle
Ajouter une application canevas intégrée à un formulaire basé sur un modèle
Effectuer des actions prédéfinies dans le formulaire d’hôte depuis une application canevas intégrée
Partager une application canevas intégrée
Instructions pour l’utilisation d’applications canevas intégrées