Création de groupes de ressources pour des chaînes de texte personnalisées

Dans cette leçon, vous créez un fichier de propriétés et un groupe de ressources afin de définir les chaînes de texte personnalisées qui apparaissent dans l'interface utilisateur du Management Center pour les objets fenêtre personnalisés. Dans le Management Center, tous les libellés de texte et les images affichés dans l'interface utilisateur doivent être définis en tant que propriétés et enregistrés dans un fichier de groupes de ressources.

Pourquoi et quand exécuter cette tâche

Un fichier de propriétés est un groupe de ressources contenant du texte traduisible qui apparaît dans l'interface utilisateur. Les groupe de ressources contiennent des objets spécifiques de l'environnement linguistique. A l'aide des fichiers de regroupement de ressources, le texte peut facilement être traduit en plusieurs langues. Dans la leçon précédente, vous avez planifié l'interface utilisateur nécessaire à la prise en charge de votre nouvelle promotion et vous avez déterminé que vous devez inclure quatre nouvelles chaînes de texte :
Chaîne de texte Description Clé de ressource
"Achat minimum sur des entrées de catalogue de base ($)" Libellé pour le seuil du prix total pour la condition d'achat promotion_Minimum_purchase_TotalPrice
"Quantité du cadeau" Libellé de la quantité de cadeau pour la récompense promotion_Free_gift_qty
"Achetez l'entrée de catalogue X pour $ et recevez en cadeau l'entrée de catalogue Y" Nom du nouveau type de promotion qui apparaît dans la fenêtre Sélecteur de type de promotion promotion_type_ProductLevelFreeGift
"Condition d'achat : La commande contient un montant de dépense spécifié pour une entrée de catalogue.

Récompense : Un ou plusieurs cadeaux.

Exemple : "Dépensez 100 $ ou plus sur KitcheCraft Chef Line Knife Set, et recevez un verre de Vienne gratuitement !"

 Description du nouveau type de promotion qui apparaît dans la fenêtre Sélecteur de type de promotion promotion_type_description_ProductLevelFreeGift
Vous pouvez réutiliser toutes les autres chaînes de texte des types de promotion existants.

Procédure

  1. Ouvrez HCL Commerce Developer.
  2. Créez un module pour le fichier de propriétés :
    1. Dans la vue vue Explorateur d'entreprise, développez LOBTools > JavaResources > src.
    2. Cliquez avec le bouton droit de la souris sur le projet src et sélectionnez Nouveau > Package.
    3. Dans la fenêtre Nouveau package Java, créez un package de propriétés nommé com.mycompany.commerce.promotion.client.lobtools.properties.
    4. Cliquez sur Terminer.
  3. Dans le nouveau package de propriétés, créez les fichiers de propriétés pour votre type de promotion :
    1. Cliquez avec le bouton droit de la souris sur le module de propriétés com.mycompany.commerce.promotion.client.lobtools.properties.
    2. Cliquez sur Nouveau > Autre.
    3. Dans la fenêtre Sélectionnez un assistant, développez le dossier Généralités puis cliquez sur Fichier.
    4. Cliquez sur Suivant.
    5. Nommez votre nouveau fichier PromotionLOB_en_US.properties.
    6. Cliquez sur Terminer pour sauvegarder le fichier.
      Le fichier apparaît dans l'éditeur XML par défaut.
    7. Pour définir les nouvelles propriétés, copiez et collez le code suivant dans le fichier PromotionLOB_en_US.properties : 
      
#===========================================================================
# Customized Promotion Properties
#===========================================================================
#Used in extProductLevelFreeGiftTemplate to define the new Promotion type name in the drop down list
promotion_type_ProductLevelFreeGift=Spend $ on catalog entry X, get catalog entry Y free
#Used in PromotionTypeTemplatePicker.xml  to define the promotion type description in the Promotion Type Selector window
promotion_type_description_ProductLevelFreeGift=<b>Purchase condition:</b>Order contains a specified amount spent on a catalog entry.<br/><br/><b>Reward:</b> One or more free gifts.<br/><br/><b>Example:</b><ul><li>Spend $200 or more on KitchenCraft Chef Line Knife Set, and receive a Vienna Glass free!</li></ul>
#Used in extProductLevelFreeGiftProperties and extProductLevelFreeGiftPurchaseConditionObjectDefinition to define the property label of the total price threshold
promotion_Minimum_purchase_TotalPrice=Minimum Purchase on base catalog entries ($)
#Used in extProGiftRewardGrid and extProductLevelFreeGiftPurchaseConditionObjectDefinition to define the property label of the gift quantity
promotion_Free_gift_qty=Quantity for free
    8. Enregistrez et fermez le fichier.
    9. Répétez cette étape pour créer le fichier PromotionLOB.properties.
  4. Créez une structure de répertoires pour le code personnalisé :
    1. Développez LOBTools > WebContent > WEB-INF > src > xml.
    2. Cliquez avec le bouton droit de la souris sur le dossier xml et cliquez sur Nouveau > Dossier.
    3. Dans la zone Nom de dossier, entrez mycompany.
      Tout le code de votre fichier de définition personnalisé doit être placé sous ce dossier.
    4. Cliquez sur Terminer.
    5. Créez un répertoire nommé promotion dans votre nouveau répertoire mycompany.
  5. Les nouvelles chaînes de texte ajoutées au fichier de propriétés ne peuvent pas être directement utilisées par les définitions du Centre de gestion. Enregistrez les propriétés avec les nouveaux groupes de ressources :
    1. Développez LOBTools > WebContent > WEB-INF > src > xml > mycompany > promotion.
    2. Cliquez avec le bouton droit de la souris sur le répertoire promotion, puis cliquez sur Nouveau > Autre.
    3. Développez le dossier Général et cliquez sur Fichier.
    4. Cliquez sur Suivant.
    5. Nommez votre nouveau fichier PromotionResourceBundle.xml.
    6. Cliquez sur Terminer pour sauvegarder le fichier.
      Le fichier apparaît dans l'éditeur XML par défaut.
    7. Pour définir la nouvelle classe de groupe de ressources et en créer une instance, copiez et collez le code suivant dans le fichier PromotionResourceBundle.xml : 
      <?xml version="1.0" encoding="UTF-8"?>
<Definitions>
     <ResourceBundle baseName="com.mycompany.commerce.promotion.client.lobtools.properties.PromotionLOB" 
      definitionName="cmc/promotion/ExtPromotionResources" singletonDefinition="true"/>
</Definitions>
      Pour faire référence au groupe de ressources depuis les définitions du Management Center, utilisez l'ID dans la classe de groupe de ressources. Dans cet exemple, l'ID est extPromotionResources. Par conséquent, pour utiliser la ressource "promotion_type_ProductLevelFreeGift" dans une définition du Management Center, la référence doit se présenter comme suit : 
      ${ExtPromotionResources.promotion_Minimum_purchase_TotalPrice}
      Vous devez également inclure une dépendance qui identifie votre regroupement de ressources.
      <dependency localName="ExtPromotionResources" moduleName="cmc/promotion/ExtPromotionResources"/>
    8. Enregistrez et fermez le fichier.

Résultats

Dans cette leçon, vous avez créé le fichier de propriétés et la définition de groupes de ressources. Dans la leçon suivante, vous créez la définition du nouvel élément de promotion de condition d'achat.