Tutorial: Reemplazar un botón en la cinta de Server para una colección de sitios

Artículo
09/24/2014

Última modificación: viernes, 04 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 muestra un reemplazo en el nivel de la colección de sitios de un botón de la Cinta de Server en Microsoft SharePoint Foundation. Se usa una acción personalizada con la ubicación ScriptLink para agregar ECMAScript (JavaScript, JScript) en todas las páginas.

Requisitos previos

Microsoft SharePoint Foundation 2010

Herramientas de desarrollo de SharePoint en Microsoft Visual Studio 2010

Crear un proyecto de SharePoint

Para personalizar la cinta de opciones, comience creando un proyecto de SharePoint vacío.

Para crear un proyecto de SharePoint

Inicie Microsoft Visual Studio 2010.
En el menú Archivo, elija Nuevo y, a continuación, haga clic en Proyecto.
En Tipos de proyecto, seleccione C# y, a continuación, seleccione Proyecto de SharePoint vacío.
Escriba ReplaceARibbonButtonUsingScriptLink 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 de granja de servidores 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 Replace a Ribbon Button Using ScriptLink.
En el Explorador de soluciones, haga clic con el botón secundario en Feature1 y, a continuación, seleccione Cambiar nombre. Escriba ReplaceARibbonButtonUsingScriptLink como el nuevo nombre.
En el Explorador de soluciones, haga clic con el botón secundario en el proyecto ReplaceARibbonButtonUsingScriptLink, elija Agregar y, a continuación, seleccione Nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, seleccione la plantilla Elemento vacío. Escriba ReplaceARibbonButtonUsingScriptLink como el nombre.

Definir la acción personalizada

El botón de la cinta de opciones se reemplaza mediante el atributo Location del elemento CommandUIDefinition. Los valores predeterminados de los botones de la cinta de opciones se enumeran en Ubicaciones predeterminadas de las personalizaciones de la cinta de Server. 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 reemplaza el botón Conectar con Outlook en la ficha Biblioteca del grupo Conectar y exportar de una biblioteca de documentos.

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

Implementar la personalización

Dado que el proyecto se configuró como una solución de granja de servidores, se implementará automáticamente y se restablecerá Internet Information Services (IIS).

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 una biblioteca de documentos en el sitio o subsitio.
Haga clic en la pestaña Biblioteca, vaya al grupo Conectar y exportar y observe la ausencia del botón Conectar con Outlook.