Schéma de définition d’Action personnaliséCustom Action Definition schema

S’applique à: 2016 SharePoint | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Les actions personnalisées sont définies dans des documents XML et déployées dans le cadre d’un composant fonctionnel.Custom actions are defined in XML documents and deployed as part of a Feature.

Définition de schéma XMLXML schema definition

Un document XML qui définit les actions personnalisées doivent être validés avec le schéma défini dans le fichier wss.xsd.An XML document that defines custom actions must validate with the schema defined in the file wss.xsd. Ce fichier se trouve sur le chemin d’accès suivant : %ProgramFiles%\\Common Files\\Microsoft Shared\\web server extensions\\15\\TEMPLATE\\XML.This file is located on the following path: %ProgramFiles%\\Common Files\\Microsoft Shared\\web server extensions\\15\\TEMPLATE\\XML.

ÉlémentsElements

RemarquesRemarks

L’élément CustomActionGroup contient la définition principale d’un regroupement d’actions personnalisées.The CustomActionGroup element contains the core definition for a grouping of custom actions.

L’élément UrlAction doit être utilisé pour spécifier l’URL pour une action personnalisée.The UrlAction element must be used to specify the URL for a custom action. Si aucune action n’est spécifiée (une condition d’erreur), le lien est affiché, mais il n’est pas liée à rien.If no action is specified (an error condition), the link is displayed but it is not linked to anything.

Utilisez l’élément HideCustomAction pour masquer une action existante effectuée par défaut au sein de l’infrastructure des fonctionnalités de Microsoft SharePoint Foundation, ou d’une autre action personnalisée.Use the HideCustomAction element to hide an existing action that is implemented by default within the infrastructure of Microsoft SharePoint Foundation Features, or within another custom action. Pour obtenir la liste de l’ID d’actions personnalisées par défaut, voir Default Custom Action Locations and IDs.For a list of the default custom action IDs, see Default Custom Action Locations and IDs.

ExempleExample

L’exemple suivant montre un fichier XML dont le contenu remplace les actions par défaut dans une page SharePoint Foundation avec de nouvelles actions.The following example shows an XML file whose contents replace default actions in a SharePoint Foundation page with new actions. Pour une tâche de programmation qui montre les étapes de la définition et l’enregistrement des actions personnalisées, voir Comment : modifier l’Interface à l’aide de Actions personnalisées utilisateur.For a programming task that shows the steps for defining and registering custom actions, see How to: Modify the User Interface Using Custom Actions.

    <Elements xmlns="http://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>

Voir aussiSee also