Reference texts in messages.en.properties file

Question

Hi,
I've got a peculiar issue. I'm trying to access a variable/property/reference
in my VM file like below:
<p class="warning">${FailureWarning}</p>
And FailureWarning is defined in messages.en.properties file as
# Custom Warning Messages
FailureWarning=Session status fail, additional data entry not permitted
However, when rendered on the UI, the message is contained with square
brackets. This does not happen with any other text (if I were to change the
value for FailureWarning).
[Session status fail, additional data entry not permitted]
Does the text hold a special meaning in OPA/Velocity rendering?
Regards,
Ajay

Answer 1

Each message is treated like any other key and value in Velocity.  A value will consist of either a string *or* a comma-separated list of strings (see Velocity - Developer's Guide).  What you have defined is a list consisting of 2 strings -  "Session status fail" and " additional data entry not provided", so Velocity will render these values within square brackets to indicate this is a list of strings.  You need to escape the comma with a preceding '\' to have Velocity treat this as a single string:
# Custom Warning Messages
FailureWarning=Session status fail\, additional data entry not permitted
You will see the escaped comma in the values for case-saved-label, NullTemplateError and NoActiveSessionError.
Hope this helps,
Brad