Skip to Content
Author's profile photo Former Member

Translating standard SAP Fiori apps into your own language

Introduction

SAP is rapidly developing a great number of SAP Fiori Tiles. Users are delighted about the functionality, but unfortunately not all languages are supported.

For example, Dutch language is not provided for the standard Tiles.

Schermafbeelding 2016-05-27 om 11.41.38.png

Still, customers would like to have their Tiles available in their own language. How to handle?

There are actually 3 steps:

  1. 1.     Tile title
  2. 2.     Tile text elements
  3. 3.     Messages

I’ll explain the steps using the standard SAP Tile Customer Invoices.

Step 1 – Tile title

The Tile title is actually defined in the tile catalog. To translate the tile, you need to start the Launchpad Customizing. The URL is http://<yourserver>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?scope=CUST

You need to logon in the language to which you want to translate.

  1. 1.     Create new catalog by using existing standard catalog and dragging it to left bottom.

Schermafbeelding 2016-05-27 om 12.40.52.png

In the pop-up screen enter the name of the new catalog:

Schermafbeelding 2016-05-27 om 12.40.59.png

  1. 2.     Rename all tiles to your description (Dutch in this case)

Enter Title and Subtitle. Don’t forget to save.

Result:

Schermafbeelding 2016-05-27 om 12.45.11.png

  1. 3.     Create new catalog group

First click om Groups on top left. Then click on button ‘+’ on bottom.

Schermafbeelding 2016-05-27 om 12.46.23.png

Create a new group with a clear description and ID and save it.

  1. 4.     Add tiles by clicking on ‘+’  in tiles

First select the catalog to choose from. This is the catalog you created in the first two steps.

All tiles are presented. Click on the ‘+’ under each tile you want to add to your group.

Schermafbeelding 2016-05-27 om 12.47.21.png

When you’re done, go back to the group screen.

Now your new Fiori Catalog Group is created.

  1. 5.     Create new PFCG role for your new Fiori Catalog Group and add this to your user

In Gateway, create new single role in transaction PFCG.

Schermafbeelding 2016-05-27 om 12.49.58.png

Enter the name of your role and a description.

Schermafbeelding 2016-05-27 om 12.51.02.png

Click on tab Menu.Click on button and choose SAP Fiori Tile Group

Add your newly created Tile Group from step 4.

Schermafbeelding 2016-05-27 om 12.51.41.png

Click on button  and choose SAP Fiori Tile Catalog. Add your newly created Tile Catalog from step 1.

Schermafbeelding 2016-05-27 om 12.53.00.png

Save your new role and add this to your user.

Logon to your Fiori Launchpad again. Your new group will be available now on your homepage.

Schermafbeelding 2016-05-27 om 12.54.02.png

Your tiles now all have your own description (in your own language).

However, your tile itself is still not in Dutch:

Schermafbeelding 2016-05-27 om 12.57.43.png

Step 2 – Tile Labels

There may be more ways to translate tiles, but I’ll be using the solution by enhancing the BSP application and adding a new properties file for your own language to the BSP application.

To find the name of the BSP application, you can go to the SAP Fiori Reference Library.

In the Implementation Information, you can find the name of the BSP application under header Configuration and then SAPUI5 Application.

  1. 1.     Start transaction SE80 in your Gateway system.

Schermafbeelding 2016-05-27 om 13.00.10.png

Under the folder Page Fragments, open the folder i18n.

  1. 2.     Copy existing properties file to a new file for your own language

Select one file and right click on it and select option Copy

Schermafbeelding 2016-05-27 om 13.01.05.png

Enter the new name under Page. The format is:

i18n/i18n_<iso code for your language>.properties

In our case this is i18n/i18n_nl.properties

System will now ask for an object key. Request this via SSCR keys via http://support.sap.com/sscr

Schermafbeelding 2016-05-29 om 11.22.55.png

Now edit all texts to your own needs. Save and activate the changes.

The texts will still not appear in your own language. You need to clean up your cache first.

  1. A.    On gateway execute program /UI2/INVALIDATE_GLOBAL_CACHES
  2. B.    On Gateway clear cache via transaction SMICM à Goto à HTTP-PlugIn à Server Cache à Invalidate Globally
  3. C.     Restart your browser

Now your Tile is translated.

Schermafbeelding 2016-05-27 om 14.24.46.png

Step 3 – Tile Messages

We’re almost there. Now we still need to translate some messages that pop-up dynamically.

These message are located in a message class on your backend system. In this case, it is SAP ERP.

  1. 1.     Start transaction SE91 and enter message class

For our Tile, the message class is CM_SRA021_INVOICE.

  Schermafbeelding 2016-05-27 om 11.48.07.png

  1. 2.     Select the messages and translate each individual text via Goto ->Translation

Schermafbeelding 2016-05-27 om 11.48.41.png

After the translation is done, refresh your browser. Now the message is also displayed in Dutch.

Schermafbeelding 2016-05-29 om 10.57.37.png

Assigned Tags

      3 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Masayuki Sekihara
      Masayuki Sekihara
      Author's profile photo Former Member
      Former Member

      Hi 関原さん,

      Thank you so much for the valuable information.

      I've seen your reply for UI5-relevant questions else where, and they are all wonderful. 😎

      Hope I can see your comment more often. 🙂

      Regards

      Xuebin Sun

      Author's profile photo Emanuel Affatati
      Emanuel Affatati

      Hi Masa,

      Which is the recommended way for doing the translations?

      From the Launchpad Designer or from the SE63 t-code?

      I understand that if I create the translations from the se63 t-code, I will have the same "Catalog identifier" for the original and the translated catalog, while if I do the translation from the Launchpad Designer, I would have two different identifiers and I would have to assign one of this two catalogs depending on the country the sap user uses the erp system.

      Instead, If I use the se63 t-code I could assign the same catalog for all the different users worldwide that use the same fiori app.

      Is that correct?

      Best Regards,

      Emanuel