Unicode Support

Applies to ReadyAPI 3.51, last modified on March 21, 2024

Unicode is a character encoding standard designed to support characters of the world’s languages.

Recommendations

The following recommendations will help you avoid issues when working with Unicode characters in ReadyAPI:

  1. Open Settings and go to Time & Language:

    Unicode support: Windows settings

    Click the image to enlarge it.

  2. Go to Region & language and click Administrative language settings:

    Unicode support: Region and language

    Click the image to enlarge it.

  3. On the Administrative tab, click Change system locale:

    Unicode support: Changing system locale
  4. Select the needed locale and apply the changes.

Set the -Dfile.encoding=UTF8 system property.

The way you do this depends on how you run ReadyAPI. See Modifying JVM Settings.

Working with Unicode: Specify fonts

Click the image to enlarge it.

  1. Open Preferences > Editor.

  2. In the Editor font and Text Field font options, specify fonts that support the needed Unicode characters.

Unicode symbols in the names of the following test items may cause issues:

  • Projects
  • Test suites
  • Test cases
  • Security tests
  • Load tests
  • Virtual services

We recommend that you avoid using Unicode characters in their names.

When you send requests containing Unicode characters set the encoding property to UTF-8. To do this:

  1. Open a request.

  2. Set the Encoding property to UTF-8.

Working with Unicode: Set request encoding

Click the image to enlarge it.

It is also possible to make ReadyAPI set the Unicode encoding for all the requests. To do this, set the -Dsoapui.request.encoding=UTF-8 system property. The way you do this depends on how you run ReadyAPI. See Modifying JVM Settings.

In some cases, the Normalize line-break option may cause issues with Unicode characters in your project. To turn off the option:

  1. Open Preferences > UI.

  2. Deselect the Normalize line-break option.

Working with Unicode: Turn off normalize line break option

Click the image to enlarge it.

Current support limitations

Currently, ReadyAPI has a number of limitations related to Unicode characters:

  • ReadyAPI does not show Unicode characters in the following panels:

    • Test item properties

    • ReadyAPI logs

    • Assertions

    • Grid data source

  • ReadyAPI does not support emoji symbols.

When ReadyAPI cannot show Unicode characters correctly, it displays "rectangle" symbols:

The issue affects only displaying characters. ReadyAPI does not modify any strings.

See Also

Modifying JVM Settings
Best Practices

Highlight search results