Exemple : Substitution de description d'entrée de catalogue

Vous pouvez vous servir de l'utilitaire de chargement de données ou de téléchargement de catalogue pour créer, remplacer ou supprimer des substitutions de description d'entrée de catalogue pour votre magasin de site étendu. Les substitutions de description d'entrée de catalogue vous permettent de remplacer les descriptions d'entrée de catalogue héritées de votre magasin de ressources. Vous pouvez ainsi créer des descriptions d'entrée de catalogue spécifiques à afficher dans votre boutique en ligne.

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.

Après avoir chargé vos données de substitution de description, vous pour vérifier les données qui sont chargées au sein du Management Center et dans votre boutique en ligne. Dans l'outil Catalogues du Management Center, ouvrez la vue des propriétés de l'entrée de catalogue afin de vérifier les informations de substitution. Vous pouvez changer ces dernières dans cette vue. Pour vérifier les données de votre boutique en ligne, vous pouvez lancer l'aperçu de magasin dans le Management Center. Pour plus d'informations sur l'utilisation du Management Center pour modifier et prévisualiser vos substitutions de description, voir Ajout de remplacements de descriptions d'entrées de catalogue.

définitions de colonne CSV et d'élément XML

PartNumber
(Requis, chaîne) Identificateur de l'entrée de catalogue. La zone PartNumber 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 Management Center comme valeur de la propriété de code d'entrée de catalogue.
LanguageId
(Chaîne) ID de langue des zones dépendantes de la langue (Nom, Description abrégée, Description détaillée, Image miniature, Image taille réelle, Publiée et Mot clé). Par exemple : -1 – anglais, -2 – français
Nom
(Requis, chaîne) Nom d'affichage de cette entrée de catalogue. La zone name est dépendante de la langue.
ShortDescription
(Chaîne) Brève description, spécifique à la langue, de cette entrée de catalogue.
LongDescription
(Chaîne) Description longue, spécifique à la langue, de cette entrée de catalogue.
Miniature
(Chaîne) Chemin de l'image miniature de cette entrée de catalogue, spécifique à chaque langue. Par exemple, images/thumbnails/G1preview.jpg.
AuxDescription1
(Chaîne) Description supplémentaire spécifique à la langue de cette entrée de catalogue.
FullImage
(Chaîne) Chemin de l'image grande taille de cette entrée de catalogue, spécifique à chaque langue. Par exemple, images/G1.jpg. Le chemin d'accès peut être soit un chemin d'accès complet, soit un chemin d'accès relatif à partir du répertoire de votre magasin.
AuxDescription2
(Chaîne) Description supplémentaire spécifique à la langue de cette entrée de catalogue.
Publiée
(Entier) Indique si cette entrée de catalogue doit être affichée : 0 = l'entrée du catalogue ne doit pas être affichée, 1 = l'entrée du catalogue doit être affichée.
Par défaut, vous ne pouvez pas remplacer le paramètre du magasin de ressources pour la propriété Published. La propriété s'affiche dans le Management Center sous la forme Affichage aux clients. Pour remplacer le paramètre de magasin de ressources pour cette propriété, vous devez demander au responsable informatique d'ajouter la prise en charge du remplacement de cette propriété via la configuration. Pour en savoir plus sur cette option de configuration, voir Activer le remplacement de publication.
Remarque : Si vous ajoutez la prise en charge permettant de remplacer cette propriété, il se peut que votre paramètre de remplacement pour cette propriété ne fonctionne pas avec toutes les fonctions de recherche de boutique en ligne. Par défaut, l'index de recherche HCL Commerce inclut toutes les entrées de catalogue publiées et non publiées. Cet index repose sur l'identificateur de catalogue et est partagé par tous les magasins qui partagent le catalogue. Si vous remplacez cette propriété pour une entrée de catalogue d'un catalogue, vous ne pouvez pas personnaliser l'index de recherche partagé pour n'inclure que les entrées de catalogue Published (publiées) pour ce catalogue.
Mot clé
(Chaîne) Mot clé propre à chaque langue, utilisé pour les recherches. Si vous utilisez un éditeur de texte en clair et que vous souhaitez inclure plusieurs mots clés, séparés par des virgules, délimitez la chaîne entière par des guillemets. Par exemple, "keyword 1, keyword 2, keyword3". Si vous utilisez un éditeur de feuille de calcul, il n'est pas nécessaire d'inclure la totalité de la chaîne entre des guillemets.
Field 1
(Entier) Zone personnalisée pour les données de votre entrée de catalogue.
Field 2
(Chaîne) Zone personnalisée pour les données de votre entrée de catalogue.
Field 3
(Chaîne) Zone personnalisée pour les données de votre entrée de catalogue.
Supprimer
(Chaîne) Indicateur de suppression ou non. Pour supprimer une ligne, spécifiez 1.

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

Remplacement

Dans cet exemple, les données source proviennent d'un fichier CSV. Ce fichier contient des exemples de descriptions d'entrées de catalogue. Tous les champs disponibles ne sont pas affichés dans l'exemple.Fichier CSV avec exemples de données de substitution de description d'entrée de catalogue.

Fichier CSV mis en forme avec en-têtes de colonnes
PartNumber LanguageId Nom ShortDescription LongDescription
AuroraWMDRS-11 -1 Robe d'été blanche à fleurs Mettez du soleil dans votre vie avec cette robe d'été blanche à fleurs
AuroraWMDRS-6 -1 Strapless Cocktail Dress, Luigi Valenti red cocktail dress with appliqued roses and tassels at the hem
Fichier CSV mis en forme avec en-têtes de colonnes - suite
Miniature FullImage
images/catalog/apparel/women/womens_dresses_160x160/WD_031_a_red.jpg images/catalog/apparel/women/womens_dresses_1000x1000/WD_031_a_red.jpg
images/catalog/apparel/women/womens_dresses_160x160/WD_006_a_red.jpg images/catalog/apparel/women/womens_dresses_1000x1000/WD_006_a_red.jpg

Supprimer

Dans cet exemple, le fichier CSV contient des exemples de substitutions de description d'entrée de catalogue. Seules les zones obligatoires sont affichées dans l'exemple. Fichier CSV avec exemples de données de suppression de substitution de description d'entrée de catalogue.

Fichier CSV mis en forme avec en-têtes de colonnes
PartNumber Language_ID Supprimer
Example-PN-10001 -1 1
Example-PN-10002 -1 1

Données de mappage

Le fragment de code suivant du fichier de configuration de chargement de substitution de description 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/UniqueID" value="CatalogEntryUniqueId" />      
	<_config:mapping xpath="CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="PartNumber" />
	<_config:mapping xpath="Description[0]/language" value="LanguageId" />        
	<_config:mapping xpath="Description[0]/Override[0]/Name" value="Name"  />
	<_config:mapping xpath="Description[0]/Override[0]/ShortDescription" value="ShortDescription"   />
	<_config:mapping xpath="Description[0]/Override[0]/LongDescription" value="LongDescription"   />
	<_config:mapping xpath="Description[0]/Override[0]/Thumbnail" value="Thumbnail"   />
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/auxDescription1" value="AuxDescription1"   />
	<_config:mapping xpath="Description[0]/Override[0]/FullImage" value="FullImage"   />       
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/auxDescription2" value="AuxDescription2"   /> 
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/published" value="Published"   />
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/field1" value="Field1"   />
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/field2" value="Field2"   />
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/field3" value="Field3"   />        
	<_config:mapping xpath="Description[0]/Override[0]/Keyword" value="Keyword"  />
	<_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.CatalogEntryDescriptionOverrideMediator.

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.