Se familiariser avec la personnalisation des applications pilotées par modèle à l’aide de code

  • Article

Vous pouvez personnaliser les applications pilotées par modèle à l’aide des outils qui sont disponibles dans le portail Power Apps ou qui sont décrits dans la documentation. Ces personnalisations sont prises en charge et peuvent être 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 rubriques couvertes dans les articles techniques publiés sur les sites Microsoft tels que celui-ci sont prises en charge, mais peuvent ne pas être mises à niveau.

Personnalisations à l’aide de Power Apps

Vous pouvez utiliser divers outils fournis avec les applications pilotées par modèle pour les personnaliser. Les personnalisations effectuées via les outils des applications pilotées par modèle sont entièrement prises en charge et peuvent être intégralement mises à jour.

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

Notes

Le comportement des applications pilotées par modèle dépend des personnalisations appliquées à la solution Microsoft Dataverse associée. Pour plus d’informations, voir : Personnalisations prises en charge pour Dataverse Totalement pris en charge signifie que le support de développeur peut fournir de l’aide pour les personnalisations et que le support d’application peut aider les clients à exécuter ces modifications.

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. Les IFRAMES configurés pour autoriser les scripts inter-sites au sein des ressources Web HTML comprises dans un formulaire peuvent interagir avec les méthodes Xrm.Page ou Xrm.Utility documentées dans le formulaire via la référence parente.

Toutes les interactions avec les pages d’application doivent être exécutées uniquement via les méthodes documentées dans la Référence de l’API client pour les applications pilotées par modèle. L’accès direct du Modèle d’objet de document (DOM) de toute page d’application pilotée par modèle n’est pas pris en charge. Nous ne vous recommandons pas d’utiliser jQuery dans les scripts de formulaire ni les commandes. Pour plus d’informations, voir : Création de scripts client dans les applications pilotées par modèle à l’aide de JavaScript.

Vous pouvez ouvrir les formulaires, vues, boîtes de dialogue et rapports des applications pilotées par modèle à l’aide des méthodes documentées dans Ouvrir des formulaires, des vues, des dialogues et des rapports avec une URL.

Personnalisation du ruban

L’utilisation de RibbonDiffXml pour ajouter, supprimer ou masquer des éléments du ruban n’est pas prise en charge. Une réutilisation des commandes du ruban définies par les applications pilotées par modèle est prise en charge ; toutefois, nous nous réservons le droit de modifier ou de désapprouver les commandes disponibles. Une réutilisation des fonctionnalités JavaScript définies dans les commandes du ruban n’est pas prise en charge.

Personnalisations non prises en charge

Les modifications apportées aux applications pilotées par modèle sans utiliser les méthodes décrites dans cette documentation ou les outils Power Apps ne sont pas prises en charge et ne sont pas conservées pendant les mises à jour ou les mises à niveau des applications pilotées par modèle. Tout élément non documenté dans cette documentation et les documents de support n’est pas pris en charge. En outre, les modifications non prises en charge pourraient causer des problèmes lorsque vous mettez à jour via l’ajout de correctifs ou de service packs ou mettez à niveau les applications pilotées par modèle.

La liste qui suit répertorie les types d’action non prise en charge faisant l’objet de questions fréquentes :

  • Réutilisation de tout code JavaScript des applications pilotées par modèle. Ce code peut être modifié ou remplacé lors d’une mise à niveau.

  • La modification d’un fichier de solutions pour modifier tout composant de solution autre que les rubans, formulaires, plans de site 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 Maintenir les solutions gérées, la modification du contenu d’une solution gérée n’est pas prise en charge.

  • L’affichage d’un formulaire dans un IFrame imbriqué 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

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é).