Personnaliser des applications basées sur des modèles à l’aide du code

Découvrez comment personnaliser des applications basées sur des modèles à l’aide des outils de Power Apps pris en charge et du code documenté. Cet article vous aide à identifier les méthodes prises en charge et pouvant être mises à niveau afin d’éviter les problèmes de personnalisation pendant les mises à jour et les mises à niveau.

Les personnalisations effectuées à l’aide de méthodes autres que celles décrites ici ne sont pas prises en charge et peuvent entraîner des problèmes pendant les mises à jour et les mises à niveau vers les applications pilotées par modèle. Pour plus d’informations, voir Personnalisations non prises en charge plus loin dans cette rubrique.

Les personnalisations effectuées à l’aide de méthodes autres que celles décrites dans cet article ne sont pas prises en charge et peuvent entraîner des problèmes pendant les mises à jour et les mises à niveau vers des applications basées sur des modèles. Pour plus d’informations, consultez Personnalisations non prises en charge plus loin dans cet article.

Personnalisations à l’aide de Power Apps

Les articles techniques publiés sur Microsoft sites tels que celui-ci prennent en charge les rubriques qu’ils couvrent, mais ils peuvent ne pas prendre en charge la mise à niveau.

Les méthodes de personnalisation suivantes peuvent être utilisées pour produire des personnalisations entièrement prises en charge :

• Personnalisation dans Power Apps ou l’Explorateur de solutions. Pour plus d’informations, voir Présentation de la création d’une application pilotée par modèle
• Paramètres dans l’application Web. Pour plus d’informations, voir Administrer les applications pilotées par modèle.
• Services de reporting. Pour plus d’informations, voir le Guide de création de rapports et d’analyse pour les applications pilotées par modèle.

Personnalisations appliquées à l’aide de code

La documentation de ce site pour les développeurs, les articles techniques, l’exemple de code publié sur ce site, ainsi que les informations publiées par l’équipe de support des développeurs de Dataverse pour applications sont inclus dans la zone des personnalisations appliquées à l’aide de code. Les actions et niveaux spécifiques de prise en charge et de mise à niveau sont décrits ultérieurement dans cette rubrique.

JavaScript côté client

Vous pouvez utiliser JavaScript dans les applications pilotées par modèle dans trois zones :

• Gestionnaires d’évènements du script du formulaire : vous pouvez configurer les gestionnaires d’évènements de formulaire pour appeler les fonctions définies dans les ressources Web JavaScript.
• Commandes de la barre de commandes (ruban) : vous pouvez utiliser les éléments <CustomRule> ou <JavaScriptFunction> pour définir les actions qui appellent les fonctions définies dans les ressources Web JavaScript.
• Ressources Web et IFRAMEs : vous pouvez utiliser les ressources Web JavaScript dans les ressources Web HTML. IFRAMES configuré pour autoriser les scripts intersite ou les scripts au sein de ressources web HTML incluses dans un formulaire, peuvent interagir avec les méthodes documentées Xrm.Page dans Xrm.Utility le formulaire via la référence parente.

Toutes les interactions avec les pages d’application doivent utiliser uniquement les méthodes documentées dans la référence de l’API cliente pour les applications basées sur des modèles. L’accès direct au dom (Document Object Model) d’une page d’applications basées sur des modèles n’est pas pris en charge. N’utilisez pas jQuery dans les scripts de formulaire et les commandes. Pour plus d’informations, consultez Script client dans les applications basées sur des modèles à l’aide de JavaScript.

Vous pouvez ouvrir des formulaires d’applications basées sur des modèles, des vues, des dialogues et des rapports à l’aide des méthodes documentées dans Les formulaires Ouverts, les vues, les dialogues et les rapports avec une URL.

Personnalisation du ruban

Vous pouvez utiliser RibbonDiffXml pour ajouter, supprimer ou masquer des éléments du ruban. Vous pouvez réutiliser les commandes du ruban définies par les applications basées sur des modèles ; toutefois, Microsoft se réserve le droit de modifier ou de déprécier les commandes disponibles. Vous ne pouvez pas réutiliser les fonctions JavaScript définies dans les commandes du ruban.

Personnalisations non prises en charge

Les modifications apportées aux applications basées sur des modèles que vous effectuez sans utiliser les méthodes décrites dans cette documentation ou les outils Power Apps ne sont pas pris en charge. Les mises à jour ou mises à niveau des applications basées sur des modèles ne conservent pas ces modifications. Tout ce qui n’est pas documenté dans cette documentation et les documents de prise en charge n’est pas pris en charge. Les modifications non prises en charge peuvent entraîner des problèmes lorsque vous effectuez une mise à jour via l’ajout de correctifs chauds ou de service packs ou la mise à niveau d’applications basées sur des modèles.

La liste suivante inclut des types d’actions non pris en charge qui sont fréquemment interrogés sur :

• Réutilisation de n’importe quel code JavaScript pour les applications basées sur des modèles. Ce code peut changer ou être remplacé pendant une mise à niveau.

• La modification d’un fichier de solutions pour modifier tout composant de solution autre que les rubans, formulaires, SiteMap ou demandes sauvegardées n’est pas prise en charge. Pour plus d’informations, voir Quand modifier le fichier de personnalisations.

  • La définition de nouveaux composants de solution en modifiant le fichier de solutions n’est pas prise en charge.
  • La modification des fichiers de ressources web exportés avec une solution n’est pas prise en charge.
  • À l’exception des étapes documentées dans Gérer les solutions managées, la modification du contenu d’une solution managée n’est pas prise en charge.

• L’affichage d’un formulaire dans un IFrame incorporé dans un autre formulaire n’est pas pris en charge.

Voir aussi

Personnalisations prises en charge pour Dataverse
Appliquer la logique métier en utilisant le script client dans les applications basées sur un modèle avec Javascript
Personnaliser les commandes et le ruban
Ressources Web des applications pilotées par modèle