產品顧問 XML 搜尋空間建立檔 DTD

下列元素定義清單適用於個別和基礎搜尋空間。 適當的話,這些範例也會顯示元素需要不同資料之處。

控制指令

attribute

說明

屬性元素用以說明搜尋空間的產品屬性。

語法

<attribute>
...attribute content...
</attribute>

環境定義

基礎搜尋空間範例

<attribute>
   <columnName>PRICE</columnName>
   <length>16</length>
   <include>1</include>
   <type>com.ibm.commerce.pa.datatype.DsCurrency</type>
   <NLVdesc>
      <language>-1</language>
      <attrName>PRICE</attrName>
      <description>MSRP</description>
      <scale>2</scale>
      <precision>15</precision>
      <unitOfMeasure></unitOfMeasure>
   </NLVdesc>
</attribute>

個別搜尋空間範例

<attribute>
   <columnName>PPPRC</columnName>
   <length>16</length>
   <include>1</include>
   <type>com.ibm.commerce.pa.datatype.DsCurrency</type>
   <NLVdesc>
      <language>-1</language>
      <attrName>PRICE</attrName>
      <description>MSRP</description>
      <scale>2</scale>
      <precision>15</precision>
      <unitOfMeasure></unitOfMeasure>
   </NLVdesc>
</attribute>

attrName

說明

此元素用以定義屬性的名稱。如果是基礎搜尋空間,這個名稱應該符合它在基礎表格中所對應的直欄名稱。 如果是使用 ATTRVALUE 表格中之屬性值的個別搜尋空間,這個名稱應該符合 ATTRIBUTE 表格 NAME 直欄中的值。 如果您要使產品成為可根據價格來搜尋,您有兩個選擇。 您可以根據要作為搜尋依據的價格,將 <attrName> 值設為 LISTPRICE 或 PRICE,但建議您使用 PRICE,因為它會從 OFFERPRICE 表格取得標準價格。 在含有共同型錄項目的所有搜尋空間中,用法必須維持一致。 如果需要詳細資訊,請參閱「產品顧問」中的價格規則

語法

<attrName>attribute_name
</attrName>

環境定義

範例

<attrName>PRICE</attrName>

catalogBuilder

說明

必要元素。此元素用以定義 XML 搜尋空間建立檔的啟動。

語法

<catalogBuilder>...XML search space creation file content...
</catalogBuilder>

環境定義

基礎搜尋空間範例

<catalogBuilder>
    <delete_catalogBuilder CID="6001">
    <category CID="6001">
        <attribute>
            <columnName>Color</columnName>
            <length>254</length>
            <include>1</include>
            <type>com.ibm.commerce.pa.datatype.DsString</type>
            <NLVdesc>
                <language>-1</language>
                <attrName>Color</attrName>
                <description>Color</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
            <NLVdesc>
                <language>-2</language>
                <attrName>Color_fr</attrName>
                <description>Color2</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
        </attribute>
        <attribute>
            <columnName>Size</columnName>
            <length>254</length>
            <include>1</include>
            <type>com.ibm.commerce.pa.datatype.DsString</type>
            <NLVdesc>
                <language>-1</language>
                <attrName>Size</attrName>
                <description>Size</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
        </attribute>
    </category>
    <category CID="6000">
        <attribute>
            <columnName>Color</columnName>
            <length>254</length>
            <include>1</include>
            <type>com.ibm.commerce.pa.datatype.DsString</type>
            <NLVdesc>
                <language>-1</language>
                <attrName>Color</attrName>
                <description>Color</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
            <NLVdesc>
                <language>-2</language>
                <attrName>Color_fr</attrName>
                <description>Color2</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
        </attribute> 
    </category>
</catalogBuilder>

個別搜尋空間範例

<catalogBuilder>
    <delete_catalogBuilder CID="6001">
    <category CID="6001">
        <attribute>
            <columnName>F_Color</columnName>
            <length>254</length>
            <include>1</include>
            <type>com.ibm.commerce.pa.datatype.DsString</type>
            <NLVdesc>
                <language>-1</language>
                <attrName>Color</attrName>
                <description>Color</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
            <NLVdesc>
                <language>-2</language>
                <attrName>fr_Color_fr</attrName>
                <description>Color2</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
        </attribute>
        <attribute>
            <columnName>F_Size</columnName>
            <length>254</length>
            <include>1</include>
            <type>com.ibm.commerce.pa.datatype.DsString</type>
            <NLVdesc>
                <language>-1</language>
                <attrName>Size</attrName>
                <description>Size</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
        </attribute>
    </category>
    <category CID="6000">
        <attribute>
            <columnName>F_Color</columnName>
            <length>254</length>
            <include>1</include>
            <type>com.ibm.commerce.pa.datatype.DsString</type>
            <NLVdesc>
                <language>-1</language>
                <attrName>Color</attrName>
                <description>Color</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
            <NLVdesc>
                <language>-2</language>
                <attrName>fr_Color_fr</attrName>
                <description>Color2</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
        </attribute> 
    </category>
</catalogBuilder>

category

說明

此元素用以指出應建置搜尋空間的種類。

語法

<category>...category content...
</category>

環境定義

基礎搜尋空間範例

<category CID="6000">
        <attribute>
            <columnName>Color</columnName>
            <length>254</length>
            <include>1</include>
            <type>com.ibm.commerce.pa.datatype.DsString</type>
            <NLVdesc>
                <language>-1</language>
                <attrName>Color</attrName>
                <description>Color</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
            <NLVdesc>
                <language>-2</language>
                <attrName>Color_fr</attrName>
                <description>Color2</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
        </attribute> 
    </category>

個別搜尋空間範例

<category CID="6000">
        <attribute>
            <columnName>F_Color</columnName>
            <length>254</length>
            <include>1</include>
            <type>com.ibm.commerce.pa.datatype.DsString</type>
            <NLVdesc>
                <language>-1</language>
                <attrName>Color</attrName>
                <description>Color</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
            <NLVdesc>
                <language>-2</language>
                <attrName>fr_Color_fr</attrName>
                <description>Color2</description>
                <scale>0</scale>
                <precision>0</precision>
                <unitOfMeasure></unitOfMeasure>
            </NLVdesc>
        </attribute> 
    </category>

columnName

說明

這個元素指定用來識別虛擬狀態中之屬性的名稱。 如果是個別搜尋空間,它對應於個別表格中所用的直欄名稱。 如果是基礎搜尋空間,它應該符合直欄中所表示之屬性在基礎表格中所用的直欄名稱。 只要 attrName 是正確的,ATTRVALUE 表格中的屬性可使用任何唯一名稱。 「產品顧問」預期部份屬性會有特定 columnNames。比方說:

個別搜尋空間:
  • prrfnbr,型錄項目 ID
  • ppprc,代表價格
  • setccurr,代表貨幣
  • prnbr,代表產品編號
基礎搜尋空間:
  • catentry_id,型錄項目 ID
  • partnumber,代表產品編號
  • currency,代表貨幣

請參閱虛擬狀態建立 XML 檔中的屬性定義,取得詳細資訊。

語法

<columnName>column_name</columnName>

環境定義

  • columnName 元素只能含在 attribute 元素中。
  • columnName 元素中不含其它元素。

delete_CatalogBuilder

說明

選用元素。此元素用以刪除所指種類的搜尋空間。

語法

<delete_CatalogBuilder CID="category_ID">

category_ID 值用以指出所要刪除的搜尋空間。此值必須和在 WebSphere Commerce 資料庫中找到的種類 ID 吻合。

環境定義

  • deleteCatalogBuilder 種類只能含在 catalogBuilder 元素中。
  • deleteCatalogBuilder 元素中不含其它元素。

範例

<delete_catalogBuilder CID="6001">

description

說明

此元素用以定義屬性的說明。

語法

<description>description</description>

環境定義

  • description 元素可含在 NLVDesc 元素中。
  • description 元素中不含其它元素。

範例

<description>Color2</description>

include

include 元素用以指出屬性是否可供顯示。

語法

<include>include</include>

環境定義

  • include 元素可含在 attribute 元素中。
  • include 元素中不含其它元素。
  • 可接受 0-1 間的數字。這些值有其對應意義:
    0
    不應包含屬性。
    1
    應包含屬性。

範例

<include>1</include>

language

說明

此元素用以定義 NLVDesc 元素的目標語言碼。

語法

<language>language_ID</language>

環境定義

  • language 元素可含在 NLVDesc 元素中。
  • language 元素中不含其它元素。

範例

<language>-2</language>

length

說明

此元素用以定義資料庫表格中所容許的資料長度。

語法

<length>length</length>

環境定義

  • length 元素可含在 attribute 元素中。
  • length 元素中不含其它元素。

範例

<length>254</length>

NLVdesc

說明

此元素用以說明特定語言的屬性。每一個元素在每一種支援的語言方面應各有一個 NLVDesc 元素。

語法

<NLVDesc>
...NLVDesc content...
</NLVDesc>

環境定義

基礎搜尋空間範例

<NLVdesc>
    <language>-2</language>
    <attrName>Color_fr</attrName>
    <description>Color2</description>
    <scale>0</scale>
    <precision>0</precision>
    <unitOfMeasure></unitOfMeasure>
</NLVdesc>

個別搜尋空間範例

<NLVdesc>
    <language>-2</language>
    <attrName>fr_Color_fr</attrName>
    <description>Color2</description>
    <scale>0</scale>
    <precision>0</precision>
    <unitOfMeasure></unitOfMeasure>
</NLVdesc>

precision

說明

此元素用以定義屬性的精確度。

語法

<precision>precision</precision>

環境定義

  • precision 元素可含在 NLVDesc 元素中。
  • precision 元素中不含其它元素。

範例

<precision>0</precision>

scale

說明

此元素用以定義屬性的小數位數。

語法

<scale>scale</scale>

環境定義

  • scale 元素可含在 NLVDesc 元素中。
  • scale 元素中不含其它元素。

範例

<scale>0</scale>

type

說明

此元素用以定義屬性的資料類型。

語法

<type>type</type>

環境定義

  • type 元素可含在 attribute 元素中。
  • type 元素中不含其它元素。

範例

<type>com.ibm.commerce.pa.datatype.DsString</type>

unitOfMeasure

說明

這個選用元素用以定義屬性的度量單位。

語法

<unitOfMeasure>unit type</unitOfMeasure>

環境定義

  • unitOfMeasure 元素可含在 attribute 元素中。
  • unitOfMeasure 元素中不含其它元素。

範例

<unitOfMeasure></unitOfMeasure>

IBM copyright