Exemple : Valeurs autorisées pour les attributs de définition d'entrée de catalogue

Vous pouvez vous servir de l'utilitaire de chargement de données pour insérer, remplacer ou supprimer des valeurs autorisées afin de définir des attributs au niveau du produit. Vous pouvez entrer en même temps plusieurs valeurs autorisées pour chaque attribut.

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) Identificateur d'entrée de catalogue (produit). Cette zone ou l'élément CatalogEntryUniqueId est obligatoire. 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.
CatalogEntryUniqueId: (Requis, BigInt) Référence unique interne de l'entrée de catalogue (produit). Cette zone ou l'élément PartNumber est obligatoire.
Nom: (Chaîne) Nom de cet attribut. Cette zone est dépendante de la langue.
ValueSequence: (Double) Numéro de séquence utilisé pour spécifier l'ordre d'affichage des valeurs d'attribut dans un attribut. Cette valeur ne peut pas être NULL. La valeur par défaut est = 0.
Valeur: (Chaîne|Entier|Valeur en virgule flottante) Valeur de l'attribut.
Image1: (Chaîne) Chemin d'accès de la première image de cet attribut. Cette zone est dépendante de la langue.
Image2: (Chaîne) Chemin d'accès de la seconde image de cet attribut. Cette zone est dépendante de la langue.
AttachmentID: (BigInt) Numéro de référence d'une pièce jointe associée à la valeur d'attribut.
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 :

ValueField1: (Entier) Zone définie par l'utilisateur et disponible à des fins de personnalisation.
ValueField2: (Entier) Zone de valeur d'attribut définie par l'utilisateur et disponible à des fins de personnalisation.
ValueField3: (Entier) Zone de valeur d'attribut définie par l'utilisateur et disponible à des fins de personnalisation.

Fichier CSV avec exemples de données d'attributs de définition d'entrée de catalogue

Insertion ou remplacement

Dans cet exemple, le fichier CSV contient des échantillons de valeurs autorisées pour les attributs de définition. Fichier CSV avec exemples de valeurs autorisées d'attributs de définition. En raison du nombre élevé de zones dans le fichier CSV, le tableau a été scindé en deux sections :

Fichier CSV mis en forme avec en-têtes de colonnes
PartNumber	Nom	ValueSequence	Valeur
Example-PN-10001	Couleur	1	Rouge
Example-PN-10001	Couleur	2	Bleu
Example-PN-10002	Size	3	Large
Example-PN-10002	Taille	4	Small

Fichier CSV mis en forme avec en-têtes de colonnes - suite
Image1	Image2	AttachmentID
Red1/image.jpg	Red2/image.jpg	1221
Blue1/image.jpg	Blue2/image.jpg
Large1/image.jpg	Large2/image.jpg	1222
Small1/image.jpg	Small2/image.jpg

Supprimer

Dans cet exemple, le fichier CSV contient des échantillons de valeurs autorisées d'attributs de définition destinées à être supprimées. Fichier CSV avec exemples de valeurs autorisées d'attributs de définition. En raison du nombre élevé de zones dans le fichier CSV, le tableau a été scindé en deux sections :

Fichier CSV mis en forme avec en-têtes de colonnes
PartNumber	Nom	ValueSequence	Valeur
Example-PN-10001	Couleur	1	Rouge
Example-PN-10001	Couleur	2	Bleu
Example-PN-10002	Size	3	Large
Example-PN-10002	Taille	4	Small

Fichier CSV mis en forme avec en-têtes de colonnes - suite
Image1	Image2	AttachmentID	Supprimer
Red1/image.jpg	Red2/image.jpg	1221	1
Blue1/image.jpg	Blue2/image.jpg		1
Large1/image.jpg	Large2/image.jpg	1222	1
Small1/image.jpg	Small2/image.jpg		1

Données de mappage

Le fragment de code suivant du fichier de configuration de chargement de valeurs autorisées d'attributs de définition 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" valueFrom="InputData"/>
	<_config:mapping xpath="CatalogEntryIdentifier/UniqueID" value="CatalogEntryUniqueId" valueFrom="InputData"/>
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AttributeIdentifier/UniqueID" value="AttributeUniqueId" valueFrom="InputData"/>
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/Name" value="Name" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/displaySequence" value="ValueSequence" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/identifier" value="Value" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/Value" value="Value" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/Image1" value="Image1" valueFrom="InputData"/>
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/Image2" value="Image2" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/Field1" value="ValueField1" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/Field2" value="ValueField2" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/Field3" value="ValueField3" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/AttachmentID" value="AttachmentID" valueFrom="InputData" />
	<_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.CatalogEntryAttributeMediator.

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.