Compartir a través de


Creación de una característica simple

En este ejemplo se explica paso a paso el proceso para crear una característica de acción personalizada que agrega un botón a la barra de herramientas del formulario para editar elementos de anuncios en el ámbito de un sitio de SharePoint.

Para agregar un botón a una barra de herramientas en un formulario de elementos de lista

  1. Cree una carpeta SimpleFormToolbarButton en unidad_local:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES.

    Nota

    Cuando se crea una carpeta dentro del directorio de características haciendo clic con el botón secundario del mouse en una carpeta, eligiendo Nuevo y, a continuación, haciendo clic en Carpeta en el Explorador de Windows, la nueva carpeta creada no tiene permisos heredados. Si implementa una función en la carpeta, algunas páginas de Windows SharePoint Services, como las de configuración del sitio o vistas de lista, generarán una excepción. Para corregir este problema, haga clic con el botón secundario del mouse en la nueva carpeta, haga clic en Propiedades, seleccione Seguridad y, a continuación, haga clic en Avanzadas. En la ficha Permisos, seleccione Permitir que los permisos heredables del primario se propaguen a este objeto y todos los objetos secundarios. Incluirlos junto con las entradas indicadas aquí de forma explícita. Haga clic en Aceptar. También puede solucionar este problema si crea la nueva carpeta en la línea de comandos mediante el comando md.

  2. En esta carpeta, cree un archivo Feature.xml con el contenido siguiente, que utiliza el elemento Feature para registrar la característica.

    <Feature Title="New Simple Form Toolbar Button"
      Scope="Web" 
      Id="GUID" 
      xmlns="https://schemas.microsoft.com/sharepoint/">
      <ElementManifests>
        <ElementManifest Location="Elements.xml" />
      </ElementManifests>
    </Feature>
    
  3. Para reemplazar el GUID de marcador de posición en el atributo Id anterior, genere un GUID mediante la ejecución de guidgen.exe, ubicado en unidad_local:\Program Files\Microsoft Visual Studio 8\Common7\Tools.

  4. Cree un archivo Elements.xml en la carpeta SimpleFormToolbarButton que señala a un archivo .aspx, como la siguiente, que utiliza el elemento CustomAction para definir la acción personalizada.

    <Elements xmlns="https://schemas.microsoft.com/sharepoint/">
      <CustomAction Title="Simple" 
        Sequence="10" 
        RegistrationType="List" 
        RegistrationId="104" 
        Location="EditFormToolbar" 
        Id="Simple Toolbar">
        <UrlAction Url="/_layouts/SampleUrl.aspx" /> 
      </CustomAction>
    </Elements>
    
  5. Para probar la característica de ejemplo, cree una página SampleUrl.aspx como la siguiente que muestre "Hello, World!" y colóquela en el directorio TEMPLATE\LAYOUTS.

    <html>
    <head runat="server">
    <title>Sample Page</title>
    </head>
    <body>
    <p>Hello, world!</p>
    </body>
    </html>
    
  6. En un símbolo del sistema, escriba los comandos siguientes para instalar la característica en la implementación y, a continuación, activar dicha característica en un subsitio especificado.

       a. stsadm -o installfeature -filename SimpleFormToolbarButton\Feature.xml
       b. stsadm -o activatefeature -filename SimpleFormToolbarButton\Feature.xml -url https://Server/Site/Subsite
    
  7. Para probar el nuevo botón, desplácese hasta el formulario para editar un elemento de anuncios existente.

Vea también

Otros recursos

Trabajo con características
Elemento Feature (Característica)
Elemento CustomAction (Acción personalizada)
Acción personalizada
Definiciones de acción personalizada
Agregar acciones a la interfaz de usuario