Exemple : Attributs descriptifs et valeurs d'attributs d'entrée de catalogue

Vous pouvez insérer, remplacer ou supprimer des attributs descriptifs et des données de valeurs d'attribut à l'aide de l'utilitaire de chargement de données. Ces exemples utilisent un fichier CSV pour illustrer comment insérer, remplacer ou supprimer des attributs descriptifs et des données de valeurs d'attributs.

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 ou UGS). 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) Numéro de référence unique de l'entrée de catalogue (produit ou UGS). Cette zone ou l'élément PartNumber est obligatoire.
Type: (Chaîne) Type de données de l'attribut, tel que chaîne, entier ou valeur en virgule flottante. Cette zone est requise et ne peut pas contenir la valeur NULL.
Nom: (Chaîne) Nom de cet attribut. Cette zone est dépendante de la langue.
Séquence: (Double) Numéro de séquence utilisé pour spécifier l'ordre d'affichage des attributs d'un produit. Cette valeur ne peut pas être NULL. La valeur par défaut est = 0.
Description: (Chaîne) Description de cet attribut. Cette zone est dépendante de la langue.
SecondaryDescription: (Chaîne) Description secondaire de cet attribut. Cette zone est dépendante de la langue.
GroupName: (Chaîne) Nom du groupe d'attributs auquel appartient cet attribut.
Zone1: (Chaîne) Zone personnalisable pour cet attribut.
Footnote: (Chaîne) Données d'attribut supplémentaires. Par exemple, note de bas de page.
ValueName: (Chaîne) Nom de cette valeur d'attribut. Cette zone est dépendante de la langue.
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 l'attribut. Cette zone est dépendante de la langue. La barre oblique '/' doit être utilisée dans le chemin. N'utilisez pas de barre oblique inversée ('\'). Par exemple, images/G1.jpg.
Image2: (Chaîne) Chemin d'accès de la seconde image de l'attribut. Cette zone est dépendante de la langue. La barre oblique '/' doit être utilisée dans le chemin. N'utilisez pas de barre oblique inversée ('\'). Par exemple, images/G1.jpg.
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 personnalisable pour cet attribut.
ValueField2: (Chaîne) Zone personnalisable pour cet attribut.
ValueField3: (Chaîne) Zone personnalisable pour cet attribut.
UnitOfMeasure: (Chaîne) Unité de mesure de cette valeur d'attribut.
AttachmentID: (Entier) Numéro de référence d'une pièce jointe associée à la valeur d'attribut.

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

Insertion ou remplacement

Dans cet exemple, le fichier CSV contient un exemple d'attributs descriptifs et de données de valeurs d'attributs d'entrées de catalogue : Fichier CSV avec exemples de données d'attributs descriptifs d'entrée de catalogue. Le fichier CSV mis en forme et divisé en trois sections est présenté dans les tables ci-dessous :

Fichier CSV mis en forme avec en-têtes de colonnes
PartNumber	Type	Nom	Séquence	Description
Example-PN-10001	Chaîne	WashMethod	1	Wash method
Example-PN-10002	Chaîne	WashMethod	2	Wash method

Fichier CSV mis en forme avec en-têtes de colonnes - suite
SecondaryDescription	GroupName	Zone1	Footnote
	Clothing	H	H
	Clothing	B	B

Fichier CSV mis en forme avec en-têtes de colonnes - suite
ValueName	Valeur	Image1	Image2
dryCleanOnly	Dry clean only	dry_clean_1/image.jpg	dry_clean_2/image.jpg
handWashable	Hand Washable	handwash_thumb1/image.jpg	handwash_thumb2/image.jpg

Supprimer

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

Fichier CSV mis en forme avec en-têtes de colonnes
PartNumber	Type	Nom	Séquence	Description
Example-PN-10001	Chaîne	WashMethod	1	Wash method
Example-PN-10002	Chaîne	WashMethod	2	Wash method

Fichier CSV mis en forme avec en-têtes de colonnes - suite
SecondaryDescription	GroupName	Zone1	Footnote
	Clothing	H	H
	Clothing	B	B

Fichier CSV mis en forme avec en-têtes de colonnes - suite
ValueName	Valeur	Image1	Image2	Supprimer
dryCleanOnly	Dry clean only	dry_clean_1/image.jpg	dry_clean_2/image.jpg	1
handWashable	Hand Washable	handwash_thumb1/image.jpg	handwash_thumb2/image.jpg	1

Données de mappage

Le fragment de code suivant du fichier de configuration de chargement d'attributs descriptifs 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]/AttributeDataType" value="Type" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/Name" value="Name" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/usage" value="Descriptive" valueFrom="Fixed" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/displaySequence" value="Sequence" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/Description" value="Description" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/ExtendedData/SecondaryDescription" value="SecondaryDescription" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/ExtendedData/DisplayGroupName" value="GroupName" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/ExtendedData/Field1" value="Field1" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/ExtendedData/Footnote" value="Footnote" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/ExtendedData/UnitOfMeasure" value="UnitOfMeasure" 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.