# Transliterate

> `UiPath.MicrosoftTranslator.Activities.TransliterateActivity`

`UiPath.MicrosoftTranslator.Activities.TransliterateActivity`

The **Transliterate** activity uses the Microsoft Translator [API](https://docs.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-transliterate) to transliterate the provided text.

## How It Works

The following steps are an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the [Setup](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-translator-setup) steps.
2. Add the [Microsoft Translator Scope](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-translator-scope) activity to your project.
3. Add the **Transliterate** activity inside the **Microsoft Translator Scope** activity.
4. Create and enter `Strings` or a `String` variables for the [Intput](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-translator-transliterate) properties.
5. Create and enter a `String` variable for the [Output](https://docs.uipath.com/marketplace/automation-cloud/latest/user-guide/microsoft-translator-transliterate) property.

## Properties

### Common
* **DisplayName** - The display name of the activity. This field supports only `Strings` or `String` variables.

### Input
* **From Script** - The script from which to transliterate. This field supports only `Strings` or `String` variables. The script needs to be specified as an ISO 15924 script ID.
* **Language** - The language in which the text is written specified as a BCP 47 language tag. This field supports only `Strings` or `String` variables. For a complete list of the supported llanguages, please visit the official Microsoft Documentation.
* **Text** - The text to be transliterated. This field supports only `Strings` or `String` variables.
* **To Script** - The script into which to transliterate. This field supports only `Strings` or `String` variables. The script needs to be specified as an ISO 15924 script ID.

### Misc
* **Private** - If selected, the values of variables and arguments are no longer logged at Verbose level.

### Output
* **Transliteration Result** - The result of the transliteration process. This field supports only `String` variables.

## Example

The values that are needed for Translate and Transliterate can be confusing for first time users. Below is a working sample activity flow and the resulting output.

  ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-265671-c2de68a0-1568b92b.webp)