Modifier les enregistrements de table associés directement à partir du formulaire principal d’une autre table

Il existe plusieurs façons de travailler avec des enregistrements de table associés dans un formulaire de table dans Power Apps. Par exemple, vous pouvez inclure des tables associées en mode lecture seule avec un aperçu et créer ou modifier un enregistrement à l’aide d’un formulaire principal dans une boîte de dialogue.

Une autre façon de travailler avec des enregistrements de table associés consiste à ajouter un contrôle de composant de formulaire au formulaire principal d’une autre table. Le contrôle de composant de formulaire permet aux utilisateurs de modifier les informations d’un enregistrement de table associé directement à partir du formulaire d’une autre table.

Par exemple, voici le composant de formulaire sur un onglet séparé du formulaire de compte principal, qui permet à l’utilisateur de modifier un enregistrement de contact sans quitter le formulaire de compte.

Par exemple, voici le composant de formulaire sur un onglet existant sur le formulaire de compte principal, qui permet également à l’utilisateur de modifier un enregistrement de contact sans quitter l’onglet Résumé de formulaire de compte.

Ajouter le composant Form à un formulaire principal de table

1. Dans le volet de navigation de gauche, sélectionnez Composants. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.
2. Développez Entrée ou Affichage, puis sélectionnez Formulaires. Sur la page de configuration du contrôle Form component, sélectionnez les propriétés du contrôle :
   • Sélectionnez la Colonne de recherche pour le formulaire.
   • Sélectionnez le Formulaire associé. En fonction de la configuration de table associée pour la colonne :
     • Si la colonne est connectée à une seule table (telle que la colonne Créateur), sélectionnez le Formulaire associé à utiliser.
     • Si la colonne est connectée à plusieurs tables (polymorphiques, comme la colonne Propriétaire), sélectionnez + Formulaire associé, puis sélectionnez Ajouter pour ajouter le formulaire associé. Continuez à sélectionner + Formulaire associé > Ajouter pour ajouter un formulaire associé pour chaque table associée.
   • Par défaut, tous les types d’application cliente Web, Téléphone et Tablette sont activés pour afficher le formulaire. Effacez les types de client où vous ne voulez pas que le formulaire apparaisse.
3. Cliquez sur Terminé.
4. Enregistrez, puis Publiez le formulaire.

Ajouter le composant de formulaire en utilisant l’expérience classique

Dans cet exemple, le formulaire principal standard Contact est configuré pour le contrôle Form Component ajouté au formulaire principal du compte.

Important

La façon dont vous ajoutez un contrôle Form component a changé. Nous vous recommandons d’utiliser l’expérience la plus récente. Plus d’informations : Ajouter le composant de formulaire à un formulaire principal de table

1. Connectez-vous à Power Apps.

2. Sur le volet de gauche, sélectionnez Tables. Sinon, ouvrez une solution, puis sélectionnez une table, par exemple Compte. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.

3. Sélectionnez Formulaires dans le menu des composants.

4. Sélectionnez un formulaire avec un type de formulaire Principal à partir des formulaires disponibles.

5. Sélectionnez Basculer vers l’affichage classique. L’interface de l’éditeur de formulaires classique s’ouvre sous la forme d’un onglet dans votre navigateur.

6. Sélectionnez l’onglet Insérer. Ensuite, créez un nouvel onglet et ajoutez une nouvelle section ou ajoutez une nouvelle section à un onglet existant.

7. Dans la nouvelle section, ajoutez une colonne de recherche, telle que la colonne de recherche Contact principal.

8. Sélectionnez la colonne de recherche, puis dans l’onglet Accueil, sélectionnez Modifier les propriétés.

9. Sur l’onglet Contrôles, sélectionnez Ajouter un contrôle, dans la liste des types de contrôle, sélectionnez Contrôle Composant de formulaire, puis sélectionnez Ajouter.

   

10. Sélectionnez Web, Tablette et Téléphone pour le composant.

11. Sélectionnez Modifier (icône de crayon), puis sur la boîte de dialogue Configurer la propriété, sélectionnez Associer à une valeur statique et ajoutez une entrée XML similaire à celle-ci où TableName est le nom unique de la table et FormID est l’ID du formulaire principal : <QuickForms><QuickFormIds><QuickFormId entityname="TableName">FormID</QuickFormId></QuickFormIds></QuickForms>

    • Par exemple, pour afficher le formulaire principal Contact sur le formulaire de compte, utilisez : <QuickForms><QuickFormIds><QuickFormId entityname="contact">1fed44d1-ae68-4a41-bd2b-f13acac4acfa</QuickFormId></QuickFormIds></QuickForms>

    

12. Cliquez sur OK, puis de nouveau sur OK.

13. Sélectionnez Enregistrer, puis sur Publier pour publier votre formulaire.

Conseil

Pour trouver le nom unique d’une table, sélectionnez la table dans Power Apps, puis sélectionnez Paramètres. Le Nom apparaît sur le volet de table Éditer. L’ID de formulaire se trouve dans l’URL du navigateur lorsque vous modifiez un formulaire. L’ID suit la partie /edit/ de l’URL.

Dans le concepteur de formulaires classique, l’ID de formulaire suit la partie formId%3d de l’URL.

Comportement du composant de formulaire

Cette section décrit le comportement des composants de formulaire lorsqu’ils sont utilisés dans une application pilotée par modèle.

Sélection d’enregistrements

Pour que le contrôle Form component affiche un formulaire, la colonne de recherche à laquelle il est lié doit avoir une valeur. Sinon, le contrôle affichera le message Enregistrement source non sélectionné. Une façon de définir la valeur consiste à ajouter au formulaire un contrôle de recherche qui est lié à la même colonne de recherche que le contrôle de composant de formulaire. Lorsque vous utilisez le contrôle de recherche pour modifier la valeur de la colonne de recherche, le contrôle du composant de formulaire affiche un formulaire avec les données de la nouvelle valeur de la colonne de recherche.

Validation de la colonne

Toutes les colonnes, à la fois dans le formulaire principal et dans les contrôles de composant de formulaire, doivent être valides pour que les données soient envoyées à Microsoft Dataverse. Cela est vrai pour les erreurs de validation de colonne, les colonnes obligatoires manquantes, etc.

Les gestionnaires OnSave sont exécutés pour le formulaire principal et ses contrôles de composant de formulaire. Tout gestionnaire peut annuler l’enregistrement pour le formulaire principal et les contrôles de composant de formulaire en utilisant preventDefault. Cela signifie qu’aucune opération de sauvegarde ne peut appeler preventDefault pour les données à envoyer à Dataverse. L’ordre d’appel des gestionnaires OnSave n’est pas défini. Informations complémentaires : Événement OnSave de formulaire (référence de l’API client) dans les applications pilotées par modèle

Sauvegarde de l’enregistrement

Une fois l’étape de validation passée, les données sont envoyées à Dataverse pour chaque enregistrement. Actuellement, chaque enregistrement est mis à jour indépendamment, avec différentes demandes. Les sauvegardes ne sont pas transactionnelles et l’ordre des sauvegardes n’est pas défini. Une erreur générée lors de l’enregistrement d’un composant de formulaire n’annulera pas les modifications apportées au formulaire principal ou à d’autres composants de formulaire. Une fois chaque enregistrement terminé, les données sont actualisées pour tous les enregistrements du formulaire.

Notifications

Les notifications concernant le composant de formulaire sont agrégées dans les notifications du formulaire principal. Par exemple, s’il y a des colonnes non valides dans le composant de formulaire et que vous essayez d’enregistrer, la notification de colonne non valide apparaîtra en haut du formulaire principal plutôt que dans le composant de formulaire.

Gestion des erreurs

S’il y a plusieurs erreurs lors de l’enregistrement, une seule erreur sera affichée à l’utilisateur. Si l’utilisateur peut apporter des modifications pour corriger la première erreur et enregistre, l’erreur suivante s’affichera. L’utilisateur devra continuer à enregistrer jusqu’à ce que toutes les erreurs aient été résolues.

Modification des enregistrements suite à des modifications non enregistrées

S’il y a des modifications non enregistrées dans un formulaire pour un composant de formulaire et qu’un utilisateur tente de modifier la colonne de recherche à laquelle le composant de formulaire est lié, il sera averti de cette modification.

API de client

Un contexte de formulaire est disponible pour le contrôle de composant de formulaire. Il est accessible via le contexte de formulaire du formulaire principal en accédant au contrôle via une API, telle que getControl. Avant d’accéder aux données de la table associée dans le contrôle de composant de formulaire, les gestionnaires d’événements doivent attendre l’API isLoaded pour que le contrôle retourne vrai.

Limitations

Notez les limitations suivantes lorsque vous ajoutez le contrôle de composant de formulaire à un formulaire de table :

• Le contrôle de composant de formulaire prend uniquement en charge le rendu des formulaires principaux. De même, la prise en charge de l’ajout d’un contrôle de composant de formulaire n’est prise en charge qu’avec les formulaires principaux. Les autres types de formulaires, tels que de création rapide, d’affichage rapide et de carte ne sont pas pris en charge.

• Les formulaires avec un flux de processus d’entreprise ne sont actuellement pas pris en charge dans le formulaire de table principale ou le formulaire de table associé. Si vous avez un formulaire avec un flux des processus d’entreprise, vous pouvez rencontrer un comportement inattendu. Nous vous recommandons de ne pas utiliser un composant de formulaire avec un formulaire qui utilise un flux des processus d’entreprise.

• Le contrôle de composant de formulaire ne prend pas en charge les contrôles de composant de formulaire incorporés, tels que l’ajout d’un contrôle de composant de formulaire à un formulaire utilisé par un contrôle de composant de formulaire.

• Le contrôle du composant de formulaire ne prend pas en charge les applications canevas intégrées. Vous pourriez rencontrer un comportement inattendu avec ces applications canevas.

• Le contrôle de composant de formulaire affichera uniquement le premier onglet du formulaire qu’il utilise si plusieurs onglets sont inclus dans ce formulaire.

• L’utilisation du même formulaire pour différents contrôles de composant de formulaire sur un même formulaire n’est pas prise en charge.

• Le formulaire que vous utilisez avec un composant de formulaire doit être inclus dans votre application. Si ce n’est pas le cas, ou si l’utilisateur actuel n’a pas accès au formulaire, il reviendra au formulaire principal le plus haut inclus dans l’application et disponible pour l’utilisateur (en fonction de l’ordre des formulaires).

• Tous les composants utilisés par le formulaire dans un composant de formulaire doivent être inclus dans votre application. Ces composants incluent des tables, des vues et des flux de processus métier associés. Si ce n’est pas le cas, ils ne seront pas disponibles dans le formulaire ou un comportement inattendu pourrait se produire.

• Les contrôles de composant de formulaire présentent certaines limitations lorsqu’ils sont rendus dans des applications multisession. Si l’API client est utilisée pour modifier le contrôle du composant de formulaire, ou si des données sont saisies dans le formulaire, les modifications peuvent ne pas être conservées lors du changement d’onglets multisession.

• Vous remarquerez peut-être que le mur de chronologie n’est pas mis à jour lorsqu’une colonne utilisée pour définir la chronologie a changé dans le composant de formulaire. Lorsque la page est actualisée, le mur de chronologie se met à jour comme prévu.

• Sur appareil mobile, le contrôle Timeline n’apparaît pas actuellement dans le contrôle Form component.

• Pour les sous-grilles, les boutons de commande Voir tous les enregistrements et Voir les enregistrements associés ne sont pas disponibles s’ils sont affichés dans un composant de formulaire.

• Les contrôles Form component ne sont pas pris en charge dans les boîtes de dialogue de modification en bloc. Ils n’apparaîtront pas dans le formulaire dans la boîte de dialogue d’édition en bloc par défaut et toute modification apportée aux enregistrements de table associés avec eux ne sera pas enregistrée.

Voir aussi

Utiliser des contrôles personnalisés pour des visualisations de données d’application pilotée par modèle

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).