Procédure pas à pas : ajout d’un groupe au 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’un nouveau composant fonctionnel
Définition de l’action personnalisée
Déploiement de la personnalisation

Cette rubrique indique comment ajouter un nouveau groupe au Ruban serveur dans Microsoft SharePoint Foundation. Pour ajouter un groupe, vous identifiez sur le Ruban l’onglet où le groupe apparaîtra. En outre, vous définissez les contrôles dans le groupe, ainsi que la façon dont celui-ci les affichera. La procédure suivante ajoute un nouveau groupe à l’onglet Page d’un site Web.

Conditions requises

Microsoft SharePoint Foundation 2010

Outils de développement SharePoint dans Microsoft Visual Studio 2010

Création d’un projet SharePoint

Pour ajouter un nouveau groupe, vous commencez par créer un projet SharePoint vide.

Pour créer un projet SharePoint

Démarrez 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 AjouterUnGroupeAuRuban comme nom de projet. Cliquez sur OK.
Dans l’Assistant Personnalisation de SharePoint, choisissez Déployer en tant que solution bac à sable (sandbox). Cliquez sur Terminer.

Ajout d’un nouveau composant fonctionnel

Vous personnalisez le Ruban par le biais de l’utilisation d’un composant fonctionnel. Les étapes suivantes permettent d’ajouter un nouveau composant fonctionnel à votre solution.

Pour ajouter un nouveau composant fonctionnel

Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Fonctionnalités et choisissez Ajouter une fonctionnalité.
Affectez au composant fonctionnel le titreGroupe de Ruban personnalisé.
Cliquez avec le bouton droit sur Fonctionnalité1 dans l’Explorateur de solutions et choisissez Renommer. Tapez GroupeRubanPersonnalisé comme nouveau nom.
Cliquez avec le bouton droit sur le projet AjouterUnGroupeAuRuban dans l’Explorateur de solutions et choisissez Ajouter, puis Nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, choisissez le modèle Élément vide. Entrez GroupeRubanPersonnalisé comme nom.

Définition de l’action personnalisée

Le groupe du Ruban est défini à l’aide du code XML du Ruban dans une action personnalisée. Cela permet d’identifier l’emplacement futur du groupe sur le Ruban. 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.

Copiez et collez la syntaxe XML suivante dans le fichier Elements.xml. Cette syntaxe XML ajoute un nouveau groupe Custom comportant deux boutons sous l’onglet Page d’un site Web.

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.WikiPageTab.CustomGroup" 
    Location="CommandUI.Ribbon">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition 
          Location="Ribbon.WikiPageTab.Groups._children">
          <Group 
            Id="Ribbon.WikiPageTab.CustomGroup" 
            Sequence="55" 
            Description="Custom Group" 
            Title="Custom" 
            Command="EnableCustomGroup" 
            Template="Ribbon.Templates.Flexible2">
            <Controls Id="Ribbon.WikiPageTab.CustomGroup.Controls">
              <Button 
                Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupHello" 
                Command="CustomGroupHelloWorld" 
                Image16by16="Insert an image URL here." 
                Image32by32="Insert an image URL here." 
                LabelText="Hello, World" 
                TemplateAlias="o2" 
                Sequence="15" />
              <Button 
                Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupGoodbye" 
                Command="CustomGroupGoodbyeWorld" 
                Image16by16="Insert an image URL here." 
                Image32by32="Insert an image URL here." 
                LabelText="Good-bye, World" 
                TemplateAlias="o2" 
                Sequence="18" />
            </Controls>
          </Group>
        </CommandUIDefinition>
        <CommandUIDefinition 
          Location="Ribbon.WikiPageTab.Scaling._children">
          <MaxSize 
            Id="Ribbon.WikiPageTab.Scaling.CustomGroup.MaxSize" 
            Sequence="15" 
            GroupId="Ribbon.WikiPageTab.CustomGroup" 
            Size="LargeLarge" />
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler 
          Command="EnableCustomGroup"
          CommandAction=”javascript:return true;” />
        <CommandUIHandler 
          Command="CustomGroupHelloWorld" 
          CommandAction="javascript:alert('Hello, world!');" />
        <CommandUIHandler 
          Command="CustomGroupGoodbyeWorld" 
          CommandAction="javascript:alert('Good-bye, world!');" />
      </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 à la page d’accueil de votre site ou sous-site.
Cliquez sur l’onglet Page, recherchez le groupe Custom, puis cliquez sur les boutons Hello, World ou Good-bye, World.

Partager via