Chargez votre widget dans la base de données à l'aide de l'utilitaire Chargement des données.

Dans cette leçon, vous vous servez de l'utilitaire Chargement des données pour enregistrer votre nouveau widget et abonnez un magasin à votre widget.

Pour utiliser un widget afin composer une présentation de page pour un magasin, vous devez charger la relation entre le widget et le magasin. Un magasin doit être abonné à un widget pour que les utilisateurs puissent inclure ce widget dans une présentation. Vous pouvez utiliser les fichiers CSV générés et les fichiers de configuration de l'utilitaire Chargement des données pour vous aider à charger vos informations de widget dans la base de données.

Pour plus d'informations sur le chargement d'informations de widget avec l'utilitaire Chargement des données, voir Enregistrement d'un widget Commerce Composer.

Pour plus d'informations sur l'utilitaire de chargement de données, voir Présentation de l'utilitaire de chargement de données.

Procédure

Dans un gestionnaire de fichiers, accédez au répertoire DataLoad\widget de votre nouveau répertoire de projet.
Si vous avez créé votre nouveau répertoire de projets au niveau supérieur de votre espace de travail, le chemin d'accès à ce répertoire peut être workspace_dir\NewWidgetProject\DataLoad\widget.
Dans le répertoire widget, ouvrez le fichier registerWidgetdef.csv pour l'éditer.
Vous utilisez le fichier d'entrée registerWidgetdef.csv pour charger les informations de définition de widget afin d'enregistrer votre nouveau widget dans la structure Commerce Composer. Vous utilisez également le fichier pour abonner un magasin au widget. Un magasin doit s'abonner à un widget pour que ce widget puisse être utilisé dans l'outil Commerce Composer pour ce magasin. Le fichier d'entrée registerWidgetdef.csv charge les données dans les tables de base de données PLWIDGETDEF et PLWIDGETDEFDESC. Le fichier d'entrée registerWidgetdef.csv généré inclut les informations que vous avez spécifiées dans le fichier XML d'entrée du modèle JET. Vous pouvez mettre à jour le fichier CSV pour inclure plus de propriétés et d'informations pour votre widget ou modifier les informations générées.

Vérifiez que les colonnes suivantes du fichier CSV sont correctement spécifiées :

WidgetDefIdentifier

Le nom de référence externe pour la définition de widget. Vous pouvez utiliser n'importe quel nom, mais il doit être unique pour le magasin. Par exemple, ShoppingCartDetailWidget. La valeur de ce paramètre ne peut pas inclure des espaces ou des caractères spéciaux.

WidgetDisplayName

Le nom qui s'affiche dans l'outil Commerce Composer dans pour aider les utilisateurs professionnels à identifier le widget. Par exemple, le widget Exemple de détails du panier.

WidgetUIObjectName

Le nom qui identifie l'objet et la définition du widget. Par exemple, ShoppingCartDetailPageWidget. La valeur de ce paramètre ne peut pas inclure des espaces ou des caractères spéciaux.

WidgetVendor

Nom de l'entreprise ou du fournisseur qui a créé le widget. Par exemple, MonEntreprise. La valeur de ce paramètre ne peut pas inclure des espaces ou des caractères spéciaux.

WidgetType

Le type de widget. Les valeurs possibles pour la propriété sont :

1

Objet fenêtre

2

Conteneur

Assurez-vous que la valeur spécifiée est 1.

WidgetPath

Le chemin d'accès relatif au fichier JSP de niveau supérieur du point d'entrée pour le widget. Par exemple : /Widgets-MyCompany/com.mycompany.commerce.store.widgets.ShoppingCartDetail/ShoppingCartDetail.jsp

WidgetDefinitionxml

Le XML de définition des propriétés dynamiques du widget. Dans l'exemple de ce tutoriel, aucune propriété supplémentaire n'est définie pour le widget Panier. Ainsi, vous n'avez pas besoin de spécifier une valeur pour cette colonne.

WidgetState

L'état de l'enregistrement du widget. Les valeurs possibles pour cette propriété sont :

1

Actif.

2

Inactif.

WidgetStoreUniqueID

Le numéro de référence unique du magasin dans lequel vous enregistrez le widget. Vous pouvez utiliser la propriété pour spécifier si le widget doit être un widget de niveau site ou magasin. Les valeurs possibles de la propriété sont les suivantes :

storeId

La valeur de l'ID de magasin qui est définie dans la colonne STORE_ID de la table de base de données STORE. Spécifiez un ID pour enregistrer le widget dans le magasin spécifié. Le widget n'est pas partagé avec d'autres magasins, sauf si le widget est également enregistré auprès d'un autre magasin.
Remarque : Si vous spécifiez un ID de magasin de ressources, l'utilitaire Chargement des données enregistre le widget avec tous les magasins de site étendu pour ce magasin de ressources. Chaque magasin de site étendu doit cependant toujours s'abonner au widget séparément avant que le widget puisse être utilisé pour le magasin.

0

Spécifiez une valeur de 0 pour enregistrer le widget au niveau du site. Le widget enregistré peut être partagé dans tous les magasins du site.

Vérifiez que la valeur spécifiée est 0.

WidgetDescription

La description qui s'affiche pour le widget dans l'outil Commerce Composer dans le Centre de gestion pour aider les utilisateurs professionnels à identifier le widget. Par exemple, Ce widget est destiné aux détails du panier.

Supprimer

Un indicateur qui détermine si la définition de widget doit être supprimée. Spécifiez 1 pour supprimer le widget. La valeur par défaut est 0, ce qui indique que l'utilitaire Chargement des données doit charger les informations de la ligne dans la base de données.

Votre fichier CSV d'entrée registerWidgetdef.csv peut ressembler au fichier suivant. (Notez que l'image est divisée en deux lignes pour s'adapter à cette page) :

Remarque : registerWidgetdef.csv abonne le magasin dont l'identificateur est défini dans le fichier de configuration de l'environnement de chargement de données au widget. Si vous ne définissez pas de valeur dans le fichier de configuration de l'environnement, le magasin que vous identifiez lorsque vous exécutez l'utilitaire Chargement des données s'abonne au widget.
Pour en savoir plus sur la manière de remplir ce fichier CSV d'entrée registerWidgetdef.csv, voir fichier d'entrée registerWidgetdef0
Pour plus d'informations sur l'enregistrement d'un widget et la définition du XML de définition de widget pour un widget, voir Enregistrement d'un widget Commerce Composer.
Enregistrez le fichier CSV, puis fermez-le.
Ouvrez le fichier subscribeWidgetdef.csv pour l'éditer.
Utilisez le fichier d'entrée subscribeWidgetdef.csvpour abonner des magasins supplémentaires au widget. Vous pouvez également utiliser le fichier d'entrée CSV pour remplacer le XML de définition du widget pour un magasin. Le fichier d'entrée subscribeWidgetdef.csv charge les données dans les tables de base de données PLSTOREWIDGET. Le fichier d'entrée subscribeWidgetdef.csv généré inclut les informations que vous avez spécifiées dans le fichier XML d'entrée de modèle JET. Vous pouvez mettre à jour le fichier CSV pour inclure plus d'informations sur votre widget avant de charger le fichier CSV.

Vérifiez que les colonnes suivantes du fichier CSV sont correctement spécifiées :

WidgetDefIdentifier

Le om de référence externe pour la définition du widget. Assurez-vous que la valeur de la propriété est la même que la valeur spécifiée pour le widget dans le fichier registerWidgetdef.csv. Par exemple, ShoppingCartDetailWidget. La valeur de ce paramètre ne peut pas inclure des espaces ou des caractères spéciaux.

WidgetDefinitionxml

Le XML de définition des propriétés dynamiques du widget. Si vous spécifiez une valeur pour la propriété, vous remplacez la valeur de la colonne WidgetDefinitionxml dans le fichier registerWidgetdef.csv pour un magasin. Pour ce tutoriel, ne spécifiez pas de valeur pour la propriété.

WidgetState

L'état de l'enregistrement du widget. Les valeurs possibles pour cette propriété sont :

1

Actif.

2

Inactif.

Supprimer

Un indicateur qui détermine si la définition de widget doit être supprimée. Spécifiez 1 pour supprimer le widget. La valeur par défaut est 0, ce qui indique que l'utilitaire Chargement des données doit charger les informations de la ligne dans la base de données.

Votre fichier d'entrée subscribeWidgetdef.csv peut ressembler au fichier suivant. (Notez que l'image est divisée en deux lignes pour s'adapter à cette page) :

Remarque : Vous n'avez pas à spécifier l'identificateur pour votre magasin. L'utilitaire Chargement des données utilise la valeur de l'identificateur de magasin défini dans le fichier de configuration de l'environnement de chargement des données. Si vous ne définissez pas de valeur dans le fichier de configuration de l'environnement, vous devez entrer un identificateur lorsque vous exécutez l'utilitaire Chargement des données.
Pour en savoir plus sur la manière de remplir ce fichier d'entrée subscribeWidgetdef.csv, voir Fichier d'entrée subscribeWidgetdef.
Enregistrez et fermez le fichier.
Configurez l'utilitaire Chargement des données afin que vous puissiez utiliser l'utilitaire pour charger vos informations de widget.
1. Dans le répertoire DataLoad de votre nouveau répertoire de projets, ouvrez le fichier wc-dataload-env.xml pour le modifier. Le fichier wc-dataload-env.xml est le fichier de configuration de l'environnement de chargement des données généré pour vous aider à configurer et à exécuter l'utilitaire Chargement des données. Le fichier de configuration définit les variables d'environnement que l'utilitaire Chargement des données utilise, telles que les paramètres de base de données, le résolveur d'ID et le programme d'écriture des données.
2. Mettez à jour le fichier pour qu'il corresponde aux paramètres de votre base de données et de votre environnement. Supprimez la mise en commentaire et mettez à jour le paramètre approprié pour votre base de données.
  Votre fichier wc-dataload-env.xml terminé pourra ressembler à l'exemple de code suivant :
```
<_config:DataLoadEnvConfiguration
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/foundation/config ../../../xml/config/xsd/wc-dataload-env.xsd"
  xmlns:_config="http://www.ibm.com/xmlns/prod/commerce/foundation/config">
  <_config:BusinessContext storeIdentifier="AuroraStorefrontAssetStore" languageId="-1">
  </_config:BusinessContext>
	    
  
	  <_config:Database type="derby" name="..\db\mall" schema="APP"/>
  
  
  
  
  
  
  
  <_config:IDResolver className="com.ibm.commerce.foundation.dataload.idresolve.IDResolverImpl" cacheSize="0"/>
  <_config:DataWriter className="com.ibm.commerce.foundation.dataload.datawriter.JDBCDataWriter" />
</_config:DataLoadEnvConfiguration>
```
3. Facultatif : Dans le répertoire DataLoad de votre nouveau répertoire de projets, ouvrez les fichiers wc-loader-registerWidgetdef.xml et wc-loader-subscribeWidgetdef.xml pour examiner le code généré.
  Les fichiers wc-loader-registerWidgetdef.xml et wc-loader-subscribeWidgetdef.xml sont les fichiers de configuration d'objet métier pour le chargement des informations afin d'enregistrer un widget et de s'abonner à un widget. Un fichier de configuration d'objet métier définit la manière dont l'utilitaire Chargement des données charge les informations dans la base de données. Dans les fichiers, les classes d'implémentation sont spécifiées pour les composants Lecteur de données, Générateur d'objet métier et Médiateur d'objet métier. Dans les fichiers de configuration d'objet métier, vous pouvez spécifier d'autres attributs et propriétés pour ces composants.
  Pour plus d'informations sur la création d'un fichier de configuration d'environnement de chargement des données, voir Configuration des paramètres d'environnement de chargement de données.
4. Facultatif : Dans le répertoire DataLoad\widget de votre nouveau répertoire de projets, ouvrez le fichier wc-dataload-widget.xml pour examiner le code généré.
  Le fichier wc-dataload-widget.xml généré est le fichier de configuration de l'ordre de chargement détermine la séquence de chargement des informations par l'utilitaire Chargement des données. Le fichier de configuration comprend un pointeur vers le fichier de configuration de l'environnement, les fichiers de configuration d'objet métier et les fichiers CSV d'entrée. Votre fichier de configuration d'ordre de chargement de données généré peut ressembler au code suivant :
```
<_config:DataLoadConfiguration
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/foundation/config ../xsd/wc-dataload.xsd"
  xmlns:_config="http://www.ibm.com/xmlns/prod/commerce/foundation/config">
  <_config:DataLoadEnvironment configFile="../wc-dataload-env.xml" />
  <_config:LoadOrder commitCount="100" batchSize="1" dataLoadMode="Replace">
    <_config:property name="charset" value="UTF-8" />
    <_config:property name="loadSEO" value="true" />
    
    <_config:LoadItem name="RegisterWidgetDef" businessObjectConfigFile="../wc-loader-registerWidgetdef.xml">
      <_config:DataSourceLocation location="registerWidgetdef.csv" />
    </_config:LoadItem>
    
    <_config:LoadItem name="SubscribeWidgetDef" businessObjectConfigFile="../wc-loader-subscribeWidgetdef.xml">
      <_config:DataSourceLocation location="subscribeWidgetdef.csv" />
    </_config:LoadItem>
  </_config:LoadOrder>
</_config:DataLoadConfiguration>
```
  Pour plus d'informations sur la création d'un fichier de configuration de l'ordre de chargement des données, voirConfiguration de l'ordre de chargement des données.
5. Enregistrez tous les fichiers que vous avez modifiés et fermez tous les fichiers.
Exécutez l'utilitaire de chargement de données.
1. Vérifiez que votre serveur est arrêté avant d'exécuter l'utilitaire Chargement des données. Pour plus d'informations sur l'arrêt du serveur, reportez-vous à la rubrique Démarrage et arrêt de HCL Commerce Test Server.
2. Dans l'utilitaire de ligne de commande, accédez au répertoire WCDE_installdir\bin.
3. Exécutez la commande suivante pour charger les fichiers CSV d'entrée afin d'enregistrer votre widget et d'abonner un magasin à votre widget :
```
Dataload.bat workspace_dir\NewWidgetProject\DataLoad\widget\wc-dataload-widget.xml 
```
4. Vérifiez les résultats du chargement de données.