Exemple : Chargement d'informations de description de widget Commerce Composer dans plusieurs langues

Cet exemple explique comment charger des informations de description pour Commerce Composer dans plusieurs langues afin de les utiliser dans le Management Center 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

Si vous disposez de widgets Commerce Composer pour votre magasin, vous pouvez vous servir de l'utilitaire de chargement de données afin de charger des informations de description pour les widgets dans d'autres langues. Cet exemple charge les informations de description pour un widget dans deux langues, en anglais (en_US) et en français (fr_FR). Pour plus d'informations sur les langues prises en charge par défaut, voir Prise en charge de la globalisation.

Pour que vous puissiez charger les informations de description d'un widget, ce dernier doit avoir été créé, enregistré et abonné à un magasin. Pour plus d'informations sur la création de widgets, voir Création de widgets Commerce Composer. Pour plus d'informations sur le chargement d'informations permettant d'enregistrer des widgets et de les abonner à un magasin, voir Exemple : Chargement 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 é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/widget/MultiLanguages
WCDE_installdir\samples\DataLoad\CommerceComposer\widget\MultiLanguages

Pour charger cet exemple, vous pouvez charger les informations multilingues dans des fichiers distincts ou dans un fichier unique.

Pour charger les informations dans un fichier unique, chargez le fichier de configuration de l'ordre de chargement des données wc-dataload-widgetdefdesc-one-step-lang.xml. Lorsque vous exécutez ce fichier de l'ordre de chargement, l'utilitaire de chargement de données charge les informations dans l'exemple de fichier d'entrée registerWidgetdefdescWithTwoLanguages.csv. Le fichier registerWidgetdefdescWithTwoLanguages.csv contient plusieurs colonnes de description et de nom d'affichage. Les deux colonnes de description sont mappées à la même colonne de base de données. Les deux colonnes de nom d'affichage sont également mappées à la même colonne. Toutefois, le fichier de configuration d'objet métier configure l'utilitaire de chargement de données en vue de la création d'entrées distinctes pour le widget dans la base de données, une pour chaque langue.
Remarque : la configuration qui gère le chargement des informations dans plusieurs langues pour cette option est définie dans le fichier de configuration d'objet métier.
Pour charger les informations multilingues dans des fichiers distincts, chargez le fichier wc-dataload-widgetdefdesc-two-step-lang.xml. Lorsque vous exécutez ce fichier, l'utilitaire de chargement de données charge les informations dans les exemples de fichier d'entrée registerWidgetdefLanguageOne.csv et registerWidgetdefdescLanguageTwo.csv. Le fichier registerWidgetdefLanguageOne.csv contient les informations permettant d'enregistrer les informations de widget et de langue par défaut (anglais). Le fichier registerWidgetdefdescLanguageTwo.csv contient les informations permettant de charger les informations en langue française pour le widget.
Remarque : lorsque vous utilisez l'approche des fichiers distincts, la configuration qui identifie la langue dans laquelle les données sont chargées est définie dans le fichier de configuration de l'ordre de chargement des données.

Si vous utilisez cet exemple pour charger des informations de widget 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 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. Etant donné que les exemples de fichier de l'Utilitaire d'extraction de donnée extraient les informations de description de widget dans toutes les langues dans un seul fichier, utilisez l'approche du fichier unique pour charger les données extraites.

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 registerWidgetdefLanguageOne.csv XML registerWidgetdefLanguageOne.xml Pour plus d'informations sur le type de données dans le fichier d'entrée, voir fichier d'entrée registerWidgetdef.	L'utilitaire de chargement de données charge les informations permettant d'enregistrer un widget en vue de son utilisation dans l'Outil de composition Commerce. L'utilitaire de chargement de données charge les informations de description qui se trouvent dans les 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 ce fichier d'entrée : Médiateur d'objet métier com.ibm.commerce.pagelayout.dataload.mediator.RegisterWidgetDefMediator Fichier de configuration d'objet métier `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-registerWidgetdef.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-registerWidgetdef.xml`
CSV registerWidgetdefdescLanguageTwo.csv XML registerWidgetdefdescLanguageTwo.xml Pour plus d'informations sur le type de données dans le fichier d'entrée, voir fichier d'entrée registerWidgetdefdesc.	L'utilitaire de chargement de données charge les informations de description d'un widget dans plusieurs langues. L'utilitaire de chargement de données charge les informations de description qui se trouvent dans les 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 ce fichier d'entrée : Médiateur d'objet métier com.ibm.commerce.pagelayout.dataload.mediator.RegisterWidgetDefMediator Fichier de configuration d'objet métier `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-registerWidgetdefdesc.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-registerWidgetdefdesc.xml`
CSV registerWidgetdefdescWithTwoLanguages.csv XML registerWidgetdefdescWithTwoLanguages.csv	Cet exemple de fichier d'entrée contient les informations permettant d'enregistrer le widget et les informations de description de widget dans un fichier unique. Cet exemple de fichier comprend le contenu des exemples de fichier d'entrée registerWidgetdefLanguageOne.csv et registerWidgetdefdescLanguageTwo.csv. Médiateur d'objet métier com.ibm.commerce.pagelayout.dataload.mediator.RegisterWidgetDefMediator Fichier de configuration d'objet métier `utilities_root/samples/DataLoad/CommerceComposer/widget/MultiLanguages/wc-loader-registerWidgetdefdesc-two-langs.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\widget\MultiLanguages\wc-loader-registerWidgetdefdesc-two-langs.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 afin de charger les informations de description de widget dans plusieurs langues :
- Pour charger les informations de description dans un exemple de fichier d'entrée unique :
  - ./dataload.sh ../samples/DataLoad/CommerceComposer/widget/MultiLanguages/wc-dataload-widgetdefdesc-one-step-lang.xml
  - dataload ..\samples\DataLoad\CommerceComposer\widget\MultiLanguages\wc-dataload-widgetdefdesc-one-step-lang.xml
- Pour charger les informations de description dans des exemples de fichier d'entrée distincts :
  - ./dataload.sh ../samples/DataLoad/CommerceComposer/widget/MultiLanguages/wc-dataload-widgetdefdesc-two-step-lang.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 afficher la description en français pour le widget dans l'Outil de composition Commerce. Connectez-vous au centre de gestion en français et créez 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 la description du widget apparaît dans la langue appropriée 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 l'exemple à nouveau, mais en indiquant la valeur 1 dans la colonne delete pour toutes les entrées figurant dans les fichiers. Si vous définissez la valeur 1 pour cette colonne, l'utilitaire de chargement de données supprime les données qui sont identifiées dans le fichier CSV de votre base de données.