---
parser: v2
author_name: Fiona Murphy
author_profile: https://github.com/MCMANUSF
auto_validation: true
primary_tag: software-product>sap-translation-hub
tags: [  tutorial>beginner, software-product>sap-translation-hub, software-product>sap-business-technology-platform, programming-tool>java, tutorial>license ]
time: 15
slug: sth-translate-java-app
canonical_url: https://developers.sap.com/tutorials/sth-translate-java-app
---

# Translate a Java App (Neo environment)
<!-- description --> Use SAP Translation Hub to translate the UI texts for a Java app that you develop in Eclipse.

## Prerequisites  
  - **IMPORTANT:** This tutorial cannot be completed on a trial account.
  - [Install and configure Eclipse environment](https://github.com/SAP/cloud-espm-v2#1-quick-start-guide) Complete the **1. Quick start guide** section.

## You will learn  
  - How to translate the properties file of a Java app using the file upload scenario in SAP Translation Hub


---
### Locate .properties file


In your Eclipse window, locate the `i18n.properties` file that contains your app texts.

![Locate i18n.properties file](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-locate-i18n-prop-file.png)


### View texts in .properties file


Before you get started with the translation process, open the `i18n.properties` file to look at the texts that you're going to translate.

![Open i18n.properties file](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-view-texts-i18n-prop-file.png)


### Choose your SAP BTP Neo account


In the [SAP BTP cockpit](https://account.eu3.hana.ondemand.com/neo/), choose the tile for your account in the SAP BTP Neo environment.

![access menu to open service catalog](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-choose-Neo.png)


### Open the service catalog


Choose **Services** in the navigation area on the left. Search for the SAP Translation Hub service by entering **trans** and then choose the **SAP Translation Hub** tile.

![open service catalog](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-open-services.png)


### Open SAP Translation Hub UI


To access the SAP Translation Hub, UI, choose **Go to UI for Translation Workflow**.

![Go to SAP Translation Hub service](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-tile-go-to-service.png)


### Create a translation project


Create a **File Project** for the .properties file that you're going to upload.

![Create translation project](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-create-file-proj.png)


### Enter translation project details


Enter the following details about your file translation project:

Field Name | Value
:-------------  | :-------------
Project Name | `espmcloud`
File Type | **Java Properties File**
Domain | **Sales**
Source Language | **English**
Target Languages | Enter the languages of your choice, such as **French** and **Italian**

Choose **Proceed to upload file(s)**.

![Create project](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-create-file-proj-details.png)


### Upload properties file


You can upload the properties file in two ways: there's the drag & drop option, which automatically starts the translation process, and there's the more traditional file selection option, which requires you to select the file and start the translation process. The end result is the same, it's just a matter of how you prefer to work.

#### Drag & Drop Option
Simply drag the file from your Eclipse project to the translation project screen. SAP Translation Hub uploads your properties file to the translation project.

#### File Selection Option
 <ol> <li> On the translation project screen, choose **Upload File**:
 <li> Navigate to the folder on your local PC that contains the `i18n.properties` file and open it:
![Select properties file](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-file-upload-explorer.png) </li>
<li> Choose **Upload**:
![Select properties file](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-file-upload-translate.png)</li>
</ol>

Regardless of the option you choose, you need to start the translation step by selecting **Translate without Download** or **Translate and Download**:

![Start translation](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-translate-fiori-app-success-status.png)


### Review translations


To review the translated texts, choose the **Translations** tab.
On this screen, you can switch between target languages and view information about the translation provider and quality rating:

![Choose translations tab](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-translations-tab.png)


### Filter by quality index (optional)


To better plan the language review process, you can filter translations by the quality rating. For example, this enables you to see only those translations that have a quality rating below a certain threshold, such as `50`.
Choose the filter icon above the **Quality Index** column:

![Choose filter button](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-filter-step1.png)

Choose **Quality Index**:

![Choose quality index button](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-filter-step2.png)

Enter `50` as the upper limit or move the right slider bubble to the center of the scale:

![Adjust quality index slider](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-filter-step3.png)

The following success message confirms your filter setting:

![Confirm quality index filter](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-filter-confirm.png)


### Update translations (optional)


If you want to update any translations, make the changes in the **Translated Text** column and choose **Save Changes**:

![Save translation project](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-save-trans-proj.png)


### Download translations


Now it's time to download your translations so that you see your Java app in other languages. Choose **Download Translations**:

![Download translations](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-download-translations.png)

SAP Translation Hub prepares a `zip` file that contains properties files for each of the target languages in your translation project; save the `zip` file on your local PC and make a note of its location. You'll need to navigate to this file later in the tutorial.

![Confirm zip download](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-zip-downloaded.png)


### Import translations in Eclipse


Now it's time to head back to your Eclipse window and import the translations into the project for your Java app.

Ensure that you're looking at the **Java** perspective:

![Choose Java perspective](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-Java-perspective-import.png)

In the **Package Explorer**, navigate to your `i18n` folder, by choosing `espm-cloud-web > src > main > webapp > webshop`.
Right-click the `i18n` folder and choose **Import...**.  

![Choose import in Eclipse](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-eclipse-i18n-import.png)

Choose **Archive File**:

![Choose archive file for import](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-eclipse-import-archive-file.png)

At the top of the **Import** window, browse to the `zip` file that you downloaded from the SAP Translation Hub UI and choose **Finish**:

![Select zip file to import](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-eclipse-import-archive-file-zip.png)

The properties files per target language appear in the `i18n` folder:

![Show target language properties files](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-target-prop-files-imported.png)


### Restart Java server (optional)


To see the translations in your Java app, you need to restart the Java server. In Eclipse, switch to the **Git** perspective:  

![Choose Git perspective](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-eclipse-choose-git-persp.png)

Choose the **Servers** tab:  

![Choose Servers tab](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-eclipse-servers-tab.png)

Right-click **Java Web Server** and choose **Clean...**:  

![Choose Servers tab](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-eclipse-choose-clean.png)

Confirm the clean process by choosing **OK**:

![Confirm clean process](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-eclipse-clean-confirm.png)

Depending on system performance, it can take several minutes for the Java server to be cleaned and restarted. When the process is complete, the status of the Java Web server changes to **Started, Synchronized**:

![Server started](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-eclipse-server-started-synchro.png)


### Display app in browser


To see your app in the translated languages, enter the following address in a browser; the last two letters denote the language of your app: `http://localhost:8080/espm-cloud-web/webshop/?sap-language=fr`

![Enter local host address in browser](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-espm-app-browser-lang-select.png)

The French version of the app appears:

![Display French version of app](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/sth-translate-java-app/sth-espm-app-browser-fr-version.png)