${name} - This syntax is used to specify a parameter name.

${name#type} - This syntax is used to specify the name and type of the dynamic parameter.

${name#type#value} - This syntax is used to specify the name, type and value.

${name##value} - If the type has to be excluded and just the default value has to be specified, the syntax is given as above.

## - A plain text field (the default).

#password# - A password field and hence the typed characters are masked.

#choice(A,B,C)# - A combo box with choices A, B and C.

#integer# - An integer field, which accepts non-negative integer values.

#number# - A field for numeric values, which may be positive or negative and may include decimals.

#date()# - A date field with a popup calendar.

The date type provides a number of variants to control how the date is presented to the user. Within the tool, the string representation of dates always follows the international standard format yyyy-MM-dd. Here are some examples of date syntax and their meaning (the // indicates a comment and is not part of the syntax):

As you can see, date can take up to two parameters (locale,format). Both parameters are optional. The locale is defined using the appropriate language, country and variant codes, separated by underscores: LA_CO_VA. Again you can omit values from the end to accept the default, LA_CO, or just LA. The language codes are defined at: http://www.loc.gov/standards/iso639-2/englangn.html, while the country codes are defined at: http://www.iso.org/iso/country_codes/iso-3166-1_decoding_table.htm. The format should either be "long","medium" or "short" or else a custom pattern. Remember the format only affects how the date is presented to the user, not the internal string representation of the date.

Dynamic parameters are always strings. This means the result substituted for a date type will not be a date object but only a string representation (in ISO format, as mentioned earlier). If such a string is substituted in JavaScript, you will be performing subtraction instead: 2005-01-01 = 2003! To convert the string to a date, you need the following form of JavaScript (showing a french date, here):

asDate("${Enter French date#date(fr,"long")}");

There are two important parts to this example. First, notice that the ${} substitution is enclosed within quotes. This ensures the result is substituted as a string, not as a series of number subtractions. Second, the string is passed to the asDate() function, which is pre-defined within the tool for converting strings in ISO date format into actual Date objects.

#lookup(...)# - Lookup choices from a datasource.

It is good to give users a choice of valid values, but the options are often dynamic. Using the lookup type, you can fetch values from a datasource to populate a combo box on the parameter UI. The following is an example:

${Company Name#lookup(Fruit,CompanyName)#B}

This will create a parameter on the UI with label Company Name with a combo box that reads its values from the data source called Fruit using the field called "CompanyName". The default selection will be company B.

Further, the datasource "Fruit" can be either:

Also, further parameters can be passed in if the datasource requires parameters:

${Company Name#lookup(Fruit,CompanyName,User=Jon,Password=XXX)#B}