Procédure pas à pas : remplacement d’un bouton sur le Ruban serveur pour une collection de sites

Article
09/24/2014

Dernière modification : vendredi 4 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 illustre un remplacement d’un bouton au niveau de la collection de sites sur le Ruban serveur dans Microsoft SharePoint Foundation. Vous allez utiliser une action personnalisée avec l’emplacement ScriptLink pour ajouter le script ECMAScript (JavaScript, JScript) dans toutes les pages.

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, sélectionnez C#, puis Projet SharePoint vide.
Tapez RemplacerUnBoutonDeRubanAvecScriptLink comme nom de projet. Cliquez sur OK.
Dans l’Assistant Personnalisation de SharePoint, choisissez Déployer en tant que solution de batterie. Cliquez sur Terminer.

Ajout d’un nouveau Composant fonctionnel

Vous personnalisez le Ruban par le biais 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é.
Attribuez au Composant fonctionnel le titreRemplacer un bouton de Ruban avec ScriptLink.
Cliquez avec le bouton droit sur Fonctionnalité1 dans l’Explorateur de solutions et choisissez Renommer. Tapez RemplacerUnBoutonDeRubanAvecScriptLink comme nouveau nom.
Cliquez avec le bouton droit sur le projet RemplacerUnBoutonDeRubanAvecScriptLink 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 RemplacerUnBoutonDeRubanAvecScriptLink comme nom.

Définition de l’action personnalisée

Le bouton de Ruban est remplacé à 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.ConnectToClient"
    Location="CommandUI.Ribbon"
    RegistrationId="101"
    RegistrationType="List"
    Title="Custom ECMAScript Button">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition
          Location="Ribbon.Library.Actions.ConnectToClient">
          <Button Id="Ribbon.Library.Actions.ConnectToClient"
            Command="CustomECMAScriptCommand"
            Image16by16="Insert an image URL here."
            Image32by32="Insert an image URL here."
            LabelText="Hello World"
            TemplateAlias="o1" />
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler
          Command="CustomECMAScriptCommand"
          CommandAction="javascript:HelloWorld();" />
      </CommandUIHandlers>
    </CommandUIExtension>
  </CustomAction>
  <CustomAction Id="Ribbon.Library.Actions.NewButton.Script"
    Location="ScriptLink"
    ScriptBlock="
    function HelloWorld()
    {
      alert('Hello, world!');
    }" />
</Elements>

Déploiement de la personnalisation

Dans la mesure où le projet a été configuré en tant que solution de batterie de serveurs, il sera automatiquement déployé et les services Internet (IIS) seront réinitialisés.

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.