Exemple : Chargement de widgets Commerce Composer

Cet exemple explique comment charger des informations de widget Commerce Composer pour enregistrer un widget et abonner un magasin à un widget. Une fois que vous avez enregistré un widget et que vous l'avez abonné avec l'utilitaire de chargement de données, les utilisateurs du Management Center peuvent l'utiliser pour concevoir des pages de magasin avec l'Outil de composition Commerce.

Remarque : Cet exemple charge des exemples de widget Composeur Commerce ainsi qu'un exemple de modèle d'agencement et un exemple d'agencement.

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

Lorsque vous créez un widget Commerce Composer, en plus des ressources de vitrine que vous devez créer, vous devez vous servir de l'utilitaire de chargement de données afin de charger et d'enregistrer les informations de définition pour le widget. Vous devez aussi charger la relation entre le widget et un magasin afin d'abonner le magasin pour qu'il utilise le widget. Un magasin doit être abonné à un widget pour que les utilisateurs puissent inclure ce widget dans une page de ce magasin. L'exemple ci-dessous charge les informations nécessaires pour enregistrer un widget et abonner un magasin au widget. Lorsque vous chargez ces informations, vous créez deux widgets : un exemple de widget de site et un exemple de widget de magasin. Toutefois, cet exemple ne crée pas la définition de boutique en ligne ou de Management Center pour le widget. Pour plus d'informations sur la création d'un widget, voir Création de widgets Commerce Composer.

Vous pouvez charger ces exemples d'informations 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 créer les fichiers XML et éditer les exemples de fichier de configuration afin de charger les fichiers XML. Les exemples de fichier d'entrée CSV se trouvent dans le répertoire suivant :

utilities_root/samples/DataLoad/CommerceComposer/widget
WCDE_installdir\samples\DataLoad\CommerceComposer\widget

Cet exemple charge également des fichiers d'entrée qui sont inclus dans les exemples pour le chargement de modèles d'agencement Commerce Composer. Les fichiers d'entrée pour le chargement de modèles d'agencement 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 HCL Commerce 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 créer des widgets 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 de widget. Vous pouvez vous servir de l'Utilitaire d'extraction de donnée pour extraire les données d'enregistrement et d'abonnement de widget 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 de widget, voir Exemple : Extraction de widgets Commerce Composer.

Le tableau ci-après répertorie les exemples de fichier d'entrée qui sont utilisés pour charger les données dans cet exemple. Il identifie également les médiateurs d'objet métier et les fichiers de configuration d'objet métier dont l'utilitaire de chargement de données se sert pour charger les exemples de données.
Exemple de fichier d'entrée	Description
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.	L'utilitaire de chargement de données se sert de cet exemple de fichier d'entrée pour charger les informations permettant d'enregistrer des conteneurs de modèles d'agencement et des widgets dans la base de données HCL Commerce et l'infrastructure Commerce Composer. Cet exemple charge deux fichiers d'entrée registerWidgetdef.csv : Le fichier registerWidgetdef.csv qui se trouve dans le répertoire widget charge les informations permettant d'enregistrer des widgets. Le fichier registerWidgetdef.csv qui se trouve dans le répertoire template charge les informations permettant d'enregistrer des conteneurs de modèles pour un modèle. Le fichier registerWidgetdef.csv, qui charge des informations de conteneur de modèles, 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-widget.xml. Le fichier registerWidgetdef.csv qui se trouve dans le répertoire template est chargé avant le fichier qui se trouve dans le répertoire widget. L'utilitaire de chargement de données charge les informations qui se trouvent dans ces fichiers 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 ces fichiers 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 subscribeWidgetdef.csv XML subscribeWidgetdef.xml Pour plus d'informations sur les données pouvant être incluses dans ce fichier, voir Fichier d'entrée subscribeWidgetdef.	Après avoir chargé les informations permettant d'enregistrer les widgets et les conteneurs, l'utilitaire de chargement de données charge deux fichiers subscribeWidgetdef.csv afin d'abonner les widgets et les conteneurs à un magasin. 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. Cet exemple charge deux fichiers subscribeWidgetdef.csv : Le fichier subscribeWidgetdef.csv qui se trouve dans le répertoire widget 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-widget.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 widget. L'utilitaire de chargement de données charge les informations qui se trouvent dans ces fichiers 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 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.	Ce fichier d'entrée charge des informations permettant de créer la relation entre des conteneurs de modèles et un modèle. Il 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.	Ce fichier d'entrée charge des informations permettant de définir les emplacements dans un conteneur pour un modèle. Chaque emplacement est défini avec des coordonnées x et y. Management Center utilise ces informations pour dessiner la maquette fonctionnelle du site web pour le modèle dans l'Outil de composition Commerce. 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`
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 charge ce fichier d'entrée afin de charger des informations d'agencement dans un magasin pour que les utilisateurs du Management Center puissent utiliser les agencements 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.	Ce fichier d'entrée charge des informations sur la relation entre les widgets, les conteneurs et un agencement. Il charge les informations permettant d'associer un conteneur et un widget à un 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`

Cet exemple charge des informations de widget pour une seule langue. Pour plus d'informations sur le chargement d'informations de description de widget dans plusieurs langues, voir Exemple : Chargement d'informations de description de widget Commerce Composer dans plusieurs langues.

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 widget Commerce Composer et charger les informations pour cet exemple :
- ./dataload.sh ../samples/DataLoad/CommerceComposer/widget/wc-dataload-widget.xml
- dataload ..\samples\DataLoad\CommerceComposer\widget\wc-dataload-widget.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 de widget 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%');

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 le Management Center, vérifiez que les utilisateurs peuvent utiliser le widget dans l'Outil de composition Commerce en créant un agencement pour une page. Lorsque vous créez l'agencement, sélectionnez un emplacement de modèle afin d'ajouter un widget à l'emplacement. Assurez-vous que les widgets que vous avez chargés apparaissent dans la fenêtre Ajout de widgets dans des emplacements. L'image ci-dessous représente l'exemple de widget de site et l'exemple de widget de magasin dans la fenêtre Ajout de widgets dans des emplacements.

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/widget
WCDE_installdir\samples\DataLoad\CommerceComposer\widget

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/widget/Cleanup.sql

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