Importation et exportation de catalogues

Intershop Commerce Management dispose de mécanismes puissants d’importation pour faciliter le traitement en masse des données. Les concepts importants liés aux processus d’importation et d’exportation sont décrits dans les sections suivantes. En ce qui concerne les formats d’importation, les fichiers XSD Schema et les fichiers d’importation ASCII sont disponibles. Si nécessaire, contactez votre administrateur système pour obtenir ces fichiers.

Que peut-on importer ou exporter ?

Les entités suivantes peuvent être importées ou exportées :

  • Contenu statique

    Le contenu statique comprend, sans s’y limiter, des images de produits, des fiches techniques et des manuels de l’utilisateur. Ces fichiers peuvent être utilisés comme référence, par exemple, lors de la définition des images ou des pièces jointes pour un produit. Il est possible de créer une structure de répertoire pour stocker et gérer le contenu téléversé. Notez que le contenu des fichiers zip est automatiquement extrait et stocké dans le répertoire désigné.

  • Données de produit

    Les données de produit peuvent être importées dans le stock de produits principal ou celui des canaux. Les données sont importées au format ASCII (fichiers csv utilisant le point-virgule comme séparateur) ou au format XML. Les données de produit peuvent être exportées au format XML.

  • Catégories de catalogue

    Les catégories de catalogue peuvent être importées pour les catalogues principaux et ceux des canaux. Les catalogues sont importés en utilisant des sources de données au format ASCII (fichiers csv utilisant le point-virgule comme séparateur) ou des fichiers XML. Pour importer une structure de catégories, vous devez d’abord créer une catégorie racine comme cible pour les catégories de catalogue importées. Les catégories sont exportées en fichiers XML.

  • Catégories de classification

    Les catégories de classification peuvent être importées et exportées depuis et vers des fichiers XML.

  • Données BMEcat

    Les données de produit et de catégorie au format BMEcat peuvent être importées et exportées depuis et vers des fichiers XML.

  • Types de variation

    Les données définissant les types de variation peuvent être importées à partir des fichiers CSV et XML et peuvent être exportées en fichiers XML.

Modes d’importation standards

Les modes d’importation standards décrits ci-dessous s’appliquent à tous les processus d’importation dans Intershop Commerce Management. En d’autres termes, elles sont valables pour les données de catalogue et de produit, les données de promotion, les éléments de contenu, etc., sauf indication contraire.

Modes d’importation standards
Mode Description
OMIT L’importation est simulée, les modifications ne sont pas écrites dans la base de données. Peut être utilisé à des fins de test.
IGNORE Ignore tous les objets qui existent déjà dans la base de données, crée des enregistrements uniquement pour les nouveaux objets et les ajoute à la base de données. Par exemple, si un produit est spécifié dans la source d’importation et que le produit est trouvé dans la base de données par le service d’importation/exportation, il ne sera pas modifié.
UPDATE Met à jour les objets existants et crée des enregistrements pour de nouveaux objets. Les attributs et les objets qui n’existent pas dans le fichier d’importation restent inchangés.
REPLACE Remplace les objets existants (UUID est conservé) et crée des enregistrements pour de nouveaux objets. Les objets qui n’existent pas dans le fichier d’importation restent inchangés. Les attributs manquants des objets existants (dans le fichier d’importation) seront supprimés.
DELETE Supprime tous les enregistrements de fichiers d’importation qui existent dans la base de données.
INITIAL N’effectue pas de requête de base de données pour trouver des objets existants. Ceci permet une importation rapide mais cause une erreur lorsqu’un objet déjà existant est importé. Ce mode est généralement utilisé durant le processus DBInit.

Verrouillage des objets

Les opérations simultanées de données de masse et les opérations d’« objet unique » déclenchées individuellement peuvent produire des données incohérentes. Intershop Commerce Management dispose d’un mécanisme de verrouillage d’objet spécifique pour empêcher les modifications simultanées des mêmes données. Dans le cas où un utilisateur a l’intention de modifier un objet qui est déjà verrouillé par un autre processus, Commerce Management affiche un avertissement et, selon l’opération, fournit les options soit :

  • de le déverrouiller, ce qui donne la priorité au processus « appelant » et lui permet d'être exécuté,

  • d’attendre un délai déterminé, puis échouer, où le processus « appelant » attend le temps déterminé pour la fin du verrouillage précédent afin de fonctionner ensuite, ou échouer si le timeout est atteint, ou

  • d’échouer lorsque le processus « appelant » est immédiatement terminé.

Identificateurs de produit

Pour que l’importation de données de produits, de catalogues et d’autres données soit réussie, certains éléments doivent être définis dans la source de données tandis que d’autres peuvent être optionnels. Lors de la préparation des données d’importation, vérifiez toujours les fichiers de schéma Intershop XSD pour les éléments optionnels et requis. Si nécessaire, contactez votre administrateur système pour obtenir ces fichiers.

Pour l’importation de produits, notez que Intershop Commerce Management utilise un système d’identification de produit étendu (IDP), en complément des références de produit standard. Intershop Commerce Management prend en charge les types d’identificateur de produit suivants :

  • ID du fabriquant

    Cet identificateur de produit est défini et géré par le fabricant d’origine d’un produit. Puisque les fabricants ne sont pas hébergés par Intershop Commerce Management, ils ne gèrent pas eux-mêmes ces ID dans la base de données de Intershop Commerce Management. Cependant, ces identificateurs jouent un rôle important quand des fournisseurs ou vendeurs hébergés ont besoin d’interagir avec leurs fabricants, par exemple pour répondre à des commandes.

  • ID du fournisseur

    Cet identificateur de produit est défini et géré par le fournisseur d’un produit. Les fournisseurs regroupent généralement les produits de différents fabricants et ont donc besoin de leur propre schéma de numérotage pour identifier de façon unique les produits de différents fabricants.

  • ID du vendeur

    Cet identificateur de produit est défini et géré par le vendeur réel d’un produit. Les ID du vendeur sont définis en fonction d’un identificateur de produit. Ceci permet d’attribuer plusieurs ID de vendeur au cas où le vendeur offre le produit dans plusieurs stocks de produits.

  • ID de l’acheteur

    Cet identificateur de produit est défini et géré par une organisation d’achats.

Les IDP sont définis comme des attributs personnalisés. Chaque définition d’IDP se compose de deux parties : une partie pour définir le propriétaire de l’IDP (acheteur, vendeur, fournisseur ou fabricant), l’autre partie pour définir la valeur réelle. Un exemple de définition d’un ID de fournisseur est présenté ci-dessous :


<custom-attribute dt:dt="string" name="PID_OWNER_SupplierID@global">IQ</
custom-attribute>
<custom-attribute dt:dt="string" name="PID_VALUE_SupplierID@global">D598
9C</custom-attribute>
					
Dans de nombreux cas, les définitions des IDP sont plus complexes. Regardez l’exemple ci-dessous. L’exemple définit trois IDP différents (ID Vendeur, ID Fournisseur, ID Fabricant). Vous remarquerez que l’ID du vendeur a un but bien défini (le domaine « inSPIRED-MasterRepository ») : identifier le référentiel sur lequel l’ID du vendeur a été défini.
<custom-attribute dt:dt="string" name="PID_OWNER_SellerID
                @inSPIRED-MasterRepository">inSPIRED</custom-attribute>
<custom-attribute dt:dt="string" name="PID_VALUE_SellerID
                @inSPIRED-MasterRepository">D5989C</custom-attribute>
<custom-attribute dt:dt="string" name="PID_OWNER_SupplierID@global">IQ</
custom-attribute>
<custom-attribute dt:dt="string" name="PID_VALUE_SupplierID@global">D598
9C</custom-attribute>
<custom-attribute dt:dt="string" name="PID_OWNER_ManufacturerID@global">
IQ</custom-attribute>
<custom-attribute dt:dt="string" name="PID_VALUE_ManufacturerID@global">
D5989C</custom-attribute>
         
En préparant les produits pour l’importation, tenez compte des points suivants :
  • Un produit qui doit être importé par un fournisseur doit avoir au moins un IDP de type ID de fournisseur.

  • Un produit qui doit être importé par une organisation de vente ou d’achats doit avoir au moins un IDP de type ID de vendeur ou ID de fournisseur. Lors de la définition d’un ID de vendeur, un champ d’application doit être fourni et faire référence au domaine derrière le référentiel auquel l’ID de vendeur appartient. Pour obtenir les noms de domaine à utiliser, contactez votre administrateur système.

  • Assurez-vous que la structure de l’IDP soit correcte. Les IDP dont la structure est incorrecte sont ignorés lors de l’importation. En outre, le système ignore une définition d’IDP avec la valeur « null » ou aucune valeur du tout.

Remarque :
Les IDP sont validés automatiquement avant l’importation.

Flux de tâches des importations/exportations en général

L’approche générale pour l’importation de données dans Intershop Commerce Management est la suivante :

  1. Téléversez les données d’importation stockées dans un fichier depuis votre machine locale vers le serveur.
  2. Importez les données depuis un fichier.

L’exportation fonctionne dans l’autre sens :

  1. Exportez les données vers un fichier stocké dans Intershop Commerce Management.
  2. Téléchargez le fichier sur votre machine locale.
Conseil :
Cette procédure est identique pour tous les processus d’importation/exportation de données, y compris les données de catalogue et de produit, les données de promotion, les éléments de contenu, etc., sauf indication contraire.