Exemple : Associations de marchandisage d'entrée de catalogue

Vous pouvez vous servir de l'utilitaire de chargement de données pour remplacer, ou supprimer, simultanément plusieurs associations de marchandisage d'entrée de catalogue.

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

PartNumber
(Requis, chaîne) Référence unique utilisée pour identifier l'entrée de catalogue source dans l'association. Cette zone ne peut pas être Null. Le numéro de référence d'une entrée de catalogue s'affiche dans le centre de gestion comme valeur de la propriété de code d'entrée de catalogue.
AssociationType
(Requis, chaîne) Type d'association de marchandisage à utiliser. Les valeurs disponibles sont les suivantes : CrossSell, UpSell, Accessory, et Replacement. Cette zone ne peut pas être Null.
TargetPartNumber
(Requis, chaîne) Référence unique utilisée pour identifier l'entrée de catalogue cible dans l'association. Cette zone ne peut pas être Null.
TargetStoreIdentifier
(Chaîne) Identificateur unique du magasin auquel appartient l'entrée de catalogue cible. Si l'identificateur TargetStoreIdentifier n'est pas fourni dans le fichier CSV source, l'élément StoreIdentifier des données de contexte est utilisé.
Séquence
(Décimal) Ordre d'affichage des associations de marchandisage.
SemanticSpecifier
(Requis, chaîne) Spécificateur sémantique de l'association de marchandisage. Les exemples de spécificateurs sémantiques sont comes_with, none, requires ou temp. Cette zone ne peut pas être Null.
Quantité
(Double) Quantité d'entrées de catalogue associées à la source. Par exemple, si l'entrée de catalogue source est un appareil photo et l'entrée de catalogue cible le type de pile utilisé, cette quantité indique le nombre de piles requis.
Supprimer
(Chaîne) Indicateur spécifiant si une suppression doit être effectuée. Spécifiez 1 pour supprimer la ligne.

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

Zone1
(Chaîne) Zone définie par l'utilisateur et disponible à des fins de personnalisation de l'association de marchandisage.
Field2
(Entier) Zone définie par l'utilisateur et disponible à des fins de personnalisation de l'association de marchandisage.
Field3
(Valeur décimale) Zone définie par l'utilisateur et disponible à des fins de personnalisation de l'association de marchandisage.
Date1
(Horodatage) Zone définie par l'utilisateur et disponible à des fins de personnalisation de l'association de marchandisage.

Fichier CSV avec exemples d'associations de marchandisage d'entrée de catalogue

Insertion ou remplacement

Dans cet exemple, le fichier CSV contient des échantillons de données d'association de marchandisage d'entrée de catalogue. Chaque colonne est délimitée par une virgule. Fichier CSV avec exemples de données d'associations de marchandisage d'entrée de catalogue.

Fichier CSV mis en forme avec en-têtes de colonnes.
PartNumber AssociationType TargetPartNumber TargetStoreIdentifier Séquence SemanticSpecifier Quantité
Example-PN-10001 UpSell Example-PN-10004 ExampleTargetB2BStore 1 NONE 23
Example-PN-10002 Accessory Example-PN-10005 ExampleTargetB2BStore 2 NONE 11
Figure 1. Supprimer

Dans cet exemple, le fichier CSV contient des échantillons de données d'associations de marchandisage d'entrée de catalogue destinées à être supprimées. Fichier CSV avec exemples de données d'associations de marchandisage d'entrée de catalogue.

Fichier CSV mis en forme avec en-têtes de colonnes.
PartNumber AssociationType TargetPartNumber TargetStoreIdentifier Séquence SemanticSpecifier Quantité Supprimer
Example-PN-10001 UpSell Example-PN-10004 ExampleTargetB2BStore 1 NONE 23 1
Example-PN-10002 Accessory Example-PN-10005 ExampleTargetB2BStore 2 NONE 11 1

Données de mappage

Le fragment suivant du fichier d'exemple de configuration d'association d'entrée de catalogue illustre comment mapper chaque valeur à un chemin de schéma logique d'objet métier.
<_config:DataMapping>
	<_config:mapping xpath="CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="PartNumber" />
	<_config:mapping xpath="Association/Name" value="AssociationType" />
	<_config:mapping xpath="Association/CatalogEntryReference/CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="TargetPartNumber" />
	<_config:mapping xpath="Association/CatalogEntryReference/CatalogEntryIdentifier/ExternalIdentifier/StoreIdentifier/ExternalIdentifier/NameIdentifier" value="TargetStoreIdentifier" />
	<_config:mapping xpath="Association/displaySequence" value="Sequence" />
	<_config:mapping xpath="Association/semantic" value="SemanticSpecifier" />
	<_config:mapping xpath="Association/quantity" value="Quantity" />
	<_config:mapping xpath="Association/Attributes/field1" value="Field1" />
	<_config:mapping xpath="Association/Attributes/field2" value="Field2" />
	<_config:mapping xpath="Association/Attributes/field3" value="Field3" />
	<_config:mapping xpath="Association/Attributes/date1" value="Date1" />
	<_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.CatalogEntryAssociationMediator.

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.