[Sitecore CMS]コマンドテンプレートを作成してみる

概要:サイトコアで用意されているテンプレートの中の1つコマンドテンプレートを作成してみたときのメモを記載します。
投稿者：handcraft 公開日：8/18/2013 閲覧数:5157 評価者数：0

サイトコアにはデータテンプレート、ブランっテンプレートの他に、コマンドテンプレートというテンプレートが用意されています。コマンドテンプレートは .NET (C#) を使ったプログラムによる実装が必要なテンプレートです。作りこみが必要な分、もっとも強力なアイテムの作成方法になります。

コマンドテンプレートを使用することでたとえば、ウィザード形式でユーザーがにフォームに入力した結果を利用してアイテムを作成するといったことができるようになります。

今回作成するコマンドテンプレートは Data Definition Cookbook に掲載されているコマンドテンプレートを参考にしています。

今回は Data Definition Cookbook に記載されているコマンドテンプレートを実際に実装してみます。

検証環境は次の通りです

Sitecore CMS 6.6 Service Pack1
.NET 4.0

1. コマンドクラスの実装

コマンドテンプレートの定義アイテムを作成する場合は、コマンドを選択したときに実行されるクラスを実装する必要があります。今回は NewAssignedFolder というコマンドクラスを作成します。コマンドテンプレートでコマンドを実行するクラスは Sitecore.Shell.Framework.Commands.Command クラスを継承する必要があります。コマンドクラスは Execute メソッドをオーバーライドしてコマンドを実装します。

NewAssigedFolder では、最初に(args.IsPostBack=falseのとき)アイテム名を入力する画面を表示します。ユーザーがアイテム名を入力してOKボタンをクリックしたとき(args.IsPostBack = true) 入力された名前のフォルダー型のアイテムを作成します。アイテム作成時に親アイテムの挿入オプションと挿入ルールを作成したフォルダ型のアイテムにコピーしています。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Collections.Specialized;

namespace SCSupport.Core
{
    public class NewAssignedFolder : Sitecore.Shell.Framework.Commands.Command
    {
        public override void Execute(Sitecore.Shell.Framework.Commands.CommandContext context)
        {
            if (context.Items.Length == 1)
            {
                Sitecore.Data.Items.Item item = context.Items[0];
                NameValueCollection parameters = new NameValueCollection();
                parameters["id"] = item.ID.ToString();
                parameters["language"] = item.Language.ToString();
                parameters["database"] = item.Database.Name;
                // ユーザーがNewAssignedFolderコマンドテンプレートを選択するとRunメソッドが実行される。
                Sitecore.Context.ClientPage.Start(this, "Run", parameters);
            }
        }

        protected void Run(Sitecore.Web.UI.Sheer.ClientPipelineArgs args)
        {
            if (args.IsPostBack)
            {
                if (!string.IsNullOrEmpty(args.Result) && args.Result != "null")
                {
                    // テキストボックスに入力があった場合のみ処理実施
                    Sitecore.Data.Database database = Sitecore.Configuration.Factory.GetDatabase(args.Parameters["database"]);
                    Sitecore.Data.Items.Item parent = database.GetItem(args.Parameters["id"],
                        Sitecore.Globalization.Language.Parse(args.Parameters["language"]));
                    // フォルダ型のデータテンプレート取得
                    Sitecore.Data.Items.TemplateItem tamplate = database.Templates[Sitecore.TemplateIDs.Folder];
                    // 親アイテムに テキストボックスで入力された名前をもつ フォルダ型のサブアイテムを作成
                    Sitecore.Data.Items.Item item = parent.Add(args.Result, tamplate);

                    // 親アイテムに挿入ルールか挿入オプションがある場合は、そのフィールド値をコピー
                    if (!(string.IsNullOrEmpty(parent[Sitecore.FieldIDs.Branches]) &&
                        string.IsNullOrEmpty(parent["__Insert Rules"])))
                    {
                        item.Editing.BeginEdit();
                        if (!string.IsNullOrEmpty(parent[Sitecore.FieldIDs.Branches]))
                        {
                            item.Fields[Sitecore.FieldIDs.Branches].Value = parent[Sitecore.FieldIDs.Branches];
                        }
                        if (!string.IsNullOrEmpty(parent["__Insert Rules"]))
                        {
                            item.Fields["__Insert Rules"].Value = parent["__Insert Rules"];
                        }
                        item.Editing.EndEdit();                        
                    }
                    Sitecore.Context.ClientPage.SendMessage(this, "item:load(id=" + item.ID.ToString() + ")");


                }
            }
            else
            {
                // ページを初期表示
                // アイテム名を入力するテキストボックスを表示。検証にはWeb.configのItemNameValidationで設定した正規表現を使用する。
                Sitecore.Context.ClientPage.ClientResponse.Input("Enter the name of the new folder:",
                    Sitecore.Globalization.Translate.Text("New folder"),
                    Sitecore.Configuration.Settings.ItemNameValidation, "'$input' is not a valid name.", 100);
                args.WaitForPostBack();
            }
        }
    }
}

コマンドクラスの実装が完了しました。

2. Command.config のコメントの定義を作成

作成したコマンドクラス用のコマンドを Commands.config に定義します。

  <command name="sample:contenteditor:newassigendfolder" type="SCSupport.Core.NewAssignedFolder, SCSupport"/>

コマンドの準備は完了です。

3. コマンドテンプレート定義アイテムの作成

コマンドを使用するコマンドテンプレート型のアイテムを作成します。/sitecore/テンプレート配下の任意の場所にコマンドテンプレート型のアイテムを作成できますが、今回は、下図のようにユーザー定義アイテム配下のアイテムを選択して、挿入オプションのテンプレートから挿入を選択してアイテムを作成しました。

テンプレートから挿入で /テンプレート/システム/ブランチ/コマンドテンプレートデータテンプレートを選択します。名前は NewAssignedFolder という名前でコマンドテンプレートアイテムを作成しました。

作成したアイテムにはコマンドフィールドがあります。コマンドフィールドには namespace:category:command(id=$ParentID) という文字列を設定しています。 Commands.config に追加したコマンドの引数に id=$ParentID を設定するようにしています。このように記述することで、コマンドに親のIDが渡されるようになります。Data Definition Cookbook によると、id=$ParentID というパラメーターを指定しないと、挿入グループから作成するアイテムの種類を選択する前にコンテンツツリーで別のアイテムを右クリックすると、親のアイテムではなく、右クリックしたアイテムのIDがコマンドテンプレートのコマンドに渡されることがあるそうです。

これで準備完了です。

4. 動作確認

実際にアイテムを作成してみます。コマンドテンプレートを使用する場合は、アイテムの挿入オプションにコマンドテンプレートを設定しておく必要があります。今回はホームアイテムの挿入オプションに作成した NewAssigedFolder コマンドテンプレートを設定してみました。下図のようにホームアイテムを選択して挿入グループから NewAssigedFolder をクリックします。