IPolicyFeature インターフェイスの概要
最終更新日: 2010年4月2日
適用対象: SharePoint Server 2010
アイテムに情報管理ポリシーを最初に適用するときには、多くの場合、ポリシー機能で一定の操作を実行し、そのアイテムに強制する機能のポリシーを初期化する必要があります。この初期化には、以下のアクションが含まれる場合があります。
アイテムのリストでの列の作成。たとえば、有効期限ポリシー機能は、適用先のアイテムに、ExpireDate という名前の新しい列を作成します。
アイテムのリストでのイベントの登録。
アイテムに対する何らかの作業の実行。たとえば、有効期限ポリシー機能は、適用先アイテムの ExpireDate 列の初期値を計算します。
有効なポリシー機能の定義をインストールすることに加えて、各ポリシー機能には、IPolicyFeature インターフェイスを実装するクラスが含まれている必要があります。このインターフェイスにより、Microsoft SharePoint Server 2010 はポリシー機能に必要な初期化作業を実行するコードを呼び出すことができます。また、このインターフェイスにより、SharePoint Server 2010 はポリシー機能に関連付けられている、特定のコンテンツ タイプのポリシー アイテムが追加、削除、または変更されたときに必要なすべてのタスクを実行するコードを呼び出すことができます。
SharePoint Server 2010 は、コンテンツ タイプのポリシー アイテムが追加、削除、または変更されたときに適切なメソッドを呼び出します。
IPolicyFeature インターフェイスには以下のメソッドが含まれます。
-
ユーザーがポリシー機能に関連付けられている特定のポリシー アイテムに対するカスタム設定を変更したときに、SharePoint Server 2010 によって呼び出されます。
-
ユーザーがポリシー機能のサーバー ファーム レベルの設定を変更したときに、SharePoint Server 2010 によって呼び出されます。
-
ポリシーが変更されたときに、SharePoint Server 2010 によって呼び出されます。リストに現在割り当てられているポリシーが編集された場合や、リストに異なるポリシーが割り当てられた場合も変更に含まれます。
注意
ポリシー機能から false が返された場合、SharePoint Server 2010 は残りのアイテムを処理しません。この最適化により、SharePoint Server 2010 では、アイテムの処理には関係がないポリシー機能のリストにあるすべてのアイテムが反復処理されません。
-
指定したポリシーの対象ではなくなったリスト アイテムに対して、SharePoint Server 2010 によって呼び出されます。このメソッドを使用すると、アイテムからポリシーが削除されたときに実行する必要があるアイテム レベルの登録を解除するよう指定できます。
-
ユーザーがポリシーに新しいポリシー アイテムを追加したときに、SharePoint Server 2010 によって呼び出されます。このメソッドは、コンテンツ タイプに特定の列を追加したり、イベントを登録したりするなど、ポリシー機能のために必要なすべての開始作業を実行します。
-
ポリシーから既存のポリシー アイテムが削除されたときに、SharePoint Server 2010 によって呼び出されます。
ポリシーにポリシー アイテムを追加すると、SharePoint Server 2010 は関連付けられているポリシー機能の Register メソッドを呼び出して、必要なすべての開始作業を実行します。
同様に、ポリシーからポリシー アイテムを削除した場合、SharePoint Server 2010 は関連付けられているポリシー機能の UnRegister メソッドを呼び出して、必要なすべてのクリーンアップ作業を実行します。
ポリシーが変更されると、SharePoint Server 2010 は変更された各ポリシー機能の ProcessListItem メソッドを呼び出します。ポリシー機能が変更されていない場合、SharePoint Server 2010 はメソッドを呼び出しません。
たとえば、特定のコンテンツ タイプについてのポリシーに 1 つのポリシー機能としてバー コードが含まれていて、後から有効期限ポリシー機能のポリシー アイテムを追加したと仮定します。SharePoint Server 2010 は、有効期限ポリシー機能の Register メソッドを呼び出し、そのコンテンツ タイプに割り当てられている各アイテムに対して有効期限ポリシー機能を初期化します。ただし、バー コード ポリシー機能のポリシー アイテムはポリシー内で変更されていないため、SharePoint Server 2010 は、バー コード ポリシー機能の ProcessListItem メソッドは呼び出しません。