Exemple : Catégories

Vous pouvez insérer, remplacer ou supprimer simultanément des données de catégorie à l'aide de l'utilitaire de chargement de données. Ces exemples utilisent un fichier CSV pour illustrer l'insertion, le remplacement ou la suppression de données de catégories.

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

GroupIdentifier

Obligatoire : (Chaîne) Identificateur de la catégorie. Cette zone ne peut pas contenir la valeur null et doit être unique.

TopGroup

(Booléen) Indique si cette colonne est une catégorie principale ou une sous-catégorie. Les catégories principales n'ont pas de catégorie parent. Associez la colonne à la valeur true pour une catégorie principale. Associez la colonne à la valeur false ou null pour une sous-catégorie. La valeur par défaut est false. False est automatiquement attribué à toute valeur autre que true.

ParentGroupIdentifier

(Chaîne) Identificateur parent de cette catégorie. Laissez cette zone vide s'il s'agit d'une catégorie de premier niveau.

Séquence

(Double) Nombre facultatif utilisé pour spécifier l'ordre d'affichage des catégories enfants dans une catégorie parent.

Nom

(Chaîne) Nom d'affichage, dépendant de la langue, de cette catégorie.

ShortDescription

(Chaîne) Brève description, dépendante de la langue, de cette catégorie.

LongDescription

(Chaîne) Description détaillée, dépendante de la langue, de cette catégorie.

Miniature

(Chaîne) Chemin de l'image miniature, dépendant de la langue, de cette catégorie. Utilisez des barres obliques (/) pour spécifier ce chemin. Par exemple : images/G1.jpg.

FullImage

(Chaîne) Chemin de l'image taille réelle, dépendant de la langue, de cette catégorie. Utilisez des barres obliques (/) pour spécifier ce chemin. Par exemple : images/G1.jpg.

Publié

(Entier) Valeur dépendante de la langue déterminant si la catégorie doit être affichée dans la boutique en ligne.

1: Published. Il s'agit de la valeur par défaut. La catégorie est alors affichée dans la boutique en ligne.
0: Not published

Mot clé

(Chaîne) Mot clé spécifique à chaque langue qui est utilisé pour les recherches. S'il s'agit de plusieurs mots clés, encadrez-les par des guillemets en les séparant par des virgules. Par exemple : "keyword 1, keyword 2, keyword3".

Supprimer

(Chaîne) Indicateur de suppression ou non. Spécifiez 1 pour supprimer la ligne.

Vous pouvez utiliser l'option de marquage pour suppression lorsque vous supprimez une catégorie. Lorsque vous configurez l'utilitaire de chargement de données afin d'appliquer ce comportement, les catégories ne sont pas supprimées de la base de données lorsque vous définissez une catégorie à supprimer dans un fichier d'entrée. Lorsque vous définissez la valeur '1' dans la colonne Delete d'une catégorie, la catégorie est marquée pour suppression. L'utilitaire met à jour la valeur de la colonne MARKFORDELETE pour la ligne d'objet dans la table CATGROUP au lieu de supprimer la ligne.

Les autres zones suivantes sont facultatives et ne sont pas incluses dans l'exemple :

storeIdentifier: (Chaîne) Identificateur du magasin auquel la catégorie appartient. Cette colonne n'est requise que si la catégorie appartient à un magasin autre que celui défini dans les éléments BusinessContext du fichier de configuration wc-dataload.xm ou du fichier de configuration de l'utilitaire de chargement de groupes de catalogue. Si cette colonne n'est pas fournie dans le fichier CSV, l'élément StoreIdentifier du contexte métier est utilisé.
parentStoreIdentifier: (Chaîne) Identificateur du magasin auquel appartient la catégorie parent. Utilisez cette zone dans un magasin de site étendu, lorsque le magasin parent est différent du magasin auquel votre catégorie est ajoutée.
Remarque: (Chaîne) Utilisez cette zone pour ajouter des notes de bas de page ou des descriptions étendues pour cette catégorie.
Zone 1: (Chaîne) Zone définie par l'utilisateur et disponible à des fins de personnalisation.
Field 2: (Chaîne) Zone définie par l'utilisateur et disponible à des fins de personnalisation.

Insertion ou remplacement - Fichier CSV avec exemples de données de catégorie

L'exemple de fichier contient des données de catégorie Fichier CSV avec exemples de données de catégories

Fichier CSV mis en forme avec en-têtes de colonnes
GroupIdentifier	TopGroup	ParentGroupIdentifier	Séquence	Nom	ShortDescription	LongDescription	Miniature	FullImage	Publié	Mot clé
TV_category	true			TV category	TV short description	TV long description	TV_thumb/image.jpg	TV_full/image.jpg	1	TV Keyword
LCD_category	false	TV_category	1	LCD TV	LCD TV short description	LCD TV long description	LCD_TV_thumb/image.jpg	LCD_TV_full/image.jpg	0	LCD Keyword
Appl_category	true			Appliances category	Appliances short description	Appliances long description	app_thumb/image.jpg	app_full/image.jpg	1	Appliances Keyword
Fridge_category	false	Appl_category	2	Refrigerators	Refrigerator short description	Refrigerator long description	fridge_thumb/image.jpg	fridge_full/image.jpg	1	Refrigerator Keyword

Suppression - Fichier CSV avec exemples de données de catégorie

Pour supprimer une catégorie, ajoutez une colonne Delete à votre fichier CSV. Dans cet exemple, les données source proviennent d'un fichier CSV. Ce fichier contient des exemples de données de catégories. La catégorie associée aux lignes pour lesquelles l'indicateur est défini à 1 dans la colonne 'Delete' sera supprimée. Celles pour lesquelles rien n'est indiqué dans la colonne 'Delete' feront l'objet d'une insertion ou d'un remplacement (si des données antérieures existent dans la base de données). Fichier CSV avec exemples de données de catégorie

Fichier CSV mis en forme avec en-têtes de colonnes
GroupIdentifier	TopGroup	ParentGroupIdentifier	Séquence	Nom	ShortDescription	LongDescription	Miniature	FullImage	Publié	Mot clé	Supprimer
TV_category	true			TV category	TV short description	TV long description	TV_thumb/image.jgp	TV_full/image.jgp	1	TV Keyword	1
LCD_category	false	TV_category	1	LCD TV	LCD TV short description	LCD TV long description	LCD_TV_thumb/image.jpg	LCD_TV_full/image.jpg	0	LCD Keyword	1
Appl_category	true			Appliances category	Appliance short description	Appliances long description	app_thumb/image.jpg	app_full/image.jpg	1	Appliances Keyword
Fridge_category	false	Appl_category	2	Refrigerators	Refrigerator short description	Refrigerator long description	fridge_thumb/image.jpg	fridge_full/image.jpg	1	Refrigerator Keyword

Données de mappage

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

<_config:DataMapping>
	<_config:mapping xpath="CatalogGroupIdentifier/UniqueID" value="GroupUniqueId" />
	<_config:mapping xpath="CatalogGroupIdentifier/ExternalIdentifier/GroupIdentifier" value="GroupIdentifier" />
	<_config:mapping xpath="ParentCatalogGroupIdentifier/UniqueID" value="ParentGroupUniqueId" />
	<_config:mapping xpath="CatalogGroupIdentifier/ExternalIdentifier/StoreIdentifier/ExternalIdentifier/NameIdentifier" value="StoreIdentifier" valueFrom="InputData" />
	<_config:mapping xpath="ParentCatalogGroupIdentifier/ExternalIdentifier/GroupIdentifier" value="ParentGroupIdentifier" />
	<_config:mapping xpath="ParentCatalogGroupIdentifier/ExternalIdentifier/StoreIdentifier/ExternalIdentifier/NameIdentifier" value="ParentStoreIdentifier" valueFrom="InputData" />
	<_config:mapping xpath="topCatalogGroup" value="TopGroup" />
	<_config:mapping xpath="displaySequence" value="Sequence" />
	<_config:mapping xpath="Description[0]/Name" value="Name" />
	<_config:mapping xpath="Description[0]/ShortDescription" value="ShortDescription" />
	<_config:mapping xpath="Description[0]/LongDescription" value="LongDescription" />
	<_config:mapping xpath="Description[0]/Thumbnail" value="Thumbnail" />
	<_config:mapping xpath="Description[0]/FullImage" value="FullImage" />
	<_config:mapping xpath="Description[0]/Attributes/published" value="Published" />
	<_config:mapping xpath="Description[0]/Keyword" value="Keyword" />
	<_config:mapping xpath="Description[0]/Attributes/note" value="Note" />
	<_config:mapping xpath="Attributes/field1" value="Field1"/>
	<_config:mapping xpath="Attributes/field2" value="Field2"/>
	<_config:mapping xpath="" value="Delete" valueFrom="InputData" 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.CatalogGroupMediator.

Remarque : Ce médiateur ne prend pas en charge le marquage pour suppression d'une catégorie. Si vous définissez un mappage afin de mettre à jour la colonne MARKFORDELETE pour une catégorie et marquez une catégorie pour suppression dans un fichier d'entrée, l'utilitaire de chargement de données supprime la catégorie explicitement. L'opération supprime également les enregistrements liés dans les tables CATTOGRP, CATGRPREL et CATGPENREL pour la catégorie.

Le médiateur CatalogGroupMediator prend en charge le marquage pour suppression d'une catégorie via une propriété configurable. Pour activer cette propriété, ajoutez la configuration suivante dans l'élément <_config:BusinessObjectMediator> du fichier de configuration d'objet métier :

<_config:BusinessObjectMediator className="com.ibm.commerce.catalog.dataload.mediator.CatalogGroupMediator" componentId="com.ibm.commerce.catalog">
     <_config:property name="markForDelete" value="true" />
</_config:BusinessObjectMediator>

Si vous configurez aussi l'utilitaire de chargement de données afin qu'il charge des informations d'optimisation pour les moteurs de recherche, les informations d'optimisation pour les moteurs de recherche pertinentes pour la catégorie sont supprimées lorsque vous marquez la catégorie pour suppression.
Si votre magasin utilise la recherche HCL Commerce, l'index de recherche est régénéré afin de supprimer les catégories qui sont marquées pour suppression et afin de supprimer les relations concernant ces catégories.

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.