Localizing SXP Partner

First published on: 08/10/2023/6:54 pm

Learn how to configure SXP Partner payment methods for invoice payments or B2B checkout and how to view details of the available gateway providers and their associated configuration options.

Localization is automatically displayed to users based on their locale. 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 isn't the same as language, it can be related (e.g., you can “localize” English to UK English). Users can access SXP Partner in a language different from their locale. The user’s experience will be presented in their native locale, but the language will be displayed based on what the administrator configured.

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

When using the default language (English en-us), no further localization is required.

If another language or a localized version of English is desired, update these areas: menus, reports, application strings, and B2B catalogs.

Language packs aren't provided, and it's assumed a single language will be displayed throughout the Portal.

Menu Localization

Menu items and report titles require manual updates by an admin before they can be configured for a specific language. By default, all menus and reports are “localized” and displayed in US English (en-us). If language strings for another locale are set up, they'll replace the previous language strings.

Menus currently support only a single language; however, this language may be translated or localized as described below.

To localize a menu:

1. Go to SXP Manager AddOn > Manage Menu.

2. Select the desired application and menu.

3. For each menu entry, ensure the entry’s Name field is translated. 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 reload the language default from B1WebAPI. See 'Recycling Application Pools' for a walkthrough.

Report Localization

For SXP Partner, localizing reports has been simplified with the 'Manage Translations' screen, as outlined below.

Application String Localization

For SXP Partner, localizing application strings has been simplified with the 'Manage Translations' screen, as outlined below.

Manage Translations

The 'Manage Translations' utility manages configured languages. One language is provided out of the box; however, you may create additional languages. The default language (US English en-us) can be replaced by a different language, allowing for translation or localization in the preferred language.

Currently, 'Manage Translations' is only supported in SXP Partner.

You can use 'Manage Translations' to update application strings or view/update reports for a specific language.

To open 'Manage Translations' in SAP Business One, go to SXP Manager AddOn > Manage Translations.

Assigning a Different Default Language

Out of the box, each SXP Platform has a single default language. If you want a different default language, you should set it at the beginning of an implementation. If a system is fully configured and the default language needs updating, extra steps are required to ensure backups are made for all configured content (namely, 'AppStrings' files and report queries).

In new implementations, change the language SXP as its default by updating the ZEDS_APPLOCALE UDT 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' dropdown.

3. Recycle the B1WebAPI’s application pool. This will clear the cached language default for all SXP Platform instances. See 'Recycling Application Pools' for a walkthrough.

4. Recycle the Portal’s application pool. This will reload the language default from B1WebAPI. See 'Recycling Application Pools' for a walkthrough.

If multiple languages are required for SXP Partner, you must add each language to the application languages table ZEDS_APPLOCALE and assign them to SXP Partner.

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 translations or localization.

Included in the application strings file are breadcrumb labels, which all begin with the word “Breadcrumb” (e.g., BreadcrumbHome). Replace the value associated with each breadcrumb link to update the breadcrumbs seen by web users.

Walkthrough: Localizing app strings from English to UK English

This walkthrough demonstrates the steps to localize application strings from English into UK English.

1. Open 'Manage Translations': In SAP Business One, go to SXP Manager AddOn > 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.

a. Press the golden arrow for the desired label.

b. Edit the label value, then press the 'Update' button to apply the label change.

Localizing reports with the Manage Translations utility

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

The Queries tab displays the queries required for the selected language. The 'Exists' column indicates whether the query exists for the selected language (Y) or not (N). Each query must be edited to ensure they're localized or translated into the desired language.

To localize queries:

1. Select the desired query from the list. At this point, the query requirements will be displayed in the Translations pane.

   

2. Press the golden arrow to drill into the query details. This will open the SAP Business One query editor window.

   

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 they're required by the back-end code.

   

5. Save query edits. If the query already exists and you choose 'Save', 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.

8. Recycle the Portal’s application pool. This will reload changed queries from B1WebAPI. See 'Recycling Application Pools' for a walkthrough.

Now, users will see localized versions of reports.

B2B Catalog Localization

You can configure B2B 'Collections' and 'Web Products' in multiple languages; however, this walkthrough assumes you've implemented a single, localized language. Number and date formats display in the user’s locale automatically; however, application strings for SXP Partner must be updated in the corresponding language before B2B catalogs can be fully localized. See 'Localizing Application Strings' for a walkthrough.

The following instructions describe how to localize B2B catalogs: collections, web products, store fronts, and media.

Collections

1. In SAP Business One, go to  SXP Manager AddOn > SXP Partner B2B > Manage Collections.

2. Select the desired language from the upper-right dropdown. If the desired language isn't available, you can configure it as described in 'Assigning a Different Default Language'.

3. Configure details for the selected language as described in 'Managing Collections for B2B Marketplace'. Update these settings:

   • Ensure the proper store fronts are assigned to the collection that grants access to the target audience.
   • Ensure all desired web products have been configured in the desired language. A collections language is used to filter configured web products of the same language.

Web products

1. In SAP Business One, go to SXP Manager AddOn > SXP Partner B2B > Manage Products.

2. Select the desired language from the upper-right dropdown. If the desired language isn't available, you can configure it as described in 'Assigning a Different Default Language'.

3. Configure details for the selected language as described in 'Managing Web Products for B2B Marketplace'. Update these settings:

   • Ensure this web product is assigned to a collection with the same language configured. You must manage this within the collection.
   • When web product details are complete, update the search index to apply the changes immediately. If you don't do it, there may be up to a 10-minute delay before the web product details are displayed to users.

Store fronts

Store Fronts provide details about the layout of a B2B Marketplace web store. Within a store front, language-specific labels may be configured to tailor the experience to a specific language.

1. In SAP Business One, go to SXP Manager AddOn > SXP Partner B2B > Manage Store Fronts.

2. Edit the desired store front.

3. On the labels tab, select the desired language from the locale dropdown on the right.

4. Configure language strings for each template by selecting the template from the left-hand dropdown.

Media

Media such as product images may have language-specific content. To assist with the setup of localized content, you can use Media Manager to upload localized versions of product images or other supporting media. See 'Media Manager for B2B Marketplace'.

Previous

Next