View Element Reference

< message />

This element defines a text string that can be localized and used as part of the presentation of the view. The text may appear as a button label, an instruction or anywhere else in the presentation that the view creator chooses. The message may be retrieved in the JavaScript code associated with the view by using the getMessage() function. All other strings in the JavaScript file are not localized.

Translatable text must be in "XML-safe" format. For example, double-quote (") characters are not allowed in translatable text. Single quotes are allowed. HTML tags may be incorporated into the message text by substituting the '<' and '>' with square brackets. In the following example, String.format() is used to incorporate the action id and description into the message text:

<message name="confirmWithdraw">Are you sure you want to withdraw the following request:[br/][br/][b]{0}[/b]: {1}</message>

Enclosing Element: This tag is a direct child of the <view> element.
Encloses: This element encloses the text that is to be used verbatim or used as a key to look up the localized text.
Attributes:
Attribute Description Valid Values Optional
name unique identifier, referenced by the getMessage function in JavaScript a string unique within the panel no
translatable specifies that the content will be translated into the local language when the localization file contains an entry using this tag’s content as the key 'true' or 'false' , defaulting to true yes

Note: In the axvw file, <message> must be put before the <panel type=”view”…>. For example, the following shows the correct order:

<view version="2.0">
<js file="ab-move-approve-form.js"/>
<title translatable="true">Examine my Moves</title>
<message name="move_category" translatable="false">Individual</message>
<message name="view_status" translatable="false">Examine</message>
<message name="view_role" translatable="false">Requestor</message>
<message name="newHire" translatable="true">New Hire:</message>
<message name="employeeLeaving" translatable="true">Employee Leaving:</message>
<message name="equipmentToMove" translatable="true">Equipment to Move:</message>
<message name="assetToMove" translatable="true">Asset to Move:</message>
<message name="roomToMove" translatable="true">Room to Move:</message>
<message name="employeeToMove" translatable="true">Employee to Move:</message>
…
<panel type="view" id="panel_abMoveReview_quest" file="ab-questionnaire.axvw"/>
<panel id="panel_abMoEditMoAssets" type="view" file="ab-mo-edit-mo-eqta.axvw"    useFrame="false"/>
</view>