產品顧問 XML 輸入檔 DTD

控制指令

answer

說明

answer 元素用以將回答納入到「銷售輔助」虛擬狀態問答樹內的某個問題中。不論哪一個問題皆可有多個回答。

環境定義

語法

<answer>
...answer content...
</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">
...虛擬狀態內容...
</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>
   <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 元素可含在 conceptInfoopVal 元素中。
  • 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 元素可含在 answerquestion 元素中。
  • orderSeq 元素中不含其它元素。

範例

<orderseq>1</orderseq>

passConstraint

說明

此 Boolean 變數用來決定是否應將限制傳給目標鏈結。 若值為 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 元素中可含有下列元素:

productExplorer

說明

選用元素。此元素用以定義「產品探索」虛擬狀態的啟動。

語法

<productExplorer>

...metaphor content...

</productExplorer>

環境定義

  • productExplorer 元素可含在 category 元素中。
  • productExplorer 元素中可含有下列元素:

qnaTree

說明

選用元素。此元素用以納入「銷售輔助」虛擬狀態的整個問答樹。

語法

<qnaTree>

...question and answer tree content...

</qnaTree>

環境定義

範例

<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 元素中可含有下列元素:

範例

<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 值指出所要建立之「銷售輔助」虛擬狀態的種類。

環境定義

sort

此元素用來定義特性值的顯示順序。若值為 1,則會按升冪順序來排序特性。若值為 2, 則會按降冪順序來排序特性。

語法

<sort>sort</sort>

說明

環境定義

  • sort 元素可含在 feature 元素中。
  • sort 元素中不含其它元素。

範例

<sort>1</sort>

store

說明

必要元素。此元素用以定義要套用所含之虛擬狀態的商店。 虛擬狀態會套用在個別的商店上,且凡具有 XML 輸入檔中所定義之虛擬狀態的商店,皆必須有一個唯一的 store 元素。

語法

<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>/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 copyright