基礎モード scaffolding

同じ構造を共有しながらコンテンツが異なるページを大量に作成しなくてはならない場合があります。標準的な Adobe Experience Manager(AEM)インターフェイスを使用する場合は、各ページを作成し、適切なコンポーネントをページにドラッグして、それぞれのコンポーネントに内容を入力する必要があります。

基礎モードを使用すると、ページに必要な構造を反映したフィールドを含むフォーム(基礎)を作成し、このフォームを使用して必要な構造に基づいたページを簡単に作成できます。

NOTE
基礎モード(クラシック UI)では、MSM の継承が考慮されます。

基礎モードの機能 how-scaffolding-works

基礎モードは、サイト管理の「ツール」コンソールタブに格納されています。

  • ツール ​コンソールを開き、「デフォルトページの基礎モード」をクリックします。
  • この下の「Geometrixx」をクリックします。
  • Geometrixx」で、「ニュース」という名前の​ 基礎モードページ ​を探します。ダブルクリックしてこのページを開きます。

howscaffolding_work

基礎モードは、作成するページを構成するコンテンツの各部品用のフィールドを持つフォームと、基礎モードページの「ページプロパティ」で設定できる 4 つの重要なパラメーターで構成されます。

pageprops

基礎モードページのプロパティは次のとおりです。

  • タイトルテキスト:これは、この基礎モードページ自体の名前です。この例では、「ニュース」と呼ばれます。
  • 説明:これは、基礎モードページのタイトルの下に表示されます。
  • ターゲットテンプレート:これは、この基礎モードが新しいページを作成する際に使用するテンプレートです。この例では、Geometrixx コンテンツページ ​テンプレートが使用されます。
  • ターゲットパス:これは、この基礎モードが新しいページを作成する親ページのパスです。この例では、パスは /content/geometrixx/en/news です。

基礎モードの本文はフォームに入力します。ユーザーが基礎モードを使用してページを作成する場合、ユーザーは、フォームに入力して、下部にある「作成」をクリックします。前述の​ ニュース ​の例では、フォームに以下のフィールドがあります。

  • タイトル:作成するページの名前です。このフィールドは、すべての基礎モードに常に表示されます。
  • テキスト:このフィールドは、生成されるページのテキストコンポーネントに対応します。
  • Image:このフィールドは、生成されるページの画像コンポーネントに対応します。
  • 画像/詳細タイトル:画像のタイトルです。
  • 画像/詳細代替テキスト:画像の代替テキストです。
  • 画像/詳細説明:画像の説明です。
  • 画像/詳細サイズ:画像のサイズです。
  • タグ/キーワード:このページに割り当てるメタデータです。このフィールドは、すべての基礎モードに常に表示されます。

基礎モードの作成 creating-a-scaffold

基礎モードを作成するには、 ツール コンソール、次に デフォルトのページ基礎モード をクリックし、ページを作成します。 使用できるテンプレートの種類は、基礎モードテンプレート ​だけです。

新しいページの「ページプロパティ」に移動し、前述の説明に従って、「タイトルテキスト」、「説明」、「ターゲットテンプレート」および「ターゲットパス」を設定します。

次に、この基礎モードで作成するページの構造を定義する必要があります。これを行うには、基礎モードページで「デザインモード」に切り替えます。リンクが表示され、 ダイアログエディター.

cq5_dialog_editor

このダイアログエディターを使用すると、この基礎モードを使用して新しいページを作成するたびに作成されるプロパティを指定できます。

基礎モードのダイアログ定義は、コンポーネントのダイアログ定義と同様に機能します(コンポーネントを参照)。ただし、次のようないくつかの重要な違いがあります。

  • コンポーネントダイアログ定義は、通常のダイアログボックスとしてレンダリングされます(例えば、ダイアログエディターの中央のウィンドウに表示されます)。一方、基礎モードダイアログの定義は、ダイアログエディターで通常のダイアログボックスとして表示されますが、基礎モードフォームとして基礎モードページにレンダリングされます(前述の​ ニュース ​基礎モードのように表示されます)。
  • コンポーネントダイアログには、単一の特定のコンポーネントのコンテンツを定義するために必要な値用のフィールドのみが表示されます。基礎モードダイアログでは、作成するページの各段落のすべてのプロパティに対してフィールドを提供する必要があります。
  • コンポーネントダイアログがある場合、指定したコンテンツをレンダリングするために使用されるコンポーネントは暗黙的なものなので、 sling:resourceType プロパティには、段落が作成されると自動的に値が入力されます。 基礎モードの場合、特定の段落に対して、コンテンツおよび割り当てられたコンポーネントの両方を定義するすべての情報は、ダイアログで指定する必要があります。基礎モードダイアログでは、非表示フィールドを使用してこの内容を指定し、ページの作成時にこの内容が送信されるようにする必要があります​

ダイアログエディターの​ ニュース ​基礎モードダイアログの例を確認し、この仕組みを説明します。基礎モードページでデザインモードに切り替え、ダイアログエディターリンクをクリックします。

ダイアログフィールドで、以下のように​ ダイアログ/タブパネル/テキスト/テキスト ​をクリックします。

textedit

このフィールドのプロパティリストが、以下のようにダイアログエディターの右側に表示されます。

list_of_properties

このフィールドの name プロパティに注意してください。次の値が設定されています

./jcr:content/par/text/text

これは、基礎モードを使用してページを作成する際に、このフィールドのコンテンツが書き込まれるプロパティの名前です。プロパティは、作成するページを表すノードからの相対パスとして指定します。page ノードの下の jcr:content ノードの子である par ノードの下にある、text ノードの下の text プロパティを指定します。

これにより、このフィールドに入力されるテキストのコンテンツストレージの場所が定義されます。ただし、このコンテンツに対して、さらに 2 つの特性を指定する必要があります。

  • ここに格納された文字列は「リッチテキスト」として解釈される必要があるということ、および
  • 生成されるページに対してこのコンテンツをレンダリングする際に使用するコンポーネント。

通常のコンポーネントダイアログでは、このダイアログが既に特定のコンポーネントにバインドされていることが暗黙的に定義されているので、この情報を指定する必要はありません。

これら 2 つの情報を指定するには、非表示フィールドを使用します。以下のように、ダイアログ/タブパネル/テキスト/非表示 ​をクリックして、最初の非表示フィールドを選択します。

hidden

この非表示フィールドのプロパティを以下に示します。

hidden_list_props

この非表示フィールドの name プロパティには以下の値が指定されています。

./jcr:content/par/text/textIsRich

これは、./jcr:content/par/text/text に格納されたテキスト文字列の解釈に使用されるブール値プロパティです。

テキストはリッチテキストとして解釈する必要があるので、このフィールドの value プロパティを true に指定します。

CAUTION
ダイアログエディターを使用すると、ユーザーがダイアログ定義の​ 既存の ​プロパティの値を変更できます。新しいプロパティを追加するには、ユーザーは CRXDE Lite を使用する必要があります。例えば、ダイアログエディターを使用して新しい非表示フィールドをダイアログ定義に追加した場合、value プロパティ(つまり、「value」という名前のプロパティ)はありません。問題の非表示フィールドにデフォルトの value プロパティを設定する必要がある場合は、いずれかの CRX ツールを使用して、このプロパティを手動で追加する必要があります。値は、ダイアログエディターに追加することはできません。ただし、プロパティが存在する場合は、その値をダイアログエディターで編集できます。

2 つ目の非表示フィールドは、以下のようにクリックして表示できます。

hidden2

この非表示フィールドのプロパティを以下に示します。

hidden_list_props2

この非表示フィールドの name プロパティには以下の値が指定されています。

./jcr:content/par/text/sling:resourceType

また、このプロパティには以下の固定値が指定されています。

foundation/components/textimage

これは、この段落のテキストコンテンツのレンダリングに使用するコンポーネントが​ テキスト画像 ​コンポーネントであることを指定しています。他の非表示フィールドで指定されている isRichText ブール値を使用すると、./jcr:content/par/text/text に格納された実際のテキスト文字列を希望の方法でコンポーネントがレンダリングできます。

MSM の継承による基礎モード scaffolding-with-msm-inheritance

クラシック UI では、基礎モードは MSM 継承が完全に統合されています(該当する場合)。

(サイドキックの下部にあるアイコンを使用して)ページを​ 基礎モード ​モードで開くと、継承の対象となるすべてのコンポーネントは次のように示されます。

  • ロック記号(テキストやタイトルなどのほとんどのコンポーネントの場合)
  • クリックして継承をキャンセル」と記載されたマスク(画像コンポーネントの場合)

これらは、継承がキャンセルされるまでコンポーネントを編集できないことを示します。

chlimage_1

ロック記号または画像アイコンのいずれかをクリックすると、継承が解除されます。

  • 記号が開かれた南京錠に変わります。
  • ロックを解除したら、コンテンツを編集できます。

chlimage_1-1

ロックを解除した後は、ロックが解除された南京錠の記号をクリックすることで継承を復元できます。これにより、加えた変更はすべて破棄されます。

NOTE
継承がページレベルで(ページプロパティの「ライブコピー」タブから)キャンセルされた場合、すべてのコンポーネントはで編集できます。 基礎モード モード(ロック解除状態で表示されます)
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2