Show TOC

Syntax documentationEvGTS Locate this document in the navigation structure

The EvGTS (Get value and scale) function retrieves a data value based on the specified members, and scales the value if the scale property is enabled on the dimension. The report templates provided in the sample application set have a scale reference in the Control Panel area of the template.

Syntax Syntax

EvGTS(AppName,ScaleValue,[dim:]member1,[dim:]member2,[dim:]memberN)

AppName — The name of the application. This is required if the corresponding dimension does not exist in the active application.

ScaleValue — If the scale property in the Account-type dimension is Y, then EvGTS uses this value. If the scale property is N, this value is ignored. The scale value can be set to 1, 100, 1000, or 1,000,000. The default value in report templates is one (1). When the scale value is 1 (units), this function works identically like the EvGET function.

Member1–n — You can specify as many members that you want. Any dimension not specified in the formula is taken from the current view. If you supply only the period and not the year, EvGET uses the year from the Category's YEAR property. For example, EvGET(Finance, Jan,Budget,GlobalMotors, Revenue,AllProducts) uses the year specified in the Budget category YEAR property. If that year is 2008, the example gets data for the period Jan.2008.

If the same member name is used in more than one dimension, you must specify the dimension name. Use this syntax: dimension:member.

End of the code.

Example Example

The following example returns $500,000.00 from the database:

EvGTS(Finance,1,Account.Sales,Entity.Sales,Jan.20008,Budget)

End of the example.