Tutorial: Agregar un grupo a la cinta de Server

Artículo
09/24/2014

Última modificación: lunes, 07 de febrero de 2011

Hace referencia a: SharePoint Foundation 2010

En este artículo
Crear un proyecto de SharePoint
Agregar una nueva característica
Definir la acción personalizada
Implementar la personalización

En este tema se describe cómo agregar un nuevo grupo a la Cinta de Server en Microsoft SharePoint Foundation. Para agregar un grupo, debe identificar la ficha de la cinta de opciones donde aparecerá el grupo. También debe definir los controles del grupo y decidir el modo en que el grupo los representará. Mediante el siguiente procedimiento se agrega un nuevo grupo a la ficha Página de un sitio web.

Requisitos previos

Microsoft SharePoint Foundation 2010

Herramientas de desarrollo de SharePoint en Microsoft Visual Studio 2010

Crear un proyecto de SharePoint

Para agregar un nuevo grupo, debe comenzar por la creación de un proyecto vacío de SharePoint.

Para crear un proyecto de SharePoint

Inicie Visual Studio 2010.
En el menú Archivo, elija Nuevo y, a continuación, haga clic en Proyecto.
En Tipos de proyecto, en Visual Basic o C#, seleccione Proyecto de SharePoint vacío.
Escriba AddARibbonGroup como el nombre del proyecto y, a continuación, haga clic en Aceptar.
En el Asistente para la personalización de SharePoint, seleccione Implementar como solución en espacio aislado y, a continuación, haga clic en Finalizar.

Agregar una nueva característica

Personalice la cinta de opciones mediante el uso de una característica. Los siguientes pasos agregan una nueva característica a la solución.

Para agregar una nueva característica

En el Explorador de soluciones, haga clic con el botón secundario en Características y, a continuación, seleccione Agregar característica.
Cambie el título de la característica a Custom Ribbon Group.
En el Explorador de soluciones, haga clic con el botón secundario en Feature1 y, a continuación, seleccione Cambiar nombre. Escriba CustomRibbonGroup como el nuevo nombre.
En el Explorador de soluciones, haga clic con el botón secundario en el proyecto AddARibbonGroup, elija Agregar y, a continuación, haga clic en Nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, seleccione la plantilla Elemento vacío. Escriba CustomRibbonGroup como el nombre.

Definir la acción personalizada

El grupo de la cinta de opciones se define mediante XML de la cinta de opciones en una acción personalizada. De este modo, se identifica dónde aparecerá el grupo en la cinta de opciones. Si desea obtener una explicación más detallada sobre el XML de la cinta de opciones, vea XML de la cinta de Server.

Para definir la acción personalizada

Abra el archivo Elements.xml.

Pegue el siguiente XML en el archivo Elements.xml. Este XML agrega un nuevo grupo Personalizado con dos botones en la ficha Página de un sitio web.

Importante
Debe reemplazar los atributos Image32by32 e Image16by16 con direcciones URL de imagen válidas.

<?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>

Implementar la personalización

Puesto que el proyecto se configuró como una solución de espacio aislado, se implementa en la galería de soluciones.

Para implementar la personalización

Presione F5. Herramientas de desarrollo de SharePoint en Visual Studio 2010 compilará e implementará automáticamente la característica.
Navegue a la página principal del sitio o subsitio.
Haga clic en la pestaña Página, busque el grupo Personalizado y haga clic en los botones Hello, World o Good-bye, World.

Share via