Recently I produced a blog detailing the new portal feature offering a Site Preview option where different Roles could be selected. You can check this out HERE. This blog detailed the ability to test security role assignments prior to publishing of the portal site being maintained. Working on from this I now want to use the SAP Translation Hub to translate the site I set up to multiple languages and showcase this using the Site Preview option.
NOTE: This blog will only cover the Fiori Launchpad generic texts such as those for the Groups and Catalogs, it will NOT cover the App titles nor any fields within the apps themselves. Look out for an upcoming blog on this in the next month or so.
The SAP Translation Hub is part of the DevOps category and while generally available it needs to be requested specifically via an email.
Figure: 1 DevOps options services with SAP Cloud Platform
To do this, when you click on the tile you will see the following links with a note about sending an email to the translation hub email address.
Figure: 2 SAP Translation Hub service screen
You will also notice that there is no [Enable] icon. What I have found in my experience is that key IT staff need to sign some paperwork SAP sends out to agree on the Terms and Conditions of using this service as there may be a cost in the future of using this service.
There are a number of links available on this page that provide more information about the service and what is possible. Here are the links included from the service screen.
So, the first step is to send an email to the following email address translationhub@sap.com to enable the service on SAP Cloud Platform.
Once this is done, we can start the process of translating our Portal site. During this process we will:
OK, let’s get started but before we do let us check the language options from the Portal Site Preview – prior to any translations taking place. This is the site we will enhance with multiple languages during this blog.
Figure: 3 Portal site preview screen (English only)
You will see above on the Language drop down only English is available. We will check back to this in the last step of the process – i.e. after we have performed the translation of the Portal site.
When SAP has activated the service the tile will change from the previous screenshot above and it will show that it is Not Enabled. We can see this now.
Figure: 4 SAP Translation Hub service Not Enabled screen
We can also see now that there is an Enable option now appearing.
Figure: 5 SAP Translation Hub service screen
Select the [Enable] icon to activate the service within the sub-account. You will need to repeat this for the sub-accounts configured in your SAP Cloud Platform global account. Once this is done all of the links will be activated.
Figure: 6 SAP Translation Hub service screen once enabled
When the service is enabled the Predefined User security role will be provisioned to your Userid automatically. You can view this if you choose the [Configure Service] option then choose Roles.
The next step is to download the Master file for the specific Portal Site. In the SAP Cloud Platform, navigate to the Fiori Configuration Cockpit for the specific portal site you wish to translate.
Figure: 7 Translation option for Portal Site screen
Navigate over the tile and choose the Configure option.
The following screen will be displayed.
Figure: 8 Translations Master Language file screen
A Master language ZIP file will be downloaded onto your machine – check screen below. Extract the file onto your desktop and keep this handy as we will need to use this in the next step when we run the SAP Translation hub service.
The key file for translation is the PROPERTIES file, this is included in the folder (once extracted).
This file will be used below.
The next step is to translate the Fiori launchpad site into multiple languages. We will use the SAP Translation Hub service to do this and we will use the Multi language ZIP file we just downloaded.
From the main service page you need to select the Go to UI for Translation Workflow option as shown below.
Figure: 9 SAP Translation Hub Overview screen
The following screen will be displayed.
Figure: 10 Translation Projects screen
To start converting the FLP site click on the + icon and choose the [File Upload] option.
Figure: 11 Add Translations Project options
This task is to create a new Translation project for our Fiori launchpad site and the first step is to categorise the metadata for this translation.
Enter the following in the next screen that is displayed:
Figure: 12 Create Translation Project screen
In this case we will select Chinese, Hindi (for Indian users), Indonesian and Thai.
Figure: 13 Language Selection screen
The selected languages will show up once selected.
In the Project Configuration section choose Yes for the Show Quality Index for MT option.
Once you are happy with the rest of the settings choose [Save].
This will save a new Translation project and for the next step make sure you select the Project name in the left hand navigation window.
You will then see an [Upload File] option enabled on the footer action bar.
Figure: 14 Translations Projects main screen
Click on the [Upload File] icon and choose the folder that holds the Language metadata and find the PROPERTIES file you downloaded from the previous step.
Figure: 15 Upload File project popup box
Browse for the file and select the PROPERTIES file.
The next step is to choose the [Upload and Translate] option.
The translation task will start and this will track the status in the main screen and finally will come back with an overall Execution status.
Figure: 16 Project Execution progress screen
Once this is completed a new Tab will be displayed called TRANSLATIONS. On this tab you can check the translations that have occurred and the quality of the translations for each of the languages selected.
Figure: 17 Translation Project detail screen
The detail of the screen shows the following items:
You can actually modify the translated text by overtyping in the Translation Text column (for those with lower percentages) however for this exercise we will simply download the translations file.
Select the Download Translations icon and a ZIP file will be downloaded to your desktop/laptop.
The ZIP file will actually contain a separate PROPERTIES file for each language selected in the Translation exercise.
Figure: 18 Multiple languages Properties files
You can see the 4 properties files above matching the 4 languages I selected for translation.
Once the translations have taken place we can load the files back into the Portal site configuration.
In the SAP Cloud Platform, navigate to the Fiori Configuration Cockpit for the specific portal site you wish to translate. This should be the same site as selected in previous steps.
Figure: 18 Portal Site Services and Tools screen - Translations option
Navigate over the tile and choose the Configure option.
The following screen will be displayed. This time choose the Upload option.
Figure: 19 Portal Site Translations screen
Browse for the ZIP file and select [Open].
The file will be processed and the relevant languages will be displayed on the screen. None will be active until they are specifically selected.
Figure: 20 Translations Management screen for Portal Site
In the first instance, we will choose the first 2 language translations and below show how it displays on the Portal Site preview.
We will update the Status for the first two languages. When selected a message toast will be displayed stating that the language has been activated successfully.
Now that the 2 languages have been activated we will use the Site Preview option and see how they look.
After all of the translation activities we will now use the Site Preview option to showcase the various languages.
Figure: 21 Portal Site Preview option
Let’s specially set the Role to Retail Operators so we get a reduced view of the Fiori Launchpad and let's also check out our handywork on the languages. We should see multiple languages offered now.
Figure: 22 Portal Site Preview with Multiple Languages
Awesome!!!! We can now see the additional 2 language options added to the Launchpad enabling the user to select them.
When I choose the Chinese option the FLP is updated and texts are converted including the main heading in the middle of the screen. Check the group names are in Chinese as well as the text included on the Customer Invoices tile itself. Gold! You can see this below.
Figure: 23 Portal Site Preview in Chinese
Let us choose the other language we included – Thai. We do this by simply selecting the language from the drop down list.
Figure: 24 Portal Site Preview in Thai
Using the Site Preview options I can also select a different layout to see what it would look like on a mobile or tablet device.
Figure: 25 Portal Site Preview in Thai on mobile device layout
This is super cool.
Now let’s go back to our Portal site and include the other languages. Remember, we only activated 2 of the 4 languages we had translations so now is our chance to activate the full set.
Navigate over the tile and choose the Configure option.
The following screen will be displayed.
Let’s activate the second Chinese language as well as the Hindi language.
A message toast will be displayed.
OK – now let’s go back to the Site Preview and check our handywork.
We can now see the additional languages that we activated offered in the Site Preview. Awesome! If we choose Hindi here we can see the translations taking place in the screen below.
I will now choose the Employees role now to offer a slightly different view.
Texts are also translated when I navigate to the Me area.
Hopefully this has showcased the steps involved in translating a Fiori Launchpad site. In my next blog on this subject I hope to translate individual app texts as well as the tile texts themselves.
Please feel to leave a comment or ask any questions.
Until next time – thanks for reading!
NOTE: This blog will only cover the Fiori Launchpad generic texts such as those for the Groups and Catalogs, it will NOT cover the App titles nor any fields within the apps themselves. Look out for an upcoming blog on this in the next month or so.
The SAP Translation Hub is part of the DevOps category and while generally available it needs to be requested specifically via an email.
Figure: 1 DevOps options services with SAP Cloud Platform
To do this, when you click on the tile you will see the following links with a note about sending an email to the translation hub email address.
Figure: 2 SAP Translation Hub service screen
You will also notice that there is no [Enable] icon. What I have found in my experience is that key IT staff need to sign some paperwork SAP sends out to agree on the Terms and Conditions of using this service as there may be a cost in the future of using this service.
There are a number of links available on this page that provide more information about the service and what is possible. Here are the links included from the service screen.
- Documentation
- APIs for SAP Translation Hub
- Youtube Videos
- SAP Translation Hub on SAP Community
- SAP Translation Hub Notifications
So, the first step is to send an email to the following email address translationhub@sap.com to enable the service on SAP Cloud Platform.
Once this is done, we can start the process of translating our Portal site. During this process we will:
- Enable the SAP Translation Hub service within the SCP Sub-account.
- Download the Master Language file for the specific Portal site.
- Translate the file and select the relevant languages.
- Upload the translated file back into the Portal site
- Perform a test using the Site Preview
OK, let’s get started but before we do let us check the language options from the Portal Site Preview – prior to any translations taking place. This is the site we will enhance with multiple languages during this blog.
Figure: 3 Portal site preview screen (English only)
You will see above on the Language drop down only English is available. We will check back to this in the last step of the process – i.e. after we have performed the translation of the Portal site.
Enabling the Service
When SAP has activated the service the tile will change from the previous screenshot above and it will show that it is Not Enabled. We can see this now.
Figure: 4 SAP Translation Hub service Not Enabled screen
We can also see now that there is an Enable option now appearing.
Figure: 5 SAP Translation Hub service screen
Select the [Enable] icon to activate the service within the sub-account. You will need to repeat this for the sub-accounts configured in your SAP Cloud Platform global account. Once this is done all of the links will be activated.
Figure: 6 SAP Translation Hub service screen once enabled
When the service is enabled the Predefined User security role will be provisioned to your Userid automatically. You can view this if you choose the [Configure Service] option then choose Roles.
Download Portal Site Master Language File
The next step is to download the Master file for the specific Portal Site. In the SAP Cloud Platform, navigate to the Fiori Configuration Cockpit for the specific portal site you wish to translate.
- Choose the [Translations] tile from the Services and Tools option in the navigation pane.
Figure: 7 Translation option for Portal Site screen
Navigate over the tile and choose the Configure option.
The following screen will be displayed.
Figure: 8 Translations Master Language file screen
- Click on the [Download] option to save the master language file for this Portal site.
A Master language ZIP file will be downloaded onto your machine – check screen below. Extract the file onto your desktop and keep this handy as we will need to use this in the next step when we run the SAP Translation hub service.
The key file for translation is the PROPERTIES file, this is included in the folder (once extracted).
This file will be used below.
Translate File into Multi Languages
The next step is to translate the Fiori launchpad site into multiple languages. We will use the SAP Translation Hub service to do this and we will use the Multi language ZIP file we just downloaded.
From the main service page you need to select the Go to UI for Translation Workflow option as shown below.
Figure: 9 SAP Translation Hub Overview screen
The following screen will be displayed.
Figure: 10 Translation Projects screen
To start converting the FLP site click on the + icon and choose the [File Upload] option.
Figure: 11 Add Translations Project options
This task is to create a new Translation project for our Fiori launchpad site and the first step is to categorise the metadata for this translation.
Enter the following in the next screen that is displayed:
- Project Name
- File Type – select the Java Properties File option.
- Domain – choose a suitable grouping.
- Target Languages – choose from the list the languages you would like offered to your users.
Figure: 12 Create Translation Project screen
In this case we will select Chinese, Hindi (for Indian users), Indonesian and Thai.
Figure: 13 Language Selection screen
The selected languages will show up once selected.
In the Project Configuration section choose Yes for the Show Quality Index for MT option.
Once you are happy with the rest of the settings choose [Save].
This will save a new Translation project and for the next step make sure you select the Project name in the left hand navigation window.
You will then see an [Upload File] option enabled on the footer action bar.
Figure: 14 Translations Projects main screen
Click on the [Upload File] icon and choose the folder that holds the Language metadata and find the PROPERTIES file you downloaded from the previous step.
Figure: 15 Upload File project popup box
Browse for the file and select the PROPERTIES file.
The next step is to choose the [Upload and Translate] option.
The translation task will start and this will track the status in the main screen and finally will come back with an overall Execution status.
Figure: 16 Project Execution progress screen
Once this is completed a new Tab will be displayed called TRANSLATIONS. On this tab you can check the translations that have occurred and the quality of the translations for each of the languages selected.
Figure: 17 Translation Project detail screen
The detail of the screen shows the following items:
- Source text in English as well as the text as Translated in the selected Language.
- The Status – has this been translated or not.
- The Translation Provider where
- MLTR = SAP Multilingual Text Repository
- MT = SAP Machine Translation
- The Quality Index – a translation quality value based on ratings language specializes provide. Obviously, the higher the number the higher the quality in the range between 0 and 100.
You can actually modify the translated text by overtyping in the Translation Text column (for those with lower percentages) however for this exercise we will simply download the translations file.
Select the Download Translations icon and a ZIP file will be downloaded to your desktop/laptop.
The ZIP file will actually contain a separate PROPERTIES file for each language selected in the Translation exercise.
Figure: 18 Multiple languages Properties files
You can see the 4 properties files above matching the 4 languages I selected for translation.
Upload File back into Portal Site
Once the translations have taken place we can load the files back into the Portal site configuration.
In the SAP Cloud Platform, navigate to the Fiori Configuration Cockpit for the specific portal site you wish to translate. This should be the same site as selected in previous steps.
- Choose the [Translations] tile from the Services and Tools option in the navigation pane.
Figure: 18 Portal Site Services and Tools screen - Translations option
Navigate over the tile and choose the Configure option.
The following screen will be displayed. This time choose the Upload option.
Figure: 19 Portal Site Translations screen
Browse for the ZIP file and select [Open].
The file will be processed and the relevant languages will be displayed on the screen. None will be active until they are specifically selected.
Figure: 20 Translations Management screen for Portal Site
In the first instance, we will choose the first 2 language translations and below show how it displays on the Portal Site preview.
We will update the Status for the first two languages. When selected a message toast will be displayed stating that the language has been activated successfully.
Now that the 2 languages have been activated we will use the Site Preview option and see how they look.
Site Preview with Multiple Languages
After all of the translation activities we will now use the Site Preview option to showcase the various languages.
- Choose the [Site Preview] option to preview the new Portal site translations.
Figure: 21 Portal Site Preview option
Let’s specially set the Role to Retail Operators so we get a reduced view of the Fiori Launchpad and let's also check out our handywork on the languages. We should see multiple languages offered now.
Figure: 22 Portal Site Preview with Multiple Languages
Awesome!!!! We can now see the additional 2 language options added to the Launchpad enabling the user to select them.
When I choose the Chinese option the FLP is updated and texts are converted including the main heading in the middle of the screen. Check the group names are in Chinese as well as the text included on the Customer Invoices tile itself. Gold! You can see this below.
Figure: 23 Portal Site Preview in Chinese
Let us choose the other language we included – Thai. We do this by simply selecting the language from the drop down list.
Figure: 24 Portal Site Preview in Thai
Using the Site Preview options I can also select a different layout to see what it would look like on a mobile or tablet device.
Figure: 25 Portal Site Preview in Thai on mobile device layout
This is super cool.
Now let’s go back to our Portal site and include the other languages. Remember, we only activated 2 of the 4 languages we had translations so now is our chance to activate the full set.
- Choose the [Translations] tile from the Services and Tools option in the navigation pane.
Navigate over the tile and choose the Configure option.
The following screen will be displayed.
Let’s activate the second Chinese language as well as the Hindi language.
A message toast will be displayed.
OK – now let’s go back to the Site Preview and check our handywork.
We can now see the additional languages that we activated offered in the Site Preview. Awesome! If we choose Hindi here we can see the translations taking place in the screen below.
I will now choose the Employees role now to offer a slightly different view.
Texts are also translated when I navigate to the Me area.
Hopefully this has showcased the steps involved in translating a Fiori Launchpad site. In my next blog on this subject I hope to translate individual app texts as well as the tile texts themselves.
Please feel to leave a comment or ask any questions.
Until next time – thanks for reading!
- SAP Managed Tags:
3 Comments
