Exemple : Valeurs d'attribut du dictionnaire d'attributs

Cet exemple explique comment insérer, remplacer ou supprimer des valeurs d'attribut pour plusieurs attributs du dictionnaire 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

Identificateur: (Requis, chaîne) Nom de référence unique permettant d'identifier l'attribut. Soit ce champ ou AttributeUniqueId est nécessaire.
AttributeUniqueId: (Requis, entier) Numéro de référence unique de l'attribut. Cette zone ou l'identificateur est obligatoire.
ValueIdentifier: (Chaîne) Identificateur unique de la valeur d'attribut. Utilisez cette zone lorsque l'attribut inclut des valeurs prédéfinies (autorisées). Si l'attribut n'est pas associé à des valeurs prédéfinies, cette zone est utilisée comme identificateur de valeur de la nouvelle valeur créée.
Sequence: (Décimal) Numéro utilisé pour contrôler l'ordre d'affichage des valeurs d'attribut pour un attribut du dictionnaire d'attributs. Les valeurs d'attribut sont affichées par ordre croissant. La valeur par défaut est 0.
Valeur: (Chaîne|Entier|Valeur en virgule flottante) Valeur de l'attribut, spécifique à chaque langue. Les valeurs d'attribut sont fonction du type de données (par exemple, texte, entier ou décimal).
ValueUsage: (Entier) Utilisation de la valeur de l'attribut. 1 pour une valeur prédéfinie (autorisée) (par exemple, l'une des valeurs autorisées pour un attribut de couleur est le bleu). Si cette zone est NULL, elle est utilisée pour les valeurs d'attribut affectées (par exemple, la longueur d'un produit est 30. Un attribut de longueur ne possède pas de valeur autorisée). Si la valeur est 2, la valeur est attribuée en tant que valeur par défaut.
Image1: (Chaîne) Chemin de l'image taille réelle, dépendant de la langue, de cette valeur d'attribut. Utilisez la barre oblique /' dans ce nom de chemin. N'utilisez pas de barre oblique inversée ('\'). Par exemple, images/G1.jpg.
Image2: (Chaîne) Chemin de l'image taille réelle, dépendant de la langue, de cette valeur d'attribut. Utilisez la barre oblique /' dans ce nom de chemin. N'utilisez pas de barre oblique inversée ('\'). Par exemple, images/G1.jpg.

Autres zones facultatives non incluses dans l'exemple :

Langue

(Entier) Identificateur de langue des zones dépendantes de la langue. Par exemple : -1 pour l'anglais, -2 pour le français.

LanguageId

(Entier) Identificateur de langue des zones spécifiques à chaque langue. Par exemple :

-1 pour l'anglais
-2 pour le français

La colonne Language s'appelle désormais LanguageId. Vous ne devez spécifier qu'un seul identificateur de langue ; à cet effet, utilisez LanguageId plutôt que Language.

(Entier) ID de langue des zones spécifiques à chaque langue (Nom, Description abrégée, Description détaillée, Description auxiliaire 1, Description auxiliaire 2, Image miniature, Image grande taille, Publiée et Mot clé). Par exemple :

-1 pour l'anglais
-2 pour le français

AttributeValueField1

(Entier) Zone personnalisée pour les informations d'attribut. (colonne FIELD1 de la table ATTRVAL).

AttributeValueField2

(Entier) Zone personnalisée pour les informations d'attribut. (colonne FIELD2 de la table ATTRVAL).

AttributeValueField3

(Chaîne) Zone personnalisée pour les informations d'attribut. (colonne FIELD3 de la table ATTRVAL).

Zone1

(Entier)Zone personnalisée pour les informations d'attribut. (colonne FIELD1 de la table ATTRVALDESC).

Field2

(Chaîne)Zone personnalisée pour les informations d'attribut. ( colonne FIELD2 de la table ATTRVALDESC ).

Field3

(Chaîne)Zone personnalisée pour les informations d'attribut. (colonne FIELD3 de la table ATTRVALDESC).

Supprimer: (Chaîne) Indicateur de suppression ou non. Pour supprimer une ligne, spécifiez 1.

Fichier CSV avec exemples de données de valeurs d'attributs du dictionnaire d'attributs

Insertion ou remplacement

Dans cet exemple, le fichier CSV contient des valeurs d'attribut du dictionnaire d'attributs. Fichier CSV avec exemples de valeurs d'attributs du dictionnaire d'attributs.

Fichier CSV mis en forme avec en-têtes de colonnes
Identificateur	Type	ValueIdentifier	ValueUsage	Séquence	Valeur	Image1	Image2
ShirtSize	chaîne	Shirt_Size_Large	1	2	Large	`Shirt_size_large/image1.jpg`	`Shirt_size_large/image2.jpg`
ShirtColor	chaîne	Shirt_Color_Red	1	6	Rouge	`Shirt_color_red/image1.jpg`	`Shirt_color_red/image2.jpg`

Supprimer

Dans cet exemple, le fichier CSV contient des valeurs d'attribut du dictionnaire d'attributs destinées à être supprimées. Fichier CSV avec exemples de valeurs d'attributs du dictionnaire d'attributs.

Fichier CSV mis en forme avec en-têtes de colonnes
Identificateur	Type	ValueIdentifier	ValueUsage	Séquence	Valeur	Image1	Image2	Supprimer
ShirtSize	chaîne	Shirt_Size_Large	1	2	Grand	`Shirt_size_large/image1.jpg`	`Shirt_size_large/image2.jpg`	1
ShirtColor	chaîne	Shirt_Color_Red	1	6	Red	`Shirt_color_red/image1.jpg`	`Shirt_color_red/image2.jpg`	1

Données de mappage

Le fragment de code suivant du fichier de configuration de chargement de valeurs d'attributs du dictionnaire d'attributs illustre comment mapper chaque valeur à un chemin de schéma logique d'objet métier.

<_config:DataMapping>
        <_config:mapping xpath="AttributeIdentifier/ExternalIdentifier/Identifier" value="Identifier" />
        <_config:mapping xpath="AttributeIdentifier/UniqueID" value="AttributeUniqueId" />
        <_config:mapping xpath="AllowedValue/language" value="Language" />
        <_config:mapping xpath="AllowedValue/identifier" value="ValueIdentifier" />
        <_config:mapping xpath="AllowedValue/displaySequence" value="Sequence" />
        <_config:mapping xpath="AllowedValue/Value" value="Value" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/ValueUsage" value="ValueUsage" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/Image1" value="Image1" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/Image2" value="Image2" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/Field1" value="Field1" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/Field2" value="Field2" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/Field3" value="Field3" />
        <_config:mapping xpath="" value="Delete" deleteValue="1" />
</_config:DataMapping>

<_config:DataMapping>
        <_config:mapping xpath="AttributeIdentifier/ExternalIdentifier/Identifier" value="Identifier" />
        <_config:mapping xpath="AttributeIdentifier/UniqueID" value="AttributeUniqueId" />
        <_config:mapping xpath="AllowedValue/language" value="Language" />
        <_config:mapping xpath="AllowedValue/language" value="LanguageId" />
        <_config:mapping xpath="AllowedValue/identifier" value="ValueIdentifier" />
        <_config:mapping xpath="AllowedValue/displaySequence" value="Sequence" />
        <_config:mapping xpath="AllowedValue/Value" value="Value" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/ValueUsage" value="ValueUsage" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/AttributeValueField1" value="AttributeValueField1" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/AttributeValueField2" value="AttributeValueField2" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/AttributeValueField3" value="AttributeValueField3" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/Image1" value="Image1" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/Image2" value="Image2" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/Field1" value="Field1" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/Field2" value="Field2" />
        <_config:mapping xpath="AllowedValue/ExtendedValue/Field3" value="Field3" />
        <_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 classe de médiateur est com.ibm.commerce.catalog.dataload.mediator.AttributeDictionaryAttributeMediator.

Si la recherche HCL Commerce est activée, utilisez la classe de médiateur com.ibm.commerce.catalog.dataload.mediator.AttributeDictionaryAttributeSearchIndexMediator.

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.