Show Menu
トピック×

テンプレートについて

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

テンプレートについて

プレゼンテーションテンプレートとトランスポートテンプレートを追加、編集、コピー、名前の変更または削除できます。 「テンプレート」(Templates)テーブル内の既存のテンプレート名をクリックすると、エディタ(またはビューア)ウィンドウで開き、変更を加えることができます。
テンプレートに対して行った変更は、「テンプレート」(Templates)テーブルのテンプレート名のドロップダウンリストから、「ヒストリー」(History)機能を使用して元に戻すことができます。
テンプレートテーブル内のテンプレートの対応するチェックボックスをオンにすることで、プレゼンテーションテンプレートのペ Minimize ージの重みを軽減することができます。 テンプレートのページの重みを減らすことで、インラインのJavaScriptとCSSを動的に最小限に抑えることができます。 また、HTML内の重複した空白を削除します。 プレゼンテーションテンプレートのページの重みを最小限に抑えると、検索結果をより迅速に配信できます。
最小化したテンプレートの外観をプレビューするには、ファイル名の横のドロップダウンリストをクリックし、をクリックしま Preview minimized ​す。 メインのプレゼンテーションテンプレートを最小限に抑える場合は、(タグに付属の)テンプレートを最小限に抑えることを忘れないでください。このオプションは継承でき guided-include ないためです。
プレゼンテーションテンプレートを最小化しても、同じテンプレートの「最小化されていない」バージョンを編集できます。
検索前のルール、検索後のルール、ビジネスルールを使用して、他のプレゼンテーションテンプレートの1つを使用するタイミングを決定できます。 「検索ごとに、対象のテンプレートをxxxxに設定する」などのルールを持つのが一般的です。 このようなルールを適用した状態で、「テンプレート」(Templates)テーブルの「デフォルト」(Default)テンプレートを変更しても、何の影響も与えないように見えます。

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

プレゼンテーションテンプレートは、顧客がWebサイトで検索結果を表示する際に表示されるHTMLテンプレートです。
プレゼンテーションレイヤーには、さまざまなソースからの複数の検索結果を表示する単一のプレゼンテーションテンプレートを用意できます。 必要な数のプレゼンテーションテンプレートを定義したり、他のテンプレートが共有するプレゼンテーションテンプレートをコマンドを使用して定義することも include できます。 プレゼンテーションテンプレートは、ファセット、メニュー、パンくずリストなど、すべてのデザインコンポーネントを組み合わせる場所です。 様々なデザインコンポーネントを表示するには、プレゼンテーションテンプレートタグを使用する必要があります。
複数のプレゼンテーションテンプレートがある場合は、使用する各種プレゼンテーションテンプレートを、どの条件で定義します。 受信するCGIパラメーターとcookieに基づいて、使用するプレゼンテーションテンプレートを選択できます。 また、以前の検索の結果に基づいて、使用しているプレゼンテーションテンプレートを切り替えることもできます。
複数のプレゼンテーションテンプレートを使用する場合は、検索結果を最初に表示するテンプレートを必ず指定してください。 これは、テンプレートテーブルの Default 列を使用して行います。

転送テンプレートについて

トランスポートテンプレートは、バックエンド検索からガイド付き検索プレゼンテーションレイヤーにデータを渡すXMLまたはJSONテンプレートのいずれかです。
デフォルトでは、アカウントはXMLトランスポートテンプレートを使用するように設定されています。 ただし、JSONを使用してガイド付き検索にデータを渡す場合は、アドビのコンサルティング担当者にお問い合わせください。
プレゼンテーションレイヤーには、複数の検索結果を表示する単一のプレゼンテーションテンプレートを含めることができます。 各検索では、同じトランスポートテンプレートまたはカスタムトランスポートテンプレートを使用して、プレゼンテーションレイヤーにデータを渡すことができます。 トランスポートテンプレートは、プレゼンテーションレイヤーにデータを渡す目的でのみ使用されるので、検索結果の表示に使用するHTMLを持つことはできません。 テンプレートは、トランスポートテンプレートタグを使用して、検索の結果とファセットの入力の結果を渡します。 これらのタグ内では、標準の検索テンプレートタグを使用して実際の値が表示されます。
XML Transport Template固有のタグ
XMLトランスポートテンプレートタグ
説明
<guided-xml></guided-xml>
これらは、プレゼンテーションレイヤーがトランスポートテンプレートから何を解析する必要があるかを検出するために使用するルートXMLタグです。
<general></general>
この一連のタグは、結果セットに基づいて概要データを提供する検索テンプレートタグを囲みます。 通常、これらのタグには、結果の合計数、最小結果、最大結果を示す検索タグが含まれます。 汎用フィールドタグを使用して、任意の数の追加のグローバルフィール ドを定義で きます。
    <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>
この一連のタグは検索結果に含まれるので、ガイド付き検索では検索場所がわかります。
<結果></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>
このタグのセットは、ファセットを設定する結果を渡します。
<facet name="name"></facet>
各ファセットには、nameパラメーターがファセット名と一致する独自のファセットタグが必要です。 検索タグは、ファセット値のファセットタグ内で使用されます。
ファセットにつ いてを参照してくだ さい。
    <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>
この一連のタグは、ガイド付き検索でどのXMLノードに提案が含まれているかを認識できるように、「Did You Mean」の提案をラップします。
<提案></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の紹介。 https://www.json.org/を参照し てください
  • JSONをテストして、有効であることを確認します。 https://jsonlint.com/を参照し てください
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コードをプレビューできます。
最小化したプレゼンテーションテンプレートをプレビューするには
  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 列の下で、Webサイ Minimize ト上で最小限に抑えて表示する1つ以上のプレゼンテーションテンプレートファイルのチェックボックスをオンにします。
    表の列を使 Type 用して、テ Templates ンプレートをプレゼンテーションと転送で並べ替えます。
  3. (オプション)次のいずれかの操作を行います。

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

複数のプレゼンテーションテンプレートがある場合、検索結果の表示に最初に使用するテンプレートを指定できます。
検索前のルール、検索後のルールおよびビジネスルールを使用して、他のプレゼンテーションテンプレートの1つを使用するタイミングを決定できます。
「検索ごとに、対象のプレゼンテーションテンプレートをxxxxに設定する」などのルールを設定するのは一般的です。 このようなルールを適用した状態で、テンプレートページの「デフォルト」テンプレートを変更しても効果がないように見えます。
To set the default presentation template file to use on your website
  1. 製品メニューで、/をクリッ Design クしま Templates ​す。
  2. ページの Templates 列の下で、デフ Default ォルトとして使用する対応するプレゼンテーションテンプレートファイルのラジオボタンをクリックします。
    表の列を使 Type 用して、テ Templates ンプレートをプレゼンテーションと転送で並べ替えます。
  3. (オプション)次のいずれかの操作を行います。

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

を使用して、追 Preview 加したトランスポートテンプレートのXMLを確認できます。
テンプレートのXMLをプレビューするには、既にトランスポートテンプレートを追加しておく必要があります。
最小化したプレゼンテーションテンプレートファイルをプレビューして、ページの重さを軽減できます。
トランスポートテンプレートファイルのXMLをプレビューするには
  1. 製品メニューで、/をクリッ Design クしま Templates ​す。
  2. ページで、 Templates トランスポートテンプレート名の横のドロップダウンリストで、をクリックしま Preview ​す。
    表の列を使 Type 用して、テ Templates ンプレートをプレゼンテーションと転送で並べ替えます。
  3. 表示ウィンドウを閉じ、に戻りま site search/merchandisingす。
  4. (オプション)次のいずれかの操作を行います。