Créer ou modifier des ressources Web pour étendre une application

  • Article

Cette rubrique s’applique à Dynamics 365 Customer Engagement (on-premises). Pour la version Power Apps de cette rubrique, consultez : Créer ou modifier des ressources Web d’application pilotée par modèle pour étendre une application

Les ressources Web sont généralement utilisées par les développeurs pour étendre une application à l’aide fichiers utilisés dans la programmation Web. Les utilisateurs d’application doivent éventuellement gérer les ressources Web fournies par un développeur ou un concepteur.

Astuce

Pour consulter une discussion approfondie sur les ressources web, voir Ressources Web pour Customer Engagement.

Qu’est-ce qu’une ressource Web ?

Les ressources Web sont des fichiers virtuels stockés dans le système. Chaque ressource Web a un nom unique qui peut être utilisé dans une URL pour récupérer le fichier. Pensez à elles de cette façon : si vous aviez accès au serveur Web exécutant l’application, vous pourriez copier les fichiers vers ce site Web. Mais avec la plupart des services en ligne, vous ne pouvez pas faire cela. Vous pouvez plutôt utiliser les ressources Web pour télécharger des fichiers vers le système, puis les référencer en leur donnant un nom, comme si vous les aviez copiés en tant que fichiers vers le serveur Web.

Par exemple, si vous créez une page HTML en tant que ressource Web nommée « new_myWebResource.htm », vous pouvez ouvrir cette page dans un navigateur en utilisant une URL comme suit :

<URL Dynamics 365 Customer Engagement (on-premises)>/WebResources/new_myWebResource.htm

où <URL de l’application> représente l’URL que vous utilisez habituellement pour ouvrir l’application. Comme la ressource Web représente des données dans le système, seuls les utilisateurs bénéficiant d’une licence pour votre organisation peuvent y accéder de cette façon. Généralement, les ressources Web sont incluses dans des formulaires, plutôt que référencées directement. La pratique la plus courante consiste à fournir des bibliothèques JavaScript pour les scripts de formulaire.

Comme les ressources Web représentent des données dans le système et qu’elles sont sensibles aux solutions, vous pouvez les déplacer dans différentes organisations en les exportant à l’intérieur d’une solution et en important la solution dans une autre organisation.

Créer et modifier des ressources Web

  1. Ouvrez l’Explorateur de solutions, puis sélectionnez Ressources Web.

  2. Sous Composants, choisissez Ressources Web.

  3. Pour créer une ressource Web, choisissez Nouveau.

    Pour modifier une ressource Web, double-cliquez sur la ressource Web que vous souhaitez modifier.

  4. Le formulaire de ressource Web comporte les champs et fonctionnalités suivants :

    Étiquette Description
    Nom Obligatoire. Nom unique de la ressource Web. Vous ne pouvez pas le modifier après avoir enregistré la ressource Web.

    Ce nom peut uniquement inclure des lettres, des chiffres, des points et des caractères barre oblique (« / ») non consécutifs.

    Le préfixe de personnalisation de l’éditeur de solutions est ajouté au nom de la ressource Web.
    Nom complet Nom qui s’affiche si vous affichez une liste de ressources Web.
    Description Description de la ressource Web.
    Type Obligatoire. Type de la ressource Web. Vous ne pouvez pas le modifier après avoir enregistré la ressource Web.
    Éditeur de texte Lorsque le type de la ressource Web représente une sorte de fichier texte, sélectionnez ce bouton pour ouvrir une page afin de modifier le contenu à l’aide de l’éditeur de texte.
    Langue Permet de sélectionner une langue. Cette option référence uniquement l’enregistrement qui stocke les données de la ressource Web. Il ne modifie pas le comportement de la ressource Web.
    Télécharger le fichier Cliquez sur le bouton Parcourir pour choisir un fichier à télécharger en tant que ressource Web.

    Vous pouvez télécharger un fichier lorsque vous créez une nouvelle ressource Web ou remplacer une ressource Web existante.

    L’extension de nom du fichier doit correspondre aux extensions autorisées.

    Par défaut, la taille maximale d’un fichier pouvant être téléchargé en tant que ressource Web est de 5 Mo. Cette valeur peut être modifiée dans Dynamics 365 Customer Engagement (on-premises) via Paramètres système> onglet Courrier électronique>Définir la limite de la taille de fichier pour les pièces jointes. Pour plus d’informations, voir Boîte de dialogue Paramètres du système – onglet Courrier électronique.
    URL Après avoir enregistré la ressource Web, l’URL de la ressource Web est affichée ici. Sélectionnez ce lien pour afficher la ressource Web dans votre navigateur.

  5. Après avoir ajouté les modifications, choisissez Enregistrer, puis Publier.

Note

La publication des personnalisations peut interférer avec le fonctionnement normal du système. Nous vous recommandons de publier les personnalisations au moment le moins gênant pour les utilisateurs.

Utiliser l’éditeur de texte à bon escient

L’éditeur de texte fourni dans l’application pour les ressources Web doit uniquement être utilisé pour des modifications simples de fichiers texte. Vous pouvez l’utiliser pour créer et modifier des ressources Web HTML, mais vous devez uniquement modifier des ressources Web HTML qui ont été créées à l’aide de l’éditeur de texte. L’éditeur de texte est conçu pour du contenu HTML très simple. Si le contenu d’une ressource Web HTML n’a pas été créé à l’aide de l’éditeur de texte, n’utilisez pas l’éditeur de texte pour le modifier.

L’éditeur de texte utilise un contrôle qui modifie la source HTML de manière à permettre sa modification. Ces modifications sont susceptibles de modifier le comportement de la page dans le navigateur et d’arrêter le fonctionnement de code plus sophistiqué. Si vous ouvrez une ressource Web HTML avec l’éditeur de texte et l’enregistrez sans avoir apporté de modifications, vous risquez d’endommager certaines ressources Web HTML.

Nous recommandons d’utiliser un éditeur externe pour modifier les fichiers texte, puis de les enregistrer localement avant de les télécharger à l’aide du bouton Charger le fichier. De cette façon vous pouvez conserver une copie de la ressource Web, si vous devez revenir à une version antérieure. Il est possible d’utiliser un éditeur simple comme le Bloc-notes, mais l’utilisation d’un éditeur de texte avec des fonctionnalités plus avancées est fortement recommandée. Visual Studio Express est gratuit et propose des fonctionnalités puissantes pour modifier les fichiers utilisés par des ressources Web textuelles.

Créer et modifier une ressource Web dans un formulaire

Vous pouvez ajouter ou modifier des ressources Web dans un formulaire pour le rendre plus attrayant ou utile aux utilisateurs. Assurez-vous de disposer du rôle de sécurité Administrateur système ou de privilèges équivalents.

Note

Vous ne pouvez pas inclure une ressource Web dans un en-tête et un pied de page de formulaire.

  1. Ouvrez l’explorateur de solutions.

  2. Sous Composants, développez Entités, puis développez l’entité que vous voulez utiliser.

  3. Sélectionnez Formulaires, dans la liste, recherchez un formulaire de type Principal, puis double-cliquez ou appuyez deux fois sur l’entrée pour ouvrir et modifier le formulaire.

  4. Pour ajouter une ressource Web, sélectionnez l’onglet (par exemple, Général ou Notes) que vous souhaitez insérer, puis sous l’onglet Insérer, sélectionnez Ressource Web.
    -OU-
    Pour modifier une ressource Web, sélectionnez un onglet de formulaire et la ressource Web à modifier, puis sous l’onglet Accueil, sélectionnez Modifier les propriétés.

  5. Dans la boîte de dialogue Ajouter une ressource Web ou Propriétés de la ressource Web, sous l’onglet Général, entrez les informations appropriées dans les champs obligatoires. Prenez particulièrement note des informations suivantes :

    • Dans la zone Ressource Web, sélectionnez la ressource Web image, HTML ou Silverlight que vous voulez utiliser

      Note

      Après avoir spécifié une ressource Web, la section Propriétés de la ressource Web apparaît en bas de cet onglet, fournissant des options qui varient selon le type de ressource Web que vous ajoutez. Ces options comprennent la spécification de paramètres personnalisés, le passage d’un code d’enregistrement de type objet en tant que paramètre, ou la spécification de texte de remplacement qui décrit la ressource ou, pour les images, qui rend l’image accessible à tous les utilisateurs. Voici quelques propriétés importantes. Pour obtenir la liste complète, voir : Propriétés de la ressource Web. - Dans la zone Nom, saisissez un nom unique pour le champ. Ce nom n’accepte que les caractères alphanumériques et les traits de soulignement.

    • Le champ Étiquette est renseigné automatiquement avec une variation du nom spécifié, mais garantit que l’étiquette proposée répond à vos besoins ou les met à jour en conséquence.

  6. Sous l’onglet Mise en forme, les options qui s’affichent varient selon le type de ressource Web insérée. Ces options comprennent la spécification du nombre de colonnes et de lignes affichées, si une bordure s’affiche, ainsi que le comportement de défilement.

  7. Si l’onglet Dépendances s’affiche dans la boîte de dialogue Ajouter une ressource Web ou Propriétés de la ressource Web, dans la liste Champs disponibles, sélectionnez les champs requis par la ressource Web, sélectionnez le bouton Ajouter les enregistrements sélectionnés pour déplacer les champs sélectionnés vers la liste Champs dépendants, puis sélectionnez OK pour fermer la boîte de dialogue.

  8. Lorsque la modification du formulaire est terminée, sous l’onglet Accueil, sélectionnez Enregistrer et fermer pour fermer le formulaire. Pour afficher un aperçu de la façon dont le formulaire principal s’affichera et dont les événements se produiront :

    • Sous l’onglet Accueil, sélectionnez Aperçu, puis sélectionnez Créer un formulaire, Formulaire de mise à jour ou Formulaire en lecture seule.
    • Pour fermer le formulaire Aperçu, dans le menu Fichier, cliquez sur Fermer.

  9. Une fois vos personnalisations terminées, publiez-les :

    • Pour publier les personnalisations uniquement pour le composant en cours de modification, dans le volet de navigation, sélectionnez l’entité que vous utilisiez, puis sélectionnez Publier.
    • Pour publier les personnalisations de tous les composants non publiés en même temps, dans le volet de navigation, sélectionnez Entités, puis, dans la barre d’outils Actions, sélectionnez Publier toutes les personnalisations.

Ajouter ou modifier une ressource Web d’image

Les ressources Web sont des fichiers virtuels dans plusieurs formats, tels que des fichiers HTML, des applications JavaScript et Silverlight, stockés dans le système et qui peuvent être récupérés avec une adresse URL unique.

  1. Ouvrez l’explorateur de solutions.

  2. Pour créer une ressource Web, sélectionnez Composants>Ressources Web, puis dans la barre d’outils Actions, sélectionnez Nouveau.

  3. Saisissez ou modifiez les informations dans les zones de texte.

    • Le nom entré dans la zone de texte Nom et l’extension de fichier deviendront le nom du fichier.

    • Le nom entré dans la zone de texte Nom complet sera affiché dans Nom complet.

    • Dans la zone de la liste déroulante Type, sélectionnez le type de fichier de votre choix.

  4. Sélectionnez Parcourir pour sélectionner et télécharger le fichier depuis votre ordinateur local.

    • Pour afficher l’aperçu d’une ressource Web image téléchargée : sélectionnez Ressource Web>Aperçu.

    • Pour modifier une ressource Web texte : sélectionnez Éditeur de texte.

    • Pour afficher une ressource Web texte : sélectionnez Ressource Web>Aperçu.

  5. Lorsque vous êtes prêt à sauvegarder vos données, sélectionnez Enregistrer et fermer.

  6. Publiez votre personnalisation.

    • Uniquement pour le composant modifié : sélectionnez Enregistrer>Publier dans Accueil.

    • Pour tous les composants non publiés en même temps, sélectionnez Publier toutes les personnalisations.

Note

L’installation de personnalisations de la solution ou de la publication peuvent compromettre le fonctionnement normal du système. Nous vous recommandons de planifier l’importation d’une solution au moment le moins perturbant pour les utilisateurs.

Voir aussi

Propriétés de la ressource Web
Créer et concevoir des formulaires
Mise en route de la personnalisation
Ressources web pour Customer Engagement