Exporter, préparer à modifier et importer le ruban

Note

Cette rubrique concerne les commandes classiques.

Il existe une nouvelle façon de définir les commandes. Voir Vue d’ensemble du commandement moderne (Version préliminaire)

Cet article explique comment modifier le ruban dans les applications basées sur des modèles en exportant une solution, en préparant et en modifiant son code XML, puis en important et en publiant les personnalisations. Suivez ce processus pour appliquer les modifications du ruban avec succès :

  1. Exporter le ruban
  2. Préparer à modifier le fichier XML
  3. Modifier <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 cette option peut représenter une grande quantité de données. Utilisez une solution non managée existante ou créez une solution.

Créer une solution ou modifier une solution existante

Suivez les instructions de Créer une solution ou connectez-vous à Power Apps et sélectionnez Solutions dans le volet de navigation gauche. Sélectionnez la solution non managée que vous souhaitez modifier.

Si vous souhaitez modifier le ruban pour des tables spécifiques, ajoutez ces tables à la solution. Pour modifier les rubans de tableau, vous n’avez pas besoin d’inclure les composants requis. Si vous envisagez d’exporter cette solution et de l’appliquer à un autre système, incluez les composants requis.

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

Exporter le ruban

  1. Suivez les instructions de l’exportation d’une solution pour télécharger une solution non managée.
  2. Cliquez avec le bouton droit sur le fichier .zip compressé que vous avez téléchargé et sélectionnez Extraire tout… .
  3. Sélectionnez un emplacement d’extraction des fichiers, puis sélectionnez Extraire.
  4. Modifiez le fichier customizations.xml.

Préparer à modifier le fichier XML

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

Importer le ruban

  1. Après avoir modifié le customization.xml fichier, sélectionnez le dossier qui contient le fichier.

  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 Compresser vers..., puis sélectionnez Fichier ZIP.

    Note

    Cette étape crée un fichier .zip compressé dans le même dossier. Le nom du fichier peut varier, mais il est identique à l’un des autres fichiers du dossier, sauf qu’il a une extension de nom de fichier .zip.

  3. Suivez les instructions dans Importer une solution.

  4. Une fois que vous avez correctement importé votre solution, vous devez publier des personnalisations avant de voir les modifications. Dans le menu de la liste des solutions, sélectionnez Publier toutes les personnalisations.

Résoudre les erreurs d’importation du ruban

  1. Si vous recevez une notification indiquant que les erreurs ont provoqué l’échec de l’importation, sélectionnez Exporter le journal.

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

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

    Astuce

    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 un LocLabel qui a été référencé quelque part. Il peut y avoir un caractère vide supplémentaire à la fin d’un paramètre XML référençant un autre élément. Toutes les références doivent correspondre exactement.

  4. Après avoir corrigé l’erreur, suivez les étapes pour réimporter le ruban.

Résoudre les problèmes liés au ruban

Si vous rencontrez un problème avec un bouton de barre de commandes du ruban, utilisez les articles suivants dans le guide de résolution des problèmes pour rechercher et résoudre le problème.

Voir aussi

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