Action personnalisée
Dernière modification : vendredi 2 avril 2010
S’applique à : SharePoint Foundation 2010
Une action personnalisée représente une personnalisation visible par l’utilisateur et qui porte sur le Ruban serveur, un menu ou un lien. Les actions personnalisées peuvent être liées à un type de liste, un type de contenu, un type de fichier ou un identificateur de programmes (ProgID).
Étendues possibles :
Batterie de serveurs : oui
Application Web : oui
Collection de sites : oui
Site Web : oui
Définition d’actions personnalisées pour l’interface utilisateur
L’interface utilisateur peut être modifiée à plusieurs emplacements à l’aide d’actions personnalisées. Ces emplacements comprennent le Ruban serveur et d’autres menus dans SharePoint Foundation.
Actions personnalisées pour le Ruban serveur
Lorsque vous utilisez un élément CustomAction pour ajouter un contrôle au Ruban, les contrôles tels que les zones de texte et les listes déroulantes sont pris en charge. Toutefois, les contrôles utilisateur et les composants WebPart ne sont pas pris en charge dans le Ruban. Pour plus d’informations sur le Ruban, voir Ruban serveur dans SharePoint Foundation.
Actions personnalisées pour les autres menus
Pour définir une action personnalisée pour un menu particulier, vous devez identifier le menu en définissant l’emplacement sur l’espace de noms SharePoint Foundation approprié et en utilisant l’ID que SharePoint Foundation utilise pour identifier l’emplacement spécifique.
Par exemple, pour ajouter une action personnalisée à la page Paramètres du site, définissez l’attribut Location de l’élément CustomAction sur Microsoft.SharePoint.SiteSettings et spécifiez une zone particulière dans la page par le biais de l’attribut GroupId.
Pour obtenir la liste des emplacements et des ID d’actions personnalisées par défaut utilisés dans une installation de SharePoint Foundation, voir Emplacements et ID des actions personnalisées par défaut.
Jetons d’URL pour les actions personnalisées
SharePoint Foundation prend en charge les jetons suivants avec lesquels vous pouvez commencer une URL relative :
~site : lien relatif au site Web (SPWeb).
~sitecollection : lien relatif à la collection de sites (SPSite).
En outre, vous pouvez utiliser les jetons suivants dans une URL :
{ItemId} : ID d’entier qui représente l’élément dans une liste.
{ItemUrl} : URL de l’élément faisant l’objet d’une opération. Fonctionne uniquement pour les documents dans les bibliothèques.
{ListId} : GUID qui représente la liste.
{SiteUrl} : URL du site Web (SPWeb).
{RecurrenceId} : Index de périodicité. Ce jeton n’est pas pris en charge dans les menus contextuels des éléments de liste.
Voir aussi
Concepts
Procédure : modifier l’interface utilisateur à l’aide d’actions personnalisées
Schéma de définition d’action personnalisée