ISML Function - getValue()

Name

getValue()

Short Description

formats the result of an ISML expression

Table of Contents

Product Version

6.5

Product To Version

 

Statusfinal

1 Introduction

This function can be used to format the result of an ISML expression. The value of an ISML expression is returned by getValue() as a formatted string. The standard formatter classes control how the string is formatted.

There are three ways to control the formatter classes:

  • use pre-defined formatter string
    The standard formatter classes come with pre-defined formatter strings. These are called styles.
  • use custom formatter string
    You can define and use your own formatter string with the formatter class.
  • use default formatter string
    Each formatter class has one default style. This style will be used if you do not specify anything else (neither a style nor a custom formatter string).

2 Syntax

getValue( <value> )
getValue( <value>, <style> )
getValue( <value>, <formatter> )

3 Example

The first example shows one of the styles in the formatter class:

<ISPRINT value="#getValue(Basket:TotalPrice,MONEY_LONG)#">

The next example shows how to specify a formatter string:

<ISPRINT value="#getValue(Offering:Weight,'#,##0.00')#">

Because neither a style nor a formatter string has been specified, the default style of the formatter class is used for formatting in the following example:

<ISPRINT value="#getValue(Purchaser:Address:Zip)#">

4 Parameters

4.1 value

value = ISML Expression

Specify the ISML expression to be formatted. Usually this will be just a template variable.

4.2 style

style = style identifier

Specify a valid style to be used for formatting the expression result. See Formatting Expression Resultsfor a list of valid styles.

4.3 formatter

formatter = formatter string

Specify a formatter string to control the formatting of the expression result. See the Java documentation in <IS.INSTANCE.DIR>\docs for more information about creating formatter strings.

Reference - ISML Functions

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources
Support Tickets