DTD del archivo de entrada XML del Asesor de productos

Directivas

answer

Descripción

El elemento answer encapsula una respuesta a una pregunta en el árbol de preguntas y respuestas de la metáfora del Asistente de ventas. Pueden haber varias respuestas a una pregunta determinada.

Contexto

Sintaxis

<answer>
...contenido de la respuesta...
</answer>

Ejemplo

<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

Descripción

Un elemento necesario. Este elemento define el inicio del archivo de entrada XML.

Sintaxis

<builder>

...archivo XML de entrada...

</builder>

Contexto

category

Descripción

Un elemento necesario. Este elemento define la categoría para la que se están definiendo las metáforas.

Sintaxis

<category ID="núm_ref_categoría">

...archivo XML de entrada...

</category>  

El valor de núm_ref_categoría identifica al número de referencia de categoría al que se aplica la metáfora. Debe coincidir con el número de referencia de categoría que aparece en la base de datos de WebSphere Commerce.

Contexto

Ejemplo

<category ID="1">
...contenido de la metáfora...
</category>

columnName

Descripción

Un elemento necesario. Este elemento define el nombre de columna que se utiliza en la base de datos para el elemento padre. El elemento columnName debe coincidir con el columnName utilizado al crear el espacio de búsqueda. Debe consultar el archivo XML que ha creado para generar su espacio de búsqueda.

Sintaxis

<columnName>nombre_columna</columnName>

Contexto

Ejemplo

<columnName>F_CDROM</columnName>

conceptInfo

Descripción

Sintaxis

<conceptInfo>
...contenido de conceptInfo...
</conceptInfo>

Contexto

Ejemplo

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

conceptName

Descripción

El texto de la pregunta o respuesta que verá el comprador.

Sintaxis

<conceptName>nombre_concepto</conceptName>

Contexto

Ejemplo

<conceptName>Concept 2</conceptName>

constraint

Descripción

Este elemento define las restricciones que se pasan entre las preguntas y respuestas sucesivas dentro de una metáfora del Asistente de ventas.

Sintaxis

<constraint>

...contenido de constraint...

</constraint>

Contexto

Ejemplo

<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

Descripción

Un elemento opcional. Este elemento indica que la metáfora de Comparación de productos definida actualmente debe suprimirse.

Sintaxis

<delete_productComparer>

Contexto

delete_productExplorer

Descripción

Un elemento opcional. Este elemento indica que la metáfora del Explorador de productos definida actualmente debe suprimirse.

Sintaxis

<delete_productExplorer>

Contexto

delete_salesAssistant

Descripción

Un elemento opcional. Este elemento indica que la metáfora del Asistente de ventas definida actualmente debe suprimirse.

Sintaxis

<delete_salesAssistant SACID="SA_category_ID">

El valor de SA_category_ID identifica la metáfora del Asistente de ventas que se ha de suprimir. Debe coincidir con el número de ID de categoría que aparece en la base de datos de WebSphere Commerce.

Contexto

display

Este elemento define si debe visualizarse o no la característica padre.

Sintaxis

<display>display</display>

Descripción

Contexto

Ejemplo

<display>1</display>

elaboration

Este elemento está reservado para su uso futuro y debe establecerse siempre en NULL.

Sintaxis

<elaboration>elaboration</elaboration>

Contexto

Ejemplo

<elaboration>NULL</elaboration>

feature

Descripción

Un elemento necesario. Este elemento define la característica que es la base de comparación para utilizar esta metáfora.

Sintaxis

<feature>

...especificación de feature...

</feature>

Contexto

Ejemplo

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

lang_id

Descripción

Un elemento opcional. Este elemento define el idioma del elemento padre.

Sintaxis

<lang_id>identificador_idioma</lang_id>

Contexto

  • El elemento lang_id se puede incluir en los elementos conceptInfo y opVal.
  • El elemento lang_id no contiene otros elementos.

Ejemplo

<lang_id>-2</lang_id>

metaCategoryId

Descripción

El elemento metaCategoryId especifica qué metáfora de categoría debe utilizarse para este enlace de metáfora.

Sintaxis

<metaCategoryId>número_metaCategoryID</metaCategoryId>

Contexto

  • El elemento metaCategoryId se puede incluir en los elementos metaphorLink.
  • El elemento metaCategoryId no contiene otros elementos.

Ejemplo

<metaCategoryId>1</metaCategoryId>

metaphorLink

Descripción

Este elemento define el enlace para una respuesta del Asistente de ventas, o el enlace por omisión que se ha de utilizar cuando una respuesta no tiene uno definido.

Sintaxis

<metaphorLink>
...contenido_de_metaphor_link...
</metaphorLink>

Contexto

Ejemplo

<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

Descripción

Este elemento define el nombre de la metáfora de destino.

Sintaxis

<metaphorName>nombre_metáfora</metaphorName>

Contexto

  • El elemento metaphorName se puede incluir en los elementos metaphorLink.
  • El elemento metaphorName_id no contiene otros elementos.

Ejemplo

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

operation

Descripción

Este elemento define la operación que se ha de realizar para evaluar la restricción.

Sintaxis

<operation>número_operación</operation>

Contexto

  • El elemento operation se puede incluir en los elementos constraint.
  • El elemento operation no contiene otros elementos.
  • Acepta un número entre 1-4. Estos valores tienen un significado:
    1
    Significa la operación "igual a" (=)
    2
    Significa la operación "no igual a" (!=).
    3
    Significa la operación "mayor que o igual a" (>=).
    4
    Significa la operación "menor que o igual a" (<=).

Ejemplo

<operation>3</operation>

opVal

Descripción

Este elemento define información de restricción específica del idioma.

Sintaxis

<opVal>

...contenido de opVal...

</opVal>

Contexto

  • El elemento opVal se puede incluir en los elementos constraint.
  • El elemento opVal puede contener los elementos siguientes:

Ejemplo

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

opValue

Descripción

Este elemento define el valor de la característica en la que desea que esté basada la restricción. Este es el valor que se encontrará en el elemento <columnName> especificado para el elemento padre <constraint>.

Sintaxis

<opValue>opValue</opValue>

Contexto

  • El elemento opValue se puede incluir en los elementos opVal.
  • El elemento opValue no contiene otros elementos.

Ejemplo

<opValue>6099.0</opValue>

opValueType

Descripción

Los tipos válidos se pueden encontrar en la tabla ICDATAREG.

Sintaxis

<opValueType>tipo_valor_op</opValueType>

Contexto

  • El elemento opValueType se puede incluir en los elementos constraint.
  • El elemento opValueType no contiene otros elementos.

Ejemplo

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

order

Descripción

Este elemento define el orden en el que se visualizarán las diferentes características.

Sintaxis

<order>orden</order>

Contexto

  • El elemento order se puede incluir en los elementos feature.
  • El elemento order no contiene otros elementos.

Ejemplo

<order>1</order>

orderSeq

Un elemento necesario. Este elemento define la secuencia de visualización de preguntas y respuestas dentro de una pregunta realizada a la metáfora del Asistente de ventas.

Sintaxis

<orderSeq>número_orderSeq</orderSeq>

Descripción

Contexto

  • El elemento orderSeq se puede incluir en los elementos answer y question.
  • El elemento orderSeq no contiene otros elementos.

Ejemplo

<orderseq>1</orderseq>

passConstraint

Descripción

Una variable booleana que determina si debe pasarse o no una restricción al enlace de destino. Si el valor se establece en 0, no se pasará la restricción. Si se establece en 1, se pasará la restricción.

Sintaxis

<passConstraint>número_passConstraint</passConstraint>

Contexto

  • El elemento passConstraint se puede incluir en los elementos metaphorLink.
  • El elemento passConstraint no contiene otros elementos.

Ejemplo

<passConstraint>1</passConstraint>

pfReference

Descripción

El id de familia de productos o categorías.

Sintaxis

<pfReference>número_pfReference</pfReference>

Contexto

  • El elemento pfReference se puede incluir en los elementos constraint.
  • El elemento pfReference no contiene otros elementos.

Ejemplo

<pfReference>1</pfReference>

productComparer

Descripción

Un elemento opcional. Este elemento define el inicio de una metáfora de Comparación de productos.

Sintaxis

<productComparer>

...contenido de la metáfora...

</productComparer>

Contexto

  • El elemento productComparer se puede incluir en los elementos category.
  • El elemento productComparer puede contener los elementos siguientes:

productExplorer

Descripción

Un elemento opcional. Este elemento define el inicio de una metáfora del Explorador de productos.

Sintaxis

<productExplorer>

...contenido de la metáfora...

</productExplorer>

Contexto

  • El elemento productExplorer se puede incluir en los elementos category.
  • El elemento productExplorer puede contener los elementos siguientes:

qnaTree

Descripción

Un elemento opcional. Este elemento encapsula todo el árbol de preguntas y respuestas para una metáfora del Asistente de ventas.

Sintaxis

<qnaTree>

...contenido del árbol de preguntas y respuestas...

</qnaTree>

Contexto

  • El elemento qnaTree sólo puede incluirse en un elemento salesAssistant.
  • El elemento qnaTree puede contener los elementos siguientes:

Ejemplo

<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

Descripción

El elemento question encapsula una pregunta en el árbol de preguntas y respuestas de la metáfora del Asistente de ventas.

Sintaxis

<question>
...contenido de la pregunta...

</question>

Contexto

  • El elemento question sólo puede incluirse en un elemento answer.
  • El elemento question puede contener los elementos siguientes:

Ejemplo

<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

Descripción

El elemento rootQuestion encapsula la pregunta principal del árbol de preguntas y respuestas de la metáfora del Asistente de ventas. La pregunta principal es la pregunta que siempre se muestra en primer lugar cuando se inicia una nueva sesión del Asistente de ventas.

Sintaxis

<rootQuestion>

...contenido de rootQuestion...

</rootQuestion>

Contexto

  • El elemento rootQuestion se puede incluir en los elementos qnaTree.
  • El elemento rootQuestion sólo puede contener los elementos siguientes:

Ejemplo

<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

Descripción

Un elemento opcional. Este elemento define el inicio de una metáfora del Asistente de ventas.

Sintaxis

<salesAssistant SACID="category_ID">

...contenido de la metáfora...

</salesAssistant>

El valor de SACID identifica la categoría para la metáfora del Asistente de ventas que se está creando.

Contexto

  • El elemento salesAssistant se puede incluir en los elementos store.
  • El elemento salesAssistant puede contener los elementos siguientes:

sort

Este elemento define la secuencia en la que se visualizan los valores de la característica. Si el valor se establece en 1, las características se clasifican en orden ascendente. Si se establece en 2, las características se clasifican en orden descendente.

Sintaxis

<sort>sort</sort>

Descripción

Contexto

  • El elemento sort se puede incluir en los elementos feature.
  • El elemento sort no contiene otros elementos.

Ejemplo

<sort>1</sort>

store

Descripción

Un elemento necesario. Este elemento define la tienda para la que se aplican las metáforas contenidas. Las metáforas se aplican a tiendas individuales, y debe tener un elemento store exclusivo para cada tienda que tenga metáforas definidas en el archivo de entrada XML.

Sintaxis

<store SID="núm_ref_tienda">

...archivo XML de entrada...

</store>

El valor de núm_ref_tienda identifica el número de referencia de la tienda al que se aplica la metáfora. Debe coincidir con el número de referencia de tienda que aparece en la base de datos de WebSphere Commerce.

Contexto

  • Los elementos store sólo se pueden incluir en un elemento builder.
  • Los elementos store puede contener los elementos siguientes:
    1. Cualquier número de elementos category opcionales
    2. Cualquier número de elementos salesAssistant opcionales

Ejemplo

<store SID="1">

...archivo XML de entrada...

</store>

template

Descripción

Un elemento necesario. Este elemento define el archivo JSP que va a utilizar como plantilla para todas las páginas que se generen utilizando esta metáfora.

Sintaxis

<template>archivo de plantillas</template>

Contexto

Ejemplo

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

templateName

Descripción

Este elemento define el archivo JSP que se va a utilizar como plantilla para la metáfora de destino.

Sintaxis

<templateName>nombre_plantilla</templateName>

Contexto

  • El elemento templateName se puede incluir en los elementos metaphorLink.
  • El elemento templateName no contiene otros elementos.

Ejemplo

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

templateUsage

Descripción

Este elemento define cómo debe visualizarse la plantilla para la metáfora de destino.

Sintaxis

<templateUsage>número_templateUsage</templateUsage>

Contexto

  • El elemento templateUsage se puede incluir en los elementos metaphorLink.
  • El elemento templateUsage no contiene otros elementos.
  • Acepta un número entre 0-3. Estos valores tienen un significado:
    0
    Utilizar metaphorLink por omisión, según esté definido para la metáfora padre del Asistente de ventas.
    1
    Ir a la página de metáfora anterior.
    2
    Utilizar el templateName de este metaphorLink (en lugar del enlace por omisión).
    3
    Enlazar con un URL.

Ejemplo

<templateUsage>0</templateUsage>

widget

Descripción

Un elemento necesario. Este elemento define qué elemento widget se utilizará para visualizar los valores de las características.

Sintaxis

<widget>nombre_widget</widget>

Contexto

  • El elemento widget se puede incluir en los elementos feature.
  • El elemento widget no contiene otros elementos.

Ejemplo

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

IBM copyright