Formatting Decimal Numbers

XML Publisher allows you to define formatting characteristics for the decimal numbers displayed in a report. For example, you might want to specify that all dollar values displayed in a report end with two decimals, thus $10 would be formatted as $10.00, $21.72 as $21.72, $99 as $99.00, and so on.

Formatting decimal numbers is a two-step process:

1. Specify the formatting you want to use - which character you want to use as the decimal separator, for example.
2. Specify the pattern, called a picture string, you want the decimal numbers in your report to match in order for this format to be applied.

Formatting for decimal numbers is specified for the report body and affects all decimal numbers in a report for which you have specified a picture string. Formatting applies only to dynamically generated values - the total value of an order, for example - and not to any numbers that you type by hand as body text or in a text component.

Where You Specify Decimal Number Formats

You specify the formats for decimal numbers on the Decimal Format tab of the XML Publisher Properties window, shown here:

For example, if you want decimal values to be separated by a comma (,) instead of a period (.), you would enter a comma in the Value field for the Decimal Separator property. Default values are used for any properties that you do not specify. See Table 177, "Decimal Format Properties" on page 1108 for more information.

In addition to defining the format of the decimal numbers in your reports, the properties on the Decimal Format tab also affect the values you can use to define your picture string. For example, the Digit property defines the character that you use to define digits in the picture string. Its default value is the number character (#). Similarly, the Decimal Separator property defines the character used to separate decimal values; its default value is the period character (.). If you want to use values other than these in your picture strings, you must be sure to specify them on the Decimal Format tab.

Where You Specify Picture Strings

As mentioned earlier in this section, a picture string represents a pattern for number strings. An example of a picture string might be #,###.00. Number strings that match the picture string you define are formatted using values you specify on the Decimal Format tab.

You specify the picture string in the Format property on the Dynamic Value tab for the report component - the Price node, in the following illustration - whose number strings you want to format. You must specify a picture string for any number strings you want formatted using the values you define on the Decimal Format tab. If you do not specify a picture string, no formatting is applied to the number string and it is rendered in the finished report as-is.

Values entered for the Format property must conform with the rules described in the XSLT specification: http://www.w3.org/TR/xslt20/#dt-picture-string.

Example

We are producing reports for consumption by a European audience. This audience is accustomed to seeing monetary values represented using the period (.) as the grouping separator (for thousands, for example), and the comma (,) used as the decimal separator. Thus, for example, a monetary typically displayed in North America as 4,230.95 needs to be rendered as 4.230,95 for this report.

To satisfy this report requirement:

1. In XML Publisher, display the Properties window.
2. Click the Decimal Format tab.
3. In the Decimal Separator property Value field, enter a comma (,).
4. In the Grouping Separator property Value field, enter a period (.).

When we have finished, the Properties window looks like this:

Next, we need to define the picture string for the decimal number we want to format using these characters.

5. In the XML Publisher canvas, select the glyph that represents the decimal number. In this example, it is the node for book price.
6. In the Properties window, click the Dynamic Values tab.
7. In the Value field for the Format property, specify the following picture string: #.###,00. The pound sign (#) is the default character used to represent digits in a picture string; the zeroes after the decimal separator instruct the XML Publisher to use "00" unless another value is present in the number string, so 82 is represented as "82,00". If we had specified the picture string as #.###,##, no decimal value would be represented in the report because none was present in the number string, so 82 would be represented as "82,".
 
Free Stylus Studio XML Training:
W3C Member