User Manual

Configuration

You can configure the KMFasTrans selecting Components-> KM FasTrans-> Control Panel-> Options from top menu.

A modal window appears with several tabs:

KMFasTrans permissions configuration KMFasTrans permissions configuration

 

In all tabs except 'Translation options' the tips on the options texts clearly explain the purpose of each parameter.

The following describes the tab 'Translation options':

Here you can configure an automatic translation service from those available in the dropdown menu 'Translation service'. The Bing translator is the only one currently supported.

 

KMFasTrans translation options configuration KMFasTrans translation options configuration

 

Bing Translator Service

Bing Translator is a hosted service by Microsoft that provides language translation. This can be used within KMFasTrans PRO to suggest translations when creating or updating items.

At the time of writing you can subscribe to several plans based in the number of characters to translate per month. There is a free plan that allows translation up to 2 million characters per month.

Please note that Microsoft may change its plans at any time.

To use the translator you have to:

    • 1. Sign up for the service.
    • 2. Getting your Credentials.
    • 3. Configure KMFasTrans.

For the first two steps above you can follow the instructions on Signing up for Microsoft Translator on Windows Azure Marketplace or follow the step-by-step instructions below.

Step 1. Sign up for the service.

a). Visit https://datamarket.azure.com/dataset/bing/microsofttranslator to see the Microsoft Translator Offer page on Windows Azure Marketplace.

 

Windows Azure Marketplace Microsoft Translator

 

b). On the right hand side of the screen, you'll see a number of different monthly volume offers. Choose the one that meets your monthly volume usage needs. The free 2 million characters per month subscription offer, is at the top of the list.

c). Press the 'Sign Up' link on your chosen offer and you'll be taken to a page where you are asked to sign in using a Microsoft account. If you already have one, just sign in. If you don't, you'll have to create a new one.

 

Windows Azure Marketplace Sign in

 

d). After Sign in you'll be taken to a Registration page where you have to enter some data.

 

Windows Azure Marketplace Registration

 

e). Fill out your details, and press the 'Continue' button. You'll be taken to the Terms of Use page.

 

Windows Azure Marketplace Terms of Use

 

f). Read it carefully, and if you accept it, check the box at the bottom of the screen that says 'I accept the Terms of Use', and press the 'Register' button. You will be taken to the Sign up page.

 

Windows Azure Marketplace Sign Up

 

f). Check that you agree with 'Offer Terms and Privacy Policy' and click the 'Sign Up' button. This will complete Step 1.

 

Step 2. Getting your Credentials.

Visit https://datamarket.azure.com/developer/applications/register to be taken to the screen that allows you register your application.

 

Windows Azure Marketplace Register application

 

You use this to get the Client ID and Client Secret values that KMFasTrans needs to authenticate the service.

    • - Fill out the Client ID, and Name fields.
    • - The Client Secret field is already completed for you. Do not change it.
    • - Fill out the 'Redirect URI' field with any valid URL that uses https, for example https://microsoft.com. This field is not used by the Microsoft Translator.
    • - You can also leave the 'Enable subdomain access' checkbox unchecked, as the translator doesn't use it.

Remember and note the Client ID and Client Secret fields. You will need these to configure KMFasTrans.

Next, you'll be taken to a page containing the list of your applications. (Note: For future reference, here's a shortcut: https://datamarket.azure.com/developer/applications).

Step 3. Configure KMFasTrans.

Fill in the following options in the 'Translation options' tab with the data from Step 2:

    • Translation service: Bing translator.
    • Bing translator Client ID: The Client ID supplied in Step 2.
    • Bing translator Client Secret: The Client Secret obtained in Step 2 (Copy and Paste).

Translation tags option:

This option is valid for all translation services.

Using this option you can choose to perform a special process for the translation of texts contained between the choosed characters. If for example you choose '{ }', that indicates that all the content between the opening tag '{' and the closing tag '}' will be subject to a special translation process. You can choose none, one or several options from the drop down menu.In the current version the only special process available is 'No translation', which means that the original value is preserved after translation.