Feature Stapling を使用して、個人用サイトのカスタマイズを実施する

2015-07-01

こんにちは SharePoint サポートの森　健吾 (kenmori) です。

今回の投稿では、SharePoint Server 2013/2010 において、Feature Stapling (ホチキス止め機能) を使用した個人用サイトのカスタマイズの例をご紹介します。
(SharePoint Online では、ファームソリューションとして展開する本カスタマイズは実施できませんのでご了承ください。)

個人用サイトは、下記の投稿にもある通り、ホストサイトコレクションとユーザーごとの個別サイトコレクションに分かれます。

タイトル : SharePoint 2013 個人用サイトのアーキテクチャについて
アドレス: https://blogs.technet.com/b/sharepoint_support/archive/2014/10/15/sharepoint-2013-my-sites-architecture.aspx

個別のサイトコレクションは、ユーザーごとにサイトコレクションが別々に作成されるので、全ユーザーのサイトコレクションに一律でカスタマイズを適用することは簡単ではありません。

今回紹介するカスタマイズ手法 Feature Stapling は、サイトにカスタマイズに組み込むのではなく、サイト定義 (個人用サイトのベーステンプレート SPSPERS#2) にカスタマイズを組み込む方法となります。
個人用サイトの定義にカスタマイズを組み込むことで、個人用サイトが作成されたタイミングで機能が有効化され、自動的にカスタマイズが適用されていく仕組みとなります。

それでは、手順を見てみましょう。

実装手順

1. Visual Studio を起動し、[ファイル] - [新規作成] - [プロジェクト] をクリックします。
2. SharePoint 2013 - 空のプロジェクトを選択して、ファームソリューションでプロジェクトを作成します。

3. ソリューションエクスプローラーより Features フォルダを右クリックし、[フィーチャーの追加] をクリックします。

4. Features 直下のフォルダで [F2] をクリックして、機能名 (例. MySiteAddIn) を指定します。

補足

サイトに含めたいカスタマイズ (Web パーツ、カスタムマスタページ、イベントレシーバーなど) があれば、この時点で機能に追加してください。

5. アドインを右クリックして、[イベントレシーバーの追加] をクリックします。

    [Guid("26f56572-4769-436a-b31f-3ea02f4eb12f")]
    public class MySiteAddInEventReceiver : SPFeatureReceiver
    {
        // フィーチャーをアクティブにした後に発生したイベントを処理するには、以下のメソッドのコメントを解除します。

        public override void FeatureActivated(SPFeatureReceiverProperties properties)
        {
            // ここに必要な処理を書きます。
            SPSite site = (SPSite)properties.Feature.Parent;
            SPWeb web = site.RootWeb;

            SPClaim userClaim = SPClaimProviderManager.Local.ConvertIdentifierToClaim("domain\\SPSAdmin", SPIdentifierTypes.WindowsSecurityGroupName);
            SPUser user = web.EnsureUser(SPClaimProviderManager.Local.EncodeClaim(userClaim));
            user.IsSiteAdmin = true;
            user.Update();

}

上記コードサンプルは、個別に作成されるサイトコレクションの管理者にあらかじめ domain\SPSAdmin セキュリティグループを登録しておくためのコードです。

補足

サイトが作成される際に、手順 5. 補足部分で生成したカスタマイズをどう組み込むか、ここのコードで記載します。
例えば、サイトにマスターページ (SPWeb.MasterUrl, SPWeb.CustomMasterUrl) を指定したり、SPLimitedWebPartManager クラスを使用してトップページに Web パーツを貼るなどが考えられます。

7. 上記で作成したフィーチャーを非表示にします。(あくまで内部的に追加されるフィーチャーであるため)