macro

Forms: Macro

A Macro allows Centerview to define and retain functions (macros) can be called repeatedly.

Form: Macro

Field Description
Name The name of the macro. This name is also how the macro will be invoked (called) from elsewhere in Centerview
Minimum Parameters The minumum number of parameters that must be passed to the macro when it is invoked.
Maximum Parameters The maximum number of parameters that may be passed to the macro when it is invoked.
Expression The script that evaluates to a value based on the input parameters.

The following fields are displayed through a separate tab within the main macro form:

Field Description
Description Free form text field to describe the Macro.

Form Icons

The form provides the standard form icons.

Example Macro

This sample macro is called padCost. It takes 1 parameter - a numeric value. It checks to see if the numeric value is missing a 0 before a decimal point. If so, it adds the 0 and returns the string. It can be called anywhere in centerview that an expression can be entered (for example) with :

padCost(".977")

do( $val = $args[1], if(startsWith($val, "."), //if the cost is positive, add a zero onto the beginning "0" + $val, if(startsWith($val, "-."), //if the cost is negative, replace the -. with a -0. "-0." + substring($val,3), //ELSE $val ) )

See Also