テンプレートについて

Templates​を使用して、プレゼンテーションテンプレートと転送テンプレートを管理できます。

テンプレートについて

プレゼンテーションテンプレートとトランスポートテンプレートは、追加、編集、コピー、名前の変更または削除が可能です。 「テンプレート」(Templates)テーブル内の既存のテンプレート名をクリックすると、そのテンプレートがエディタ(またはビューア)ウィンドウに開き、変更を加えることができます。

「テンプレート」(Templates)テーブルのテンプレート名のドロップダウンリストから、「ヒストリー」(History)機能を使用してテンプレートに加えた変更は、すべて元に戻すことができます。

テンプレートテーブル内のテンプレートに対応する​Minimize​チェックボックスをオンにすると、プレゼンテーションテンプレートのページ重み付けを減らすことができます。 テンプレートのページ重み付けを減らすことで、インラインのJavaScriptとCSSを動的に最小化できます。 また、HTML内の重複した空白を削除します。 プレゼンテーションテンプレートのページ重み付けを最小化すると、検索結果をより迅速に配信するのに役立ちます。

ファイル名の横のドロップダウンリストをクリックし、Preview minimized​をクリックすると、最小化したテンプレートの外観をプレビューできます。 メインのプレゼンテーションテンプレートを最小限に抑える場合は、(guided-includeタグと共に)含めるテンプレートの最小化を必ず有効にしてください。このオプションは継承できないからです。

プレゼンテーションテンプレートを最小化しても、同じテンプレートの「最小化解除」バージョンを編集できます。

検索前のルール、検索後のルールおよびビジネスルールを使用して、他のプレゼンテーションテンプレートのどちらかを使用するタイミングを決定できます。 「検索ごとに、ターゲットテンプレートをxxxxに設定」などのルールを設定するのは一般的です。 このようなルールを適用した場合、テンプレートテーブルで「デフォルト」テンプレートを変更しても効果がないように見えます。

Pre-Search Rulesについてを参照してください。

検索後のルールについてを参照してください。

ビジネスルールについてを参照してください。

プレゼンテーションテンプレートについて

プレゼンテーションテンプレートは、顧客がWebサイト上で検索結果を表示する際に表示するHTMLテンプレートです。

プレゼンテーションレイヤーには、様々なソースからの複数の検索結果を表示する、単一のプレゼンテーションテンプレートを用意することができます。 プレゼンテーションテンプレートは必要な数だけ定義でき、includeコマンドを使用して、他のテンプレートが共有するプレゼンテーションテンプレートも定義できます。 プレゼンテーションテンプレートは、ファセット、メニュー、パンくずリストなど、すべてのデザインコンポーネントを組み合わせる場所です。 様々なデザインコンポーネントを表示するには、プレゼンテーションテンプレートタグを使用する必要があります。

プレゼンテーションテンプレートタグを参照

複数のプレゼンテーションテンプレートがある場合は、使用する各種プレゼンテーションテンプレートを、どの条件で定義します。 受信するCGIパラメーターとCookieに基づいて、使用するプレゼンテーションテンプレートを選択できます。 また、以前の検索の結果に基づいて、使用しているプレゼンテーションテンプレートを切り替えることもできます。

複数のプレゼンテーションテンプレートを使用する場合は、検索結果を最初に表示するテンプレートを指定してください。 これは、Templatesテーブルの​Default​列を使用して行うことができます。

トランスポートテンプレートについて

トランスポートテンプレートは、バックエンド検索からGuided Searchプレゼンテーションレイヤーにデータを渡すXMLまたはJSONテンプレートにすることができます。

デフォルトでは、アカウントはXMLトランスポートテンプレートを使用するように設定されています。 ただし、JSONを使用してガイド付き検索にデータを渡す場合は、Adobeコンサルティングにお問い合わせください。

プレゼンテーションレイヤーには、複数の検索結果を表示する単一のプレゼンテーションテンプレートを用意することができます。 各検索では、同じトランスポートテンプレートまたはカスタムトランスポートテンプレートを使用して、プレゼンテーションレイヤーにデータを渡すことができます。 トランスポートテンプレートはプレゼンテーションレイヤーにデータを渡す目的でのみ使用されるので、検索結果の表示に使用するHTMLを持つことはできません。 テンプレートは、トランスポートテンプレートタグを使用して検索の結果とファセットに入力する結果を渡します。 これらのタグ内では、標準の検索テンプレートタグを使用して実際の値が表示されます。

検索テンプレートタグを参照してください。

XML Transport Template固有のタグ

XMLトランスポートテンプレートタグ

説明

<guided-xml></guided-xml>

これらは、プレゼンテーションレイヤーがトランスポートテンプレートから解析する必要のある内容を検出するために使用するルートXMLタグです。

<general></general>

この一連のタグは、結果セットに基づく概要データを提供する検索テンプレートタグを囲みます。 通常、これらのタグには、結果の合計数、最小の結果、最大の結果の検索タグが含まれます。 general-field タグを使用して、任意の数の追加のグローバルフィールドを定義できます。

    <general>       <total><search-total /></total>       <lower><search-lower /></lower>       <upper><search-upper /></upper>       <general-field name="my_custom_field">Some global content</general-field>     </general>

<results></results>

この一連のタグは検索結果に含まれるので、ガイド付き検索では検索場所がわかります。

<result></result>

この一連のタグは各検索結果に含まれるので、ガイド付き検索は1つの検索結果開始のコンテンツのどこを認識し、その終わりを識別します。

    <results>       <search-results>         <result>           <index><search-index /></index>           <loc><search-cdata><search-url length="500" /></search-cdata></loc>         </result>       </search-results>     </results>

<attribute-table name="tablename">

このタグを使用すると、複数値のリストで各項目をループ処理して1つの結果を得ることができます。 タグは結果内でのみ使用します。 主な目的は、結果フィールドに属する属性を繰り返し実行できるようにすることです。

      <results>         <search-results>           <result>             <index><search-index /></index>             <loc><search-url /></loc>             <title><search-title /></title>             <attribute-table name="downloads">               <field name="download_title"><search-display-field name="download_title" /></field>               <field name="download_link" delimiter="|"><search-display-field name="download_link" /></field>             </attribute-table>           </result>         </search-results>       </results>

<facets></facets>

このタグのセットは、ファセットを設定する結果を渡します。

<facet name="name"></facet>

名前パラメーターがファセット名と一致するファセットには、それぞれ独自のファセットタグが必要です。 検索タグは、ファセット値のファセットタグ内で使用されます。

ファセットについてを参照してください。

    <facets>       <facet name="brand">         <values><search-field-value-list name="brand" quotes="no" commas="yes" data="values" sortby="values" /></values>         <counts><search-field-value-list name="brand" quotes="no" commas="yes" data="counts" sortby="values" /></counts>       </facet>       <facet name="category">         <values><search-field-value-list name="category" quotes="no" commas="yes" data="values" sortby="values" /></values>         <counts><search-field-value-list name="category" quotes="no" commas="yes" data="counts" sortby="values" /></counts>       </facet>     </facets>

<suggestions></suggestions>

この一連のタグは、「Did You Mean」の提案をラップするので、ガイド付き検索では、提案が含まれるXMLノードが認識されます。

<suggestion></suggestion>

この一連のタグは、各「Did You Mean」サーチクエリをラップします。

    <search-if-suggestions>       <suggestions>         <search-suggestions>           <suggestion>             <value><search-suggestion-text /></value>             <count><search-suggestion-result-count /></count>           </suggestion>         </search-suggestions>       </suggestions>     </search-if-suggestions>

JSONトランスポートテンプレート固有のタグ

JSONとXMLを検索エンジンから渡す方が、ペイロードが小さく、パーサーが高速なので、処理が高速であることがわかっています。 ただし、JSONを使用して出力内容が厳密なJSONであることを確認する場合は、パーサーが許可しないので注意が必要です。

JSONを初めて使用する場合は、次のリンクと例を使用して作業を開始できます。

JSONテンプレートの例

{ 
 "general": 
 { 
  "total" : "<search-total />", 
  "lower" : "<search-lower />", 
  "upper" : "<search-upper />", 
  "rbt-trigger-list" : "<search-rbta-trigger-id-list>", 
  "fields" :  
  [ 
   { 
    "name" : "seo_search_title", 
    "value" : "<search-include file="seo/seo_search_title.tpl" />" 
   }, 
   { 
    "name" : "seo_search_keywords", 
    "value" : "<search-include file="seo/seo_search_keywords.tpl" />" 
   } 
  ] 
 }, 
 
 <search-if-suggestions> 
 "suggestions": 
  [ 
  <search-suggestions> 
  { 
   "suggestion":"<search-suggestion-text />", 
   "count": "<search-suggestion-result-count>" 
  }<search-if-not-last-suggestion>,</search-if-not-last-suggestion> 
  </search-suggestions> 
 ], 
 </search-if-suggestions> 
 
 "facets" : 
 [ 
  { 
   "name" : "leveli", 
   "values" : [ <search-field-value-list name="leveli" quotes="yes" sortby="values" data="values" encoding="json"/>], 
   "counts" : [<search-field-value-list name="leveli" quotes="no" sortby="values" data="results" />] 
  }, 
  { 
   "name" :"levelii", 
   "values" : [<search-field-value-list name="levelii" quotes="yes" sortby="values" data="values" encoding="json"/>], 
   "counts" : [<search-field-value-list name="levelii" quotes="no" sortby="values" data="results" />] 
  }, 
  { 
   "name" : "brand", 
   "values" : [<search-field-value-list name="brand" quotes="yes" sortby="values" data="values" encoding="json"/>], 
   "counts" : [<search-field-value-list name="brand" quotes="no" sortby="values" data="results" />] 
  }, 
 ], 
 "results" : 
 [ 
  <search-results> 
  { 
   "fields" : 
   [ 
    { 
     "name" : "index", 
     "value" : "<search-index />" 
    }, 
    { 
     "name" : "loc", 
     "value" : "<search-display-field name="url" length="500" encoding="json"/>" 
    }, 
    { 
     "name" : "title", 
     "value" : "<search-display-field name="title" encoding="json"/>" 
    }, 
    { 
     "name" : "img_url_thumbnail", 
     "value" : "<search-display-field name="img_url_thumbnail" encoding="json"/>" 
    }, 
    { 
     "name" : "description", 
     "value" : "<search-display-field name="description" encoding="json"/>" 
    }, 
    { 
     "name" : "mdi", 
     "value" : "<SEARCH-RBTA-DISPLAY-MDI-FIELD>" 
    } 
   ] 
  }<search-if-not-last>,</search-if-not-last>  
  </search-results> 
 ] 
}

結果属性テーブルを含むJSON結果セクションの例

{ 
 "results" : 
 [ 
  <search-results> 
  { 
   "fields" : 
   [ 
    { 
     "name" : "index", 
     "value" : "<search-index />" 
    }, 
    { 
     "name" : "loc", 
     "value" : "<search-display-field name="url" length="500" encoding="json"/>" 
    } 
   ], 
   "tables" : 
   [ 
    { 
     "name" : "downloads", 
     "fields" : 
     [ 
      { 
       "name" : "download_title", 
       "value" : <search-display-field name="download_title" encoding="json"/> 
      }, 
      { 
       "name" : "download_link", 
       "value" : <search-display-field name="download_link" encoding="json"/> 
      } 
     ] 
    } 
   ] 
  }<search-if-not-last>,</search-if-not-last>  
  </search-results> 
 ] 
}

関連付けられたフィールドを持つファセットのJSONファセットセクションの例

{ 
 facets" : 
 [ 
  { 
   "name" : "t1", 
   "values" : [<search-field-value-list name="t1" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />], 
   "counts" : [<search-field-value-list name="t1" quotes="yes" commas="yes" data="results" sortby="values" />], 
   "custom-fields" : 
   [ 
    { 
     "name" : "taxonmyId", 
     "value" : [<search-field-value-list name="tax1" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />] 
    } 
   ] 
  } 
 ] 
}

スロットファセットのJSONファセットセクションの例

{ 
  "facets" : 
  [  
   { 
    "name" : "fvalue0", 
                  "dynamic" : 1, 
                  "display-names" : [<search-field-value-list name="fname0" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />], 
    "values" : [<search-field-value-list name="fvalue0" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />], 
    "counts" : [<search-field-value-list name="fvalue0" quotes="no" commas="yes" data="results" sortby="values" />] 
   } 
  ] 
} 

新しいプレゼンテーションまたはトランスポートテンプレートファイルの追加

Add Template​を使用して、プレゼンテーションテンプレート(.tmpl)またはトランスポートテンプレート(.tpl)をTemplatesページに追加できます。

新しいプレゼンテーションまたはトランスポートテンプレートファイルを追加するには

  1. 製品メニューで、Design/Templates​をクリックします。

  2. Templatesページで、Add New Template​をクリックします。

  3. Add Templateダイアログボックスで、必要なオプションを設定します。

    オプション 説明
    新しいファイル名 追加するテンプレートの名前を指定します。 選択したテンプレートタイプに基づいて、適切なファイル拡張子がファイル名に自動的に追加されます。 プレゼンテーションテンプレートには.tmplファイル拡張子が付きます。トランスポートテンプレートのファイル拡張子は.tplです。
    新しいテンプレートタイプ 追加するプレゼンテーションまたはトランスポートテンプレートを選択できます。 テンプレートについてを参照してください。

    プレゼンテーションまたはトランスポートテンプレートの編集」も参照してください。

  4. クリック Add.

  5. (オプション)Templatesページで、次のいずれかの操作を行います。

プレゼンテーションまたはトランスポートテンプレートの編集

テンプレートエディターを使用して、プレゼンテーションの内容を表示および編集し、テンプレートファイルを転送することができます。

Webサイトの訪問者が引き続きテンプレートのライブバージョンを使用する間、ステージングされたプレゼンテーションやトランスポートのテンプレートを編集およびテストできます。 ステージングされたテンプレートは、検索ドメインのURLのステージングされたバージョンを使用してテストします。 例えば、ステージングされたクエリ(sp_staged=1)を実行し、トランスポートテンプレートの名前に設定されたsp_tを使用して、ステージングされたトランスポートテンプレートをテストできます。 レイアウトの表示に満足したら、テンプレートエディター内で​Push Live​を使用してテンプレートをライブにします。 テンプレートがライブになると、サイトの訪問者はテンプレートの使用を開始します。

プレゼンテーションテンプレートタグ参照を使用して、ファセット、パンくずリスト、メニューなどのガイド付き検索コンポーネントにプレゼンテーションテンプレートを接続する方法を学習します。

プレゼンテーションテンプレートタグを参照

トランスポートテンプレートで使用するタグの詳細については、トランスポートテンプレートタグ参照を参照してください。

トランスポートテンプレートタグを参照

To edit a presentation or a transport template

  1. 製品メニューで、Design/Templates​をクリックします。

  2. Templatesページで、プレゼンテーションまたはトランスポートテンプレートファイル名をクリックします。

  3. Template Editorページで、タグとコーディングを変更します。

    Template Editor;で行う変更には注意が必要です。元に戻す機能はありません。 意図しない変更を行い、前のバージョンのファイルに戻る場合は、Cancel​をクリックしてテンプレートの表に戻ります(その時点まで変更を保存していない場合)。 変更を保存済みの場合は、エディターで​History​を使用して、変更を元に戻すことができます。

  4. (オプション)Insert Symbol​をクリックして、米国英語のキーボードに対応するキーを持たない特殊文字や記号を入力します。

  5. クリック Save Changes.

  6. (オプション)次のいずれかの操作を行います。

  7. 終了したら、テンプレートエディタページを閉じます。「テンプレート」ページに戻ります。

プレゼンテーションまたはトランスポートテンプレートファイルのコピー

Copy Template​を使用すると、既存のプレゼンテーションテンプレート(.tmpl)またはトランスポートテンプレート(.tpl)を複製してテンプレートページに追加することで、時間を節約できます。

テンプレート名、テンプレートタイプ、またはその両方を変更する必要があります。 変更を行わない場合、テンプレートはコピーされません。

テンプレートをコピーするには、既にテンプレートを追加しておく必要があります。

新しいプレゼンテーションまたはトランスポートテンプレートファイルの追加」を参照してください。

プレゼンテーションまたはトランスポートテンプレートファイルをコピーするには

  1. 製品メニューで、Design/Templates​をクリックします。

  2. Templatesページの、コピーするテンプレート名の横にあるドロップダウンリストで、Copy​をクリックします。

  3. Copy Templateダイアログボックスで、必要な1つ以上のオプションを設定します。

  4. クリック Copy.

  5. (オプション)次のいずれかの操作を行います。

プレゼンテーションまたはトランスポートテンプレートファイルの名前の変更

Rename Templateを使用して、既存のプレゼンテーションテンプレート(.tmpl)またはトランスポートテンプレート(.tpl)の名前を変更できます。

必要に応じて、テンプレートタイプを変更することもできます。

テンプレート名を変更するには、既にテンプレートを追加しておく必要があります。

新しいプレゼンテーションまたはトランスポートテンプレートファイルの追加」を参照してください。

プレゼンテーションまたはトランスポートテンプレートファイルの名前を変更するには

  1. 製品メニューで、Design/Templates​をクリックします。

  2. Templatesページの、名前を変更するテンプレート名の横にあるドロップダウンリストで、Rename​をクリックします。

  3. Rename Templateダイアログボックスで、必要な1つ以上のオプションを設定します。

  4. クリック Rename.

  5. (オプション)次のいずれかの操作を行います。

プレゼンテーションまたはトランスポートテンプレートファイルの削除

Delete Template​を使用して、既存のプレゼンテーションテンプレート(.tmpl)またはトランスポートテンプレート(.tpl)を削除できます。

ライブにプッシュされたステージテンプレートに対応するバージョンが既に存在する可能性があります。 テンプレートが存在する場合は、必ず​Staging​を使用して削除済みの環境をライブにプッシュし、ライブテンプレートからも削除されるようにしてください。 または、テンプレートページで​Push Live​を使用できます。

ステージングについてを参照

ステージ設定をライブにプッシュするを参照

テンプレートを削除するには、既にテンプレートを追加しておく必要があります。

新しいプレゼンテーションまたはトランスポートテンプレートファイルの追加」を参照してください。

プレゼンテーションまたはトランスポートテンプレートファイルを削除するには

  1. 製品メニューで、Design/Templates​をクリックします。

  2. Templatesページの、削除するテンプレート名の横にあるドロップダウンリストで、Delete​をクリックします。

  3. Delete Templateダイアログボックスで、Delete.​をクリックします

  4. (オプション)次のいずれかの操作を行います。

最小化したプレゼンテーションテンプレートのプレビュー

プレゼンテーションテンプレートを最小限に抑える場合、Preview minimized​を使用して、プレゼンテーションテンプレートの縮小ページ重み付けがどのように表示されるかを確認できます。

メインのプレゼンテーションテンプレートを最小限に抑える場合は、(ガイド付きインクルードタグと共に)テンプレートを含める際の最小化を必ず有効にしてください。これは、このオプションは継承できないからです。

プレゼンテーションテンプレートのページ重み付けを減らすを参照してください…

テンプレートは、最小化した状態で、プレビューに既に追加されている必要があります。

新しいプレゼンテーションまたはトランスポートテンプレートファイルの追加」を参照してください。

トランスポートテンプレートファイルのXMLコードをプレビューできます。

トランスポートテンプレートファイルのXMLのプレビュー」を参照してください。

プレゼンテーションテンプレートを最小化してプレビューするには

  1. 製品メニューで、Design/Templates​をクリックします。

  2. Templatesページのプレゼンテーションテンプレート名の横のドロップダウンリストで、Preview minimized​をクリックします。

    テンプレートテーブルの​Type​列を使用して、プレゼンテーションとトランスポートでテンプレートを並べ替えます。

  3. (オプション)Preview Minimized Templateページで、Wrap lines​をチェックして、定義されたウィンドウ内のタグを読み取ります。

  4. クリック Close.

  5. (オプション)次のいずれかの操作を行います。

Webサイト上のプレゼンテーションテンプレートのページ重み付けを減らす

テンプレートテーブルの​Minimize​オプションを使用すると、プレゼンテーションテンプレートのページ重み付けを減らすことができます。

テンプレートのページ重み付けを減らすことで、インラインのJavaScriptとCSSを動的に最小化できます。 また、HTML内の重複した空白を削除します。 プレゼンテーションテンプレートのページ重み付けを最小化すると、検索結果をより迅速に配信するのに役立ちます。

Preview minimized​を使用して、最小化したプレゼンテーションテンプレートの外観をプレビューすることもできます。

最小化したプレゼンテーションテンプレートのプレビューを参照してください。

To reduce the page weight of a presentation template on your website

  1. 製品メニューで、Design/Templates​をクリックします。

  2. TemplatesページのMinimize列の下で、Webサイト上で最小限に抑えてプッシュする1つ以上のプレゼンテーションテンプレートファイルのチェックボックスをオンにします。

    Templatesテーブルの​Type​列を使用して、テンプレートをプレゼンテーションとトランスポートで並べ替えます。

  3. (オプション)次のいずれかの操作を行います。

Webサイトで使用するデフォルトのプレゼンテーションテンプレートファイルの設定

複数のプレゼンテーションテンプレートがある場合、検索結果の表示に最初に使用するテンプレートを指定できます。

検索前のルール、検索後のルールおよびビジネスルールを使用して、他のプレゼンテーションテンプレートの1つを使用するタイミングを決定できます。

Pre-Search Rulesについてを参照してください。

検索後のルールについてを参照してください。

ビジネスルールについてを参照してください。

「検索ごとに、対象のプレゼンテーションテンプレートをxxxxに設定する」などのルールを設定するのは一般的です。 このようなルールを適用した状態で、テンプレートページの「デフォルト」テンプレートを変更しても何も起こりません。

To set the default presentation template file to use on your website

  1. 製品メニューで、Design/Templates​をクリックします。

  2. TemplatesページのDefault列の下で、デフォルトとして使用する対応するプレゼンテーションテンプレートファイルのラジオボタンをクリックします。

    Templatesテーブルの​Type​列を使用して、テンプレートをプレゼンテーションとトランスポートで並べ替えます。

  3. (オプション)次のいずれかの操作を行います。

トランスポートテンプレートファイルのXMLのプレビュー

Previewを使用して、追加したトランスポートテンプレートのXMLを確認できます。

テンプレートのXMLには、既にプレビューにトランスポートテンプレートを追加しておく必要があります。

新しいプレゼンテーションまたはトランスポートテンプレートファイルの追加」を参照してください。

最小化したプレゼンテーションテンプレートファイルをプレビューして、その縮小ページ重み付けを表示できます。

最小化したプレゼンテーションテンプレートのプレビューを参照してください。

トランスポートテンプレートファイルのXMLをプレビューするには

  1. 製品メニューで、Design/Templates​をクリックします。

  2. Templatesページのトランスポートテンプレート名の横のドロップダウンリストで、Preview​をクリックします。

    Templatesテーブルの​Type​列を使用して、テンプレートをプレゼンテーションとトランスポートで並べ替えます。

  3. 表示ウィンドウを閉じてsite search/merchandisingに戻ります。

  4. (オプション)次のいずれかの操作を行います。

このページ