Definiciones de acción personalizada

Los archivos de acción personalizada se incluyen como parte de las características y se implementan como descripciones de elementos XML. Un archivo de acción personalizada está estructurado con un elemento CustomAction, que actúa como definición principal de una única acción personalizada de un vínculo o un elemento de barra de herramientas.

Elements

  CustomActionGroup

  HideCustomAction

  CustomAction

    UrlAction

Ejemplo

En el ejemplo siguiente, se define un archivo de acción personalizada que se puede incluir en el archivo .wsp de una solución.

<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <CustomActionGroup 
    Id="VirtualServerConfiguration"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Title="Virtual Server Configuration"
    Sequence="10"
    ImageUrl ="/images/listset.gif"
    Description="Use these links to install Windows SharePoint Services on a new virtual server, configure settings across all sites on a virtual server, or create a new top-level Web site. "/>
  <CustomAction 
    Id="Extend"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Sequence="10" 
    Title="Extend or upgrade virtual server" 
    Description="">
    <UrlAction Url="vslist.aspx?NextPage=extendvsoption.aspx&amp;Show=NeedExtend&amp;Show=NeedUpgrade"/>
  </CustomAction>
  <CustomAction 
    Id="CreateSite"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Sequence="20" 
    Title="Create a top-level Web site" 
    Description="">
    <UrlAction Url="vslist.aspx?NextPage=createsite.aspx&amp;Show=Ready"/>
  </CustomAction>
  <CustomAction 
    Id="DeleteSite"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Sequence="30" 
    Title="Delete site collection" 
    Description="">
    <UrlAction Url="delsite.aspx"/>
  </CustomAction>
  <CustomAction 
    Id="ConfigureVirtualServer"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Sequence="40" 
    Title="Configure virtual server settings" 
    Description="">
    <UrlAction Url="vslist.aspx?NextPage=vssettings.aspx"/>
  </CustomAction>
</Elements>

El elemento CustomActionGroup contiene la definición principal para un grupo de acciones personalizadas.

Use el elemento UrlAction para especificar la dirección URL de una acción personalizada. Si no se especifica ninguna acción (condición de error), se muestra el vínculo pero éste no es operativo.

Utilice el elemento HideCustomAction para ocultar una acción existente que se implementa de forma predeterminada en la infraestructura de las características de Windows SharePoint Services o en otra acción personalizada. Para obtener una lista de identificadores de acción personalizada predeterminada, consulte Ubicaciones e identificadores de acciones personalizadas predeterminadas.

En el ejemplo siguiente se muestra un archivo XML cuyo contenido reemplaza acciones predeterminadas en una página de Windows SharePoint Services con nuevas acciones. Para una tarea de programación que muestra los pasos para definir y registrar las acciones personalizadas, consulte Agregar acciones a la interfaz de usuario.

<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
   <CustomActionGroup 
      Id="PortalAnalytics"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
      Title="Usage Reporting"
      Sequence="50" />
   <CustomAction 
      Id="ManageAnalytics"
      GroupId="PortalAnalytics"
   Location="Microsoft.SharePoint.Administration.ApplicationManagement"
      Sequence="10" 
      Title="Configure usage reporting" >
      <UrlAction 
         Url="_layouts/SpUsageConfig.aspx"/>
   </CustomAction>
   <HideCustomAction
      Id="HideWssSiteCollectionUsage"
      HideActionId="SiteCollectionUsage"
      GroupId="SiteCollectionAdmin"
      Location="Microsoft.SharePoint.SiteSettings" />
   <HideCustomAction
      Id="HideWssWebUsage"
      HideActionId="WebUsage"
      GroupId="SiteAdministration"
      Location="Microsoft.SharePoint.SiteSettings" />
   <CustomAction
      Id="PortalSiteUsage"
      GroupId="SiteCollectionAdmin"
      Location="Microsoft.SharePoint.SiteSettings"
      Rights="ViewUsageData"
      Sequence="30"
      Title="Site usage data">
      <UrlAction
         Url="_layouts/SpUsageSite.aspx" />
   </CustomAction>
   <CustomAction
      Id="PortalWebUsage"
      GroupId="SiteAdministration"
      Location="Microsoft.SharePoint.SiteSettings"
      Rights="ViewUsageData"
      Sequence="30"
      Title="Web usage data">
      <UrlAction
         Url="_layouts/SpUsageWeb.aspx" />
   </CustomAction>
</Elements>

Vea también

Otros recursos

Acción personalizada
Ubicaciones e identificadores de acciones personalizadas predeterminadas
Agregar acciones a la interfaz de usuario