Unicode Support

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:

Set system locale (for Windows users)

  1. Open Settings and go to Time & Language:

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

    Unicode support: Region and language
  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 encoding system property

Set the -Dfile.encoding=UTF8 system property.

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

Set fonts that support Unicode

Working with Unicode: Specify fonts
  1. Open Preferences > Editor.

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

Do not name test items by using 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.

Set Unicode charset for requests

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

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.

Turn off normalizing line breaks

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

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:

unicode-not-supported-symbols.png

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

See Also

Publication date: