Localizing catalog items

By using the multi-language feature, the catalog administrator can add services, service bundles, service templates, service actions, service categories, and asset groups in multiple languages. The catalog administrator can also provide specific versions of promotional banners for the end users in different locales (or with different browser localization settings).

Localization use case

With the multi-language feature of BMC Digital Workplace Catalog, a company can present different content for different BMC Digital Workplace users.

For example, one service can be published in two or more languages for two or more audiences, based on the spoken language of each audience. The service description and banners for the promotion of this service can contain specific informational messages, based on the characteristics of the locale and its employees.

BMC Digital Workplace users see the variant of a published catalog item according to their locale or the locale set in their browser settings. For example, if a BMC Digital Workplace Catalog administrator publishes the same service—in English and French, BMC Digital Workplace end users will have access to the following variations:

• Users from the English locale see the English variant of the published service.
• Users from the French locale see the French variant of the published service.
• Users from Canada with an English locale in their browser settings see the English variant of the published service.
• Users from Canada with a French locale in their browser settings see the French variant of the published service.

Before you begin

• Enable the multi-language feature in the Application Settings.

• Create the enhanced service catalog items.

  Enhanced service catalog item	Reference
  Service	Adding and updating services
  Service template	Managing service type templates
  Service action	Managing service actions
  Service category	Adding and updating service categories
  Service bundle	Adding and updating bundles
  Promotional banner	Creating promotional banners

To enable the multi-language feature

1. Go to Application Settings.
   
   
   
   

2. Turn on the Multi-language toggle, and click Save.
   
   
   The multi-language feature is enabled, and you can start localizing catalog items.

To localize a service

You can localize the following components of a service:

• Service name and version
• Service catalog profile details
• Service cost labels
• Service questionnaire

To localize service name and version

1. Go to Services > Services, and open a service.
2. Click Languages.
3. Clear the Use default language check box.
4. From the languages list, select a language (locale) for which you want to add a service name and version translations.

5. In the Service Name field, enter a new value and press Enter.

6. In the Version field, enter a new value and press Enter.

To localize service catalog profile details

The following table shows the actions that you can and cannot perform to localize service catalog profile details. The actions that are not supported in the localization mode, are still supported in the default language mode.

1. Go to Services > Services, and open a service.
2. Click Edit next to Catalog Profile.
3. Click Languages.
4. Clear the Use default language check box.
5. From the languages list, select a language (locale) for which you want to localize service catalog profile details.
   
   
   
   
6. Enter new values in the required fields.

7. Click Save.

   Important

   While localizing service catalog profile details, if you leave any values unchanged, they are displayed in the default language (English) for a BMC Digital Workplace user in the selected locale.

To localize service cost labels

The following table shows the actions that you can and cannot perform to localize cost labels. The actions that are not supported in the localization mode, are still supported in the default language mode.

1. Go to Services > Services, and open a service.
2. Click Edit next to Cost & Quantity.
3. From the Label list, select Manage labels.
   
   
   
   

4. Click Languages.

5. Clear the Use default language check box.
6. From the languages list select a language (locale) for which you want to rename the labels.

7. Enter new values for required labels, and press Enter.

   Important

   While localizing service cost labels, if you leave any values unchanged, they are displayed in the default language (English) for a BMC Digital Workplace user in the selected locale.
   

To localize a service questionnaire

The following table shows the actions that you can and cannot perform to localize a service questionnaire. The actions that are not supported in the localization mode, are still supported in the default language mode.

1. Go to Services > Services, and open a service that contains a questionnaire you want to localize. 
2. Click Edit next to Workflow.
3. Click Edit next to Questions.
4. Click Languages.
5. Clear the Use default language check box.

6. From the languages list select a language (locale) for which you want to localize the questionnaire.
   
   
   
   

7. Modify the required questionnaire items, and click Save.

   Important

   While localizing a service questionnaire, if you leave any values unchanged, they are displayed in the default language (English) for a BMC Digital Workplace user in the selected locale.

To localize a service bundle

You can localize the following components of a service bundle:

• Bundle name and version
• Bundle catalog profile details
• Bundle cost labels
• Bundle questionnaire

Localizing a service bundle is similar to localizing a service. Perform the same set of actions as to localize a service. For a service bundle, the same functions are available and disabled in localization mode.

To localize bundle name and version, follow the instructions for localizing service name and version.

To localize bundle catalog profile details, follow the instructions for localizing service catalog profile details.

To localize bundle cost labels, follow the instructions for localizing service cost labels.

To localize a bundle questionnaire, follow the instructions for localizing a service questionnaire.

To localize a service template

The following table shows the actions that you can and cannot perform to localize a service template. The actions that are not supported in the localization mode, are still supported in the default language mode.

1. Go to Services > Templates, and open a template.
2. Click Catalog Profile.
3. Click Languages.
4. Clear the Use default language check box.
5. From the languages list, select a language (locale) for which you want to localize a service template. 
6. Enter new values in the required fields.

7. Click Save Profile.

   Important

   While localizing a service template, if you leave any values unchanged, they are displayed in the default language (English) for a BMC Digital Workplace user in the selected locale.

To localize a service action

Localizing a service action is similar to localizing a service, but choose Services > Service Actions to see the actions:

• To localize a service action name, follow the instructions for localizing a service name.
• To localize service action cost labels, follow the instructions for localizing service cost labels
• To localize a service action questionnaire, follow the instructions for localizing a service questionnaire.

To localize a service category

The following table shows the actions that you can and cannot perform to localize a service category. The actions that are not supported in the localization mode, are still supported in the default language mode.

1. Go to Services > Categories.
2. Click Languages.
3. Clear the Use default language check box.
4. From the languages list, select a language (locale) for which you want to rename the categories.
   
   
   
   

5. Rename one or more categories that you want to localize, and press Enter.

   Important

   After you rename the categories, they are displayed in the same order, regardless of the new values.

To localize an asset group

You can localize an asset group by renaming it for appropriate locales.

1. Go to Services > Asset groups, and open an asset group.
2. On the Group Options pane, click Languages.
3. Clear the Use default language check box.
4. From the languages list, select a language (locale) for which you want to rename the asset group.
5. Type a new value in the Asset Group Name field, and press Enter.

To localize a promotional banner

The following table shows the actions that you can and cannot perform to localize a promotional banner. The actions that are not supported in the localization mode, are still supported in the default language mode.

1. Go to Services > Banners, and open a banner that you want to localize.
2. Click Languages. 
3. Clear the Use default language check box.
4. From the languages list, select a language (locale) for which you want to create a localized version of the banner.
   
   
   
   
5. Upload new banner images for the localized banner version (instead of the existing ones).

6. Click Save.

   Important

   While localizing a promotional banner, if you leave any banner images unchanged, these unchanged images are displayed for a BMC Digital Workplace user in the selected locale.

To find a localized catalog item

BMC Digital Workplace Catalog always displays the content in default language (English). If you localize an enhanced service catalog item, and then quit the application, you have to switch to the corresponding language (locale) to find the language-specific item.

1. Go to the appropriate section of the BMC Digital Workplace Catalog, and open the item that was previously localized.
2. Click Languages.
3. Clear the Use default language check box.

4. From the languages list, select the required language (locale) for which the item was previously localized.
   The localized version of the item appears instead of the default version.

   Important

   You can switch between languages to see the enhanced service catalog items for different locales.