1. 条件付きレンダリング

条件付きレンダリングのカスタムパーソナライゼーションルールを追加する

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecoreには、条件付きレンダリングに使用できるデフォルトのパーソナライゼーション ルールがいくつか含まれています。既存のルールでは対応できない特定のニーズがある場合は、独自のパーソナライゼーションルールを作成できます。このトピックでは、Defaultデバイスでの条件付きレンダリングに使用できるカスタムパーソナライゼーションルールを作成する方法について説明します。

カスタムルールを追加する

  1. sitecore/system/Settings/Rules/Definitions/Tagsで、Tagsを右クリックしてInsert > Tagをクリックし、新しいタグの名前を入力します。

  2. /sitecore/system/Settings/Rules/Definitions/Elementsで、「Elements」を右クリックし、「Insert > Element Folder」をクリックして、ルール・エレメント・フォルダーを作成します。

  3. 新しく作成した要素フォルダを右クリックしてInsert > Conditionをクリックし、新しい条件のわかりやすい名前を入力します。

  4. 新しい条件のTextフィールドに、ルールを使用するユーザー向けのテキストと、ルール条件を作成する入力フィールド (例: " Where the query string parameter compares to value") の組み合わせを入力します。この場合、下線付きのテキストは条件を表します。各条件は、4つのカンマ区切り値を含む角括弧のペアで定義します。

    • 条件を実装する .NETクラスのプロパティの名前。ユーザーが条件に値を入力すると、その値が .NETクラス プロパティに割り当てられます。

    • 定義済みの機能を含むマクロの名前。たとえば、ユーザーが整数を選択できるユーザー インターフェイスなどです。これを空のままにすると、デフォルトのインターフェースが使用されます。既存のマクロ (たとえば、文字列演算子) を使用できます。

      where the current contact's [AreaName,,,Area Name] [Key,,,Key] [OperatorId,StringOperator,,compares to] [RuleString,,,specific value]
      メモ

      マクロは /sitecore/system/Settings/Rules/Definitions/Macrosで定義します。

    • ユーザー インターフェースに関連するURLパラメーターで、マクロを使用してインターフェースを作成する場合に指定します。たとえば、/sitecore/Content/Homeアイテムを選択ツリーのルートとして指定するには、「 root=/sitecore/Content/Home」と入力します。URLパラメータが想定されない場合は、空のままにしておくことができます。

    • ルールセットエディタに表示するテキスト。ユーザーが値を選択すると、それに応じてテキストが変更されます。

  5. 新しい条件のTypeフィールドに、条件を実装する .NETクラスの完全修飾名をnamespace, assembly name.

    A screenshot of the Content Editor Type field for a new condition.

  6. 新しいエレメント フォルダーで、Tags > Defaultをクリックし、手順1で作成したタグを割り当てます。

  7. ルールをルールセットエディタのConditional Renderingsの下に表示するには、/sitecore/system/Settings/Rules/Conditional Renderings/Tags/Defaultを開き、新しいタグをConditional Renderingsタグに割り当てます。

  8. 最後に、Sitecoreのbinフォルダーに、条件を実装する .NETクラスを含むDLLを追加します。名前空間とクラス名が、上記のTypeフィールドで指定した値と一致していることを確認します。.NETクラスは、次のいずれかのクラスから継承する必要があります。

    • ブール条件を実装するには、Sitecore.Rules.Conditions.WhenCondition.

    • 文字列値を比較するには、Sitecore.Rules.Conditions.StringOperatorConditionを使用します。

    • 他のタイプの値を比較するには、Sitecore.Rules.Conditions.OperatorCondition.

プロセスを完了すると、ルールはSitecoreルール セット エディターで使用できるようになります。

たとえば、次のテキストがあるとします。

A screenshot of text input for a condition.

結果は次の状態になります。

A screenshot of the Sitecore Rule Set Editor.
この記事を改善するための提案がある場合は、 お知らせください!