Personnaliser les formulaires d’entités
Les formulaires constituent une interface utilisateur qui permet aux utilisateurs de créer, d’afficher ou de modifier les enregistrements d’entités. Utilisez le concepteur de formulaire dans les outils de personnalisation pour créer et modifier les formulaires d’entités. Pour plus d’informations : Créer et concevoir des formulaires pour obtenir des informations sur les tâches liées à l’utilisation des formulaires dans l’application.
Cette rubrique fournira des informations requises pour créer ou modifier des formulaires par programme.
Accès aux définitions de formulaire
Les formulaires d’entités sont enregistrés dans l’entité SystemForm avec les tableaux de bord et les visualisations. Il existe deux méthodes pour inspecter les définitions de formulaire pour une entité :
Incluez l’entité dans une solution non gérée et exportez la solution.
Interroger l’entité
SystemForm
Afficher FormXML à partir d’une entité exportée
Seules les définitions des formulaires d’entités système qui ont été personnalisées sont incluses dans la solution gérée exportée. Pour afficher la définition d’un formulaire d’entité système, vous devez la modifier d’une façon ou d’une autre, ou créer un formulaire en enregistrant le formulaire existant avec un nouveau nom.
Après avoir exporté la solution, extrayez le contenu et affichez le fichier customizations.xml. Vous trouverez la définition des formulaires dans ImportExportXml>Entities>Entity>FormXml.
Dans le nœud <FormXml>, chaque type de formulaire est regroupé dans un élément <forms> avec l’attribut type spécifiant le type de formulaire.
Propriétés du formulaire
Le tableau suivant décrit les attributs d’entités SystemForm clés et les données correspondantes incluses dans les éléments XML exportés avec la solution.
| Propriété SystemForm | Élément FormXML | Description |
|---|---|---|
AncestorFormId |
<ancestor> |
Identificateur unique du formulaire parent. Défini lorsque vous créez un formulaire à l’aide d’Enregistrer sous pour un formulaire existant ou en utilisant CopySystemFormRequest. |
CanBeDeleted |
<CanBeDeleted> |
Information qui indique si ce composant peut être supprimé. Cette propriété gérée est appliquée uniquement si le formulaire a été créé en important une solution gérée. |
Description |
<Descriptions> |
Description représente une chaîne et <Descriptions> contient les étiquettes localisées de la description du formulaire.Les étiquettes localisées peuvent être récupérées à l’aide de RetrieveLocLabelsRequest. |
FormActivationState |
<FormActivationState> |
Spécifie l’état du formulaire. Seuls les formulaires du type « principal » peuvent être désactivés. Valeurs correctes : - 0 : Inactif - 1 : Actif |
FormId |
<formid> |
Identificateur unique du formulaire |
FormPresentation |
<FormPresentation> |
Indique si ce formulaire figure dans la disposition d’interface utilisateur mise à jour dans Dynamics 365 for Customer Engagement. |
FormXml |
<form> |
Représentation XML de la disposition du formulaire. |
IntroducedVersion |
<IntroducedVersion> |
Version de la solution à laquelle le formulaire a été ajouté. |
IsAIRMerged |
S.o. | Indique si ce formulaire est fusionné avec la disposition d’interface utilisateur mise à jour dans Dynamics 365 for Customer Engagement. |
IsCustomizable |
<IsCustomizable> |
Information indiquant si ce composant est personnalisable. Cette propriété gérée est appliquée uniquement si le formulaire a été créé en important une solution gérée. |
IsDefault |
N/D | Information indiquant si le formulaire ou le tableau de bord est le système par défaut. |
Name |
<LocalizedNames> |
Name représente une chaîne et <LocalizedNames> contient les étiquettes localisées du nom du formulaire.Les étiquettes localisées peuvent être récupérées à l’aide de RetrieveLocLabelsRequest. |
ObjectTypeCode |
Le formulaire est un descendant de l’élément Entity. |
La valeur ObjectTypeCode est le nom logique de l’entité. |
Type |
Attribut type de l’élément <forms> |
Les valeurs valides pour les formulaires sont : - 2 : main- 5 : mobile- 6 : quick- 7 : quickCreate |
Créer et modifier des formulaires
Vous pouvez uniquement créer des formulaires pour une entité où EntityMetadata. CanCreateForms le permet.
Vous pouvez créer des formulaires avec CreateRequest ou CopySystemFormRequest. Lorsque vous utilisez CopySystemFormRequest ou Enregistrer sous dans l’éditeur de formulaires, notez qu’aucun héritage n’a lieu entre les formulaires. Par conséquent, les modifications apportées au formulaire de base ne sont pas automatiquement appliquées à tous les formulaires créés à partir de celui-ci.
La modification des définitions de formulaires d’une solution gérée exportée, puis la réimportation de la solution est une méthode prise en charge pour modifier les formulaires d’entités. Lors de la modification manuelle des formulaires, utilisez un éditeur XML qui permet la validation de schéma. Pour plus d’informations : Modifier le fichier XML de personnalisations avec une validation de schéma
Voir aussi
Personnaliser Microsoft Dynamics 365 Customer Engagement
Créer et concevoir des formulaires
Entité SystemForm
Créer ou modifier le mode d’initialisation des règles métier
Schéma XML du formulaire