This documentation supports the 22.1 version of BMC Helix Digital Workplace Basic and BMC Helix Digital Workplace Advanced. Icons distinguish capabilities available only for the Advanced and External license levels. For more information, see License-types-and-features.

Localizing catalog items

As a catalog administrator, you can add services, service bundles, service templates, service actions, service categories, and asset groups in multiple languages. You can also provide specific versions of promotional banners for the end users in different locales (or with different browser localization settings).

Important

To see the full list of languages and locales that BMC Helix Digital Workplace Catalog supports, go to Supported-languages-and-locales.

Localization use case

With the multi-language feature of BMC Helix Digital Workplace Catalog, a company can present different content for different BMC Helix 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 Helix 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  catalog administrator publishes the same service—in English and French, the 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.

Important

The summaries of imported catalog items that are displayed in a user’s “My Activities” page are always displayed in the item’s original language.

Required license

DWP Advanced icon.pngBMC Helix Digital Workplace Advanced

Related topics

Localizing-services-and-bundles-by-using-export-and-import

Supported-languages-and-locales

Before you begin

To enable the multi-language feature

  1. Go to Application Settings.

    Application_settings_19.11.png

  2. Turn on the Multi-language toggle, and click Save.
    Application_settings_pane_19.11.png
    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:

Important

This section provides guidance for localizing a service manually. You can also 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.

Supported

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

    cpd.png

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

Supported

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

    ml1.png

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

Supported

Not supported

You can perform the following actions in the localization mode:

On the Questions Designer

  • Change a tab (questionnaire page) name

On the Question Designer (for an individual question)

  • 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:

On the Questions Designer

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

On the Question Designer (for an individual question)

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

    sq.png

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

Important

This section provides guidance for localizing a service bundle manually. You can also 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 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.

Supported

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

    Important

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

To localize a service action

Service_actions_19.11.png

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

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.

Supported

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

    lcat.png

  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.

Supported

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

    lan1.png

  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 Helix Digital Workplace user in the selected locale.

To find a localized catalog item

BMC Helix 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 Catalog console, 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.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*