Exemple : Descriptions de catalogue maître et de catalogue de vente

Vous pouvez insérer, remplacer ou supprimer simultanément plusieurs descriptions dans le catalogue maître et le catalogue de vente à l'aide de l'utilitaire de chargement de données. Ces exemples utilisent un fichier de chargement pour illustrer comment insérer, remplacer ou supprimer des descriptions dans le catalogue maître et le catalogue de vente.

Cet exemple utilise un fichier CSV pour expliquer comment insérer, remplacer ou supprimer vos données. Vous pouvez aussi créer et utiliser un fichier au format XML pour insérer, remplacer ou supprimer vos données. Si vous choisissez de créer et d'utiliser un fichier au format XML, assurez-vous que vos éléments XML utilisent les mêmes noms que ceux des colonnes CSV.

définitions de colonne CSV et d'élément XML

Identificateur: (Chaîne) Identificateur du catalogue. Cette zone ou l'élément CatalogUniqueId est obligatoire.
CatalogUniqueId: (BigInt) Numéro de référence interne unique du catalogue. Cette zone ou l'identificateur est obligatoire.
Nom: (Chaîne) Nom d'affichage, spécifique à la langue, de ce catalogue.
ShortDescription: (Chaîne) Brève description, spécifique à la langue, de ce catalogue.
LongDescription: (Chaîne) Description longue, spécifique à la langue, de ce catalogue.
Miniature: (Chaîne) Chemin de l'image miniature, spécifique à la langue, de ce catalogue. Par exemple, images/G1.jpg.
FullImage: (Chaîne) Chemin de l'image taille réelle, spécifique à la langue, de ce catalogue. Par exemple, images/G1.jpg.
Supprimer: (Chaîne) Indicateur spécifiant si une suppression doit être effectuée. Spécifiez 1 pour supprimer la ligne.

Fichier CSV avec exemples de données de description de catalogue

Insertion ou remplacement

Dans cet exemple, quatre nouvelles descriptions sont insérées dans le catalogue. Le fichier contient des descriptions du catalogue principal et du catalogue de vente. Chaque colonne est délimitée par une virgule.

Fichier CSV mis en forme avec en-têtes de colonnes
Identificateur	Nom	ShortDescription	LongDescription	Miniature	FullImage
Example_master_cat	Example master catalog	Example master catalog short description	Example master catalog long description	master_thumb/image.jpg	master_full/image.jpg
Summer_sales_cat1	Summer sales catalog	Summer sales catalog short description	Summer sales catalog long description	summer_thumb/image.jpg	summer_full/image.jpg
Winter_sales_cat2	Winter sales catalog	Winter sales catalog short description	Winter sales catalog long description	Winter_thumb/image.jpg	Winter_full/image.jpg
Spring_sales_cat3	Spring sales catalog	Spring sales catalog short description	Spring sales catalog long description	Spring_thumb/image.jpg	Spring_full/image.jpg

Supprimer

Dans cet exemple, les données source proviennent d'un fichier CSV. Le fichier contient des descriptions du catalogue principal et du catalogue de vente. Les trois premières lignes de données sont supprimées et la quatrième remplace des données existantes. Fichier CSV avec exemples de données de description de catalogue.

Fichier CSV mis en forme avec en-têtes de colonnes
Identificateur	Nom	ShortDescription	LongDescription	Miniature	FullImage	Supprimer
Example_master_cat	Example master catalog	Example master catalog short description	Example master catalog long description	master_thumb/image.jpg	master_full/image.jpg	1
Summer_sales_cat1	Summer sales catalog	Summer sales catalog short description	Summer sales catalog long description	summer_thumb/image.jpg	summer_full/image.jpg	1
Winter_sales_cat2	Winter sales catalog	Winter sales catalog short description	Winter sales catalog long description	Winter_thumb/image.jpg	Winter_full/image.jpg	1
Spring_sales_cat3	New spring sales catalog name	Spring sales catalog new short description	Spring sales catalog new long description	Spring_thumb/image.jpg	Spring_full/image.jpg

Données de mappage

Le fragment de code suivant du fichier de configuration de chargement de description de catalogue illustre comment mapper chaque valeur à un chemin de schéma logique d'objet métier.

<_config:DataMapping>
	<_config:mapping xpath="CatalogIdentifier/ExternalIdentifier/Identifier" value="Identifier" valueFrom="InputData"/>
	<_config:mapping xpath="CatalogIdentifier/UniqueID" value="CatalogUniqueId" valueFrom="InputData"/>
	<_config:mapping xpath="Description[0]/Name" value="Name" valueFrom="InputData" />
	<_config:mapping xpath="Description[0]/ShortDescription" value="ShortDescription" valueFrom="InputData" />
	<_config:mapping xpath="Description[0]/LongDescription" value="LongDescription" valueFrom="InputData" />
	<_config:mapping xpath="Description[0]/Thumbnail" value="Thumbnail" valueFrom="InputData" />
	<_config:mapping xpath="Description[0]/FullImage" value="FullImage" valueFrom="InputData" />
	<_config:mapping xpath="" value="Delete" deleteValue="1"/>
</_config:DataMapping>

Si vous effectuez une opération d'insertion ou de remplacement, ne spécifiez pas la colonne "Delete" dans le fichier CSV ou laissez cette colonne vide.

Médiateur d'objet métier

Le nom de la classe du médiateur est com.ibm.commerce.catalog.dataload.mediator.CatalogDescriptionMediator.

Remarque : Lorsque vous utilisez un médiateur qui est fourni avec HCL Commerce avec l'utilitaire de chargement des données, l'utilitaire suppose que vous chargez des données dans toutes les colonnes d'un objet métier. Si vous souhaitez mettre à jour les données dans des colonnes spécifiques seulement, configurez une liste d'exclusion de colonne pour le processus de chargement. Une liste d'exclusion de colonne amène l'utilitaire de chargement de données à ignorer des colonnes spécifiques au cours de l'opération de chargement. Si vous n'utilisez pas de liste d'exclusion de colonne, l'utilitaire met à jour toutes les colonnes dans la ligne d'une table base de données lorsque l'utilitaire met la ligne à jour. Si aucune valeur n'est définie dans le fichier d'entrée, l'utilitaire peut remplacer la valeur de colonne existante par une valeur par défaut ou définir que la valeur sera nulle. Pour plus d'informations, voir Configuration d'une liste d'exclusion de colonnes.