Altova StyleVision 2025 Enterprise Edition

The syntax for Value Formatting is:

([prefix character/s]field[suffix character/s][{field-option1,field-option2,...}])+

Explanation of definition syntax

The Value Formatting definition is constructed as follows:

•The definition is composed of one or more fields. For example, the definition DD Month YYYY has three fields.

•Fields can be run together, or they can be separated by the following characters: space, hyphen, comma, colon, period, or by a text string in single or double quotes. For example, in the definition: DD-Month' in the year 'YYYY, the fields DD and Month are separated by a hyphen, and the fields Month and YYYY are separated by a text string enclosed in single quotes.

•A field can have optional prefix and/or suffix character/s. For example: <+###,##0.00.

•A field can have one or more optional field-options. The field-option/s for each field must be contained in a single set of curly braces, and must follow the field without any intervening space. Multiple field-options for a single field are separated by "," (comma). For example, in the definition: DD Month{uc,ro} YYYY, the curly-brace-enclosed uc and ro are field-options for the field Month.

Examples

Example of Value Formatting for an xs:decimal datatype:

"$"(##0.00)

Examples of the output would be:

$ 25.00

$ 25.42

$267.56

Example of Value Formatting for an xs:date datatype:

DD Month{uc,ro} YYYY

An example of the output would be:

24 SEPTEMBER 2003

Field types

A field type represents a component of the data and the way that component is to be formatted. The formatting inherent in the field type can be modified further by prefix and suffix modifiers as well as by field options. The following tables list the available field types. Note that, in the drop-down menu of the Value Formatting dialog, there are type-specific and field-only Value Formatting definitions. You can select one of these and modify them as required by adding prefix modifiers, suffix modifiers, and/or field options.

Notes on field length and entry length

The following points relating to the length of data components should be noted:

Length of date fields: When fields such as MM, DD, HH, hh, mm, and ss are used, they must have a length of 2 in the definition. When the y or Y fields are used, the number of y or Y characters in the definition determines the length of the output. For example, if you specify YYY, then the output for a value of 2006 would be 006; for a definition of YYYYYY, it would be 002006. See also Base Year below.

Extending field length: The * (asterisk) symbol is used to extend the length of a non-semantic numeric field (integers, decimals, etc). In the case of decimals, it can be used on either or both sides of the decimal point. For example, the Value Formatting *0.00* ensures that a number will have zeroes as specified in the formatting if these digit locations are empty, as well as any number of digits on both sides of the decimal point.

Entry lengths in Authentic View: The display in Authentic View of the contents of a node is based on the Value Formatting definition for that node. Therefore, the Authentic View user will not be able to insert more characters than are allowed by the Value Formatting definition. This is a useful way to restrict input in Authentic View. Note, however, that if the length of a pre-existing value in the XML document exceeds the length specified in the formatting definition, then the entire value is displayed.

Prefix and suffix modifiers

Prefix and suffix modifiers are used to modify the textual alignment and positive/negative representations of fields. The following table lists the available prefix and suffix modifiers.

Field options

Field options enable advanced modifications to be made to fields. The following options are available:

Field options should be used to generate number formatting for European languages, which interchange the commas and periods of the English language system: for example, 123.456,75.

The Value Formatting to use to obtain the formatting above would be: ###,###.##{dec=,,sep=.}

Notice that the field retains the English formatting, while it is the field options dec and sep that specify the decimal symbol and digit separator. If the decimal symbol and digit separator are not specified, these characters will default to decimal symbol and digit separator of the regional settings of the Windows OS (Control Panel | All Items | Region | Format).

Note on Base Year

When using short year formats (such as yy and YY), the base year specifies a cut-off for a century. For example, the base year field option could be used in the definition DD-MM-YY{base=1940}. If the user enters a value that is equal to or greater than the last two digits of the base year, which are considered together as a two-digit positive integer, then the century is the same as that of the base year. If the value entered by the user is less than the integer value of the last two digits, then the century is the century of the base year plus one. For example if you set base=1940, then if the Authentic View user enters 50, the value entered in the XML document will be 1950; if the user enters 23, the value entered in the XML document will be 2023.

Note the following points:

•Although two digits are commonly used as the short year format, one-digit and three-digit short year formats can also be used with a base year.

•Datatypes for which short year formats can be used are: xs:date, xs:dateTime, xs:gYear, and xs:gYearMonth.

•If the Value Formatting is being set for an Auto-Calculation component, make sure that the correct datatype is selected in the Value Formatting dialog. (The selected date datatype should be that of the result to which the Auto-Calculation evaluates.)

•If the yy field type is used, the default base year is 1930. Explicitly setting a base year overrides the default.

•If the YY field type is used without any base year being set, then the Authentic View user will be able to modify only the last two digits of the four-digit year value; the first two digits remain unchanged in the XML document.