Exporter, préparer à modifier et importer le ruban

  • Article

 

Date de publication : janvier 2017

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

Pour modifier le ruban, vous devez effectuer les étapes suivantes :

  1. Exporter le ruban

  2. Préparer à modifier le fichier XML

  3. Modifier <RibbonDiffXml> (RibbonDiffXml)

  4. Importer le ruban

Exporter le ruban

Vous exportez le ruban en l’incluant dans une solution et en exportant la solution. Vous pouvez exporter toutes les personnalisations, mais cela peut représenter une grande quantité de données. Il est recommandé d’utiliser une solution non gérée existante ou d’en créer une.

Créer une solution

  1. Sur la barre de navigation, choisissez Microsoft Dynamics 365 > Paramètres.

  2. Accédez à Paramètres > Personnalisations.

  3. Accédez à Paramètres > Solutions.

  4. Cliquez ou appuyez sur Nouveau.

  5. Tapez un Nom complet et un Nom unique explicites, entrez un Éditeur et tapez un numéro de Version.

    Notes

    Vous pouvez généralement utiliser l’éditeur par défaut de l’organisation.

  6. Cliquez sur l’icône Enregistrer.

  7. Pour modifier le ruban pour des entités spécifiques :

    1. Cliquez sur Ajouter existant, puis sur Entité.

    2. Sélectionnez les entités à inclure dans la solution, puis cliquez sur OK.

      Notes

      Pour les besoins de modification des rubans d’entité, il n’est pas nécessaire d’inclure les composants obligatoires. Si vous envisagez d’exporter cette solution et de l’appliquer à un autre système, vous devez inclure les composants obligatoires.

  8. Pour modifier les rubans globaux ou ajouter un groupe personnalisé à toutes les entités, cliquez sur Ajouter existant, puis sur Rubans de l’application.

  9. Cliquez sur Enregistrer et fermer.

Utiliser une solution existante

  1. Sur la barre de navigation, choisissez Microsoft Dynamics 365 > Paramètres.

  2. Accédez à Paramètres > Personnalisations.

  3. Accédez à Paramètres > Solutions.

  4. Double-cliquez sur une solution pour l’ouvrir.

  5. Pour modifier le ruban pour des entités spécifiques :

    1. Cliquez sur Ajouter existant, puis sur Entité.

    2. Sélectionnez les entités à inclure dans la solution, puis cliquez sur OK.

      Notes

      Pour les besoins de modification des rubans d’entité, il n’est pas nécessaire d’inclure les composants obligatoires. Si vous envisagez d’exporter cette solution et de l’appliquer à un autre système, vous devez inclure les composants obligatoires.

  6. Pour modifier les rubans globaux, par exemple pour ajouter un bouton personnalisé à toutes les entités, cliquez sur Ajouter existant, puis sur Rubans de l’application.

  7. Cliquez sur Enregistrer et fermer.

Exporter le ruban

  1. Sur la barre de navigation, choisissez Microsoft Dynamics 365 > Paramètres.

  2. Accédez à Paramètres > Personnalisations.

  3. Accédez à Paramètres > Solutions.

  4. Sélectionnez la solution de votre choix, puis cliquez sur Exporter.

  5. Si vous avez apporté des modifications récentes qui n’ont pas encore été publiées, cliquez sur Publier toutes les personnalisations. Sinon, cliquez sur Suivant.

  6. Sélectionnez l’option Non géré, puis cliquez sur Exporter.

  7. Cliquez sur Enregistrer dans la boîte de dialogue Téléchargement du fichier, puis sur Ouvrir le fichier dans la boîte de dialogue Téléchargement terminé.

  8. Cliquez avec le bouton droit sur le fichier .zip compressé que vous avez téléchargé et sélectionnez Extraire tout… .

  9. Sélectionnez un emplacement d’extraction des fichiers, puis cliquez sur Extraire.

  10. Le fichier customizations.xml est le fichier que vous allez modifier.

Préparer à modifier le fichier XML

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

Importer le ruban

  1. Après avoir modifié le fichier customization.xml, dans Visual Studio ou Microsoft Visual Web Developer 2010 Express, cliquez avec le bouton droit sur l’onglet customization.xml et sélectionnez Ouvrir le dossier conteneur.

  2. Sélectionnez tous les fichiers ou dossiers inclus lorsque vous avez extrait la solution. Cliquez avec le bouton droit sur les fichiers sélectionnés, sélectionnez Envoyer vers, puis Dossier compressé (zippé).

    Notes

    Cela crée un fichier .zip compressé dans le même dossier. Le nom du fichier peut varier, mais il est identique aux autres fichiers du dossier, mais avec une extension de nom de fichier .zip.

  3. Sur la barre de navigation, choisissez Microsoft Dynamics 365 > Paramètres.

  4. Accédez à Paramètres > Personnalisations.

  5. Accédez à Paramètres > Solutions.

  6. Cliquez sur Importer.

  7. Cliquez sur Parcourir et recherchez le fichier .zip compressé créé à l’étape 2 de cette procédure.

  8. Cliquez sur Suivant, puis sur Importer.

  9. Une fois l’importation terminée, un message indiquant que l’importation s’est déroulée correctement s’affiche. Cliquez sur Fermer.

  10. Après avoir correctement importé votre solution, vous devez publier les personnalisations pour pouvoir voir les modifications. Dans la liste Solutions, cliquez sur Publier toutes les personnalisations.

Gestion des erreurs lors de l’importation

  1. Si vous recevez une notification indiquant que des erreurs ont causé l’échec de l’importation, cliquez sur Journal de l’exportation.

  2. Enregistrez le fichier journal d’exportation. Sélectionnez le fichier, puis cliquez dessus avec le bouton droit. Cliquez sur Ouvrir avec, puis sélectionnez Microsoft Office Excel.

  3. Sélectionnez la feuille de calcul Composants et notez les messages dans la colonne Texte d’erreur.

    Conseil

    Le type d’échec le plus courant est une erreur lors du référencement d’un élément dépendant dans RibbonDiffXml. Vous avez peut-être oublié d’inclure LocLabel qui a été référencé quelque part. Un caractère vide supplémentaire est peut-être inclus à la fin d’un attribut XML référençant un autre élément. Toutes les références doivent correspondre exactement.

  4. Après avoir corrigé l’erreur, effectuez les étapes pour importer à nouveau le ruban.

Voir aussi

Personnaliser les commandes et le ruban
Exporter les définitions du ruban
Utiliser les étiquettes localisées avec des rubans

Microsoft Dynamics 365

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