Assistant produit - DTD du fichier d'entrée XML

Instructions

answer

Description

L'élément answer encapsule une réponse dans une arborescence de questions et de réponses d'une fonction de recherche évoluée de l'Assistant de ventes. Plusieurs réponses peuvent coexister pour une même question.

Contexte

Syntaxe

<answer>
...contenu de la réponse...
</answer>

Exemple

<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

Description

Elément obligatoire. Cet élément définit le début du fichier d'entrée XML.

Syntaxe

<builder>

...fichier d'entrée XML...

</builder>

Contexte

category

Description

Elément obligatoire. Cet exemple définit la catégorie pour laquelle les fonctions de recherche évoluée suivantes sont en cours de définition.

Syntaxe

<category ID="category_ref_num">

...fichier d'entrée XML...

</category>

La valeur category_ref_num identifie la référence de catégorie concernée par la fonction de recherche évoluée. Cette dernière doit correspondre à la référence de catégorie trouvée dans la base de données WebSphere Commerce.

Contexte

Exemple

<category ID="1">
...contenu de la fonction de recherche évoluée...
</category>

columnName

Description

Elément obligatoire. Cet élément définit le nom de colonne utilisé dans la base de données pour l'élément parent. columnName doit correspondre à columnName utilisé pour la création de l'espace de recherche. Reportez-vous au fichier XML que vous avez créé pour générer votre espace de recherche.

Syntaxe

<columnName>nom_colonne</columnName>

Contexte

Exemple

<columnName>F_CDROM</columnName>

conceptInfo

Description

Syntaxe

<conceptInfo>
...contenu de conceptInfo...
</conceptInfo>

Contexte

Exemple

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

conceptName

Description

Question ou réponse à l'intention du client.

Syntaxe

<conceptName>nom_concept</conceptName>

Contexte

Exemple

<conceptName>Concept 2</conceptName>

constraint

Description

Cet élément définit les contraintes qui se dégagent des questions et réponses successives au cours d'une fonction de recherche évoluée Assistant de ventes.

Syntaxe

<constraint>

...contenu de constraint...

</constraint>

Contexte

Exemple

<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

Description

Elément facultatif. Cet élément indique que la fonction de recherche évoluée de comparaison actuellement définie doit être supprimée.

Syntaxe

<delete_productComparer>

Contexte

delete_productExplorer

Description

Elément facultatif. Cet élément indique que la fonction de recherche évoluée d'exploration des produits actuellement définie doit être supprimée.

Syntaxe

<delete_productExplorer>

Contexte

delete_salesAssistant

Description

Elément facultatif. Cet élément indique que la fonction de recherche évoluée Assistant de ventes actuellement définie doit être supprimée.

Syntaxe

<delete_salesAssistant SACID="SA_category_ID">

La valeur SA_category_ID identifie la fonction de recherche évoluée Assistant de ventes devant être supprimée. Elle doit correspondre au numéro d'ID de catégorie trouvé dans la base de données WebSphere Commerce.

Contexte

display

Cet élément indique si la caractéristique parent doit être affichée.

Syntaxe

<display>affichage</display>

Description

Contexte

Exemple

<display>1</display>

elaboration

Cet élément est réservé à une utilisation future et doit toujours avoir la valeur NULL.

Syntaxe

<elaboration>élaboration</elaboration>

Contexte

Exemple

<elaboration>NULL</elaboration>

feature

Description

Elément obligatoire. Cet élément définit la caractéristique à la base de la comparaison à l'aide de cette fonction de recherche évoluée.

Syntaxe

<feature>

...spécification de la caractéristique...

</feature>

Contexte

Exemple

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

lang_id

Description

Elément facultatif. Cet élément définit la langue pour l'élément parent.

Syntaxe

<lang_id>identificateur_langue</lang_id>

Contexte

  • L'élément lang_id peut être inclus dans des éléments conceptInfo et opVal.
  • L'élément lang_id ne contient aucun autre élément.

Exemple

<lang_id>-2</lang_id>

metaCategoryId

Description

L'élément metaCategoryId indique la catégorie dont la fonction de recherche évoluée doit être utilisée pour ce lien de fonction de recherche évoluée .

Syntaxe

<metaCategoryId>numéro_metaCategoryID</metaCategoryId>

Contexte

  • L'élément metaCategoryId peut être inclus dans des éléments metaphorLink.
  • L'élément metaCategoryId_id ne contient aucun autre élément.

Exemple

<metaCategoryId>1</metaCategoryId>

metaphorLink

Description

Cet élément définit le lien à une réponse d'assistance de ventes ou indique le lien par défaut à utiliser lorsqu'une réponse n'en a pas un de défini.

Syntaxe

<metaphorLink>
...contenu_lien_fonction_recherche...
</metaphorLink>

Contexte

Exemple

<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

Description

Cet élément définit le nom de la fonction de recherche évoluée cible.

Syntaxe

<metaphorName>nom_fonction_recherche</metaphorName>

Contexte

  • L'élément metaphorName peut être inclus dans des éléments metaphorLink.
  • L'élément metaphorName ne contient aucun autre élément.

Exemple

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

operation

Description

Cet élément définit l'opération à effectuer pour évaluer la contrainte.

Syntaxe

<operation>numéro_opération</operation>

Contexte

  • L'élément operation peut être inclus dans des éléments constraint.
  • L'élément operation ne contient aucun autre élément.
  • Accepte un nombre entre 1 et 4. Ces valeurs ont les significations suivantes :
    1
    Cette valeur correspond à l'opération 'égal à' (=)
    2
    Cette valeur correspond à l'opération 'différent de' (!=).
    3
    Cette valeur correspond à l'opération 'supérieur ou égal à' (>=).
    4
    Cette valeur correspond à l'opération 'inférieur ou égal à' (<=).

Exemple

<operation>3</operation>

opVal

Description

Cet élément définit les informations relatives aux contraintes spécifiques de chaque langue.

Syntaxe

<opVal>

...contenu d'opVal...

</opVal>

Contexte

  • L'élément opVal peut être inclus dans des éléments constraint.
  • L'élément opVal ne peut contenir que les éléments suivants :

Exemple

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

opValue

Description

Cet élément définit la valeur de la caractéristique sur laquelle vous baserez la contrainte. Il s'agit de la valeur que l'on trouverait dans l'élément <columnName> spécifié pour l'élément parent <constraint>.

Syntaxe

<opValue>opValue</opValue>

Contexte

  • L'élément opValue peut être inclus dans des éléments opVal.
  • L'élément opValue ne contient aucun autre élément.

Exemple

<opValue>6099.0</opValue>

opValueType

Description

Les types valides se trouvent dans la table ICDATAREG.

Syntaxe

<opValueType>type_op_value</opValueType>

Contexte

  • L'élément opValueType peut être inclus dans des éléments constraint.
  • L'élément opValueType ne contient aucun autre élément.

Exemple

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

order

Description

Cet élément définit l'ordre dans lequel les différentes caractéristiques sont affichées.

Syntaxe

<order>ordre</order>

Contexte

  • L'élément order peut être inclus dans des éléments feature.
  • L'élément order ne contient aucun autre élément.

Exemple

<order>1</order>

orderSeq

Elément obligatoire. Cet élément définit la séquence d'affichage des questions et des réponses au sein d'une question adressée à la fonction de recherche évoluée d'assistance aux ventes.

Syntaxe

<orderSeq>numéro_orderSeq</orderSeq>

Description

Contexte

  • L'élément orderSeq peut être inclus dans les éléments answer et question.
  • L'élément orderSeq ne contient aucun autre élément.

Exemple

<orderseq>1</orderseq>

passConstraint

Description

Une variable booléenne qui détermine si une contrainte doit être transmise au lien cible. Si la valeur définie est 0, la contrainte ne sera pas transmise. Si la valeur est 1, la contrainte sera transmise.

Syntaxe

<passConstraint>numéro_passConstraint</passConstraint>

Contexte

  • L'élément passConstraint peut être inclus dans des éléments metaphorLink.
  • L'élément passConstraint ne contient aucun autre élément.

Exemple

<passConstraint>1</passConstraint>

pfReference

Description

ID catégorie ou famille de produits.

Syntaxe

<pfReference>numéro_pfReference</pfReference>

Contexte

  • L'élément pfReference peut être inclus dans des éléments constraint.
  • L'élément pfReference ne contient aucun autre élément.

Exemple

<pfReference>1</pfReference>

productComparer

Description

Elément facultatif. Cet élément définit le début d'une fonction de recherche évoluée de comparaison des produits.

Syntaxe

<productComparer>

...contenu de la fonction de recherche...

</productComparer>

Contexte

  • L'élément productComparer peut être inclus dans des éléments category.
  • L'élément productComparer peut contenir les éléments suivants :

productExplorer

Description

Elément facultatif. Cet élément définit le début d'une fonction de recherche évoluée d'exploration des produits.

Syntaxe

<productExplorer>

...contenu de la fonction de recherche évoluée...

</productExplorer>

Contexte

  • L'élément productExplorer peut être inclus dans des éléments category.
  • L'élément productExplorer peut contenir les éléments suivants :

qnaTree

Description

Elément facultatif. Cet élément encapsule la totalité de l'arborescence des questions et réponses pour la fonction de recherche évoluée de l'Assistant de ventes.

Syntaxe

<qnaTree>

...contenu de l'arborescence des questions et des réponses...

</qnaTree>

Contexte

  • L'élément qnaTree ne peut être inclus que dans un élément salesAssistant.
  • L'élément qnaTree ne peut comporter que les éléments suivants :

Exemple

<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

Description

L'élément question encapsule une question dans une arborescence de questions et de réponses d'une fonction évoluée de l'Assistant de ventes.

Syntaxe

<question>

...contenu de la question...

</question>

Contexte

  • L'élément question ne peut être inclus que dans un élément answer.
  • L'élément question peut comporter les éléments suivants :

Exemple

<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

Description

L'élément de rootQuestion encapsule la question principale dans une arborescence de questions et de réponses d'une fonction évoluée de l'Assistant de ventes. La question principale est toujours affichée en premier à chaque démarrage d'une session de l'Assistant de ventes.

Syntaxe

<rootQuestion>

...contenu de la question principale...

</rootQuestion>

Contexte

  • L'élément rootQuestion peut être inclus dans des éléments qnaTree.
  • L'élément rootQuestion ne peut contenir que les éléments suivants :

Exemple

<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

Description

Elément facultatif. Cet élément définit le début d'une fonction de recherche évoluée de l'Assistant produit.

Syntaxe

<salesAssistant SACID="category_ID">

...contenu de la fonction de recherche évoluée...

</salesAssistant>

La valeur SACID identifie la catégorie de la fonction de recherche évoluée de l'Assistant de ventes en cours de création.

Contexte

  • L'élément salesAssistant peut être inclus dans des éléments store.
  • L'élément salesAssistant peut contenir les éléments suivants :

sort

Cet élément définit la séquence d'affichage des valeurs des caractéristiques. Si la valeur définie est 0, les caractéristiques sont affichées par ordre croissant. Si la valeur définie est 2, les caractéristiques sont affichées par ordre décroissant.

Syntaxe

<sort>tri</sort>

Description

Contexte

  • L'élément sort peut être inclus dans des éléments feature.
  • L'élément sort ne contient aucun autre élément.

Exemple

<sort>1</sort>

store

Description

Elément obligatoire. Cet élément définit le magasin concerné par les fonctions de recherche évoluée incluses. Les fonctions de recherche évoluée concernent les magasins individuels et vous devez disposer d'un élément de magasin unique pour chaque magasin dont les fonctions de recherche sont définies dans un fichier XML d'entrée.

Syntaxe

<store SID="store_ref_num">

...fichier d'entrée XML...

</store>

La valeur store_ref_num identifie la référence de magasin concernée par la fonction de recherche. Cette dernière doit correspondre à la référence de magasin trouvée dans la base de données WebSphere Commerce.

Contexte

  • Les éléments Store ne peuvent être inclus que dans un élément builder.
  • Les éléments de magasin peuvent contenir les éléments suivants :
    1. Des éléments category facultatifs
    2. Des éléments salesAssistant facultatifs

Exemple

<store SID="1">

...fichier d'entrée XML...

</store>

template

Description

Elément obligatoire. Cet élément définit le fichier JSP à utiliser comme modèle pour toutes les pages générées à l'aide de la fonction de recherche évoluée.

Syntaxe

<template>template file</template>

Contexte

Exemple

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

templateName

Description

Cet élément définit le fichier JSP à utiliser comme modèle pour la fonction de recherche évoluée cible.

Syntaxe

<templateName>nom_modèle</templateName>

Contexte

  • L'élément templateName peut être inclus dans des éléments metaphorLink.
  • L'élément templateName ne contient aucun autre élément.

Exemple

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

templateUsage

Description

Cet élément définit le mode d'affichage du modèle de la fonction de recherche évoluée cible.

Syntaxe

<templateUsage>numéro_templateUsage</templateUsage>

Contexte

  • L'élément templateUsage peut être inclus dans des éléments metaphorLink.
  • L'élément templateUsage ne contient aucun autre élément.
  • Accepte un nombre entre 0 et 3. Ces valeurs ont les significations suivantes :
    0
    Utilise l'élément par défaut metaphorLink défini pour la fonction de recherche évoluée parent de l'Assistant de ventes.
    1
    Retourne à la page de fonction évoluée de recherche précédente.
    2
    Utilise l'élément templateName de ce lien metaphorLink (au lieu de l'élément par défaut).
    3
    Lien à une URL.

Exemple

<templateUsage>0</templateUsage>

widget

Description

Elément obligatoire. Cet élément définit l'objet fenêtre à utiliser pour afficher les valeurs des caractéristiques.

Syntaxe

<widget>nom_widget</widget>

Contexte

  • L'élément widget peut être inclus dans des éléments feature.
  • L'élément widget ne contient aucun autre élément.

Exemple

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

IBM copyright