Déploiement de ressources Commerce Composer

Vous pouvez créer et déployer un package de vos ressources Commerce Composer personnalisées ou mises à jour avec l'outil de génération et ou de déploiement HCL Commerce.

Pourquoi et quand exécuter cette tâche

L'outil de génération et de déploiement HCL Commerce est conçu pour faciliter le déploiement de ressources personnalisés de nature à être une source d'erreur et de longue durée. L'outil de génération et de déploiement HCL Commerce vous fournit un point de départ pour automatiser vos processus de génération et de déploiement de façon normalisée et contrôlée.

La procédure suivante fournit des informations pour vous aider à conditionner et déployer votre code de personnalisation de widget.

Procédure

Créez le référentiel de code source pour contenir les ressources que vous déployez.
Remarque : Si vous déployez des ressources d'agencement, assurez-vous d'inclure les ressources du widget et du modèle d'agencement si les ressources sont déjà déployées.
  1. Créez le référentiel de code source pour inclure les fichiers d'utilitaire de chargement de données les packages de code pour votre code de personnalisation de widget.
    1. Dans un gestionnaire de fichiers, accédez au répertoire WCBD_installdir.
    2. Créez la structure de répertoires suivante dans le répertoire wcbd :

      source\workspace

  2. Ajoutez les fichiers de vos ressources Commerce Composer personnalisées dans votre référentiel de code source pour l'outil de génération et de déploiement HCL Commerce.
    1. Dans le répertoire WCBD_installdir\source\workspace, créez la structure de répertoires suivante :

      DataLoad\dataload\common

      Vous utilisez la structure de répertoires pour conserver vos fichiers d'utilitaires de chargement de données pendant le processus de génération.
    2. Copiez tous les fichiers de configuration de chargement de données, les fichiers d'entrée et la structure de dossiers pour les ressources que vous déployez dans votre répertoire WCBD_installdir\source\workspace\DataLoad\dataload\common.
  3. Ajoutez les packages de vitrine et de code Management Center de votre ressource Commerce Composer dans votre référentiel de code source pour l'outil de génération et de déploiement HCL Commerce.
    1. Accédez au répertoire workspace_dir.
    2. Copiez le répertoire LOBTools.
    3. Collez le répertoire LOBTools dans le répertoire WCDE_installdir\wcbd\source\workspace.
    4. Accédez au répertoire workspace_dir\Stores\WebContent\storedir.
    5. Copiez la structure de dossiers et tous les fichiers de vos répertoires dans le répertoire WCDE_installdir\wcbd\source\workspace.
Configuration et exécution du processus de génération
  1. Configurez le script Ant d'extraction source.
    Le script Ant extrait le code source du référentiel de code source que vous avez créé.
    1. Accédez au répertoire WCBD_installdir\extract.
    2. Copiez les fichiers wcbd-sample-extract-local.properties et wcbd-sample-extract-local.xml.
    3. Collez les fichiers copiés dans le répertoire WCBD_installdir.
    4. Renommez le fichier wcbd-sample-extract-local.properties en extract-local.properties.
    5. Renommez le fichier wcbd-sample-extract-local.xml en extract-local.xml.
    6. Ouvrez le fichier extract-local.xml pour l'éditer.
    7. Localisez la ligne de code suivante : 
      <project name="wcbd-sample-extract-local" default="all">
    8. Remplacez la ligne de code que vous avez trouvée par le code suivant : 
      <project name="extract-local" default="all">
    9. Sauvegardez et fermez les fichiers.
    10. Ouvrez le fichier extract-local.properties pour l'éditer.
    11. Définition de la valeur local.extract.dir= par WCBD_installdir/source
      Remarque : Dans tous les fichiers de propriétés utilisés par votre outil de génération et de déploiement HCL Commerce, vous devez utiliser des barres obliques (/) dans les chemins d'accès des fichiers. Dans le cas contraire, le processus de génération échoue.
  2. Configurez les paramètres de génération de l'outil de génération et de déploiement HCL Commerce.
    1. Accédez au Ant_installdir\lib
    2. Copiez le fichier ant-contrib-1.0b3.jar.
    3. Collez les fichiers JAR dans le répertoire WCBD_installdir\lib.
    4. Accédez au répertoire WCBD_installdir.
    5. Créez une copie du fichier wcbd-setenv.bat et renommez-la setenv.bat.
    6. Créez une copie de wcbd-build.private.properties.template et renommez-la build-local.private.properties.
    7. Créez une copie de wcbd-build.properties.template et renommez-la build-local.properties.
    8. Ouvrez le fichier setenv.bat en édition.
    9. Modifier la valeur ANT_HOME par Ant_installdir.
      Par exemple : C:/apache-ant-1.8.1
    10. Assurez-vous que la valeur WAS_HOME soit la valeur correcte.
      Par exemple : C:/Progra~1/IBM/SDP/runtimes/base_v7
    11. Ouvrez le fichier build-local.properties pour l'éditer.
    12. Définissez cette propriété sur l'une des valeurs suivantes : 
      web.module.list=Stores
wc.home=WCDE_installdir
was.home=C:/Progra~1/IBM/SDP/runtimes/base_v7
extract.ant.file=${basedir}/extract-local.xml
    13. Sauvegardez et fermez les fichiers.
  3. Exécutez le processus de génération. Pendant le processus de génération, vous exécutez un script pour créer le package de déploiement.
    1. Ouvrez une invite de commande et accédez au répertoire WCBD_installdir.
    2. Exécutez la commande suivante :

      wcbd-ant.bat -buildfile wcbd-build.xml -Dbuild.label=composer -Dbuild.type=local

      Où la valeur du paramètre -Dbuild.label est le nom de votre package. Vous pouvez définir la valeur du paramètre comme étant la valeur que vous voulez donner à votre package. A titre d'exemple, la commande précédente nomme le package composer.
    Lorsque la commande s'exécute, l'outil de génération et de déploiement HCL Commerce crée deux packages de déploiement
    • Un package pour le déploiement dans un environnement de production
    • Un package pour le déploiement du serveur HCL Commerce Developer.
    Les packages se trouvent dans le répertoire WCBD_installdir\dist.
  4. Déployez votre package.