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)
-
Open Settings and go to Time & Language:
-
Go to Region & language and click Administrative language settings:
-
On the Administrative tab, click Change system locale:
-
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
-
Open Preferences > Editor.
-
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:
-
Open a request.
-
Set the Encoding property to UTF-8.
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
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.