Vous êtes ici :
Importation/exportation des catalogues dans B2C Commerce
Importer un catalogue entier en une seule fois ; L’importation inclut le catalogue ainsi que toutes les catégories et tous les produits qui s’y trouvent. Il en est de même pour l'exportation. Vous exportez l'intégralité du catalogue en une seule fois. Cette rubrique concerne B2C Commerce.
L'importation/exportation de catalogue est conçue de façon à respecter les points suivants :
- Vous pouvez importer un catalogue de boutique indépendamment du catalogue de produits.
- Une catégorie de catalogue de boutique peut faire référence aux produits appartenant à cette catégorie.
- Les importations d’autres catalogues de boutique n’affectent pas les associations de produit/catégorie déjà établies.
- Les importations de mise à jour des produits du catalogue de produits n’affectent pas les associations des catalogues de la boutique.
- La sémantique de l’importation de catalogue est ajustée de manière à ce que les catalogues de produits et de boutique soient des unités de données indépendantes, isolées les unes des autres, ce qui vous permet de les importer sans supprimer les structures de données de chacun.
Emplacement d'importation/exportation dans Business Manager
Cliquez sur
Importation de catalogue
Importer un catalogue à partir d’un fichier de type CSV ou XML. Vous ne pouvez télécharger un fichier CSV qu’en mode FUSIONNER et spécifier le catalogue que vous téléchargez avant de poursuivre le processus d’importation. L’importation des données de catalogue dans les environnements de développement et de production entraîne des erreurs si le même catalogue existe dans l’instance Staging. Nous vous recommandons de répliquer les données de catalogue à partir de l’instance Staging.
L'importation d'un catalogue se fait en deux temps.
- Lors de la première phase, les objets sont créés, mis à jour et supprimés.
- Lors de la deuxième phase, les relations entre objets sont établies.
Ce processus d’importation permet aux éléments category et product d’apparaître dans n’importe quel ordre dans le flux. Au cours de l’importation, vous n’avez aucun accès à ces deux phases. Le mode de transaction par défaut valide les modifications après chaque importation d’objets. Si l’importation est interrompue entre la première et la deuxième phase, l’objet créé ou mis à jour peut être abandonné. Dans ce cas, aucune relation n’est créée pour l’objet. Pour éviter d’abandonner des objets, incluez toutes les entités correspondant à un catalogue dans un même fichier XML.
Les nouveaux produits importés en mode FUSIONNER et REMPLACER prennent par défaut l'état hors ligne si l'état n'est pas spécifié dans le fichier d'importation.
- Pour les produits existants importés en mode METTRE À JOUR, FUSIONNER et REMPLACER, l’état en ligne/hors ligne ne change pas à moins qu’un état ne soit spécifié dans le fichier d’importation.
- Pour les fichiers d'importation qui précisent l'état en ligne/hors ligne pour chaque produit, cette modification n'a aucun impact sur le comportement existant de l'importation de catalogue.
Le schéma d'importation catalog.xsd oblige un élément <value-definition> à déclarer un élément <value>. La valeur spécifiée ne doit pas être vide et ne doit pas contenir d'espace ni au début ni à la fin.
Exportation de catalogue
Exportez les données de produits sélectionnés à partir de Business Manager ou via un pipeline personnalisé. Au cours de l’exportation de catalogues, B2C Commerce tronque automatiquement les espaces de début et de fin, et supprime les caractères de nouvelle ligne enregistrés précédemment dans un chemin d’image de produit. Exportez un catalogue au format XML ou CSV.
Le mode d'exportation de catalogue de Business Manager Exporter des produits spécifiques contient uniquement la liste des produits sélectionnés et les catégories associées à ces produits. Cliquez sur . Vous pouvez utiliser les fonctions de recherche de produit standard ou bêta conformément aux instructions de Recherche simple de produits.
Importation/exportation des balises méta de la page
Les règles et définitions des balises méta de la page sont désormais importées et exportées dans une section « Balises méta de la page » séparée. Voir Balises méta de la page.
Seules les associations sont importées et exportées dans les catégories Catalogue, Bibliothèque et ImpEx du site.
Pipelets
ImportCatalog
Importe les données de catalogue spécifiées par le fichier d'importation dans le système, dans le mode indiqué. Ce pipelet permet de configurer l’importation de façon à supprimer le catalogue avant l’importation. Utilisez cette technique pour vider très rapidement un catalogue, en particulier si les objets du catalogue sont inconnus. Supprimez également les attributs personnalisés avant l’importation lorsque vous utilisez le mode METTRE À JOUR ou FUSIONNER. Pour plus d'informations, voir Suppression des objets obsolètes.
Vous ne pouvez importer des définitions d’attribut de produit personnalisées qu’à l’aide du pipelet ImportCatalog. Il n'est pas possible d'importer des définitions d'attribut personnalisées d'objets produit à l'aide de l'importation de catalogue de Business Manager. Pour permettre l’importation de définitions d’attribut de produit personnalisées, définissez le paramètre ImportConfiguration du pipelet ImportCatalog sur ImportAttributeDefinitions = true. Si ce paramètre ne figure pas dans la configuration de l’importation ou s’il est défini sur false, les définitions d’attribut de produit ne sont pas importées.
Si vous fournissez des définitions d’attribut de produit dans le fichier d’importation de catalogue, mais que ImportAttributeDefinitions = false ou not provided ou que le fichier est importé dans Business Manager, une erreur de données est consignée. Dans ce cas, l'élément product-attribute-definitions est ignoré lors d'une importation en modes METTRE À JOUR, FUSIONNER et REMPLACER.
ExportCatalog
Lorsque le paramètre ExportCategoryAssignments=True, dans le pipelet ExportCatalog, et que vous spécifiez un itérateur Products, le fichier d’exportation contient uniquement les associations de catégories pour la liste des produits ou associations de catégories exportés. Lorsque l'itérateur Products n'est pas spécifié, toutes les associations de catégorie sont exportées.
Granularité : catégories passées, produits de catégories passées, associations de catégories de catégories passées, toutes les recommandations du catalogue, toutes les options de produit partagé dans le catalogue).
Éléments de schéma
Cette section décrit les éléments du schéma catalog.xsd et les points à prendre en compte lors de la création de leurs valeurs.
Élément : Category
Tenez compte de certains détails spécifiques à l’élément lors de l’importation d’un élément de catégorie.
- Les éléments category peuvent apparaître dans n'importe quel ordre dans le flux.
- Spécifiez le mode SUPPRIMER au niveau de l’élément category, en remplaçant le mode de processus d’importation, par exemple, <category category-id="Electronics » mode="delete"/>.
- La catégorie root d'un catalogue n'est jamais supprimée en mode SUPPRIMER. Elle n'est pas davantage supprimée en mode REMPLACER. En revanche, elle est mise à jour en mode REMPLACER.
- La suppression d'une catégorie entraîne la suppression des associations de catégorie de la catégorie (mais pas des produits au sein de la catégorie), des liens de catégorie (entrants et sortants) et de toutes les sous-catégories.
- Le nom d'affichage et la description de la catégorie root sont également définis comme nom d'affichage et description du catalogue.
- Certains sous-éléments de category ont une sémantique ou un ensemble de valeurs par défaut spécifique, s'ils ne sont pas fournis dans le flux. Le tableau suivant fournit des détails.
Attributs : online-from et online-to
Il arrive dans certains cas d'avoir à réinitialiser les valeurs des attributs de catégorie online-from et online-to au cours de l'importation d'un catalogue. Par exemple, la validation XML échoue si vous soumettez ces éléments dans XML avec une valeur vide (par exemple, <online-from/>). Réinitialisez les attributs de catégorie online-from et online-to lors de l’importation d’un catalogue.
Pour réinitialiser ces valeurs d’attributs au cours d’un processus d’importation de catalogue, le fichier d’importation doit être conforme à l’exemple de format XML suivant :
<category category-id="RESET_ME">
<!-- reset default online-from value -->
<online-from xsi:nil="true" />
<!-- reset default online-to value -->
<online-to xsi:nil="true" /> </category>Ajoutez les éléments suivants à votre fichier d’importation de catalogue :
xsi:noNamespaceSchemaLocation="catalog.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"Exemple :
<catalog xmlns="http://www.demandware.com/xml/impex/catalog/2006-10-31"
xsi:noNamespaceSchemaLocation="catalog.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" catalog-id="catalog">
Lors de l'utilisation du mode METTRE À JOUR :
Comprendre le comportement du mode METTRE À JOUR est important pour les clients qui souhaitent produire des fichiers delta de catalogue pour mettre à jour leurs catalogues.
- Si vous importez une catégorie qui est la cible d’un lien de catégorie sans la catégorie qui est la source du lien, le lien n’est pas supprimé.
- Si vous importez une catégorie avec des catégories enfants sans ses enfants, les enfants ne sont pas supprimés.
| Sous-élément | Commentaires |
|---|---|
| afficher-nom | Si élément omis : attribut non modifié |
| description | Si élément omis : attribut non modifié |
| Indicateur-en-ligne | Si élément omis pendant la création : configuration par défaut sur faux Si élément omis pendant la mise à jour : attribut non modifié |
| parent | Si élément omis : AVERTISSEMENT DE DONNÉES dans le journal ; prend par défaut la valeur "root". |
| position | Si élément omis : attribut non modifié |
| vignette | Si élément omis : attribut non modifié |
| image | Si élément omis : attribut non modifié |
| modèle | Si élément omis : attribut non modifié |
| indicateur-inclus-dans-plan-du-site | Si élément omis : attribut non modifié |
| fréquencemodification-plan-du-site | Si élément omis : attribut non modifié |
| priorité-plan-du-site | Si élément omis : attribut non modifié |
| attributs-page | Si éléments omis : attributs non modifiés Élément fourni : Sémantique FUSIONNER pour chaque attribut et paramètre régional |
| attributs-personnalisés | Si éléments omis : attributs non modifiés Élément fourni : Sémantique FUSIONNER pour chaque attribut et paramètre régional |
| category-links | Si élément omis : liens de catégories non modifiés Élément fourni : Sémantique REMPLACER sur les liens de catégorie sortants L'ordre d'apparition des éléments category-link définit l'ordre de tri |
| attribute-groups | Si élément omis : groupes non modifiés Élément fourni : Sémantique REMPLACER L'ordre d'apparition des éléments attribute-groups définit l'ordre de tri L'ordre d'apparition des attributs définit l'ordre de tri |
| refinement-definitions | Si élément omis : affinements non modifiés Élément fourni : Sémantique REMPLACER L'ordre d'apparition des éléments refinement-definition définit l'ordre de tri |
Élément : Produits
Tenez compte de certains détails spécifiques à l’élément lors de l’importation de l’élément product.
- Les éléments product peuvent apparaître dans n'importe quel ordre dans le flux.
- Spécifiez le mode SUPPRIMER au niveau de l’élément du produit, en remplaçant le mode de processus d’importation, par exemple : <product product-id="PN00001 » mode="delete"/>.
- Les types de produit suivants s’excluent mutuellement : offre groupée, lot de produits et produit maître. Par conséquent, les éléments suivants s'excluent aussi mutuellement : bundled-products, product-set-products et variations.
- Vous ne pouvez pas spécifier de variations pour les types de produit suivants : offre groupée, lot de produits et produit maître.
- Chaque variation et groupe de variations appartient à un seul produit maître. Faites passer la propriété d’un produit maître à un autre au cours d’un seul processus d’importation.
- Si vous importez une variation sans son produit maître, le produit reste une variation.
- Si vous importez un produit maître sans ses variations, les produits spécifiés dans la section des <variations> restent liés au produit maître. Les autres variations se dissocient du produit maître et deviennent des produits normaux.
- Si vous importez un lot de produits sans son lot de produits parent, il reste un membre du lot.
- Si vous importez un produit groupé sans son groupe, il reste un membre du groupe.
- Si vous importez un produit qui est la cible d’un lien de produit sans le produit source du lien, le lien n’est pas supprimé.
- La suppression d'un groupe n'entraîne pas la suppression des produits groupés.
- La suppression d'un produit maître supprime également ses variations.
Réinitialisation des attributs de produit
Dans certains cas, vous souhaiterez peut-être supprimer les valeurs d'attribut de produit lors d'une importation en mode FUSIONNER.
Réinitialisez les attributs suivants lors de l’importation du catalogue :
- en-ligne-à-partir-de
- en-ligne-jusqu-à
- rechercher-rang
- rechercher-positionnement
- indicateur-inclus-dans-plan-du-site
- fréquencemodification-plan-du-site
- priorité-plan-du-site
Exemple de format XML :
<product product-id="RESET_ME">
<!-- reset default online-from value -->
<online-to xsi:nil="true" />
<!-- reset default search-placement value -->
<search-placement xsi:nil="true" />
<!-- reset site-specific search-placement value -->
<search-placement site-id="YourSite" xsi:nil="true" />
</product>
Ajoutez ce qui suit :
xsi :noNamespaceSchemaLocation="catalog.xsd » xmlns :xsi="http://www.w3.org/2001/XMLSchema-instance »
à l’élément racine de votre fichier d’importation, de sorte qu’il ressemble à ce qui suit :
<catalog xmlns="http://www.demandware.com/xml/impex/catalog/2006-10-31 » xsi :noNamespaceSchemaLocation="catalog.xsd »
xmlns :xsi="http://www.w3.org/2001/XMLSchema-instance » catalog-id="catalog »>
Traitement particulier des sous-éléments
Certains sous-éléments de product ont une sémantique ou un ensemble de valeurs par défaut spécifique, s'ils ne sont pas fournis dans le flux. Le tableau suivant fournit des détails.
| Sous-élément | Commentaires |
|---|---|
| ean | Si élément omis : attribut non modifié |
| upc | Si élément omis : attribut non modifié |
| unit | Si élément omis pendant la création : configuration par défaut sur vrai Si élément omis pendant la mise à jour : attribut non modifié |
| min-order-quantity | Si élément omis pendant la création : configuration par défaut sur 1 Si élément omis pendant la mise à jour : attribut non modifié |
| step-quantity | Si élément omis pendant la création : configuration par défaut sur 1 Si élément omis pendant la mise à jour : attribut non modifié |
| afficher-nom | Si élément omis : attribut non modifié |
| short-description | Si élément omis : attribut non modifié |
| long-description | Si élément omis : attribut non modifié |
| Indicateur-en-ligne | Si élément omis pendant la création : configuration par défaut sur vrai Si élément omis pendant la mise à jour : attribut non modifié |
| en-ligne-à-partir-de | Si élément omis : attribut non modifié |
| en-ligne-jusqu-à | Si élément omis : attribut non modifié |
| Indicateur-disponible | Si élément omis pendant la création : configuration par défaut sur vrai Si élément omis pendant la mise à jour : attribut non modifié |
| Indicateur-recherchable | Si élément omis pendant la création : configuration par défaut sur vrai Si élément omis pendant la mise à jour : attribut non modifié |
| image | Si élément omis : attribut non modifié |
| vignette | Si élément omis : attribut non modifié |
| modèle | Si élément omis : attribut non modifié |
| tax-class-id | Si élément omis : attribut non modifié |
| brand | Si élément omis : attribut non modifié |
| manufacturer-name | Si élément omis : attribut non modifié |
| manufacturer-sku | Si élément omis : attribut non modifié |
| rechercher-positionnement | Si élément omis : attribut non modifié |
| rechercher-rang | Si élément omis : attribut non modifié |
| indicateur-inclus-dans-plan-du-site | Si élément omis : attribut non modifié |
| fréquencemodification-plan-du-site | Si élément omis : attribut non modifié |
| priorité-plan-du-site | Si élément omis : attribut non modifié |
| attributs-page | Si éléments omis : attributs non modifiés Élément fourni : Sémantique FUSIONNER pour chaque attribut et paramètre régional |
| attributs-personnalisés | Si éléments omis : attributs non modifiés Élément fourni : Sémantique FUSIONNER pour chaque attribut et paramètre régional Les valeurs de l'attribut personnalisé ne sont pas fusionnées. La fusion crée l'objet s'il n'existe pas, puis modifie un objet existant. Les attributs d’objet qui ne figurent pas dans le flux restent inchangés. Si une valeur d'attribut personnalisée se trouve dans le fichier XML, le produit reçoit cette valeur mais les autres valeurs, sélectionnées précédemment, ne sont plus sélectionnées. Le mode d'importation fusionner importe les attributs et non la valeur elle-même. Pour certaines valeurs (par exemple, les valeurs des attributs de variation), un mode de fusion spécifique est disponible. Mais ce n’est pas le cas pour les attributs personnalisés auxquels vous faites référence. |
| bundled-products | Si éléments omis : relations non modifiées Élément fourni : Sémantique REMPLACER L'ordre d'apparition des éléments d'une offre groupée définit l'ordre de tri. |
| product-set-products | Si éléments omis : relations non modifiées Élément fourni : Sémantique REMPLACER L'ordre d'apparition des éléments product-set-product définit l'ordre de tri |
| options | Si élément omis : options non modifiées Élément fourni : Sémantique REMPLACER sur toutes les options privées et partagées (supprimer/créer les options privées, dissocier/associer les options partagées) L'ordre d'apparition des éléments option et shared-option définit l'ordre de tri |
| variations | Élément variations omis : attributs et relations non modifiés Si l'élément attributes est omis : attributs non modifiés L'ordre d'apparition des éléments attribute définit l'ordre de tri Élément variants omis : relations non modifiées L'attribut merge-mode détermine si les variations sont ajoutées, supprimées ou remplacées, indépendamment de la sémantique FUSIONNER. Si l’attribut merge-mode n’est pas fourni, l’importateur utilise la sémantique REMPLACER par défaut. Il s’agit du comportement hérité pour l’élément. |
| product-links | Si élément omis : liens de produit non modifiés Élément fourni : Sémantique REMPLACER sur les liens de produit sortants L'ordre d'apparition des éléments product-link définit l'ordre de tri. |
| classification-category | Si élément omis : relations non modifiées |
Attributs spécifiques au site
Les <éléments d’importation/exportation de produits> online-flag>, online-from, online-to, searchable-flag, search-rank, search-placement, sitemap-included-flag, sitemap-priority, sitemap-changefrequency et custom-attribute prennent en charge un attribut< <> <> <> <> <> <> <> <> <> Site-ID facultatif qui indique que la valeur de l’attribut est spécifique au site. Pour spécifier une valeur spécifique au site, utilisez un identifiant de site en langage humain lisible. Exemple :
<online-flag site-id="MySiteEurope">false</online-flag>Élément : Images
L'importation de catalogue prend en charge un attribut merge-mode pour la section <images>. Cet attribut a deux valeurs possibles :
-
merge: la valeur par défaut. -
replace: utilisez-la si vous comptez effacer toutes les informations d'image stockées pour un produit, puis les réimporter. Utilisez cette valeur, par exemple, si vous avez modifié les attributs de variation qu’un produit maître utilise pour faire varier les images.
merge-mode, cela n'a d'intérêt que lorsque le mode d'importation global est METTRE À JOUR ou FUSIONNER.Élément : Category-Assignment
Le système conserve les associations produit-catégorie dans le fichier catalog.xsd pendant l'importation, ce qui vous permet d'importer des catégories accompagnées d'associations de produit prédéfinies en une seule étape. Cela s’avère particulièrement utile lorsque vous utilisez un seul catalogue (classification) en conjonction avec plusieurs catalogues (navigation) spécifiques aux sites.
L’élément variation-configuration et le type complexe VariationConfiguration permettent la configuration du découpage des variations au niveau de la catégorie.
Lorsque vous associez des valeurs de position de produit à une catégorie dans Business Manager, la valeur de position de chaque produit apparaît sous la forme d’un nombre séquentiel. Lors de l'importation ou de l'exportation de produits, leur élément position de category-assignment est associé à la valeur auto. Pour résoudre la valeur commune et déterminer la position d’un produit, l’ordre dans lequel il apparaît dans le fichier détermine la position réelle de chaque produit.
Par exemple, Business Manager attribue au produit A la position 1 et au produit B la position 2 pour une catégorie. Au cours de l'importation, la valeur des éléments position des deux produits est définie sur auto. Comme le produit A est le premier dans le fichier, il apparaît en premier et le produit B en deuxième.
Élément : Product-Attribute-Definitions
L'élément product-attribute-definitions est conçu pour prendre en charge les définitions d'attribut pour l'objet de produit via un flux en provenance d'un système tiers ou back-end. Il n'est pas censé permettre l'importation générale des métadonnées d'attribut via l'importation. Les métadonnées de définition d'attribut ne sont pas prises en charge en cas d'exportation. Si l'élément product-attribute-definitions inclut des définitions se rapportant à des attributs système, le fichier d'importation ne sera pas valide.
Vous ne pouvez importer des définitions d’attribut que via le pipelet ImportCatalog, et non via l’importation Business Manager. Les attributs de produit créés par l'importation de catalogue ont les valeurs par défaut suivantes :
- order-required est défini sur
false - searchable est défini sur
false - externally-defined est défini sur
false
Si l’élément product-attribute-definitions n’est pas défini dans le fichier d’importation, l’importation ne modifie aucune définition d’attribut de produit existante.
L’importation traite l’élément de manière identique pour les modes FUSIONNER, REMPLACER et METTRE À JOUR. Si vous définissez l’élément product-attribute-definitions dans le fichier d’importation, l’importation vérifie si la définition d’attribut existe déjà dans la base de données et effectue les opérations suivantes :
- Les nouvelles définitions d'attribut sont ajoutées et l'indicateur externally-defined est défini sur
truedans la base de données B2C Commerce. - Les définitions d'attribut existantes dont l'indicateur externally-defined est défini sur true dans la base de données B2C Commerce sont mises à jour, mais non remplacées.
- Les définitions d'attribut existantes dont l'indicateur externally-defined est défini sur
falsedans la base de données B2C Commerce sont ignorées pendant l'importation, et le système consigne une erreur de données. - L’importation ignore les définitions d’attribut non valides. S’il existe un attribut portant le même identifiant et que
externally-defined-flagest défini sur true, l’importation le supprime. L’importation supprime également les valeurs éventuellement configurées pour l’attribut de la base de données B2C Commerce. - Si l’indicateur externally-defined de la définition d’attribut est défini sur true dans la base de données B2C Commerce, et que l’attribut n’est pas présent dans le flux d’importation, cet attribut est supprimé. L’importation supprime également les valeurs éventuellement configurées pour l’attribut de la base de données B2C Commerce.
B2C Commerce supprime tous les attributs définis de l'extérieur et absents du flux d'importation, car les systèmes back-end sont souvent incapables de fournir des renseignements sur des informations obsolètes. La suppression automatique des attributs obsolètes empêche d'en accumuler un trop grand nombre dans la base de données.
En mode d’importation SUPPRIMER, l’importation ignore tous les éléments product-attribute-definitions définis dans le fichier d’importation.
Type complexe : AttributeDefinition
Dans catalog.xsd, le type complexe AttributeDefinition prend en charge l'attribut site-specific-flag.
Attribut : Système
Les valeurs propres au site des attributs système sont prises en charge via l'importation et l'exportation de catalogue.
Attribut : Custom
Les valeurs propres au site des attributs personnalisés sont prises en charge via l'importation et l'exportation de catalogue.
<online-flag site-id="MySiteAmerica">false</online-flag>Élément : Variantes
Attribut : Merge-Mode
L'attribut merge-mode remplace la sémantique FUSIONNER des éléments variants spécifiques en mode METTRE À JOUR, FUSIONNER et REMPLACER. L'attribut peut avoir les valeurs suivantes : add, merge, replace, et remove.
Il n’est pas nécessaire d’utiliser l’attribut en mode REMPLACER, car dans ce mode, toutes les variations sont automatiquement supprimées avant d’être remplacées par celles qui sont recensées dans le flux.
Pour ajouter et supprimer des variations séparément, placez-les dans des éléments variants distincts. N’utilisez qu’un seul élément variants par élément variations et par produit.
Exemple 1 : ajout de deux nouvelles variations
<product product-id="28447">
…
<variations>
<variants merge-mode="add">
<variation product-id="883239585285"/>
<variation product-id="883239585289"/>
</variants>
</variations>
</product>Exemple 2 : suppression de trois variations
<product product-id="28447">
…
<variations>
<variants merge-mode="remove">
<variation product-id="883239585281"/>
<variation product-id="883239585282"/>
<variation product-id="883239585283"/>
</variants>
</variations>
</product>Exemple 3 : remplacement des valeurs d’attribut par la troisième variation
<product product-id="28447">
…
<variations>
<variants merge-mode="replace">
<variation product-id="883239585287"/>
</variants>
</variations>
</product>Tri des valeurs d’attribut de variation et des variations lors de l’importation
Contrôlez le tri des valeurs d’attribut de variations et des variations lors de l’importation du catalogue. Cette possibilité s’avère utile pour conserver l’ordre de tri des valeurs d’attributs de variation et des variations lors de l’importation.
Si vous spécifiez merge pour l’attribut merge-mode des éléments variation-attribute-values et variants, l’importateur :
- Ajoute toutes les nouvelles valeurs spécifiées dans le fichier d’importation à la fin de la liste, dans le même ordre que celui spécifié dans le fichier d’importation.
- Met à jour toutes les valeurs existantes spécifiées dans le fichier d’importation. Ce comportement signifie que l’importateur met à jour tous les attributs de la valeur, tels que le nom d’affichage, s’ils sont spécifiés dans le fichier d’importation. La position des valeurs existantes n’est pas mise à jour. L’importateur supprime toutes les valeurs existantes non spécifiées dans le fichier d’importation.Remarque Les variations ne sont pas supprimées, mais elles sont dissociées du produit maître et deviennent des produits autonomes.
Si l'attribut merge-mode n'est pas spécifié dans le fichier, la procédure d'importation remplace totalement la liste stockée dans le système par les valeurs du fichier d'importation. L'importation utilise la sémantique par défaut replace pour les listes d'éléments.
Importation/exportation pour les recommandations dans B2C Commerce
Les recommandations sont importées dans le cadre du catalogue auquel elles appartiennent. Une recommandation est représentée en tant qu'élément de niveau supérieur du schéma de catalogue. L'élément recommendation est un frère des éléments <product>, <category> et <category-assignment>. Cette rubrique concerne B2C Commerce.
Fichier de schéma (catalog.xsd)
Le fragment de code suivant provient du schéma de catalogue :
<!-- Recommendation -->
<xsd:complexType name="complexType.Recommendation" mixed="false">
<xsd:sequence>
<xsd:element name="display-name" type="sharedType.LocalizedString" minOccurs="0" maxOccurs="unbounded" />
<xsd:element name="short-description" type="sharedType.LocalizedString" minOccurs="0" maxOccurs="unbounded" />
<xsd:element name="long-description" type="sharedType.LocalizedString" minOccurs="0" maxOccurs="unbounded" />
<xsd:element name="callout-message" type="sharedType.LocalizedString" minOccurs="0" maxOccurs="unbounded" />
<xsd:element name="image" type="simpleType.Generic.String.256" minOccurs="0" maxOccurs="1" />
<xsd:element name="custom-attributes" type="sharedType.CustomAttributes" minOccurs="0" maxOccurs="1" />
</xsd:sequence>Exemple
Voici la section du fichier de schéma de catalogue qui traite des types de recommandation (RecommendationTypes) :
<xsd:simpleType name="simpleType.RecommendationType">
<xsd:annotation>
<xsd:documentation>Allowed string values are the 'int' values defined for the Recommendation.recommendationType attribute, and additionally the values 'cross-sell', 'up-sell', and 'other' for backward compatibility.</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="simpleType.Generic.String" />
</xsd:simpleType>Avec RecommendationTypes, le processus d'importation exige un entier positif comme valeur dans ce champ. Le processus d'importation accepte également l'une des valeurs héritées cross-sell, up-sell ou other , qui sont converties en interne en valeurs 1, 2 ou 3, respectivement. Si une autre valeur est transmise, le processus d'importation renvoie une erreur et la recommandation n'est pas importée. Le processus d'importation ne valide pas l'entier transmis. Si la valeur transmise n'est pas égale à l'une des valeurs d'attribut configurées, le processus d'importation crée la recommandation avec le type transmis, quel qu'il soit.
Définissez une liste de types de recommandations dans Business Manager. Par exemple, définissez un nouveau type 4=="down-sell" ou 5=="upside down sell », qui apparaissent dans le fichier XML, comme illustré dans l’exemple suivant :
<recommendation type="4" target-id="PN0002" source-type="product" source-id="PN0001" />
<recommendation type="5" target-id="S1965524" source-type="product" source-id="S1937231"/>Tri
Les recommandations sont triées dans le contexte de l'objet et du type sources. Business Manager et le processus d’importation du catalogue gèrent ce tri.
Le processus d'importation positionne les recommandations dans le même ordre que dans le fichier d'importation de catalogue. Une recommandation importée :
- est ajoutée à la fin de la liste des recommandations existantes en mode REMPLACER ou des nouvelles recommandations en mode FUSIONNER ;
- conserve sa position actuelle pour les recommandations existantes en mode FUSIONNER.
