Modifier le plan du site

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Vous pouvez modifier des plans de site par défaut ou spécifiques à une application avec l'une des méthodes suivantes :

• En utilisant le nouveau concepteur SiteMap présenté dans Mise à jour de décembre 2016 pour Dynamics 365 (en ligne et local) ou d'un éditeur de plan de site tiers si vous utilisez une version antérieure de Microsoft Dynamics 365.

• En mettant jour par programme l'enregistrement de l'entité SiteMap afin de mettre à jour le XML dans l'attribut SiteMap.SiteMapXml.

• En modifiant manuellement le XML dans le nœud SiteMap du fichier customizations.xml d'une solution non gérée exportée puis en important la solution en tant que solution gérée ou non gérée.

Contenu de la rubrique

Utiliser les éditeurs de plans de site

Mettre à jour le plan du site par programme

Modification manuelle de SiteMap

Modification avec une validation de schéma

Encoder le caractère &

Récupération après une erreur

Utiliser les éditeurs de plans de site

Si vous utilisez Mise à jour de décembre 2016 pour Dynamics 365 (en ligne et local), utilisez le nouveau concepteur SiteMap pour créer et gérer des plans de site.Pour plus d'informations :Créer un plan de site pour l'application

Sinon, vous pouvez utiliser l'un des éditeurs de plan de site tiers pour modifier le plan de site par défaut. Lorsque des plans de site spécifiques à une application sont introduits dans Mise à jour de décembre 2016 pour Dynamics 365 (en ligne et local), les éditeurs de plan de site tiers peuvent ne pas fonctionner comme prévu pour modifier des plans de site pour les applications d'entreprise. Un éditeur de plan de site populaires permettant de modifier les plans de site est inclus dans la Boîte à outils pour Dynamics CRM 2011/2013 publiée par le MVP de Microsoft Dynamics 365, Tanguy Touzard.

Bien que ces applications rationalisent le processus de modification du plan du site, elles nécessitent toujours que vous compreniez le schéma XML du plan du site. Pour plus d'informations, voir SiteMap XML reference.

Notes

Le support technique deMicrosoft Dynamics 365 n’est pas pris en charge pour les applications tierces. Si vous avez des questions concernant ces applications, contactez l’éditeur de l’application.

Mettre à jour le plan du site par programme

Extrayez l'enregistrement de l'entité SiteMap que vous souhaitez mettre à jour, puis mettez à jour le XML dans l'attribut SiteMap.SiteMapXml de l'enregistrement. Assurez-vous de comprendre le schéma XML du plan du site avant de modifier le XML. Pour plus d'informations, voir SiteMap XML reference.

Lorsque vous mettez à jour un enregistrement SiteMap par programme à l'aide de la méthode Update, le XML du plan de site que vous spécifiez remplace le XML existant dans l'attribut SiteMap.SiteMapXml de l'enregistrement.

Notes

• Vous pouvez également créer et supprimer par programme l'enregistrement SiteMap spécifique à l'application. Pour créer un enregistrement SiteMap spécifique à l'application, vous devez définir les valeurs des attributs suivants sur le minimum : SiteMap.SiteMapNameUnique et SiteMap.SiteMapXml. Toutefois, plutôt que de créer et de supprimer par programme des plans de site spécifiques à l'application, nous vous conseillons d'utiliser le nouveau concepteur SiteMap pour créer et supprimer les plans de site spécifiques à l'application.Pour plus d'informations :Créer un plan de site pour l'application

• Vous ne pouvez pas créer et supprimer par programme l'enregistrement SiteMap par défaut. Vous pouvez utiliser l'attribut SiteMap.IsAppAware pour différencier les deux types de plans de site : 0 indique le plan de site par défaut ; 1 indique le plan de site propre à l'application.

Modification manuelle de SiteMap

Vous pouvez modifier manuellement le nœud SiteMap dans le fichier customizations.xml d'une solution non gérée exportée puis le réimporter dans Dynamics 365 pour mettre le plan du site à jour. La mise à jour de l'enregistrement SiteMap dépend du fait que vous importez une solution non gérée ou gérée.

• L'importation d'une solution non gérée remplace le plan de site XML existant dans l'enregistrement SiteMap.

• L'importation d'une solution gérée crée un enregistrement SiteMap avec les modifications les plus récentes et la valeur d'attribut SiteMap.OverwriteTime de l'enregistrement SiteMap le plus récent/actif est définie sur la valeur par défaut du champ DateTime (1900-01-01 00:00:00.000). La valeur de l'attribut SiteMap.OverwriteTime de l'enregistrement SiteMap existant est définie sur la valeur datetime lorsque celui-ci a été mis à jour.

Pour modifier le plan de site

1. Cliquez sur Paramètres, sur Personnalisation, puis sur Solutions.

2. Ajoutez des plans de site par défaut ou spécifiques à une application à une nouvelle solution ou à une solution existante non gérée. Dans la solution, sélectionnez Extensions client dans la liste Composants à gauche. Sélectionnez Ajouter existant, puis Plan de site. Dans la liste de plans de site :

   • Pour ajouter le plan de site par défaut, sélectionnez Site Map.

   • Pour ajouter un plan de site spécifique à une application, sélectionnez un plan de site d'applications d'entreprise personnalisé . La boîte de dialogue affiche des plans de site pour toutes les applications d'entreprise personnalisées auxquelles vous avez accès. Par exemple, dans ce cas, vous pouvez sélectionner Contoso Sales App ou Contoso Service App.

     

     Notes

     Les plans de site spécifiques à des applications s'affichent uniquement si vous avez Mise à jour de décembre 2016 pour Dynamics 365 (en ligne et local) ou une version ultérieure et qui possèdent des applications d'entreprise personnalisées dans votre instance de Dynamics 365. Vous pouvez également sélectionner plusieurs plans de site spécifiques à des applications et le plan de site par défaut à ajouter à la même solution.

   • Cliquez sur OK sur l'écran Sélectionner les composants de solution.

3. Cliquez sur Enregistrer pour enregistrer vos modifications dans votre solution.

4. Cliquez sur Exporter la solution et suivez les étapes de l'assistant d'exportation de solution pour exporter la solution.

5. Une fois la solution exportée, extrayez les fichiers du fichier .zip compressé.

   Conseil

   Conservez le fichier compressé .zip comme sauvegarde.

6. Dans le fichier customizations.xml, recherchez le :

   • nœud SiteMap sous ImportExportXml/SiteMap pour modifier le plan de site par défaut.

   • nœud SiteMap sous ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap pour modifier le plan de site spécifique à l'application.

     Conseil

     Si vous avez ajouté plusieurs plans de site spécifiques à des applications au sein d'une solution avant d'exporter la solution, vous pouvez utiliser les nœuds SiteMapUniqueName et SiteMapName sous ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap pour déterminer le nœud SiteMap dans le fichier customizations.xml que vous devez modifier pour votre plan de site d'application.

7. Modifiez le nœud SiteMap si nécessaire.

   Notes

   Il est beaucoup plus facile d’éditer des fichiers XML si vous utilisez un éditeur qui fournit la validation du schéma. Pour plus d'informations, voir Modification avec une validation de schéma.

8. Créez un fichier .zip compressé comprenant les fichiers de solutions extraits, ainsi que votre fichier customizations.xml modifié.

   Conseil

   Dans Explorateur Windows, sélectionnez tous les fichiers. Cliquez ensuite avec le bouton droit et sélectionnez Envoyer vers, puis Dossier compressé (zippé).

9. Importez le nouveau fichier de solutions.

   1. Dans Microsoft Dynamics 365, cliquez sur Paramètres, sur Personnalisation, puis sur Solutions.

   2. Cliquez sur Importer.

   3. Cliquez sur Parcourir, localisez votre fichier de solutions .zip modifié, cliquez sur Suivant, puis sur Importer.

   4. Quand l’importation est terminée, cliquez sur Fermer.

10. Publier les personnalisations

    Conseil

    Si les modifications ne s'affichent pas immédiatement, actualisez votre page de navigateur.

Modification avec une validation de schéma

Pour une meilleure expérience, modifiez le fichier customizations.xml avec une application qui peut utiliser la validation de schéma pour assurer la prise en charge de IntelliSense. Pour plus d'informations, voir Modifier le fichier XML des personnalisations avec une validation de schéma.

Encoder le caractère &

Lorsque vous ajoutez une URL au plan de site qui inclut le caractère esperluette (&), vous devez l’encoder en le remplaçant par « & ». La validation XML échoue si vous n’encodez pas ce caractère et vous ne pourrez pas importer la solution. Par exemple :

• Correct :
  <SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&amp;parameter2=value ">

• Incorrect :
  <SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&parameter2=value">

Récupération après une erreur

L’outil d’importation de solution effectue des validations sur le plan de site. Le cas échéant, le plan de site par défaut est appliqué et un message d’erreur s’affiche. Vous devez corriger les erreurs dans le plan de site et le réimporter. Toutefois, il est encore possible que certaines erreurs se produisent.

Certaines erreurs que vous pouvez rencontrer lorsque vous exécutez une application d'entreprise personnalisée après avoir manuellement modifié/importé le plan de site d'application d'entreprise personnalisée sont les suivantes :

• Plan de site sans sous-zone

• Le plan de site comporte des sous-zones, mais ne dispose pas des privilèges pour les afficher

• Entité incorrecte (pas de raison sociale d'entité Dynamics 365)

• URL non valide

• Le plan de site dispose d'un nœud de tableau de bord, mais aucun tableau de bord n'est sélectionné dans la définition d'application commerciale modulaire

Voir aussi

Personnaliser les plans de site
Modifier la navigation dans l’application à l’aide du plan de site
Transmettre les paramètres vers une URL à l’aide du plan de site
Contrôler l'accès au site Aide et formation
SiteMap XML reference
SiteMap schema

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright