Exemple : Chargement d'agencements Commerce Composer

Cet exemple explique comment charger des agencements Commerce Composer afin de les utiliser dans l'Outil de composition Commerce et la boutique en ligne.

Avant de commencer

Cet exemple requiert un magasin publié qui repose sur le magasin type Aurora et l'Outil de composition Commerce. Effectuez les tâches suivantes :

Prenez connaissance des meilleures pratiques pour le chargement de données de l'outil de composition Commerce. Appliquez ces meilleures pratiques lorsque vous chargez des ressources de l'outil de composition Commerce avec l'utilitaire de chargement de données.

A propos de cet exemple

Un agencement Commerce Composer est une organisation de widgets d'agencement dans un modèle d'agencement qui est utilisé pour afficher une page de magasin. Un agencement contient un ou plusieurs widgets qui sont placés à des emplacements spécifiques dans le modèle. Les propriétés (paires nom-valeur) de chaque widget sont associées à des valeurs spécifiques. Pour créer un agencement, vous pouvez vous servir de l'utilitaire de chargement de données afin de charger les informations d'agencement dans la base de données HCL Commerce.

Lorsque vous chargez les fichiers d'entrée dans cet exemple, vous chargez des informations permettant de créer un agencement, notamment le modèle d'agencement, un conteneur de modèles d'agencement, des emplacements, et d'affecter des widgets à des emplacements. Spécifiquement, cet exemple charge cinq agencements :

SampleHomePageLayout
SampleStaticContentLayout
SampleDepartmentPageLayout
SampleContentPageLayout
SampleDefaultContentPageLayout

L'agencement SampleDefaultContentPageLayout est chargé comme agencement par défaut pour les pages qui sont affichées sur des ordinateurs de bureau, des ordinateurs portables et des tablettes. Il ne s'affiche pas dans le Management Center et ne peut pas être édité. Lorsqu'un utilisateur crée une page de contenu, la page est affectée automatiquement à l'agencement SampleDefaultContentPageLayout jusqu'à ce que l'utilisateur affecte un autre agencement à la page. Les quatre autres agencements de cet exemple ne sont pas des agencements par défaut et peuvent être utilisés pour toutes les pages.

Pour plus d'informations sur les agencements Commerce Composer et les composants qui constituent un agencement, voir Architecture d'agencement de Commerce Composer.

Vous pouvez charger les informations pour cet exemple dans des fichiers d'entrée au format CSV ou XML. Toutefois, la procédure ci-après ne charge que les fichiers d'entrée CSV. Si vous préférez utiliser les données dans des fichiers au format XML, vous pouvez éditer les exemples de fichier de configuration afin d'utiliser les fichiers XML. Les exemples de fichier d'entrée se trouvent dans le répertoire suivant :

utilities_root/samples/DataLoad/CommerceComposer/layout
WCDE_installdir\samples\DataLoad\CommerceComposer\layout

Cet exemple charge également des fichiers d'entrée qui sont inclus dans l'exemple de chargement de modèles d'agencement Commerce Composer. Les fichiers d'entrée pour cet exemple se trouvent dans le répertoire suivant :

utilities_root/samples/DataLoad/CommerceComposer/template
WCDE_installdir\samples\DataLoad\CommerceComposer\template

Pour plus d'informations sur l'exemple de chargement de modèles d'agencement Commerce Composer, voir Exemple : Chargement de modèles d'agencement Commerce Composer.

Si vous utilisez cet exemple pour charger des informations d'agencement Commerce Composer qui existent dans une autre instance, vous pouvez vous servir de l'Utilitaire d'extraction de donnée afin de générer les fichiers d'entrée pour le chargement de vos données d'agencement. Vous pouvez vous servir de l'Utilitaire d'extraction de donnée afin d'extraire les données d'agencement existantes. Ensuite, vous pouvez éditer les fichiers de configuration pour cet exemple afin de charger les fichiers qui sont générés par l'Utilitaire d'extraction de donnée. Pour un exemple expliquant comment se servir de l'Utilitaire d'extraction de donnée afin d'extraire des données d'agencement, voir Exemple : Extraction d'agencements Commerce Composer.

Fichiers d'entrée source pour le chargement d'agencements de l'outil de composition Commerce. Ce tableau répertorie également les médiateurs d'objet métier dont l'utilitaire de chargement de données se sert pour charger les données d'agencement.
Exemple de fichier d'entrée	Description
CSV layout.csv XML layout.xml Pour plus d'informations sur les données qui sont incluses dans ce fichier, voir fichier d'entrée d'agencement.	L'utilitaire de chargement de données se sert de cet exemple de fichier d'entrée pour charger des modèles d'agencement et des agencements dans un magasin pour que les utilisateurs du Management Center puissent les utiliser dans l'Outil de composition Commerce. L'utilitaire de chargement de données charge les informations qui figurent dans le fichier d'entrée dans les tableaux de base de données PAGELAYOUT et PLTEMPLATEREL. Il se sert du médiateur d'objet métier et du fichier de configuration d'objet métier suivants pour charger les données dans ce fichier d'entrée : Médiateur d'objet métier com.ibm.commerce.pagelayout.dataload.mediator.LayoutMediator Fichier de configuration d'objet métier `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-pagelayout.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-pagelayout.xml`
CSV layoutWidgetRelationship.csv XML layoutWidgetRelationship.xml Pour plus d'informations sur les données qui sont incluses dans ce fichier, voir fichier d'entrée layoutWidgetRelationship.	Cet exemple de fichier d'entrée charge un conteneur de modèles d'agencement et ajoute des widgets dans des emplacements de modèle d'agencement afin de créer un agencement. L'utilitaire de chargement de données charge les informations qui figurent dans le fichier d'entrée dans les tableaux de base de données PLWIDGET et PLWIDGETREL. Il se sert du médiateur d'objet métier et du fichier de configuration d'objet métier suivants pour charger les données dans ce fichier d'entrée : Médiateur d'objet métier com.ibm.commerce.pagelayout.dataload.mediator.WidgetMediator Fichier de configuration d'objet métier `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-widget.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-widget.xml`
CSV subscribeWidgetdef.csv XML subscribeWidgetdef.xml Pour plus d'informations sur les données qui sont incluses dans ce fichier, voir Fichier d'entrée subscribeWidgetdef.	Cet exemple de fichier d'entrée charge des informations permettant d'abonner des widgets et des conteneurs de modèles à un magasin. Pour que vous puissiez abonner un magasin à un widget, le widget doit être enregistré dans la base de données HCL Commerce et l'infrastructure Commerce Composer. Un magasin doit s'abonner à des widgets et des conteneurs spécifiques pour que ces objets puissent être utilisés dans l'Outil de composition Commerce pour ce magasin. Les widgets qui sont utilisés dans cet exemple sont enregistrés par défaut lorsque vous activez l'Outil de composition Commerce Cet exemple charge deux fichiers subscribeWidgetdef.csv : Le fichier subscribeWidgetdef.csv qui se trouve dans le répertoire layout charge les informations permettant d'abonner des widgets à un magasin. Le fichier subscribeWidgetdef.csv qui se trouve dans le répertoire template charge les informations permettant d'abonner un modèle d'agencement à un magasin. Le fichier subscribeWidgetdef.csv est également chargé dans le cadre de l'exemple de chargement d'un modèle d'agencement Commerce Composer. L'ordre selon lequel l'utilitaire de chargement de données charge les informations dans ces fichiers d'entrée est défini dans le fichier de configuration de l'ordre de chargement wc-dataload-layout.xml. Le fichier subscribeWidgetdef.csv qui se trouve dans le répertoire template est chargé avant le fichier qui se trouve dans le répertoire layout. L'utilitaire de chargement de données charge les informations qui se trouvent dans le fichier d'entrée dans le tableau de base de données PLSTOREWIDGET. Il se sert du médiateur d'objet métier et du fichier de configuration d'objet métier suivants pour charger les données dans ce fichier d'entrée : Médiateur d'objet métier com.ibm.commerce.pagelayout.dataload.mediator.SubscribeWidgetDefinitionMediator Fichier de configuration d'objet métier `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-subscribeWidgetdef.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-subscribeWidgetdef.xml`
CSV widgetnvp.csv XML widgetnvp.xml Pour plus d'informations sur les données qui sont incluses dans ce fichier, voir widgetnvp fichier d'entrée.	Cet exemple de fichier d'entrée charge des informations permettant de définir les propriétés des widgets qui sont inclus dans les emplacements de l'agencement que vous chargez avec cet exemple. L'utilitaire de chargement de données charge les informations qui se trouvent dans le fichier d'entrée dans le tableau de base de données PLWIDGETNVP. Il se sert du médiateur d'objet métier et du fichier de configuration d'objet métier suivants pour charger les données dans ce fichier d'entrée : Médiateur d'objet métier com.ibm.commerce.pagelayout.dataload.mediator.WidgetNVPMediator Fichier de configuration d'objet métier `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-widgetnvp.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-widgetnvp.xml`
CSV registerWidgetdef.csv XML registerWidgetdef.xml Pour plus d'informations sur les données qui sont incluses dans ce fichier, voir fichier d'entrée registerWidgetdef.	Cet exemple de fichier d'entrée charge des informations permettant d'enregistrer un nouveau widget ou conteneur de modèles en vue de son utilisation dans l'Outil de composition Commerce. Dans cet exemple, le fichier d'entrée charge des informations permettant d'enregistrer les conteneurs de modèles pour l'agencement. Ce fichier d'entrée est également chargé dans le cadre de l'exemple de chargement d'un modèle d'agencement Commerce Composer. L'utilitaire de chargement de données charge les informations qui figurent dans le fichier d'entrée dans les tableaux de base de données PLWIDGETDEF et PLWIDGETDEFDESC. Il se sert du médiateur d'objet métier et du fichier de configuration d'objet métier suivants pour charger les données dans ce fichier d'entrée : Médiateur d'objet métier com.ibm.commerce.pagelayout.dataload.mediator.registerWidgetdefMediator Exemple de fichier de configuration d'objet métier pour le chargement de ces informations : `utilities_root/samples/DataLoad/PageComposer/wc-loader-registerWidgetdef.xml` `WCDE_installdir\samples\DataLoad\PageComposer\wc-loader-registerWidgetdef.xml`
CSV template.csv XML template.xml Pour plus d'informations sur les données qui sont incluses dans ce fichier, voir fichier d'entrée de modèle.	Cet exemple de fichier d'entrée charge des informations qui définissent un modèle pouvant être utilisé pour créer un agencement. Ce fichier d'entrée est également chargé dans le cadre de l'exemple de chargement d'un modèle d'agencement Commerce Composer. L'utilitaire de chargement de données charge les informations qui se trouvent dans le fichier d'entrée dans le tableau de base de données PAGELAYOUT. Il se sert du médiateur d'objet métier et du fichier de configuration d'objet métier suivants pour charger les données dans ce fichier d'entrée : Médiateur d'objet métier com.ibm.commerce.pagelayout.dataload.mediator.WidgetMediator Fichier de configuration d'objet métier `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-template.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-template.xml`
CSV slotDefinition.csv XML slotDefinition.xml Pour plus d'informations sur les données qui sont incluses dans ce fichier, voir fichier d'entrée slotDefinition.	Cet exemple de fichier d'entrée charge des informations permettant de définir les emplacements dans un conteneur pour un modèle spécifique. Chaque emplacement est défini par des coordonnées x et y. Ce fichier d'entrée est également chargé dans le cadre de l'exemple de chargement d'un modèle d'agencement Commerce Composer. L'utilitaire de chargement de données charge les informations qui se trouvent dans le fichier d'entrée dans le tableau de base de données PLWIDGETSLOT. Il se sert du médiateur d'objet métier et du fichier de configuration d'objet métier suivants pour charger les données dans ce fichier d'entrée : Médiateur d'objet métier com.ibm.commerce.pagelayout.dataload.mediator.WidgetSlotsMediator Fichier de configuration d'objet métier `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-widgetslot.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-widgetslot.xml`

Procédure

Dans une ligne de commande, accédez au répertoire WCDE_installdir\bin.
Ouvrez 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.
Entrez la commande suivante pour exécuter l'exemple de fichier de l'ordre de chargement des données pour un agencement Commerce Composer et charger les informations pour cet exemple :
- ./dataload.sh ../samples/DataLoad/CommerceComposer/layout/wc-dataload-layout.xml
- dataload ..\samples\DataLoad\CommerceComposer\layout\wc-dataload-layout.xml
Le fichier de configuration de l'ordre de chargement identifie l'ordre selon lequel l'utilitaire de chargement de données charge les exemples de fichier CSV. Le fichier de l'ordre de chargement identifie également le fichier de configuration d'objet métier approprié à utiliser pour charger chaque fichier d'entrée. Pour plus d'informations sur les fichiers de configuration de l'ordre de chargement, voir Configuration de l'ordre de chargement des données.
Pour plus d'informations sur la configuration et l'exécution de l'utilitaire de chargement de données, voir Configuration et exécution de l'utilitaire de données de chargement.

Vérification des résultats

Vérifiez que les informations d'agencement de l'Outil de composition Commerce ont été chargées en examinant le rapport récapitulatif de chargement de données. Pour plus d'informations sur l'emplacement et le contenu de ce rapport récapitulatif, voir Vérification du résultat du chargement des données.

Vous pouvez aussi vérifier que les exemples de données ont été chargés en exécutant les instructions SQL suivantes pour votre base de données WebSphere Commerce :

select * from PLWIDGETDEF where IDENTIFIER like 'Sample%';
select * from PLWIDGETDEFDESC where PLWIDGETDEF_ID in (select PLWIDGETDEF_ID from PLWIDGETDEF where IDENTIFIER 
like 'Sample%');
select * from PLSTOREWIDGET where PLWIDGETDEF_ID in (select PLWIDGETDEF_ID from PLWIDGETDEF where IDENTIFIER 
like 'Sample%');
select * from PAGELAYOUT where name like 'Sample%';
select * from PLTEMPLATEREL where PAGELAYOUT_ID in (select PAGELAYOUT_ID from PAGELAYOUT where NAME 
like 'Sample%');
select * from PLWIDGET where PAGELAYOUT_ID in (select PAGELAYOUT_ID from PAGELAYOUT where name 
like 'Sample%');
select * from PLWIDGETREL where PLWIDGET_ID_CHILD in (select PLWIDGET_ID 
from PLWIDGET where PAGELAYOUT_ID in (select PAGELAYOUT_ID 
from PAGELAYOUT where name like 'Sample%'));
select * from PLWIDGETSLOT where PAGELAYOUT_ID in (select PAGELAYOUT_ID from PAGELAYOUT where name
like 'Sample%');
select * from PLWIDGETNVP where PLWIDGET_ID in (select PLWIDGET_ID
from PLWIDGET where PAGELAYOUT_ID in (select PAGELAYOUT_ID from PAGELAYOUT where NAME like 'Sample%'));

Assurez-vous que les données qui se trouvent dans les exemples de fichier d'entrée existent dans les tables de base de données appropriées.

Dans Management Center, vérifiez que les utilisateurs peuvent afficher les agencements dans l'Outil de composition Commerce en affichant la liste des agencements disponibles. Assurez-vous que les agencements que vous avez chargés se trouvent dans la grille Agencements - Liste d'agencements. L'image ci-dessous représente les nouveaux agencements.
Liste d'agencements qui contient des exemples d'agencement

Liste d'agencements qui contient des exemples d'agencement

Ouvrez un agencement pour l'éditer et dans la section Affectations d'agencement, ajoutez une entrée dans le tableau Pages afin d'affecter l'agencement à une page.

Suppression des exemples de données depuis la base de données HCL Commerce

Pour supprimer les exemples de données de votre base de données, exécutez à nouveau l'exemple, mais avec la valeur de la colonne de suppression pour toutes les entrées dans les fichiers définie sur 1. En définissant la valeur de cette colonne sur 1, l'utilitaire de chargement de données supprime les données identifiées dans le fichier CSV de votre base de données.

Vous pouvez aussi exécuter le fichier Cleanup.sql pour cet exemple de chargement de données. Ce fichier Cleanup.sql est situé dans le répertoire suivant :

utilities_root/samples/DataLoad/CommerceComposer/layout
WCDE_installdir\samples\DataLoad\CommerceComposer\layout

Depuis une invite de commande, connectez-vous à la base de données avec votre ID utilisateur et votre mot de passe. Exécutez la commande suivante :

db2 -tvf ../samples/DataLoad/CommerceComposer/layout/Cleanup.sql

sqlplus user_name/password@ database_name@ ../samples/DataLoad/CommerceComposer/layout/Cleanup.sql