商品アドバイザー XML 検索スペース作成ファイル DTD

以下のリストのエレメント定義は、分離および基本検索スペースの両方に適用されます。 エレメントに異なるデータが必要な場所を、該当箇所で例で示します。

ディレクティブ

attribute (属性)

説明

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 列の値と一致していなければなりません。 商品を価格に基づいて検索可能にしたい場合、2 つのオプションがあります。 どの価格に基づいて検索するかに応じて、<attrName> 値を LISTPRICE または PRICE のどちらにも設定できますが、 OFFERPRICE テーブルから標準価格を取得する、PRICE を使用することが推奨されています。 共通カタログ・エントリーを有する検索スペースの使用法において一貫性を持たせる必要があります。 詳細は、商品アドバイザーでの価格の性質を参照してください。

構文

<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

説明

このエレメントで、メタフォー内の属性を識別するために使用する名前を指定します。 分離検索スペースの場合、これは分離テーブルで使用される列名に対応します。 基本検索スペースの場合、これは、列で表される属性の基本テーブルで使用される列名と一致していなければなりません。 ATTRVALUE テーブルの属性は、attrName が正しければ任意の固有名を使用できます。 商品アドバイザーでは、幾つかの属性には特定の columnNames が必要です。 例:

分離検索スペースの場合
  • catentry ID の prrfnbr
  • 価格の ppprc
  • 通貨の setccurr
  • 部品番号の prnbr
基本検索スペースの場合
  • catentry ID の catentry_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
    attribute を組み込んではいけません。
    1
    attribute を組み込む必要があります。

<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 エレメントは、attribute エレメントに組み込むことができます。
  • 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 エレメントは、NLVDesc エレメントに組み込むことができます。
  • scale エレメントは、その他のエレメントを含んでいません。

<scale>0</scale>

使用法

説明

このエレメントは属性のデータのタイプを定義します。

構文

<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 著作権