Exemple : Kits et offres groupées

Vous pouvez utiliser l'utilitaire de chargement de données pour insérer, remplacer ou supprimer plusieurs kits et offres groupées simultanément. Des produits, offres groupées et kits ne peuvent pas faire partie d'un composant kit. Seules des UGS sont incluses en tant que composants d'un kit. L'exemple présenté supprime des composants de plusieurs kits et offres groupées. Le kit ou l'offre groupée ne sont pas eux-mêmes supprimés.

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

Obligatoire : (Chaîne) Numéro de référence unique de cette offre groupée ou de ce kit. Cette zone est requise (elle ne peut pas contenir la valeur NULL) et doit être unique. 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.

Séquence

(Double) Nombre facultatif utilisé pour spécifier l'ordre d'affichage des entrées de catalogue enfant sous le kit ou l'offre groupée parent.

ChildPartNumber

(Chaîne) Identificateur de l'entrée de catalogue enfant de l'offre groupée ou du kit.

ChildStoreIdentifier

(Chaîne) Identificateur du magasin auquel l'entrée de catalogue enfant appartient.

Type

Facultatif : (Chaîne) Type de relation.

PackageComponent
BundleComponent
DynamicKitComponent

Remarque : bien que cette zone soit facultative, il est recommandé de la renseigner dans le fichier CSV pour optimiser les performances du chargement de données. Si cette zone n'est pas renseignée, l'utilitaire de chargement de données extrait le type de l'entrée de catalogue depuis la base de données. Le type de relation correspondant est créé en fonction du type de l'entrée de catalogue.

Quantité

(Double) Quantité d'entrées de catalogue associées au kit ou à l'offre groupée.

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 :

StoreIdentifier: (Chaîne) Identificateur du magasin auquel l'offre groupée ou le kit appartient.
ParentToChildCatEntryRelField1: (Chaîne) Zone définie par l'utilisateur et disponible pour la personnalisation de la relation produit parent/UGS enfant.
ParentToChildCatEntryRelField2: (Entier) Zone définie par l'utilisateur et disponible pour la personnalisation de la relation produit parent/SKU enfant.
ParentToChildCatEntryRelField3: (Double) Zone définie par l'utilisateur et disponible pour la personnalisation de la relation produit parent/SKU enfant.

Fichier CSV avec exemples de données de kit et d'offre groupée

Insertion ou remplacement

Dans cet exemple, le fichier CSV contient des échantillons de données de kit et d'offre groupée. Fichier CSV avec exemples de données de kit et d'offre groupée.

Fichier CSV mis en forme avec en-têtes de colonnes
PartNumber	Séquence	ChildPartNumber	ChildStoreIdentifier	Type	Quantité
230092	1	430092	1001	BundleComponent	2
230093	2	430093	2001	DynamicKitComponent	7

Supprimer

Dans cet exemple, le fichier CSV contient des échantillons de données de kit et d'offre groupée destinées à être supprimées. Chaque colonne est délimitée par une virgule. Fichier CSV avec exemples de données de kit et d'offre groupée.

Fichier CSV mis en forme avec en-têtes de colonnes
PartNumber	Séquence	ChildPartNumber	ChildStoreIdentifier	Type	Quantité	Supprimer
230092	1	430092	1001	BundleComponent	2	1
230093	2	430093	2001	DynamicKitComponent	7	1

Données de mappage

Le fragment de code suivant du fichier de configuration de chargement de kits et d'offres groupées d'entrées 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="KitComponent/displaySequence" value="Sequence" />
	<_config:mapping xpath="KitComponent/CatalogEntryReference/CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="ChildPartNumber" />
	<_config:mapping xpath="KitComponent/CatalogEntryReference/CatalogEntryIdentifier/ExternalIdentifier/StoreIdentifier/ExternalIdentifier/NameIdentifier" value="ChildStoreIdentifier" />
	<_config:mapping xpath="KitComponent/kitComponentCodeType" value="Type" />
	<_config:mapping xpath="KitComponent/quantity" value="Quantity" />
	<_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.CatalogEntryKitComponentMediator.

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.