Configuration du fichier de configuration d'objet métier

Le fichier de configuration d'objet métier définit comment charger les données dans la base de données. Vous devez spécifier dans ce fichier les classes d'implémentation de vos composants Lecteur de données, Générateur d'objet métier et Médiateur d'objet métier. Vous devez également y spécifier les attributs et propriétés de ces composants.

Pourquoi et quand exécuter cette tâche

Des exemples de fichier de configuration d'objet métier sont fournis pour différents objets de composant à l'intérieur des répertoires spécifiques aux composant dans le répertoire suivant :
  • Linuxutilities_root/samples/DataLoad
  • HCL Commerce DeveloperWCDE_installdir/samples/DataLoad

Procédure

  1. Créez une copie d'un exemple de fichier wc-loader-object.xml et renommez le fichier.
    Par exemple, copiez le fichier wc-loader-catalog.xml dans le répertoire du composant Catalog.
  2. Ouvrez le nouveau fichier de configuration d'objet métier pour l'éditer.
  3. Spécifiez votre classe d'implémentation de lecteur de données.
    1. Recherchez l'élément <_config:DataReader>.
    2. Ne permet pas de définir de valeur d'attribut className.
      La valeur de cet attribut spécifie le nom de classe du lecteur de données. Vous pouvez spécifier la classe fournie.
      • com.ibm.commerce.foundation.dataload.datareader.CSVReader
      • com.ibm.commerce.foundation.dataload.datareader.XmlReader
      Cependant, si vous personnalisez le lecteur de données, vous pouvez spécifier votre propre classe d'implémentation. Pour plus d'informations sur la configuration du lecteur de données, voir :
      Par exemple, le fragment suivant configure le lecteur de données :
      
      <_config:DataLoader 
        className="com.ibm.commerce.foundation.dataload.BusinessObjectLoader" >
        <_config:DataReader 
          className="com.ibm.commerce.foundation.dataload.datareader.CSVReader" 
          firstLineIsHeader="true" useHeaderAsColumnName="true" >
      </_config:DataReader>
  4. Spécifiez votre classe de générateur d'objet métier .
    1. Recherchez l'élément <_config:BusinessObjectBuilder>.
    2. Ne permet pas de définir de valeur d'attribut className.
      La valeur de cet attribut spécifie le nom de classe du générateur d'objet métier. Les deux classes d'implémentation qui sont fournies sont :
      • com.ibm.commerce.foundation.dataload.businessobjectbuilder.BaseBusinessObjectBuilder pour les objets métier reposant sur des composants
      • com.ibm.commerce.foundation.dataload.businessobjectbuilder.TableObjectBuilder pour les objets reposant sur des tableaux
      Pour plus d'informations sur la configuration de ces générateurs d'objet métier, voir
  5. Facultatif : Configurez l'utilitaire de chargement de données pour exclure les colonnes dans lesquelles il ne doit pas charger de données ou qu'il ne doit pas modifier.
    Pour exclure des colonnes, vous pouvez définir une liste d'exclusion de colonnes dans l'élément <_config:DataLoader>. Pour plus d'informations, voir Configuration d'une liste d'exclusion de colonnes.
  6. Enregistrez et fermez le fichier.
    Par exemple, le fragment suivant configure le fichier de configuration d'objet métier pour le chargement des valeurs d'attribut de dictionnaire d'attributs admises :
    <?xml version="1.0" encoding="UTF-8"?>
    <_config:DataloadBusinessObjectConfiguration 
    	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    	xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/foundation/config ../../../../
           xml/config/xsd/wc-dataload-businessobject.xsd" 
    	xmlns:_config="http://www.ibm.com/xmlns/prod/commerce/foundation/config">
     
      <_config:DataLoader className="com.ibm.commerce.foundation.dataload.BusinessObjectLoader" >
        <_config:DataReader className="com.ibm.commerce.foundation.dataload.datareader.CSVReader"
          firstLineIsHeader="true" useHeaderAsColumnName="true" >
        <_config:property name="keyColumns" value="Identifier,ValueIdentifier" />
        </_config:DataReader>
        <_config:BusinessObjectBuilder 
          className="com.ibm.commerce.foundation.dataload.businessobjectbuilder.BaseBusinessObjectBuilder" 
          packageName="com.ibm.commerce.catalog.facade.datatypes.CatalogPackage" 
          dataObjectType="AttributeDictionaryAttributeType" >
          <_config:DataMapping>
          <_config:mapping xpath="AttributeIdentifier/ExternalIdentifier/Identifier" 
            value="Identifier" />
          <_config:mapping xpath="AttributeIdentifier/UniqueID" value="AttributeUniqueId" />
          <_config:mapping xpath="AllowedValue/identifier" value="ValueIdentifier" />
          <_config:mapping xpath="AllowedValue/displaySequence" value="Sequence" />
          <_config:mapping xpath="AllowedValue/Value" value="Value" />
          <_config:mapping xpath="AllowedValue/ExtendedValue/ValueUsage" value="1" 
            valueFrom="Fixed" />
          <_config:mapping xpath="AllowedValue/ExtendedValue/AttributeValueField1" 
            value="AttributeValueField1" />
          <_config:mapping xpath="AllowedValue/ExtendedValue/AttributeValueField2" 
            value="AttributeValueField2" />
          <_config:mapping xpath="AllowedValue/ExtendedValue/AttributeValueField3" 
            value="AttributeValueField3" />
          <_config:mapping xpath="AllowedValue/ExtendedValue/Image1" value="Image1" />
          <_config:mapping xpath="AllowedValue/ExtendedValue/Image2" value="Image2" />
          <_config:mapping xpath="AllowedValue/ExtendedValue/Field1" value="Field1" />
          <_config:mapping xpath="AllowedValue/ExtendedValue/Field2" value="Field2" />
          <_config:mapping xpath="AllowedValue/ExtendedValue/Field3" value="Field3" />
          <_config:mapping xpath="AllowedValue/language" value="Language" />
          <_config:mapping xpath="AllowedValue/language" value="LanguageId" />
          <_config:mapping xpath="" value="Delete" deleteValue="1" />
          </_config:DataMapping>
          <_config:BusinessObjectMediator 
            className="com.ibm.commerce.catalog.dataload.mediator.AttributeDictionaryAttributeMediator" 
            componentId="com.ibm.commerce.catalog" >
            <_config:property name="allowChangeAttributeType" value="true" />
            <_config:property name="validateAttribute" value="true" />
          </_config:BusinessObjectMediator>
        </_config:BusinessObjectBuilder>
      </_config:DataLoader>
    </_config:DataloadBusinessObjectConfiguration>