Utiliser des formulaires pour interagir avec les données Dataverse

15 minutes

Les formulaires ajoutent la possibilité pour les pages web d’interagir avec des lignes d’une table spécifique en utilisant une définition de formulaire piloté par modèle comme modèle de disposition. À l’instar des listes, les formulaires sont des configurations basées sur les données, qui permettent aux utilisateurs d’ajouter un formulaire pour collecter ou afficher des données dans le site web, sans qu’un développeur ait à créer un formulaire personnalisé. Vous pouvez définir des formulaires en utilisant des formulaires pilotés par un modèle et vous pouvez les placer dans des pages web sur le site web.

Les formulaires peuvent afficher la plupart des types de colonnes et des sous-grilles, le type de colonne de choix (voir Configurer une colonne de choix pour Power Pages) et les composants de code (voir Utiliser des composants de code dans Power Pages).

Utilisations courantes

La table suivante présente les scénarios courants dans le cadre desquels vous pouvez utiliser des formulaires.

Scénario	Description
Disposition	Configurez et utilisez des formulaires en mode lecture seule comme mécanisme de disposition. Pensez aux formulaires comme des pages d’informations sur les collaborateurs, les produits ou toute autre table Microsoft Dataverse. Par exemple, vous pourriez avoir une table personnalisée dans votre instance Dataverse qui décrit les postes vacants disponibles au sein de votre organisation. Au lieu de créer un modèle spécial pour afficher la page, vous pouvez créer un formulaire piloté par modèle distinct pour la table, créer une page web à l’aide du studio de conception Power Pages, puis ajouter un composant formulaire à la page. Toutes les modifications publiées dans une disposition de formulaire d’une application pilotée par modèle s’appliqueront automatiquement à la page web.
Capture d’informations	Utilisez des formulaires du site web pour la capture de données auprès d’utilisateurs anonymes ou authentifiés. Par exemple, un simple formulaire de prospect peut être affiché sur une page Contactez-nous pour enregistrer des demandes anonymes en tant que prospects dans Dynamics 365 Sales. Pour les utilisateurs authentifiés, un site web peut utiliser une page d’enquête pour collecter des commentaires sur les produits auprès des clients dans une table de commentaires sur les produits personnalisée.
Gestion des enregistrements	Les formulaires permettent de définir diverses combinaisons d’opérations de création, d’extraction, de mise à jour et de suppression (CRUD) sur une table dans un ensemble de pages web connexes. Par exemple, les clients peuvent récupérer et lire leurs propres incidents et en créer de nouveaux, les partenaires peuvent modifier leurs profils d’entreprise et les collaborateurs peuvent afficher la liste des ressources qui leur sont allouées par la société.
Applications web	Lorsque vous utilisez des formulaires avec des listes et des sous-grilles, et avec les fonctionnalités étendues par JavaScript, ils permettent aux développeurs de créer des applications web complètes.

Créer un formulaire

Lorsque vous créez un formulaire, la première étape consiste à décider quelle Table et quel Formulaire vous afficherez. Bien que la réutilisation des formulaires faisant partie d’une application pilotée par modèle soit possible, la pratique courante consiste à concevoir des formulaires pilotés par modèle propres à Power Pages (qui peuvent ou non être inclus dans les applications pilotées par modèle).

Les formulaires Power Pages sont plus concis avec moins d’informations présentées, en particulier pour les audiences externes.
Les processus Power Pages sont distincts de l’utilisation interne d’une application pilotée par modèle pour le personnel (y compris les applications Dynamics 365). Les formulaires dédiés sont plus faciles à maintenir parce que vous devez appliquer manuellement les changements dans les applications pilotées par modèle aux formulaires Power Pages, ce qui vous donne l’occasion de revoir les exigences et d’évaluer les aspects liés à la facilité d’utilisation.
Il existe certaines limitations sur l’affichage du formulaire et des colonnes. Pour plus d’informations, consultez À propos des formulaires.
JavaScript et les règles métier côté client, qui constituent des parties essentielles d’un formulaire piloté par modèle, ne s’exécuteront pas sur le site web Power Pages. Ce facteur est facile à ignorer et peut entraîner des conséquences inattendues.
Des considérations particulières doivent être prises en compte lors de l’affichage des lignes, des notes et d’une chronologie associés, car les aspects fonctionnels ne sont pas tous pris en charge (ou requis) sur le site web.

Mode

Vous pouvez sélectionner le mode Formulaire dans l’onglet Données de la boîte de dialogue des propriétés du formulaire. Le mode Formulaire définit si le formulaire est utilisé pour générer une disposition, capturer les données ou fournir des fonctionnalités d’édition complètes pour des lignes Dataverse. Ce mode formulaire peut être utilisé dans l’une des options suivantes :

Lecture uniquement : le studio de conception Power Pages désigne cette option sous le terme lecture seule.
Insertion : le studio de conception désigne cette option comme Créer un enregistrement.
Modifier : le studio de conception désigne cette option comme Mettre à jour un enregistrement existant.

Remarque

Un formulaire en mode Modifier sera affiché en Lecture seule si l’utilisateur ne possède pas de privilèges d’écriture pour la ligne.

Si le mode est Insérer, aucune information supplémentaire n’est requise. Pour les modes Lecture seule et Modifier, le formulaire doit « connaître » la ligne de table à afficher et à mettre à jour. Le paramètre Type de source d’enregistrement définit la façon dont ces informations sont transmises au formulaire :

Chaîne de requête : ce paramètre est défini par défaut lorsque vous créez un formulaire dans le studio de conception. Lorsque la page qui contient le formulaire est affichée, l’identificateur de ligne devrait faire partie de la chaîne de requête, comme, https://contoso.powerappsportals.com/contacts/edit/?id=<contact guid>. Habituellement, ce paramètre est automatiquement défini lorsque le formulaire est lié à une liste. Il s’agit du paramètre le plus courant.
Utilisateur actuel du portail : vous pouvez définir cette option dans l’application Gestion de portail. Lorsque vous sélectionnez cette option, le formulaire charge les informations provenant de la ligne utilisateur actuelle du site web sans utiliser d’informations supplémentaires à partir de l’URL de la page. Cette option est généralement utilisée pour afficher un formulaire de profil utilisateur. Dans ce cas, vous devrez définir la colonne Nom de la table dans ce cas doit être défini sur Contact, car les utilisateurs du site web sont représentés par la table de contact.
Enregistrement associé à l’utilisateur actuel du portail : vous pouvez définir cette option est configurée dans l’application Gestion de portail. La sélection de cette option vous permet de modifier les lignes associées, telles que les détails du compte parent de l’utilisateur actuel. Assurez-vous de spécifier le Nom de la relation afin d’identifier la ligne à modifier. Le type de table sélectionné doit correspondre à la sélection dans la colonne Nom de la colonne. Cette option est utile dans les scénarios partenaires dans lesquels l’organisation partenaire aurait plusieurs utilisateurs du site web. Vous pouvez autoriser certains de ces utilisateurs à modifier la ligne du compte parent.

Table, Formulaire, Nom et Mode sont les propriétés requises pour afficher le formulaire.

Configurer le formulaire

D’autres options de configuration pour contrôler l’apparence et le comportement du formulaire sont disponibles dans le studio de conception.

Onglet Formulaire

Dans l’onglet Formulaire, vous pouvez sélectionner une table, un formulaire pour cette table, ainsi que le nom du formulaire (que vous ne pourrez pas modifier après sa création).

Onglet Données

Dans l’onglet Données, vous pouvez modifier le mode du formulaire.

Onglet Lors de l’envoi

Le paramètre Lors de l’envoi détermine les actions entreprises lorsqu’un formulaire est soumis avec succès :

Afficher un message : affiche un message lorsque le formulaire est soumis.
Rediriger vers la page web : permet d’accéder automatiquement à une page web en cas de succès de l’envoi du formulaire.
Rediriger vers l’URL : permet de rediriger vers une URL (site web ou externe).

Onglet CAPTCHA

La fonctionnalité CAPTCHA détermine si un captcha doit s’afficher pour les utilisateurs anonymes ou authentifiés.

Onglet Pièce jointe

Dans l’onglet Pièce jointe, vous pouvez déterminer si un utilisateur peut télécharger des fichiers, et vous pouvez spécifier la taille maximale des pièces jointes et les restrictions sur les types de fichiers.

Autres paramètres du formulaire

D’autres paramètres de configuration sont disponibles pour les formulaires dans l’application Gestion de portail. Pour accéder à un formulaire dans l’application Gestion de portail, procédez comme suit :

Sélectionnez le composant de formulaire sur la page dans le studio de conception Power Pages.
Sélectionnez la commande Modifier le formulaire.
Dans la boîte de dialogue Paramètres du formulaire, sélectionnez l’onglet Données.
Sélectionnez Ouvrir l’application Gestion de portail sous le titre Configurations.

Les formulaires peuvent inclure des Actions permettant à l’utilisateur d’interagir avec la ligne. Des configurations détaillées par élément de formulaire sont disponibles grâce à d’autres lignes Métadonnées du formulaire.

Configuration

Les sections suivantes décrivent les différentes manières de configurer les formulaires à l’aide de l’application Gestion de portail.

Options de formulaire

La plupart des options de formulaire prennent en charge la personnalisation des éléments feuilles de style en cascade (CSS) pour changer l’apparence visuelle. Vous pouvez spécifier des éléments de texte tels que les libellés, les messages et les info-bulles dans plusieurs langues. Par exemple, le message par défaut après la soumission du formulaire est « Enregistré », mais vous pouvez le personnaliser pour chaque langue de site web activée.

Une autre option de formulaire inclut le contrôle du comportement de validation, qui vous permet de déterminer si vous souhaitez marquer toutes les colonnes comme requis, quel que soit le paramètre de formulaire, par exemple.

Autres paramètres

D’autres paramètres définissent d’autres aspects du comportement du formulaire, tels que le style, la traduction des éléments de l’interface utilisateur, etc.

Conseil

Certains paramètres et options de configuration sont masqués. Cochez la case Paramètres avancés pour afficher toutes les options disponibles.

Associer l’utilisateur actuel du portail à l’insertion : utilisez cette option permet d’effectuer le suivi des contacts du site web qui ont créé ou mis à jour la ligne. Ce paramètre crée un site web équivalent aux colonnes Créé par et Modifié par dans Dataverse. Vous pouvez également définir des relations de parenté, le cas échéant. Par exemple, si une ligne de compte est créée, vous souhaiterez peut-être définir automatiquement le contact actuel comme contact principal.
Ajouter un fichier joint : de nombreuses options sont disponibles pour ajouter un contrôle de téléchargement de fichier à votre formulaire. La configuration est flexible et prend en charge plusieurs fichiers, options de stockage, types MIME et restrictions de taille (vous pouvez, par exemple, limiter les chargements à des images jusqu’à 2 Mo).
Géolocalisation : vous pouvez configurer un formulaire pour afficher un contrôle de carte, soit pour afficher un emplacement existant sous la forme d’une épingle sur une carte, soit pour permettre à un utilisateur de spécifier un emplacement. Le contrôle de carte du formulaire nécessite d’autres configurations pour déterminer quels sont les différentes colonnes d’emplacement, leur attribuer des valeurs ou en extraire des valeurs. Pour plus d’informations, consultez Configuration de géolocalisation pour les formulaires.

Référence de table associée

La fonctionnalité Référence de table associée fournit un moyen d’associer la ligne en cours de création ou de mise à jour à une autre ligne cible. Cette fonction est utile si vous avez plusieurs étapes avec plusieurs types de table et que vous souhaitez associer les lignes résultantes, ou si la page est transmise dans une chaîne de requête d’un ID de ligne que vous souhaitez associer.

Par exemple, vous pourriez avoir une page d’événement qui affiche des informations sur un webinaire à venir. Vous souhaitez inclure un bouton d’inscription qui redirige les visiteurs vers la page d’inscription où le formulaire d’inscription est affiché. Vous pouvez transmettre l’identificateur d’événement dans une chaîne de requête et, lorsque le formulaire d’inscription est soumis, vous pouvez lier automatiquement les informations d’inscription à l’événement.

Actions

Étant donné qu’un formulaire traite une ligne de table individuelle, vous pouvez exécuter de nombreuses actions sur cette ligne, telles que Mettre à jour, Supprimer, Désactiver, etc. Vous pouvez configurer ces actions, qui sont affichées lors de l’exécution sous forme de boutons de commande, en sélectionnant Paramètres supplémentaires > Configuration du bouton d’action.

Toutes les commandes incluent des options pour renommer les boutons et modifier leur emplacement sur le formulaire.

Métadonnées de formulaire

Les lignes Métadonnées du formulaire vous permettent de contrôler l’apparence et le comportement des éléments de formulaire individuels, notamment :

Apparence des colonnes, des sections et des onglets. En outre, vous pouvez définir les valeurs par défaut d’une colonne individuelle, le comportement de validation et d’autres aspects.
La configuration des sous-grilles, qui permet de définir des actions pour les lignes associées, similaires aux actions de liste de tables.
Le comportement des sections de notes et de la chronologie, et s’il est possible d’ajouter de nouvelles lignes. En règle générale, cette option est utilisée pour permettre aux utilisateurs du site web de saisir des commentaires sur la ligne, par exemple un incident en cours.

Ajouter un formulaire à votre site web

Un formulaire définit le comportement requis mais ne contient aucune information indiquant comment et où sur le site web le formulaire doit être affiché. Les deux méthodes d’affichage d’un formulaire sur un site web sont les suivantes :

Spécifiez explicitement le formulaire comme cible pour une action de liste, telle que Créer, Mettre à jour ou Modifier. Dans ce cas, le formulaire s’affiche dans une fenêtre contextuelle modale. Certaines limitations s’appliquent lorsque le formulaire est affiché dans une fenêtre contextuelle. Par exemple, la possibilité de créer des lignes associées à partir de sous-grilles n’est pas disponible.
Ajoutez un composant de formulaire à une page web dans le studio de conception de Power Pages, comme vous le feriez pour une liste. Cette action place une balise Liquid sur le texte de la page web pour afficher le formulaire.
```
{% entityform name: '<<form name>>' %}
```

Étant donné que les formulaires peuvent renvoyer des informations au serveur pour traitement, vous aurez moins de contrôle sur l’affichage des formulaires par rapport à celui que vous auriez sur des listes d’entités.

Continuer