Exemple : Extraction de modèles d'agencement Commerce Composer

Cet exemple explique comment extraire des modèles d'agencement Commerce Composer pour un magasin avec l'Utilitaire d'extraction de donnée. Ensuite, vous pouvez utiliser l'pour l'utilitaire de chargement de données pour charger les données extraites dans une autre instance ou un autre magasin HCL Commerce afin de copier rapidement des modèles d'une instance ou d'un magasin à l'autre.

Un modèle d'agencement est un point de départ réutilisable dont vous pouvez vous servir pour la création d'un agencement. Il s'agit d'une maquette fonctionnelle de site Web contenant une disposition spécifique d'emplacements. Des widgets sont affectés à ces emplacements pour la création d'un agencement. Pour plus d'informations sur les modèles d'agencement, voir Agencements, modèles d'agencement et agencements par défaut.

Avant de commencer

Vous devez exécuter les tâches suivantes :
  • Vérifiez que le magasin depuis lequel extraire des données contient des données de modèle d'agencement Commerce Composer à extraire.
Remarque : si vous prévoyez de charger les données extraites dans une autre instance, l'outil Commerce Composer doit être activé dans le magasin dans lequel charger les données. Le magasin type Aurora a été activé pour utiliser l'outil Commerce Composer.

A propos de cet exemple

Lorsque vous exécutez cet exemple, l'Utilitaire d'extraction de donnée est configuré pour extraire les modèles d'agencement uniquement pour le magasin que vous spécifiez. Vous pouvez spécifier le magasin dans le fichier de configuration de l'environnement ou directement sur la ligne de commande lorsque vous exécutez l'utilitaire.

Les exemples de fichier de configuration qui sont utilisés pour configurer l'Utilitaire d'extraction de donnée se trouvent dans le répertoire suivant et le sous-répertoire template :
  • Linuxutilities_root/samples/DataExtract/CommerceComposer
  • HCL Commerce DeveloperWCDE_installdir\samples\DataExtract\CommerceComposer

Exemples de fichier de configuration

Les fichiers de configuration ci-après sont utilisés pour configurer l'Utilitaire d'extraction de donnée en vue de l'extraction de données dans des fichiers de sortie CSV.
wc-dataextract-env.xml
Fichier de configuration de l'environnement. Il inclut les variables d'environnement pour votre instance HCL Commerce. Ces variables incluent les informations suivantes :
  • Variables de contexte métier, notamment l'identificateur de magasin, l'identificateur de catalogue, ainsi que la langue et la devise par défaut pour votre magasin.
  • Paramètres d'environnement de base de données, notamment le type, le nom et le schéma de base de données.
wc-dataextract-template.xml
Fichier de configuration de l'ordre d'extraction des données. Il spécifie les chemins d'accès au fichier de configuration de l'environnement et aux fichiers de configuration d'objet métier pour chaque type d'objet. Il identifie également l'ordre dans lequel l'Utilitaire d'extraction de donnée extrait les données et identifie les fichiers de sortie que l'utilitaire génère afin d'inclure les données extraites.
wc-extract-business-object.xml
Fichier de configuration d'objet métier. Il définit la façon dont l'utilitaire identifie les données à extraire ainsi que le médiateur d'objet métier dont l'utilitaire doit se servir afin de transformer les données extraites. Dans cet exemple, tous les fichiers de configuration d'objet métier configurent l'utilitaire en vue de l'utilisation du médiateur d'objet métier suivant :

com.ibm.commerce.foundation.dataload.businessobjectmediator.AssociationObjectMediator

Les fichiers de configuration d'objet métier suivants sont utilisés afin de configurer l'Utilitaire d'extraction de donnée pour cet exemple :
wc-extract-registerWidgetdef.xml
Ce fichier est utilisé pour configurer l'utilitaire afin d'extraire les données d'enregistrement du conteneur de modèles d'agencement. L'utilitaire extrait ces données depuis les tables de base de données suivantes :L'utilitaire génère le fichier registerWidgetdef.csv afin d'inclure les données extraites. Ce fichier peut ensuite être utilisé afin de charger des données permettant d'enregistrer un nouveau conteneur de modèles d'agencement dans l'outil Commerce Composer. Pour plus d'informations sur les données pouvant être incluses dans ce fichier, voir fichier d'entrée registerWidgetdef.
wc-extract-subscribeWidgetdef.xml
Ce fichier est utilisé pour configurer l'utilitaire afin d'extraire les données d'abonnement du conteneur de modèles d'agencement. L'utilitaire extrait ces données depuis la table de base de données suivante :L'utilitaire génère le fichier de sortie subscribeWidgetdef.csv afin d'inclure ces données extraites. Ce fichier peut ensuite être utilisé afin de charger les données permettant d'abonner des conteneurs de modèles d'agencement à un magasin. Pour plus d'informations sur les données pouvant être incluses dans ce fichier, voir Fichier d'entrée subscribeWidgetdef.
wc-extract-template.xml
Ce fichier est utilisé pour configurer l'utilitaire en vue de l'extraction de données de modèle d'agencement de base. L'utilitaire extrait ces données depuis la table de base de données suivante :L'utilitaire génère le fichier de sortie template.csv afin d'inclure ces données extraites. Ce fichier peut ensuite être utilisé afin de charger les données permettant de créer des modèles d'agencement dans l'outil Commerce Composer. Pour plus d'informations sur les données pouvant être incluses dans ce fichier, voir fichier d'entrée de modèle.
wc-extract-slotDefinition.xml
Ce fichier est utilisé pour configurer l'utilitaire en vue de l'extraction des définitions d'emplacement de maquette fonctionnelle de site Web pour les modèles d'agencement. Chaque emplacement de maquette fonctionnelle de site Web est défini par des coordonnées X et Y et est utilisé pour organiser les widgets dans un agencement. L'utilitaire extrait ces données depuis la table de base de données suivante :L'utilitaire génère le fichier de sortie slotdefinition.csv afin d'inclure les données extraites. Ce fichier peut ensuite être utilisé afin de charger les données permettant d'affecter les coordonnées de maquette fonctionnelle de site Web à un agencement. Pour plus d'informations sur les données pouvant figurer dans ce fichier, voir fichier d'entrée slotDefinition

Procédure

  1. Copiez les exemples de fichier de configuration et les répertoires dans un répertoire local.
  2. Editez votre copie de l'exemple de fichier de configuration de l'environnement afin de définir les variables de configuration pour votre environnement. L'exemple de fichier de configuration qui est utilisé dans cet exemple inclut des valeurs pour un environnement HCL Commerce Developer par défaut qui utilise une base de données Apache Derby. Si vos paramètres d'environnement sont différents, vous devez changer les valeurs configurées dans votre fichier de configuration de l'environnement pour qu'elles correspondent à votre environnement. Pour plus d'informations sur la mise à jour d'un fichier de configuration de l'environnement, voir Configuration des paramètres d'environnement de chargement de données.
  3. HCL Commerce DeveloperDans une ligne de commande, accédez au répertoire WCDE_installdir\bin.
  4. LinuxOuvrez une ligne de commande dans le . Accédez au répertoire utilities_root/bin. Pour plus d'informations sur l'entrée et la sortie des conteneurs, voir Exécution des utilitaires à partir de Utility server Docker container.
  5. Entrez la commande suivante pour exécuter l'exemple de configuration de l'ordre d'extraction des données afin d'extraire les données de modèle dans des fichiers de sortie CSV :
    • Linux./dataextract.sh ../samples/DataExtract/CommerceComposer/wc-dataextract-template.xml
    • HCL Commerce Developerdataextract ..\samples\DataExtract\CommerceComposer\wc-dataextract-template.xml
Une fois que l'utilitaire a terminé le processus d'extraction, il génère les fichiers de sortie CSV dans le répertoire et les sous-répertoires de sortie configurés. Ces fichiers incluent des données pour tous les modèles d'agencement qui existent pour l'ID de magasin configuré. Par défaut, les fichiers sont générés dans le répertoire et les sous-répertoires de sortie suivants :
  • Linuxutilities_root/samples/DataExtract/CommerceComposer/output
  • HCL Commerce DeveloperWCDE_installdir\samples\DataExtract\CommerceComposer\output

Vérification des résultats

  1. Accédez au répertoire que vous avez configuré comme répertoire de sortie. Si vous n'avez pas configuré de répertoire de sortie, accédez au répertoire suivant :
    • Linuxutilities_root/samples/DataExtract/CommerceComposer/output
    • HCL Commerce DeveloperWCDE_installdir\samples\DataExtract\CommerceComposer\output
  2. Vérifiez que les fichiers de sortie CSV suivants ont été générés :
    • template/registerWidgetdef.csv
    • template/subscribeWidgetdef.csv
    • template/template.csv
    • template/slotDefinition.csv
  3. Ouvrez les fichiers de sortie CSV afin d'examiner leur contenu.
  4. Vérifiez que le contenu des fichiers correspond aux données qui se trouvent dans la base de données pour les modèles appartenant au magasin spécifié.

Que faire ensuite ?

Vous pouvez charger les données que vous avez extraites dans une autre instance HCL Commerce avec l'pour l'utilitaire de chargement de données. Pour un exemple qui explique comment charger des données de modèle, voir Exemple : Chargement de modèles d'agencement Commerce Composer. Si vous suivez cet exemple, éditez le fichier de configuration de l'ordre de chargement afin de spécifier les fichiers CSV qui ont été générés par l'Utilitaire d'extraction de donnée.