Définition de texte d'interface utilisateur dans le Management Center

Insérez du texte dans l'interface utilisateur du Centre de gestion, par exemple dans la zone de travail principale (vues de liste, de propriétés ou de calendrier), la zone de recherche, la vue Explorateur, les menus, les messages et l'aide. Vous pouvez personnaliser les messages et les libellés qui s'affichent dans le Management Center pour rendre le texte présenté plus approprié pour les professionnels.

Incluez dans des fichiers de propriétés de ressource tout texte de message tel que des messages d'erreur, pour associer ces fichiers à des clés de ressource plutôt que de coder le texte d'interface utilisateur dans des fichiers de définition. De cette façon, vous conservez le code d'interface utilisateur dans des fichiers de définition et le texte d'interface utilisateur dans un fichier de propriétés. Les définitions de message incluent une clé de ressource pour identifier la définition de regroupement de ressources. Celle-ci identifie le fichier de propriétés contenant le texte de message à utiliser. En incluant le texte d'interface utilisateur dans des fichiers de propriétés, vous pouvez plus facilement par la suite mettre à jour, remplacer ou traduire ce texte.

Procédure

  1. Ouvrez HCL Commerce Developer et basculez vers la vue Explorateur d'entreprise.
  2. Développez LOBTools > Java Resources > src
  3. Créez un package d'extension pour étendre le package com.ibm.commerce.component.client.lobtools.properties approprié (component est le nom du composant du Management Center). Nommez ce package d'extension com.mycompany.commerce.component.client.lobtools.properties, (mycompany est le nom de votre société).
  4. Dans le package com.mycompany.commerce.component.client.lobtools.properties personnalisé, créez un fichier de propriétés. Attribuez-lui le même nom que le fichier de propriétés contenant le texte des messages à modifier. Le nom de fichier doit être associé à l'extension .properties. Créez des fichiers de propriétés distincts pour chaque langue à prendre en charge les besoins de votre site.
    • Les fichiers de propriétés nommés selon le format ComponentLOB_locale.properties incluent la liste des clés et le texte de tous les éléments d'interface utilisateur disponibles dans l'outil Management Center pour le composant dans la langue indiquée.
    • Les fichiers nommés selon le format ComponentLOBErrorMessages_locale.properties incluent la liste des clés et le texte de tous les messages d'erreur qui s'affichent dans le Management Center pour le composant dans la langue indiquée.
  5. Si vous ajoutez du texte pour un nouveau message, faites-le dans le nouveau fichier que vous ouvrez en édition. Associez le texte à une clé unique selon le format key=value. Incluez le nom de clé dans la définition du message. Précisez le message dans un fichier de définition pour indiquer le texte à utiliser.
    Par exemple, la combinaison clé-valeur textuelle suivante définit le texte d'un message d'erreur dans l'Catalogs tool. 
    CatalogGroup._ERR_DULPLICATE_IDENTIFIER_FOR_CHANGE=The specified code already exists. Type in a new code.
  6. Si vous modifiez ou remplacez le texte de messages existants, copiez la combinaison clé-texte dans le nouveau fichier de propriétés, puis éditez le texte.
    1. Développez LOBTools > Java Resources > src > com.ibm.commerce.component.client.lobtools.properties, (component est le nom du composant Management Center).
    2. Ouvrez et révisez le fichier de propriétés contenant le texte à modifier. N'éditez pas ce fichier de propriétés.
    3. Dans les fichiers de propriétés que vous révisez, identifiez et copiez la combinaison clé-texte à modifier.
    4. Ouvrez le nouveau fichier de propriétés en édition et collez la combinaison clé-texte copiée. Editez la combinaison clé-texte pour définir le texte de votre choix.
  7. Créez un regroupement de ressources afin de déterminer la définition de regroupement de ressources identifiant le fichier de propriétés. Incluez le nom de définition dans les définitions de message pour indiquer les fichiers de propriétés qui contiennent le texte des messages.
    1. Développez LOBTools > WebContent > WEB-INF > src > xml > mycompany > component
      Si le répertoire mycompany n'existe pas, vous devez créer le répertoire d'extension ci-après pour y inclure les fichiers de regroupement de ressources personnalisés.
    2. Créez un fichier de regroupement de ressources pour définir l'association aux fichiers de propriétés adéquats. Utilisez le format componentResourceBundle.xml pour nommer votre fichier.
      Par exemple, CatalogManagementResourceBundle.xml désigne le fichier de regroupement de ressources du composant catalogue.
    3. Ouvrez le nouveau fichier en édition et incluez la définition du regroupement de ressources qui identifie le fichier de propriétés à utiliser.
      Par exemple, la définition suivante détermine le fichier de propriétés associé aux fichiers de propriétés du composant catalogue
      
<Definitions>
  <ResourceBundle baseName="com.mycompany.commerce.catalog.client.lobtools.properties.CatalogLOB" 
   definitionName="cmc/catalog/CatalogResources" singletonDefinition="true"/>
</Definitions>
  8. Ajoutez la dépendance du regroupement de ressources personnalisé à un fichier de définition contenant des définitions qui font référence aux propriétés de l'un des fichiers de propriétés personnalisés.
    1. Ouvrez le ou les fichiers de définition qui nécessitent l'ajout de la dépendance.
    2. Ajoutez la dépendance du regroupement de ressources selon le format <dependency localName="" moduleName=""/>.
      Par exemple, le fragment de code suivant montre l'ajout d'une dépendance à un fichier de définitions d'objet associé au regroupement de ressources nommé "CatalogManagementResourceBundle.xml".
      
<Definitions>
  <ObjectProperties definitionName="cmc/catalog/ProductProperties">
    <dependency localName="foundationResources" moduleName="cmc/foundation/FoundationResources"/>
    <dependency localName="catalogResources" moduleName="cmc/catalog/CatalogResources"/>
    <dependency localName="CatalogManagementResourceBundle" moduleName="cmc/catalog/CatalogManagementResourceBundle"/>
    <!-- This is the set of tabs to display on the Product properties view -->
    <PropertyTabs name="tabs">
    ...
    </PropertyTabs>
  </ObjectProperties>
</Definitions>
  9. Sauvegardez et publiez vos modifications.