1. SPEAKの使用

チュートリアル : ルールの使用

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

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

ルールを使用して、ビジネスロジックをSPEAKページに追加します。このチュートリアルでは、ルールの使用方法について概説します。

  • ルール定義アイテムの作成

  • ルールエディタを使用してルールを作成する

  • 編集ルールのプレースホルダー

  • 複数のルールを作成する

  • ルールコンポーネントの追加と設定

ルール定義アイテムの作成

ルール定義アイテムを作成するには、次のようにします。

  • RuleDefinitionテンプレートを使用して、ページまたはアプリケーションのPageSettingsアイテムの子としてアイテムを作成します。

ページまたはアプリケーションに複数のRule Definitionアイテムが必要な場合は、PageSettingsアイテムの下にフォルダーを作成し、このフォルダーにすべてのRule Definitionアイテムを配置できます。

ルールエディタを使用してルールを作成する

ルールを作成するには:

  1. RuleDefinitionアイテムを開きます。

  2. Edit」をクリックします。

  3. Rule Editorダイアログで、ConditionsペインとActionsペインの線をダブルクリックしてルールを作成します。

  4. ルールセクションにさらに条件を追加するには、Conditionsペインの行をダブルクリックします。

    青色と下線付きの「and」と「or」を切り替えるには、これらの単語をクリックします。ルールエディタは、SPEAKが条件をどのように評価するかを示すために、条件のインデントを調整します。条件を右クリックすると、削除、上、または下への移動ができます。

  5. Actionsウィンドウでは、線をダブルクリックして複数のアクションを追加できます。アクションは常に "and" で結合されます。アクションを右クリックすると、アクションを削除したり、上に移動したり、下に移動したりできます。

ルールプレースホルダーの編集

条件とルールにはプレースホルダーが含まれます。プレースホルダーは青色で、下線が引かれています。ルールが機能する前に、プレースホルダーを編集する必要があります。

  • 一部のプレースホルダーはトグルです。これは、"where" などの論理演算子の場合です。これらのプレースホルダーをクリックすると、値が切り替わります (例: "where" -> "except where" -> "where")。

  • 一部のプレースホルダーはコンポーネントを参照します。彼らはしばしば「名前」と呼ばれます。プレースホルダーをクリックして、条件またはアクションが参照するSPEAKコンポーネントの名前を入力します。

  • 一部のプレースホルダーは、コンポーネント プロパティの値を参照します。それらはしばしば「価値」と呼ばれます。条件またはアクションが1つの特定のプロパティのみを対象としている場合、値プレースホルダにはこのプロパティの名前 (例: "min width") が付けられます。

複数のルールを作成する

1つのRuleDefinitionアイテムに複数のルールを作成できます。

  • Rulesパネルで右クリックして「 Add New Rule」を選択します。

Sitecoreは、複数のルールがある場合、ルールを順番に実行します。ルールを条件付きにすることはできないため、RuleDefinitionアイテムがトリガーされたときにSPEAKはすべてのルールを実行します。

ルールコンポーネントの追加と設定

SPEAKページにRuleコンポーネントを追加して、RuleDefinitionアイテムで作成したルールをトリガーします。

  1. レイアウトデザイナーでRuleコンポーネントをページに追加します。

  2. RuleItemIDプロパティでRuleDefinition項目を指定します。

  3. ページ内のコンポーネントをTargetControlプロパティに指定します。SPEAKは、このコンポーネントが発生させるイベントをリッスンします。

  4. Triggerプロパティでイベントを指定します。SPEAKはこのイベントを聴いています。

TargetControlでコントロールを指定しない場合、SPEAKは "window" デフォルトコンポーネントによって発生したイベントをリッスンします。

応答するイベントごとにRuleコンポーネントをページに追加し、ページには複数のルールコンポーネントを含めることができます。複数の異なるルールコンポーネントが同じルールアイテムを指すことができます。

この記事を改善するための提案がある場合は、 お知らせください!