Localization is applied automatically based on the locale of the person logging into the Portal. Localization of number formats and dates provides a consistent experience based on what the logged in user is accustomed to in their native locale.

While locale is not the same as language, it can be related to language and there is some overlap in configuration. From a Portal perspective, a user may access a Portal in a language that is different from their locale. In this case, the user’s experience will be presented in their native locale, but the language will be displayed based on what is configured by an administrator.

Simply put, “what is displayed” (the language) is controlled by an admin, while “how it’s displayed” (locale) is automatically adjusted for the user.

When localizing a Portal, the following areas must be updated:

When it comes to menus and reports, menu items and report titles require manual updates by an admin before it can be configured for a specific language. By default, all menus and reports are “localized” to US English (en-us) (that is, the language of display is US English) and if another locale is desired (for example, UK English), then this will replace the previous localization.

Menus currently only support a single language, however this language may be localized to a single locale as described below.

To localize a menu:

  1. Go to: zedSuite Manager > Manage Menu.

  2. Select the desired application and menu.

  3. For each Menu Entry, ensure the entry’s Name field is localized. This is the link name displayed to the end customer.

  4. For Menu Entries that are Grids, Pivots or Charts, open the report Link and edit the Query columns associated with that link. Edit the Query using the standard SAP Business One query editor. Always back up queries to a safe location before making edits.

  5. Recycle the B1WebAPI’s application pool. This will clear the cached language default for all Portals. See Recycling Application Pools for a walkthrough of this step.

  6. Recycle the Portal’s application pool. This will re-load the language default from B1WebAPI. See Recycling Application Pools for a walkthrough of this step.

Report Localization

For Customer Portal, localization of Reports has been simplified with the Manage Translations screen. See details below.

Application String Localization

For Customer Portal, localization of Application Strings has been simplified with the Manage Translations screen. See details below.

Manage Translations

The Manage Translations utility is a window into configured languages. Out-of-the-box, only one language is supported, however this default language (US English en-us) may be replaced by a different language, allowing for localization in the preferred language.

Currently, Manage Translations is only supported in Customer Portal.

Manage Translations may be used to update Application Strings or to view/update Reports for a specific locale.

To open Manage Translations, in SAP Business One, go to: zedSuite Manager > Manage Translations.

Assigning a different default language

Out-of-the-box, each Portal has a single default language. If a different default language is desired, it should be set at the beginning of an implementation. If a system is fully configured and the default language needs to be updated, extra steps must be taken to ensure backups are made for all configured content (namely, AppStrings files and Report queries).

For new implementations, to change which language a Portal uses as its default, update the ZEDS_APPLOCALE UDT (User-Defined Table) in the following way:

  1. In SAP Business One, go to: Tools > User-Defined Windows > ZEDS_APPLOCALE - Portal Locale Definitions

  2. For the desired application, change the Locale ID.

    Change a Portal's default language in the Locale ID drop-down.
    Change a Portal's default language in the Locale ID drop-down.
  3. Recycle the B1WebAPI’s application pool. This will clear the cached language default for all Portals. See Recycling Application Pools for a walkthrough of this step.

  4. Recycle the Portal’s application pool. This will re-load the language default from B1WebAPI. See Recycling Application Pools for a walkthrough of this step.

Localizing Application Strings with the Manage Translations Utility

In the Manage Translations screen, navigate to the Global App Settings tab.

The Global App Settings tab displays language strings for the selected language, such as web user-facing labels and instructions. Out-of-the-box, one language is provided (English). Edits to this language’s details can be used to apply localization.

Included in the Application Strings file are breadcrumb labels, which all begin with the word “Breadcrumb”, for example, BreadcrumbHome. Replace the value associated with each breadcrumb link to localize breadcrumbs

Walkthrough: Localizing App Strings from English to UK English

This walkthrough will demonstrate the steps necessary to localize application strings from English into UK English.

  1. Open Manage Translations: In SAP Business One, go to zedSuite Manager > Manage Translations.

  2. Open the Global App Settings tab.

  3. Configure Application Strings. In this example, we’ll change the value for LblChecking from the US value of Checking to the localized UK value of Chequeing.

    1. Press the golden arrow for the desired label.
      Press the golden arrow (1) to edit the LblChecking label details.
      Press the golden arrow (1) to edit the LblChecking label details.
    2. Edit the Value of the label.
      This label can be updated in the Value section.
      This label can be updated in the Value section.
    3. Press the Update button to apply the label change.
      After updating the value (1), press Update (2).
      After updating the value (1), press Update (2).
    4. When the desired edits are complete, press the Update button to apply all label changes to the web. This will reset the website and re-load the new labels.
      When all edits are complete (1), press Update (2). This will restart the Portal website.
      When all edits are complete (1), press Update (2). This will restart the Portal website.

Localizing Reports with the Manage Translations Utility

In the Manage Translations screen, navigate to the Queries tab.

The Queries tab displays the queries that are required for the selected language. The Exists column indicates whether the query exists for the selected language (Y) or not (N). Each query will need to be edited to ensure they are localized.

To localize queries:

  1. Select the desired query from the list. At this point, the query requirements will be displayed in the Translations pane.
    Select a query (1) to see its requirements (2) for localization.
    Select a query (1) to see its requirements (2) for localization.
  2. Press the golden arrow to drill into the query details. This will open the SAP Business One query editor window.
    Press the golden arrow (3) to drill into the query details.
    Press the golden arrow (3) to drill into the query details.
  3. Before proceeding, back up the query to a safe location.

  4. Using the query editor, refer to the Requirements pane to update the indicated query columns. Don’t update other columns, as these are required by back-end code.
    Edit the query column aliases and press  Save or Save As.
    Edit the query column aliases and press Save or Save As.
  5. Save query edits. Note that if the query already exists, it will overwrite the previous version.

  6. Close the query editor.

  7. Recycle the B1WebAPI’s application pool when all queries are edited. This will clear the cached queries for all Portals. See Recycling Application Pools for a walkthrough of this step.

  8. Recycle the Portal’s application pool. This will re-load changed queries from B1WebAPI. See Recycling Application Pools for a walkthrough of this step.

At this point, users will see localized versions of reports.