DTD del file di creazione dello spazio di ricerca XML di Product Advisor

Il seguente elenco di definizioni di elementi è valido sia per lo spazio di ricerca separato che per quello di base. Dove appropriato, l'esempio illustra dove gli elementi richiedono dati differenti.

Direttive

attributo

Descrizione

L'elemento attributo descrive gli attributi del prodotto per lo spazio di ricerca.

Sintassi

<attribute>
...contenuto dell'attributo...
</attribute>

Contesto

Esempio di spazi di ricerca di base

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

Esempio di spazi di ricerca separati

<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

Descrizione

Questo elemento definisce il nome dell'attributo. Per gli spazi di ricerca di base, tale nome deve corrispondere al nome della colonna al quale corrisponde nelle tabelle di base. Per gli spazi di ricerca separati, che utilizzano i valori degli attributi nella tabella ATTRVALUE, questo nome deve corrispondere al valore della colonna NAME della tabella ATTRIBUTE. Se si desidera ricercare i prodotti in base al prezzo, sono disponibili due opzioni. E' possibile impostare il valore <attrName> su LISTPRICE o su PRICE, a seconda del prezzo su cui si desidera basare la ricerca, anche se è consigliabile impostare il valore su PRICE, che riceve il presso standard dalla tabella OFFERPRICE. E' necessario utilizzare in modo coerente gli spazi di ricerca che condividono le voci di catalogo. Per ulteriori informazioni, consultare la sezione relativa all'azione dei prezzi in Product Advisor.

Sintassi

<attrName>
nome dell'attributo
</attrName>

Contesto

Esempio

<attrName>PRICE</attrName>

catalogBuilder

Descrizione

Un elemento richiesto. Questo elemento definisce l'avvio del file della creazione dello spazio di ricerca XML.

Sintassi

<catalogBuilder>
...contenuto del file di creazione dello spazio di ricerca XML...
</catalogBuilder>

Contesto

Esempio di spazi di ricerca di base

<catalogBuilder>
    <delete_catalogBuilder CID="6001">
    <category CID="6001">
        <attributo>
            <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>

Esempio di spazi di ricerca separati

<catalogBuilder>
    <delete_catalogBuilder CID="6001">
    <category CID="6001">
        <attributo>
            <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

Descrizione

Questo elemento indica una categoria per la quale viene creato uno spazio di ricerca.

Sintassi

<category>
...contenuto della categoria...
</category>

Contesto

Esempio di spazi di ricerca di base

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

Esempio di spazi di ricerca separati

<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

Descrizione

Questo elemento specifica il nome da utilizzare per identificare l'attributo nelle metafore. Per gli spazi di ricerca separati, esso corrisponde al nome della colonna utilizzato nelle tabelle separate. Per lo spazio di ricerca di base, deve corrispondere al nome della colonna utilizzata nelle tabelle di base per gli attributi rappresentati nelle colonne. Gli attributi nella tabella ATTRVALUE possono utilizzare qualsiasi nome univoco fino a che attrName è corretto. Per Product Advisor è necessario che alcuni attributi dispongano di particolari columnNames. Ad esempio:

Per lo spazio di ricerca separato:
  • prrfnbr per gli ID catentry
  • ppprc per il prezzo
  • setccurr per la valuta
  • prnbr per il numero di parte
Per lo spazio di ricerca di base:
  • catentry_id per gli ID catentry
  • partnumber per il numero di parte
  • currency per la valuta

Per ulteriori informazioni, consultare la sezione Definizioni dell'attributo nel file XML di creazione della metafora.

Sintassi

<columnName>nome_colonna</columnName>

Contesto

  • L'elemento columnName può essere incluso soltanto in un elemento attribute.
  • L'elemento columnName non contiene altri elementi.

delete_CatalogBuilder

Descrizione

Un elemento facoltativo. Questo elemento elimina lo spazio di ricerca per la categoria indicata.

Sintassi

<delete_CatalogBuilder CID="category_ID">

Il valore category_ID identifica lo spazio di ricerca da eliminare. Questo valore deve corrispondere all'ID di categoria trovato nel database di WebSphere Commerce.

Contesto

  • L'elemento deleteCatalogBuilder può essere incluso soltanto in un elemento catalogBuilder.
  • L'elemento deleteCatalogBuilder non può contenere altri elementi.

Esempio

<delete_catalogBuilder CID="6001">

descrizione

Descrizione

Questo elemento definisce una descrizione per l'attributo.

Sintassi

<description>description</description>

Contesto

  • L'elemento description può essere incluso soltanto negli elementi NLVDesc.
  • L'elemento description non contiene altri elementi.

Esempio

<description>Color2</description>

include

L'elemento include specifica se è possibile visualizzare l'attributo.

Sintassi

<include>include</include>

Contesto

  • L'elemento include può essere incluso negli elementi attribute.
  • L'elemento include non contiene altri elementi.
  • Accetta un numero compreso tra 0 e 1. Questi valori hanno il seguente significato:
    0
    L'attributo non deve essere incluso.
    1
    L'attributo deve essere incluso.

Esempio

<include>1</include>

language

Descrizione

Questo elemento definisce il codice della lingua di destinazione dell'elemento NLVDesc.

Sintassi

<language>language_ID</language>

Contesto

  • L'elemento language può essere incluso nell'elemento NLVDesc.
  • L'elemento language non contiene altri elementi.

Esempio

<language>-2</language>

length

Descrizione

Questo elemento definisce la lunghezza dei dati consentiti nella tabella di database.

Sintassi

<length>length</length>

Contesto

  • L'elemento length può essere incluso negli elementi attribute.
  • L'elemento length non contiene altri elementi.

Esempio

<length>254</length>

NLVdesc

Descrizione

Questo elemento descrive l'attributo per una particolare lingua. Ogni elemento deve disporre di un elemento NLVDesc per ogni lingua supportata.

Sintassi

<NLVDesc>
...contenuto NLVDesc...
</NLVDesc>

Contesto

Esempio di spazi di ricerca di base

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

Esempio di spazi di ricerca separati

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

precision

Descrizione

Questo elemento definisce la precisione di un attributo.

Sintassi

<precision>precision</precision>

Contesto

  • L'elemento precision può essere incluso negli elementi NLVDesc.
  • L'elemento precision non contiene altri elementi.

Esempio

<precision>0</precision>

scale

Descrizione

Questo elemento definisce la scala dell'attributo.

Sintassi

<scale>scale</scale>

Contesto

  • L'elemento scale può essere incluso negli elementi NLVDesc.
  • L'elemento scale non contiene altri elementi.

Esempio

<scale>0</scale>

type

Descrizione

Questo elemento definisce il tipo di dati dell'attributo.

Sintassi

<type>type</type>

Contesto

  • L'elemento type può essere incluso negli elementi attribute.
  • L'elemento type non contiene altri elementi.

Esempio

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

unitOfMeasure

Descrizione

Questo elemento facoltativo definisce l'unità di misura dell'attributo.

Sintassi

<unitOfMeasure>unit type</unitOfMeasure>

Contesto

  • L'elemento unitOfMeasure può essere incluso negli elementi attribute.
  • L'elemento unitOfMeasure non contiene altri elementi.

Esempio

<unitOfMeasure></unitOfMeasure>

IBM copyright