商品アドバイザー XML 入力ファイル DTD

ディレクティブ

answer

説明

応答エレメントは、セールス・アシスタント・メタフォーの質問と応答のツリーの質問に応答をカプセル化します。 特定の質問に対して、複数の応答がある場合があります。

コンテキスト

構文

<answer>
...answer コンテンツ...
</answer>

<answer>
   <orderseq>1</orderseq>
   <conceptinfo>
      <lang_id>-1</lang_id>
      <conceptName>none</conceptName>
      <elaboration>null</elaboration>
   </conceptinfo>
   <constraint>
      <pfReference>1</pfReference>
      <columnName>F_CDROM</columnName>
      <operation>1</operation>
      <opValueType>com.ibm.commerce.datatype.DsString</opValueType>
      <opVal>
         <lang_id>-1</lang_id>
         <opValue>none</opValue>
      </opVal>
   </constraint>
   </answer>

builder

説明

必須エレメントです。 このエレメントは XML 入力ファイルの開始を定義します。

構文

<builder>

...XML input file...

</builder>

コンテキスト

category

説明

必須エレメントです。 このエレメントは、以下のメタフォーが定義されるカテゴリーを定義します。

構文

<category ID="category_ref_num">

...XML input file...

</category>

category_ref_num 値は、メタフォーが適用するカテゴリーの参照番号を識別します。 これは WebSphere Commerce データベースにあるカテゴリー参照番号と一致していなければなりません。

コンテキスト

<category ID="1">
...metaphor content...
</category>

columnName

説明

必須エレメントです。 このエレメントは、親エレメントのデータベースで使用される列名を定義します。 この columnName は、検索スペースの作成に使用される columnName と一致していなければなりません。 検索スペースを生成するために作成した XML ファイルを参照してください。

構文

<columnName>column_name</columnName>

コンテキスト

<columnName>F_CDROM</columnName>

conceptInfo

説明

構文

<conceptInfo>
...conceptInfo content...
</conceptInfo>

コンテキスト

<conceptinfo>
   <lang_id>-1</lang_id>
   <conceptName>none</conceptName>
   <elaboration>null</elaboration>
</conceptinfo>

conceptName

説明

ショッパーに表示する質問または応答のテキスト。

構文

<conceptName>concept_name</conceptName>

コンテキスト

<conceptName>Concept 2</conceptName>

constraint

説明

このエレメントは、セールス・アシスタンス・メタフォー内で連続している質問と応答の間で渡される制約を定義します。

構文

<constraint>

...constraint content...

</constraint>

コンテキスト

<constraint>
   <pfReference>1</pfReference>
   <columnName>PPPRC</columnName>
   <operation>3</operation>
   <opValueType>com.ibm.commerce.datatype.DsCurrency</opValueType>
   <opVal>
      <lang_id>-1</lang_id>
      <opValue>6099.0</opValue>
   </opVal>
   <opVal>
      <lang_id>-2</lang_id>
      <opValue>2</opValue>
   </opVal>
</constraint>

delete_productComparer

説明

オプションのエレメントです。 このエレメントは、 現在定義済みの商品比較メタフォーを削除すべきであることを指示します。

構文

<delete_productComparer>

コンテキスト

delete_productExplorer

説明

オプションのエレメントです。 このエレメントは、現在定義済みの商品探査較メタフォーを削除すべきであることを指示します。

構文

<delete_productExplorer>

コンテキスト

delete_salesAssistant

説明

オプションのエレメントです。 このエレメントは、定義現在済みセールス・アシスタント。メタフォーを削除すべきであることを指示します。

構文

<delete_salesAssistant SACID="SA_category_ID">

SA_category_ID 値は、削除するセールス・アシスタント・メタフォーを識別します。 これは WebSphere Commerce データベースにあるカテゴリー ID 番号と一致していなければなりません。

コンテキスト

display

このエレメントは、親フィーチャーを表示するかどうかを定義します。

構文

<display>display</display>

説明

コンテキスト

<display>1</display>

elaboration

このエレメントは将来の利用のために予約されていて、常に NULL に設定されています。

構文

<elaboration>elaboration</elaboration>

コンテキスト

<elaboration>NULL</elaboration>

feature

説明

必須エレメントです。 このエレメントは、 このメタフォーを使用する比較の基本となっているフィーチャーを定義します。

構文

<feature>

...feature specification...

</feature>

コンテキスト

  • feature エレメントは、productComparer および productExplorer エレメントに組み込むことができます。
  • feature エレメントには、以下のエレメントを含めることができます:
    • 1 つの columnName エレメント
    • 1 つの order エレメント
    • 1 つのオプションの display エレメント
    • 1 つのオプションの sort エレメント
    • 1 つのオプションの widget エレメント

<feature>
   <columnName>PPPRC</columnName>
   <order>4</order>
   <display>1</display>
   <sort>1</sort>
   <widget>com.ibm.commerce.pa.widget.DropDownListFormElement</widget>
</feature>

lang_id

説明

オプションのエレメントです。 このエレメントは、親エレメントの言語を定義します。

構文

<lang_id>language_identifier</lang_id>

コンテキスト

  • lang_id エレメントは、conceptInfo および opVal エレメントに組み込むことができます。
  • lang_id エレメントは、他のエレメントを含んでいません。

<lang_id>-2</lang_id>

metaCategoryId

説明

metaCategoryId は、このメタフォー・リンクに使用するカテゴリーのメタフォーを指定します。

構文

<metaCategoryId>metaCategoryID_number</metaCategoryId>

コンテキスト

  • metaCategoryId エレメントは metaphorLink エレメント中に含めることができます。
  • metaCategoryId エレメントには他のエレメントは含まれません。

<metaCategoryId>1</metaCategoryId>

metaphorLink

説明

このエレメントは、セールス・アシスタンス応答のリンク、または定義済みの応答がないときに使用するデフォルト・リンクを定義します。

構文

<metaphorLink>
...metaphor_link_content...
</metaphorLink>

コンテキスト

<metaphorLink>
   <metaCategoryId>1</metaCategoryId>
   <metaphorName>com.ibm.commerce.pa.metaphor.ProductComparerMetaphor</metaphorName>
   <templateName>/webapp/wcs/stores/servlet/pc51.jsp</templateName>
   <templateUsage>0</templateUsage>
   <passConstraint>1</passConstraint>
</metaphorLink>

metaphorName

説明

このエレメントは、宛先メタフォーの名前を定義します。

構文

<metaphorName>metaphor_name</metaphorName>

コンテキスト

  • metaphorName エレメントは、metaphorLink エレメントに組み込むことができます。
  • metaphorName エレメントは、他のエレメントを含んでいません。

<metaphorName>com.ibm.commerce.pa.metaphor.ProductComparerMetaphor</metaphorName>

operation

説明

このエレメントは、制約を評価するために実行する演算を定義します。

構文

<operation>operation_number</operation>

コンテキスト

  • operation エレメントは、constraint エレメントに組み込むことができます。
  • operation エレメントは、他のエレメントを含んでいません。
  • 1 - 4 の間の数を受け入れます。 これらの値とそれに対応する意味は次の通りです。
    1
    これは「等しい」(=) 演算と対応しています。
    2
    これは「等しくない」(!=) 演算と対応しています。
    3
    これは「より大か等しい」(>=) 演算と対応しています。
    4
    これは「より小か等しい」(<=) 演算と対応しています。

<operation>3</operation>

opVal

説明

このエレメントは、言語固有の制約情報を定義します。

構文

<opVal>

...opVal content...

</opVal>

コンテキスト

  • opVal エレメントは、constraint エレメントに組み込むことができます。
  • opVal エレメントには、以下のエレメントだけを含めることができます。

<opVal>
   <lang_id>-1</lang_id>
   <opValue>6099.0</opValue>
<opVal>

opValue

説明

このエレメントは、制約の基にしたい値を将来のために定義します。 これは、親 <constraint> エレメントに指定された <columnName> エレメントで見つかる値です。

構文

<opValue>opValue</opValue>

コンテキスト

  • opValue エレメントは、opVal エレメントに組み込むことができます。
  • opValue エレメントは、他のエレメントを含んでいません。

<opValue>6099.0</opValue>

opValueType

説明

有効なタイプは ICDATAREG テーブル中に見つかります。

構文

<opValueType>op_value_type</opValueType>

コンテキスト

  • opValueType エレメントは、constraint エレメントに組み込むことができます。
  • opValueType エレメントは、他のエレメントを含んでいません。

<opValueType>com.ibm.commerce.datatype.DsCurrency</opValueType>

order

説明

このエレメントは、表示される別のフィーチャー内のオーダーを定義します。

構文

<order>order</order>

コンテキスト

  • order エレメントは、feature エレメントに組み込むことができます。
  • order エレメントは、他のエレメントを含んでいません。

<order>1</order>

orderSeq

必須エレメントです。 このエレメントは、セールス・アシスタンス・メタフォー内の質問と応答の表示順序を定義します。

構文

<orderSeq>orderSeq_number</orderSeq>

説明

コンテキスト

  • orderSeq エレメントは、answer および question エレメントに組み込むことができます。
  • orderSeq エレメントは、他のエレメントを含んでいません。

<orderseq>1</orderseq>

passConstraint

説明

制約を宛先リンクに渡すかどうかを判別するブール変数。 この値が 0 に設定されていると、制約は渡されません。 1 に設定されていると、制約が渡されます。

構文

<passConstraint>passConstraint_number</passConstraint>

コンテキスト

  • passConstraint エレメントは、metaphorLink エレメントに組み込むことができます。
  • passConstraint エレメントは、他のエレメントを含んでいません。

<passConstraint>1</passConstraint>

pfReference

説明

カテゴリーまたは商品ファミリー ID。

構文

<pfReference>pfReference_number</pfReference>

コンテキスト

  • pfReference エレメントは、constraint エレメントに組み込むことができます。
  • pfReference エレメントは、他のエレメントを含んでいません。

<pfReference>1</pfReference>

productComparer

説明

オプションのエレメントです。 このエレメントは、商品比較メタフォーの開始を定義します。

構文

<productComparer>

...metaphor content...

</productComparer>

コンテキスト

  • productComparer エレメントは、category エレメントに組み込むことができます。
  • productComparer には、以下のエレメントを含めることができます。
    • 1 つの template エレメント
    • 任意の個数のオプションの feature エレメント

productExplorer

説明

オプションのエレメントです。 このエレメントは、商品探査メタフォーの開始を定義します。

構文

<productExplorer>

...metaphor content...

</productExplorer>

コンテキスト

  • productExplorer エレメントは、category エレメントに組み込むことができます。
  • productExplorer エレメントには、以下のエレメントを含めることができます。
    • 1 つの template エレメント
    • 任意の個数のオプションの feature エレメント

qnaTree

説明

オプションのエレメントです。 このエレメントは、セールス・アシスタントの全質問および応答をカプセル化します。

構文

<qnaTree>

...question and answer tree content...

</qnaTree>

コンテキスト

  • qnaTree エレメントは、salesAssistant エレメントにだけ組み込むことができます。
  • qnaTree エレメントには、以下のエレメントだけを含めることができます。
    • 1 つの rootQuestion エレメント
    • 任意の個数のオプションの answer エレメント

<qnaTree>
   <rootQuestion>
      <conceptinfo>
         <lang_id>-1</lang_id>
         <conceptName>Price Question</conceptName>
         <elaboration>null</elaboration>
      </conceptinfo>
   </rootQuestion>
   <answer>
      <orderseq>1</orderseq>
      <conceptinfo>
         <lang_id>-2</lang_id>
         <conceptName>Concept 2</conceptName>
      </conceptinfo>
      <constraint>
         <pfReference>1</pfReference>
         <columnName>PPPRC</columnName>
         <operation>3</operation>
         <opValueType>com.ibm.commerce.datatype.DsCurrency</opValueType>
         <opVal>
            <lang_id>-1</lang_id>
            <opValue>6099.0</opValue>
         </opVal>
         <opVal>
            <lang_id>-2</lang_id>
            <opValue>2</opValue>
         </opVal>
      </constraint>
      <metaphorLink>
         <metaCategoryId>1</metaCategoryId>
         <metaphorName>com.ibm.commerce.pa.metaphor.ProductExplorerMetaphor</metaphorName>
         <templateName>/webapp/wcs/stores/servlet/pe51.jsp</templateName>
         <templateUsage>0</templateUsage>
         <passConstraint>1</passConstraint>
      </metaphorLink>
   </answer>
   <answer>
      <orderseq>2</orderseq>
      <conceptinfo>
         <lang_id>-1</lang_id>
         <conceptName>Low</conceptName>
      </conceptinfo>
      <constraint>
         <pfReference>1</pfReference>
         <columnName>PPPRC</columnName>
         <operation>4</operation>
         <opValueType>com.ibm.commerce.datatype.DsCurrency</opValueType>
         <opVal>
            <lang_id>-1</lang_id>
            <opValue>7099.0</opValue>
         </opVal>
      </constraint>
      <question>
         <orderseq>1</orderseq>
         <conceptinfo>
             <lang_id>-1</lang_id>
            <conceptName>Low</conceptName>
            <elaboration>null</elaboration>
         </conceptinfo>
         <answer>
            <orderseq>1</orderseq>
            <conceptinfo>
               <lang_id>-1</lang_id>
               <conceptName>none</conceptName>
               <elaboration>null</elaboration>
            </conceptinfo>
            <constraint>
               <pfReference>1</pfReference>
               <columnName>F_CDROM</columnName>
               <operation>1</operation>
               <opValueType>com.ibm.commerce.datatype.DsString</opValueType>
               <opVal>
                  <lang_id>-1</lang_id>
                  <opValue>none</opValue>
               </opVal>
            </constraint>
         </answer>
      </question>
   </answer>
</qnaTree>

question

説明

question エレメントは、セールス・アシスタント・メタフォーの質問および応答のツリーの質問をカプセル化します。

構文

<question>

...question content...

</question>

コンテキスト

  • question エレメントは、answer エレメントだけ組み込むことができます。
  • question エレメントには、以下のエレメントだけを含めることができます。
    • 1 つの orderSeq エレメント
    • 1 つまたは複数の conceptInfo エレメント
    • 任意の個数のオプションの answer エレメント

<question>
   <orderseq>1</orderseq>
   <conceptinfo>
      <lang_id>-1</lang_id>
      <conceptName>Low</conceptName>
      <elaboration>null</elaboration>
   </conceptinfo>
   <answer>
      <orderseq>1</orderseq>
      <conceptinfo>
         <lang_id>-1</lang_id>
         <conceptName>none</conceptName>
         <elaboration>null</elaboration>
      </conceptinfo>
      <constraint>
         <pfReference>1</pfReference>
         <columnName>F_CDROM</columnName>
         <operation>1</operation>
         <opValueType>com.ibm.commerce.datatype.DsString</opValueType>
         <opVal>
            <lang_id>-1</lang_id>
           <opValue>none</opValue>
         </opVal>
      </constraint>
   </answer>
</question>

rootQuestion

説明

rootQuestion エレメントは、セールス・アシスタンス・メタフォーの質問と応答のツリーの主質問をカプセル化します。 主質問とは、新規セールス・アシスタンス・セッションが開始されると、常に最初に表示される質問のことです。

構文

<rootQuestion>

...root Question content...

</rootQuestion>

コンテキスト

  • rootQuestion エレメントは、qnaTree エレメントに組み込むことができます。
  • rootQuestion エレメントには、以下のエレメントだけを含めることができます。

<rootQuestion>
   <conceptinfo>
      <lang_id>-1</lang_id>
      <conceptName>Price Question</conceptName>
      <elaboration>null</elaboration>
   </conceptinfo>
   <conceptinfo>
      <lang_id>-2</lang_id>
      <conceptName>Price Question 2</conceptName>
   </conceptinfo>
</rootQuestion>

salesAssistant

説明

オプションのエレメントです。 このエレメントは、セールス・アシスタント・メタフォーの開始を定義します。

構文

<salesAssistant SACID="category_ID">

...metaphor content...

</salesAssistant>

SACID 値は、作成しようとしているセールス・アシスタント・メタフォーのカテゴリーを識別します。

コンテキスト

  • salesAssistant エレメントは、store エレメントに組み込むことができます。
  • salesAssistant エレメントには、以下のエレメントを含めることができます。

sort

このエレメントは、フィーチャー値が表示される順序を定義します。 この値が 1 に設定されていると、フィーチャーは昇順にソートされます。 この値が 2 に設定されていると、フィーチャーは降順にソートされます。

構文

<sort>sort</sort>

説明

コンテキスト

  • sort エレメントは、feature エレメントに組み込むことができます。
  • sort エレメントは、他のエレメントを含んでいません。

<sort>1</sort>

store (ストア)

説明

必須エレメントです。 このエレメントは、含められたメタフォーに適用されるストアを定義します。 メタフォーは、個々のストアに適用されますので、 XML 入力ファイルに定義されるメタフォーをもつ各ストアには、 固有のストア・エレメントをもたせる必要があります。

構文

<store SID="store_ref_num">

...XML input file...

</store>

store_ref_num 値は、メタフォーが適用するストア参照番号を識別します。 これは WebSphere Commerce データベースにあるストア参照番号と一致していなければなりません。

コンテキスト

  • store エレメントは、builder エレメントにだけ組み込むことができます。
  • store エレメントには、以下のエレメントを以めることができます。
    1. 任意の個数のオプションの category エレメント
    2. 任意の個数のオプションの salesAssistant エレメント

<store SID="1">

...XML input file...

</store>

template

説明

必須エレメントです。 このエレメントは、 このメタフォーを使用して、生成されるすべてのページのテンプレートとして使用する JSP を定義します。

構文

<template>template file</template>

コンテキスト

  • template テンプレートは、productExplorerproductComparer、 およびsalesAssistant エレメントに組み込むことができます。
  • template エレメントは、他のエレメントを含んでいません。

<template>/webapp/wcs/stores/servlet/sa51.jsp</template>

templateName

説明

このエレメントは、宛先メタフォーのテンプレートとして使用される JSP を定義します。

構文

<templateName>template_name</templateName>

コンテキスト

  • templateName エレメントは、metaphorLink エレメントに組み込むことができます。
  • templateName エレメントは、他のエレメントを含んでいません。

<templateName>/webapp/wcs/stores/servlet/pc51.jsp</templateName>

templateUsage

説明

このエレメントは、宛先メタフォーのテンプレートをどのように表示するかを定義します。

構文

<templateUsage>templateUsage_number</templateUsage>

コンテキスト

  • templateUsage エレメントは、metaphorLink エレメントに組み込むことができます。
  • templateUsage エレメントは、他のエレメントを含んでいません。
  • 0 - 3 の間の数を受け入れます。 これらの値とそれに対応する意味は次の通りです。
    0
    親セールス・アシスタンス・メタフォーに定義されているデフォルト metaphorLink を使用します。
    1
    前のメタフォー・ページを表示します。
    2
    この metaphorLink からの templateName を (デフォルトの代りに) 使用します。
    3
    URL へのリンク。

<templateUsage>0</templateUsage>

widget

説明

必須エレメントです。 このエレメントは、フィーチャー値を表示するために使用するウィジェットを定義します。

構文

<widget>widget_name</widget>

コンテキスト

  • widget エレメントは、feature エレメントに組み込むことができます。
  • widget エレメントは、他のエレメントを含んでいません。

<widget>com.ibm.commerce.pa.widget.DropDownListFormElement</widget>

IBM 著作権