Partager via


Vue d'ensemble de l'interface IPolicyFeature

Dernière modification : vendredi 2 avril 2010

S’applique à : SharePoint Server 2010

Lors de l'application initiale d'une stratégie de gestion des informations à un élément, les fonctionnalités de stratégie doivent souvent effectuer certaines opérations pour initialiser l'exécution de la stratégie de la fonctionnalité sur cet élément. Cette initialisation peut comprendre les actions suivantes :

  • Création d'une colonne dans la liste de l'élément. Par exemple, la fonctionnalité de stratégie d'expiration crée une colonne, appelée ExpireDate, dans les éléments auxquels vous l'appliquez.

  • Inscription pour les événements de la liste de l'élément.

  • Exécution de certaines tâches sur l'élément. Par exemple, la fonctionnalité de stratégie d'expiration calcule la valeur initiale de la colonne ExpireDate des éléments auxquelles vous l'appliquez.

Outre l’installation d’une définition de fonctionnalité de stratégie valide, chaque fonctionnalité de stratégie doit également contenir une classe qui implémente l’interface IPolicyFeature. Cette interface permet à Microsoft SharePoint Server 2010 d’appeler le code pour exécuter les tâches d’initiation dont la fonctionnalité de stratégie a besoin. L’interface permet également à SharePoint Server 2010 d’appeler le code pour exécuter des tâches requises lorsqu’un élément de stratégie associé à la fonctionnalité de stratégie est ajouté, supprimé ou modifié pour un type de contenu.

SharePoint Server 2010 appelle la méthode adéquate lorsque des éléments de stratégie sont ajoutés, supprimés ou modifiés pour un type de contenu.

L’interface IPolicyFeature contient les méthodes ci-après :

  • OnCustomDataChange

    Appelée par SharePoint Server 2010 lorsqu’un utilisateur modifie les paramètres personnalisés d’un élément de stratégie associé à la fonctionnalité de stratégie.

  • OnGlobalCustomDataChange

    Appelée par SharePoint Server 2010 lorsqu’un utilisateur modifie les paramètres au niveau de la batterie de serveurs pour une fonctionnalité de stratégie.

  • ProcessListItem

    Appelée par SharePoint Server 2010 lorsqu’une stratégie change, c’est-à-dire, lorsque la stratégie actuellement affectée à la liste est modifiée ou lorsque la liste se voit affecter une autre stratégie.

    Notes

    Si une fonctionnalité de stratégie retourne la valeur false, SharePoint Server 2010 ne traite pas les éléments restants. Cette optimisation empêche SharePoint Server 2010 de parcourir tous les éléments d’une liste pour les fonctionnalités de stratégie qui ne sont pas impliquées dans le traitement de l’élément.

  • ProcessListItemOnRemove

    Appelée par SharePoint Server 2010 sur les éléments de liste qui ne sont plus sujets à la stratégie spécifiée. Cette méthode vous permet de spécifier l’annulation d’inscription de niveau élément qui doit être effectuée lorsque la stratégie est supprimée d’un élément.

  • Register

    Appelée par SharePoint Server 2010 lorsqu’un utilisateur ajoute un nouvel élément de stratégie à une stratégie. Cette méthode exécute toute tâche d’initiation requise pour la fonctionnalité de stratégie, telle que l’ajout de colonnes spécifiques au type de contenu ou l’inscription pour les événements.

  • UnRegister

    Appelée par SharePoint Server 2010 lorsqu’un élément de stratégie existant est supprimé d’une stratégie.

Lorsque vous ajoutez un élément de stratégie à une stratégie, SharePoint Server 2010 appelle la méthode Register de la fonctionnalité de stratégie associée pour effectuer toute tâche d’initiation requise.

De même, lorsque vous supprimez un élément de stratégie d’une stratégie, SharePoint Server 2010 appelle la méthode UnRegister de la fonctionnalité de stratégie associée pour effectuer toute tâche de nettoyage requise.

Lorsqu’une stratégie change, SharePoint Server 2010 appelle la méthode ProcessListItem de chaque fonctionnalité de stratégie qui a été modifiée. Si une fonctionnalité de stratégie n’a pas été modifiée, SharePoint Server 2010 n’appelle aucune méthode.

Supposons par exemple que votre stratégie pour un type de contenu donné contienne une fonctionnalité de stratégie de codes barres et que vous ajoutiez un élément de stratégie à la fonctionnalité de stratégie d’expiration. SharePoint Server 2010 appelle la méthode Register de la fonctionnalité de stratégie d’expiration pour initialiser la fonctionnalité sur chaque élément affecté à ce type de contenu. Étant donné que l’élément de stratégie de la fonctionnalité de stratégie de codes barres n’a pas été modifié dans la stratégie, SharePoint Server 2010 n’appelle toutefois pas la méthode ProcessListItem de cette fonctionnalité de stratégie.

Voir aussi

Concepts

Gestion de la stratégie de gestion des informations

Vue d'ensemble des fonctionnalités de stratégie

Définitions des fonctionnalités de stratégie

Vue d'ensemble de l'interface IPolicyFeature

Vue d'ensemble de ressources de stratégie