Bookshelf v7.5: Macro-Expansion Examples

The examples in Table 29 demonstrate macro-expansion usage. From the nominal parameter value shown in the second column, macro expansion calculates the resulting value shown in the third column. Each example is explained to show how the result was generated.

Table 29. Macro-Expansion Examples
Parameter Name	Parameter Value	Result	Explanation
Param.PhoneNumber	#8[Phone #:7-10]	#85000	If the value of the Phone # field in the current business component is 6504775000, macro expansion extracts the seventh through tenth digits of the phone number. The characters "#8" prefix the result. Because no keyword is specified, the Number part is assumed, and the country code and extension are excluded. Because the macro-expansion characters representing the phone number are enclosed in brackets, this Phone # field could be in a dialog box or in the current business component.
Param.PhoneNumber	{Phone #:Number:6-10}	75000	Assume the same value for the Phone # field as in the previous example. Macro expansion extracts the sixth through tenth digits of the phone number. In this example, the Number keyword is explicitly specified. Because the macro-expansion characters representing the phone number are enclosed in curly braces, this Phone # field could not be in a dialog box.
Param.GetId	{Id}	10-CSAE	If the Id field for a record in the current business component is 10-CSAE, macro expansion yields this string as the result.
Param.Greet	\{Hi\}	{Hi}	The backslashes escape the curly brace characters, allowing them to be included literally as part of the result. Because "Hi" is not enclosed in curly braces, it is not interpreted as a field name.
Param.ExtField	{Extension}	5000	For a field called Extension, macro expansion extracts the value of this field—for example, 5000. Because the Extension field is not of type DTYPE_PHONE, you cannot use keywords to specify a phone number part to extract.
Param.Ext	{Work Phone #:Extension}	6000	If the value of the Work Phone # field of the current business component (for example, Contacts) is (650)4775000 x6000 for a U.S. phone number and extension, only the extension number after the "x" is extracted.
Param.PhoneNumber	{Work Phone #:Lookup}	phone_num	Macro expansion generates a phone number based on applying the dialing filters to the data in the Work Phone # field of the current business component.
Param.PhoneNumber	{@Phone:PhoneTypeLookup}	phone_num	Macro expansion generates a phone number based on the logic described for the @Phone macro, in Macros for Parameter Values. Dialing filters are applied only if a field is of type DTYPE_PHONE.