Exemple : Extraction de pages Commerce Composer

Cet exemple explique comment extraire des pages Commerce Composer et le contenu des pages, comme des informations d'optimisation pour les moteurs de recherche, des agencements, des modèles d'agencement et des widgets. Il se sert de l'Utilitaire d'extraction de donnée afin d'extraire les données Commerce Composer pour un magasin spécifique. Ensuite, vous pouvez vous servir de 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 les pages et le contenu des pages d'une instance ou d'un magasin à l'autre.

Dans l'infrastructure Commerce Composer, une page est une adresse URL spécifique dans la boutique en ligne. Chaque page peut inclure des informations d'optimisation pour les moteurs de recherche spécifiques et être associée à un ou plusieurs agencements pour l'affichage des widgets dans la page. Pour plus d'informations sur les pages, voir Pages et création de pages.

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 page 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 pages et les données relatives aux pages 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 données relatives aux pages qui sont extraites incluent les informations d'optimisation pour les moteurs de recherche qui sont disponibles pour les pages extraites, dans plusieurs langues. L'utilitaire extrait également des données pour les modèles d'agencement, les agencements et les affectations d'agencement pour les pages.

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 et les sous-répertoires suivants :
  • 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 l'utilitaire à utiliser pour un 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-page.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 de sortie 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
Deux fichiers wc-extract-registerWidgetdef.xml sont utilisés dans cet exemple pour configurer l'utilitaire. L'un des fichiers est utilisé pour configurer l'utilitaire afin d'extraire les données d'abonnement des widgets. L'autre est utilisé pour configurer l'utilitaire afin d'extraire les données d'abonnement du conteneur de modèles d'agencement. L'utilitaire extrait les données pour les deux types d'objet depuis la table de base de données suivante :L'utilitaire génère 2 fichiers de sortie subscribeWidgetdef.csv afin d'inclure les données extraites. Ces fichiers peuvent ensuite être utilisés afin de charger les données permettant d'abonner des widgets et des conteneurs de modèles d'agencement à un magasin.
  • Le fichier subscribeWidgetdef.csv dans le répertoire layout inclut des données d'abonnement de widget.
  • Le fichier subscribeWidgetdef.csv dans le répertoire template inclut des données d'abonnement de conteneur de modèles d'agencement.
Pour plus d'informations sur les données pouvant être incluses dans ces fichiers, 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
wc-extract-pagelayout.xml
Ce fichier est utilisé pour configurer l'utilitaire en vue de l'extraction de données d'agencement de base pour les agencements qui existent pour un magasin. L'utilitaire extrait ces données depuis les tables de base de données suivantes : L'utilitaire génère le fichier de sortie layout.csv afin d'inclure les données extraites. Ce fichier peut ensuite être utilisé afin de charger les données permettant de créer des agencements dans un magasin. Pour plus d'informations sur les données pouvant figurer dans ce fichier, voir fichier d'entrée d'agencement.
wc-extract-page.xml
Ce fichier est utilisé pour configurer l'utilitaire en vue de l'extraction de données de page de base pour les pages Commerce Composer qui existent pour un magasin. L'utilitaire extrait ces données depuis les tables de base de données suivantes : L'utilitaire génère le fichier de sortie page.csv afin d'inclure les données extraites. Ce fichier peut ensuite être utilisé pour charger les données permettant de créer des pages dans un magasin. Pour plus d'informations sur les données pouvant figurer dans ce fichier, voir fichier d'entrée de page.
wc-extract-seopage.xml
Ce fichier configure l'utilitaire afin d'extraire des données de propriété d'optimisation pour les moteurs de recherche pour les pages de contenu. L'utilitaire extrait ces données depuis les tables de base de données suivantes :L'utilitaire génère le fichier de sortie seopage.xml afin d'inclure les données extraites. Ce fichier peut ensuite être utilisé pour charger la propriété personnalisée d'optimisation pour les moteurs de recherche pour les pages correspondantes dans un autre magasin ou dans une autre instance. Pour plus d'informations sur les données pouvant figurer dans ce fichier, voir seopage fichier d'entrée.
wc-extract-seopagedesc.xml
Ce fichier configure l'utilitaire afin d'extraire des informations de description d'optimisation pour les moteurs de recherche pour les pages de contenu dans la langue qui est spécifiée dans le contexte métier du fichier de configuration de l'environnement. L'utilitaire extrait ces données depuis les tables de base de données suivantes :L'utilitaire génère le fichier de sortie seopagedesc.csv afin d'inclure les données extraites. Ce fichier peut ensuite être utilisé pour charger les informations de description d'optimisation pour les moteurs de recherche dans la même langue pour les pages correspondantes dans un autre magasin ou dans une autre instance. Pour plus d'informations sur les données pouvant figurer dans ce fichier, voir seopagedesc fichier d'entrée
wc-extract-seopagedesc-MultiLanaguages.xml
Ce fichier configure l'utilitaire afin d'extraire des informations de description d'optimisation pour les moteurs de recherche pour les pages de contenu dans plusieurs langues. L'utilitaire extrait ces données depuis les tables de base de données suivantes :L'utilitaire génère le fichier de sortie seopagedescWithMultiLanguages.csv afin d'inclure les données extraites. Ce fichier peut ensuite être utilisé pour charger les informations de description d'optimisation pour les moteurs de recherche dans plusieurs langues. Il inclut des informations pour la langue spécifiée dans le contexte métier du fichier de configuration de l'environnement et pour toute autre langue dans laquelle les informations d'optimisation pour les moteurs de recherche sont disponibles. Pour plus d'informations sur les données pouvant figurer dans ce fichier, voir seopage fichier d'entrée.
wc-extract-layoutAssignment.xml
Ce fichier configure l'Utilitaire d'extraction de donnée pour extraire les données qui affectent des agencements à des pages. L'utilitaire extrait ces données depuis les tables de base de données suivantes :L'utilitaire génère le fichier de sortie layoutAssignment.csv afin d'inclure les données extraites. Ce fichier peut ensuite être utilisé afin de charger la relation permettant d'affecter des agencements à des pages. Pour plus d'informations sur les données pouvant figurer dans ce fichier, voir fichier d'entrée layoutAssignment.

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 page dans des fichiers de sortie CSV :
    • Linux./dataextract.sh ../samples/DataExtract/CommerceComposer/wc-dataextract-page.xml
    • HCL Commerce Developerdataextract ..\samples\DataExtract\CommerceComposer\wc-dataextract-page.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 toutes les pages et le contenu relatif aux pages 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
    • widget/subscribeWidgetdef.csv
    • template/template.csv
    • template/slotDefinition.csv
    • widget/layout.csv
    • page/page.csv
    • page/seopage.csv
    • page/seopagedesc.csv
    • page/layoutAssignment.csv
    • page/MultiLanguages/seopagedescWithMultiLanguages.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 pages 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 page seulement, voir Exemple : Chargement de pages de l'outil de composition Commerce. 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.

Si vous voulez charger les informations de description de page pour l'optimisation pour les moteurs de recherche dans plusieurs langues, chargez d'abord les informations d'optimisation pour les moteurs de recherche dans la langue par défaut du magasin. Ensuite, chargez les informations d'optimisation pour les moteurs de recherche pour plusieurs langues. En chargeant d'abord les informations dans la langue par défaut, vous réduisez le risque d'erreur au cours de l'opération de chargement. Vous pouvez spécifier la langue par défaut dans le contexte métier du fichier de configuration de l'environnement. Pour un exemple qui explique comment charger les informations de description d'optimisation pour les moteurs de recherche dans plusieurs langues, voir Exemple : Chargement d'informations d'optimisation pour les moteurs de recherche pour des pages Commerce Composer dans plusieurs langues. Si vous suivez l'exemple, utilisez l'approche du fichier unique et éditez le fichier de configuration de l'ordre de chargement afin de spécifier le fichier CSV qui a été généré par l'Utilitaire d'extraction de donnée.

.