Exemple : catalogue maître et catalogues de vente

Vous pouvez insérer, remplacer ou supprimer simultanément votre catalogue maître et votre 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 votre catalogue maître et votre 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: (Requis, chaîne) Identificateur de catalogue. Cette zone ne peut pas être Null en cas d'insertion et doit être unique. En cas de remplacement ou de suppression, cette zone ou la zone CatalogUniqueId est obligatoire.
CatalogUniqueId: (Requis, BigInt) Numéro de référence interne unique du catalogue. En cas de remplacement ou de suppression, cette zone ou la zone Identifier est obligatoire.
Nom: (Chaîne) Nom d'affichage, spécifique à la langue, de ce catalogue.
Description: (Chaîne) Description tributaire de 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.
MasterCatalog: (Booléen) Indicateur spécifiant s'il s'agit d'un catalogue maître. La valeur par défaut est false. False est automatiquement attribué à toute valeur autre que true.
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 catalogue

Insertion ou remplacement

Dans cet exemple, quatre nouvelles données de catalogue sont insérées. Le fichier contient des données du catalogue principal et du catalogue de vente. Chaque colonne est délimitée par une virgule. Fichier CSV avec exemples de données de catalogue

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

Supprimer

Dans cet exemple, les trois premières lignes de données seront supprimées et la quatrième remplacera des données existantes. Chaque colonne est délimitée par une virgule. Fichier CSV avec exemples de données de catalogue à supprimer ou à remplacer

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

Données de mappage

Le fragment de code suivant du fichier de configuration de chargement 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="primary" value="MasterCatalog" valueFrom="InputData" />
	<_config:mapping xpath="Attributes/description" value="Description" 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 classe de médiateur est com.ibm.commerce.catalog.dataload.mediator.CatalogMediator. Si vous désirez initialiser le dictionnaire d'attributs de votre magasin, reportez-vous à la rubrique Initialisation du dictionnaire d'attributs.

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.