Partager via


Effectuer des actions prédéfinies sur le formulaire piloté par modèle hôte à partir d’une application canevas incorporée

Les applications de canevas incorporées permettent d’effectuer des actions prédéfinies sur le formulaire piloté par modèle hôte. Ces actions permettent aux créateurs de naviguer, d’actualiser et d’enregistrer le formulaire piloté par le modèle hôte. À l’aide de ces actions, une application canevas incorporée peut agir comme une partie plus intégrale du formulaire piloté par modèle et de l’application pilotée par modèle.

L’objet ModelDrivenFormIntegration inclut désormais les nouvelles méthodes suivantes pour permettre aux créateurs d’effectuer des actions sur le formulaire piloté par le modèle hôte.

Navigue dans le formulaire piloté par le modèle hôte vers un formulaire principal et affiche la ligne spécifiée.

  • entityName : paramètre de chaîne obligatoire qui spécifie la table parente du formulaire principal.
  • formName : paramètre de chaîne obligatoire qui spécifie le nom du formulaire principal à accéder.
  • recordId : paramètre de chaîne obligatoire, qui spécifie l’ID de la ligne à afficher dans le formulaire principal.

L’appel de la méthode NavigateToMainForm peut afficher les messages d’erreur suivants.

Message d'erreur Instructions pour la résolution des problèmes
Table introuvable : [EntityName] Vérifiez la valeur du paramètre entityName et vérifiez qu’il s’agit d’un nom de table valide et que l’utilisateur y a accès.
Formulaire introuvable : [FormName] Vérifiez la valeur du paramètre mainFormName et vérifiez qu’il s’agit d’un nom de formulaire principal valide et que l’utilisateur y a accès.
Un problème s’est produit lors du chargement de la ligne. Vérifiez la valeur du paramètre recordId et vérifiez qu’il s’agit d’un ID de ligne valide et que l’utilisateur y a accès.

Navigue le formulaire piloté par le modèle hôte vers une vue.

  • entityName : paramètre de chaîne obligatoire qui spécifie la table parente de la vue.
  • viewName : paramètre de chaîne obligatoire qui spécifie le nom du formulaire principal à accéder.

L’appel de la méthode NavigateToView peut afficher les messages d’erreur suivants.

Message d'erreur Instructions pour la résolution des problèmes
Table introuvable : [EntityName] Vérifiez la valeur du paramètre entityName et vérifiez qu’il s’agit d’un nom de table valide et que l’utilisateur y a accès.
Affichage introuvable : [ViewName] Vérifiez la valeur du paramètre viewName et vérifiez qu’il s’agit d’un nom d’affichage valide et que l’utilisateur y a accès.

OpenQuickCreateForm(entityName)

Ouvre le formulaire de création rapide par défaut pour un tableau.

  • entityName : paramètre de chaîne obligatoire qui spécifie la table parente du formulaire de création rapide.

L’appel de la méthode OpenQuickCreateForm peut afficher les messages d’erreur suivants.

Message d'erreur Instructions pour la résolution des problèmes
Table introuvable : [EntityName] Vérifiez la valeur du paramètre entityName et vérifiez qu’il s’agit d’un nom de table valide et que l’utilisateur y a accès.

RefreshForm(showPrompt)

Actualise les données sur le formulaire piloté par le modèle hôte.

  • showPrompt : paramètre booléen obligatoire qui indique si une invite de confirmation doit être affichée à l’utilisateur avant d’enregistrer des données non enregistrées sur le formulaire piloté par le modèle hôte. Les valeurs doivent être « true » ou « false ».

L’appel de la méthode RefreshForm peut afficher les messages d’erreur suivants.

Message d'erreur Instructions pour la résolution des problèmes
Utilisez « true » ou « false » comme valeur de paramètre. Vérifiez la valeur du paramètre showPrompt et vérifiez qu’il est « true » ou « false ».

SaveForm()

Enregistre les données sur le formulaire piloté par le modèle hôte.

Note

Si vous ne voyez pas IntelliSense pour les méthodes permettant d’effectuer des actions prédéfinies dans les applications de canevas incorporées qui ont été créées avant la mise à disposition des fonctionnalités ; enregistrez, fermez et rouvrez l’application.

Voir aussi

Incorporer une application canevas sur un formulaire piloté par modèle
Ajouter une application canevas intégrée à un formulaire basé sur un modèle
Modifier une application canevas intégrée à un formulaire basé sur un modèle
Personnaliser la taille d’écran et l’orientation d’une application canevas intégrée dans un formulaire piloté par modèle
Propriétés et actions de contrôle ModelDrivenFormIntegration
Partager une application canevas intégrée
Instructions pour l’utilisation d’applications canevas intégrées
Migration des applications canevas intégrées de formulaires basés sur un modèle créés à l’aide de la version préliminaire publique la plus récente