Partager via


Vue d'ensemble de l'interface IPolicyFeature

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 à Office SharePoint Server 2007 d'appeler le code nécessaire pour exécuter les tâches d'initiation dont la fonctionnalité de stratégie a besoin, ainsi que le code pour exécuter des tâches lorsqu'un élément de stratégie associé à la fonctionnalité de stratégie est ajouté, supprimé ou modifié pour un type de contenu.

Office SharePoint Server 2007 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 Office SharePoint Server 2007 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 Office SharePoint Server 2007 lorsqu'un utilisateur modifie les paramètres au niveau de la batterie de serveurs pour une fonctionnalité de stratégie.

ProcessListItem

Appelée par Office SharePoint Server 2007 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.

Si une fonctionnalité de stratégie retourne la valeur false, Office SharePoint Server 2007 ne traite pas les éléments restants. Cette optimisation empêche Office SharePoint Server 2007 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 Office SharePoint Server 2007 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 Office SharePoint Server 2007 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 Office SharePoint Server 2007 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, Office SharePoint Server 2007 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, Office SharePoint Server 2007 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, Office SharePoint Server 2007 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, Office SharePoint Server 2007 n'appelle aucune de ses méthodes.

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. Office SharePoint Server 2007 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, Office SharePoint Server 2007 n'appelle toutefois pas la méthode ProcessListItem de cette fonctionnalité de stratégie.

Voir aussi

Autres ressources

Introduction à 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
Vue d'ensemble de l'espace de noms Policy