Translate Your SAP Cloud Platform Portal Freestyle Site
- How to download your site content for translation
- How to translate the content yourself in the SAP Translation Hub (optional)
- How to import and upload the translated content
Prerequisites
- You’ve opened your SAP Cloud Platform subaccount.
- You’ve opened the
Portal Service
and navigated to the Site Directory where yourSupplier Portal
site that you created is located. For more information, see Create a Portal freestyle site.
Note that these steps are carried out using the Supplier Portal site that you created in a previous tutorial. However you can do these steps on any Portal site that you’ve created.
- Step 1
In this step, you will download the content of the
Supplier Portal
site into a ZIP file.The files are downloaded into your
Downloads
folder. For convenience sake, in yourDownloads
folder, you may want to create a new folder calledTRANSLATIONS
and store your files there so that they are easy to find when you need to upload them again.-
From the Site Directory select the
Supplier Portal
site and click Edit to open it in the Portal Site Designer. -
From the left side panel, click Services and Tools.
-
Select the Translations Manager tile and click Configure to open the UI of the Translations Manager.
-
Under Translation Files click Download.
You are downloading the site’s content in the master language (English).
-
Select the
master_Language_<date>.zip
file that appears at the bottom of the screen and open it using the options menu.You can now see the following files in the
master_Language_<date>.zip
file.Here’s an explanation about the files that you’ve downloaded:
File Description ASSETS
A folder that includes all the site’s assets such as images, HTML files, and so on. <siteId>.properties
Example:d5669103-50a5-4c85-8118-cf1e131109a1.properties
A properties file with the site’s source strings such as text strings for menu items. README.txt
A text file with explanations. WCE_<siteId>.properties
Example:WCE_ d5669103-50a5-4c85-8118-cf1e131109a1.properties
A properties file that includes any web content strings in the site (these files exist only if there are web content widgets used in the site). -
Select the
<siteId>.properties
file and theWCE_<siteId>.properties
file and click Extract To. -
Extract the zip files into your Downloads folder and save it in the Translation Files folder that you created. It’ll make it easier to find them afterwards when you need to upload them for translation.
If you go up a level and look at your Translation Files folder, you’ll see both your translation files like this:
Your files are now ready for translation.
At this stage you can send these files to your translator. They will then translate the files and when the translation is done, they will return the files to you for uploading back into your Portal site. In this case you will continue with Step 2 of this tutorial and then skip to steps 5 and 6.
If you want to translate the files yourself using the SAP Translation Hub – a service of SAP Cloud Platform, skip Step 2 and continue with the rest of the tutorial (steps 3, 4, 5, and 6).
-
- Step 2
This step is relevant only if you’ve sent your content files to a translator (in other words, you are not using the
SAP Translation Hub
to translate your site content).When you get the translated files back from your translator, you receive them in the same format as when you sent the files to them like this:
<siteId>.properties
andWCE_<siteId>.properties
.Before you can upload the translated files to your Portal site, you need to ensure that each translated file includes a language locale as a suffix. This suffix identifies the translated language.
-
If the files don’t already include this suffix, rename the properties file that has been translated to German and add
de
as the suffix. Do the same with the properties file that has been translated to French - rename this one withfr
in the suffix. -
Now open the
master_Language_<date>.zip
file (that you downloaded in Step 1) and add the renamed property files to this zip file. -
Do this for both the
<siteId>.properties
andWCE_<siteId>.properties
files.
When you’re done, this is how the files should look in your
master_Language_<date>.zip
file.Note that you have 3 files for each - one with the German translation
<siteId>_de.properties
, one with the French translation<siteId>_fr.properties
, and the original one that is already there and has not changed. -
- Step 3
To do this step, you need to go back to the SAP Cloud Platform cockpit where you can access the SAP Translation Hub service.
Let’s start.
-
You’re still in the Translation Manager. To access the cockpit easily, click Useful Tools at the bottom of the left panel and choose SAP Cloud Platform Cockpit.
-
From the left side panel in the cockpit, click Services.
-
From the Globalization category, select the SAP Translation Hub tile.
-
From the SAP Translation Hub - Overview page, click Go to UI for Translation Workflow.
The SAP Translation Hub user interface opens in a new browser tab.
-
- Step 4
In this step, you are going to create translation projects for the
.properties
files that you downloaded.Let’s start.
-
Click + at the footer of the Translation Projects list.
-
Click File Upload.
-
In the File Upload Project Details screen, enter the following values:
Property Value Project Name Supplier Portal Site Texts
File Type Java Properties Files
Source Language English
Target Languages select German
andFrench
This is how it looks on the screen.
-
Click Save.
The new Translation Project is created.
-
Click Upload File at the bottom right corner of the screen.
-
In the File Upload dialog click Browse.
-
Navigate to the Translation Files folder where you saved your downloaded files and select the
<SITE_ID>.properties
file. Click Open. -
Click Upload and Translate. You will see that the translation process starts. Hang on until the progress bar shows that the translation process is done.
-
Once the translation process is complete, click the Translations tab that appears.
-
Click Download Translations at the bottom right of the screen.
-
You can see your translation zip file at the bottom of the screen. Click Open.
-
The
Supplier Portal Site Texts.zip
opens from yourDownloads
folder.Note that you have two files - one in German and one in French.
-
Now you need to create another translation project for the web content properties file (
WCE_<SITE_ID>.properties
). To do this, repeat steps 1 to 12. Name this projectSupplier Portal WCM Texts
. Select the same target languages as the first properties file, and then upload theWCE_<SITE_ID>.properties
file.The result is:
You are now ready to upload your translated files to your Portal site. To do this, you need to go back to the Portal Site Designer and open the
Supplier Portal
site. -
- Step 5
In this step you will upload the translated files. Either the files that you received from your translator or those that you translated above in the SAP Translation Hub.
-
Go back to the Portal Service.
-
From the Site Directory, open your
Supplier Portal
site for editing. -
Click Services and Tools and open the Translations Manager.
-
Under Translation Files, click Upload.
-
From your Downloads folder, select the
Supplier Portal Site Texts.zip
file. You will get a toast message to say that the upload was successful. -
Then click Upload again to upload the
Supplier Portal Site WCM Texts.zip
file. -
In the Translations Manager scroll down to the Available Languages section and turn on the
French
andGerman
languages to activate them. Once activated, these languages will be available for end users of your site to select.
-
- Step 6
Now you are going to publish the
Supplier Portal
with all your changes. Since you have uploaded the translated content inFrench
andGerman
, and since you have activated theFrench
andGerman
languages, end users will be able to select these languages in theirSupplier Portal
site.Let’s check this out.
-
In the top right corner of the
Supplier Portal
site, click Publish to publish the latest changes. -
In the Publish Site dialog box, click Publish and Open to open the
Supplier Portal
site in the master language (English) in a new browser tab. -
Click the
Me
icon on the left side of the top-level menu. -
Click Settings.
-
In the Settings dialog box, select Language & Region. Note that the languages
French
andGerman
are in the dropdown list for selection. -
Select
French
and then Save. Note that the browser reloads inFrench
and looks like this: -
Now try it out in
German
. -
When you are done, set the language back to your Browser Language (English) as the language settings are applied to your User and will be applied throughout your SAP Cloud Platform account.
Just for your information - web content editors can translate the web content of a site directly from the Web Content Editor tool by selecting one of the languages activated by the site administrator. For more information, see Translate Web Content
Congratulations! You have translated your Portal freestyle site and end users can now view the content of your site in French and German.
What is the master language?
-