This documentation supports the 18.02 version of BMC Digital Workplace. To view the latest version, select the version from the Product version menu.

Localizing catalog items

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

Note

To see the full list of languages and locales supported by BMC Digital Workplace Catalog, go to Supported languages and locales.

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 both English, and in French, end users will have access to the following variations:

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

Note

Push notifications are only available in English.

Before you begin

To enable the multi-language feature

  1. Go to the Application Settings.



  2. Select the Multi-language check box, and click Save.



    The multi-language feature is enabled; you can start localizing catalog items.

To localize a service

You can localize the following components of a service:

Note

This section provides the guidance for localizing a service manually. Starting from BMC Digital Workplace Catalog 18.02.00 Patch 1, you can apply localization to a service by using the export and import options. For more information, see Localizing services and bundles by using export and import.

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.

SupportedNot supported

You can perform the following actions in the localization mode:

  • Change the logo
  • Change the media (image and video)
  • Add translation for text fields
  • Change the file resources
  • Change the tags


You cannot perform the following actions in the localization mode:

  • Change the categories
  • Change the fulfillment

  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.

    Note

    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.

SupportedNot supported

You can perform the following actions in the localization mode:

  • Rename labels

You cannot perform the following actions in the localization mode:

  • Add new labels
  • Remove existing labels


  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.

    Note

    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.

SupportedNot supported

You can perform the following actions in the localization mode:

In Questionnaire page

  • Change a tab (questionnaire page) name

In Question pane

  • Change label text
  • Change description text
  • Change default value in custom value
  • Change display value (but not stored value) for selection field
  • Change the regex hint

You cannot perform the following actions in the localization mode:

In Questionnaire page

  • Add new questions
  • Remove existing questions
  • Add new actions
  • Remove existing actions
  • Reorder the questions
  • Add pages
  • Delete pages
  • Modify question conditions

In Question pane

  • Change form element type
  • Turn on and off the description
  • Turn on and off the default value
  • Change default value
  • Change regex definition, except hint
  • Change required definition
  • Change read only definition
  • Change hidden definition
  • Change the Map to Form and Map to Dataset definition
  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.

    Note

    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

Note

This section provides the guidance for localizing a service bundle manually. Starting from BMC Digital Workplace Catalog 18.02.00 Patch 1, you can apply localization to a service bundle by using the export and import options. For more information, see Localizing services and bundles by using export and import.

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 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.

SupportedNot supported

You can perform the following actions in the localization mode:

  • Rename a component label
  • Rename an optional tooltip
  • Rename form values for a list
  • Rename a placeholder


You cannot perform the following actions in the localization mode:

  • Modify a category section
  • Add, remove, reorder, or update components
  • Toggle a required/optional field
  • Add, remove, or reorder form values
  • Set a character limit and a number of lines


  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.

    Note

    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

You can localize the following components of a service action:

  • Service action name
  • Service action cost labels
  • Service action questionnaire

Localizing a service action is similar to localizing a service

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.

SupportedNot supported

You can perform the following actions in the localization mode:

  • Rename service categories

You cannot perform the following actions in the localization mode:

  • Create a new category
  • Delete an existing category
  • Use Import and Mapping
  • Reorder categories
  • Create child categories


  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.

    Note

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

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.

SupportedNot supported

You can perform the following actions in the localization mode:

  • Replace banner images with localized versions of these images

You cannot perform the following actions in the localization mode:

  • Modify Default banner settings
  • Modify Exceptions


  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.

    Note

    While localizing a promotional banner, if you leave any banner images unchanged, this 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.

    Note

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

Was this page helpful? Yes No Submitting... Thank you

Comments