Procédure pas à pas : remplacement d’un bouton sur le Ruban serveur

Article
09/24/2014

Dernière modification : lundi 7 février 2011

S’applique à : SharePoint Foundation 2010

Dans cet article
Création d’un projet SharePoint
Ajout d’une nouvelle fonctionnalité
Définition de l’action personnalisée
Déploiement de la personnalisation

Cette rubrique indique comment remplacer un bouton sur le Ruban serveur dans Microsoft SharePoint Foundation.

Conditions requises

Microsoft SharePoint Foundation 2010

Outils de développement SharePoint dans Microsoft Visual Studio 2010

Création d’un projet SharePoint

Pour personnaliser le Ruban, vous commencez par créer un projet SharePoint vide.

Pour créer un projet SharePoint

Démarrez Microsoft Visual Studio 2010.
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.
Dans Types de projets, sous Visual Basic ou C#, sélectionnez Projet SharePoint vide.
Tapez RemplacerUnBoutonDeRuban en guise de nom de projet, puis cliquez sur OK.
Dans l’Assistant Personnalisation de SharePoint, sélectionnez Déployer en tant que solution bac à sable (sandbox), puis cliquez sur Terminer.

Ajout d’une nouvelle fonctionnalité

Vous personnalisez le Ruban à l’aide d’une fonctionnalité. Les étapes suivantes permettent d’ajouter une nouvelle fonctionnalité à votre solution.

Pour ajouter un nouveau Composant fonctionnel

Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Fonctionnalités, puis cliquez sur Ajouter une fonctionnalité.
Affectez au Composant fonctionnel le titreRemplacer un bouton de Ruban.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Fonctionnalité1, puis sélectionnez Renommer. Tapez RemplacerUnBoutonDeRuban en tant que nouveau nom.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet RemplacerUnBoutonDeRuban, pointez sur Ajouter, puis sélectionnez Nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez le modèle Élément vide. Tapez RemplacerUnBoutonDeRuban en tant que nom.

Définition de l’action personnalisée

Vous remplacez le bouton de Ruban à l’aide de l’attribut Location de l’élément CommandUIDefinition. Les valeurs par défaut des boutons de Ruban sont répertoriées dans Emplacements des personnalisations du Ruban serveur par défaut. Pour une explication détaillée du code XML du Ruban, voir XML du Ruban serveur.

Pour définir l’action personnalisée

Ouvrez le fichier Elements.xml.

Collez le code XML suivant dans le fichier Elements.xml. Ce code XML remplace le bouton Se connecter à Outlook de l’onglet Bibliothèque dans le groupe Se connecter et exporter pour une bibliothèque de documents.

Important

Vous devez remplacer les attributs Image32by32 et Image16by16 par des URL d’image valides.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <CustomAction Id="Ribbon.Library.Actions.ReplacementButton"
    Location="CommandUI.Ribbon"
    RegistrationId="101"
    RegistrationType="List"
    Title="Replace a Ribbon Button">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition
          Location="Ribbon.Library.Actions.ConnectToClient">
             <Button Id="Ribbon.Library.Actions.ConnectToClient.ReplacementButton"
               Command="ReplacementButtonCommand"
               Image16by16="Insert an image URL here."
               Image32by32="Insert an image URL here."
               LabelText="Replaced Button"
               TemplateAlias="o2" />
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler
          Command="ReplacementButtonCommand"
          CommandAction="javascript:alert('This button has been replaced.');" />
      </CommandUIHandlers>
    </CommandUIExtension>
  </CustomAction>
</Elements>

Déploiement de la personnalisation

Dans la mesure où le projet a été configuré en tant que solution en bac à sable (sandbox), il est déployé dans la galerie de solutions.

Pour déployer la personnalisation

Appuyez sur la touche F5. Les Outils de développement SharePoint dans Visual Studio 2010 génèrent et déploient automatiquement le Composant fonctionnel.
Accédez à une bibliothèque de documents dans votre site ou sous-site.
Cliquez sur l’onglet Bibliothèque ; dans le groupe Se connecter et exporter, vous pouvez constater l’absence du bouton Se connecter à Outlook.

Partager via