[Name] MULTIPARAMETER

[Description]
Two ways of using this gui type.

Method #1: When the list of parameters is defined based on a choice selection, use
in combination with a MULTIPARAMCONTROLLER type and leave the config string blank.
In this case, the list of parameters represented by this parameter is set by the value
of the MULTIPARAMCONTROLLER.

Method #2: To specify a static list of parameters represented by this
parameters, set the config string to indicate the file that contains the desired parameter list.
The file should contain a list of GUI lines defining the parameters.

See FTPCaller and GMEStyler for an example of using this parameter type.

Think carefully about the delimiter you need to use.  When chosing a delimiter
ensure that this is NOT a character that will appear in any parameters values within the container.
If you have OR_ATTR types, then conditionals need to be considered and they can
have ; ' and space as delimiters in them already.  The default is ;.

In a Transformer (*.fmx) File

Syntax

PARAMETER_NAME: <macroName>
PARAMETER_TYPE: MULTIPARAMETER [FILE%<file name>][DELIM%<char>][INLINE%TRUE|FALSE]
PARAMETER_PROMPT: <label>
PARAMETER_DEFAULT: [<defaultValue>]

Example

PARAMETER_NAME: MYPARAM
PARAMETER_TYPE: MULTIPARAMETER FILE%transformers/dependencies/ftp/DownloadNoDefault.fme
PARAMETER_PROMPT: My Parameter Set
PARAMETER_DEFAULT:

where:
    A single parameter that represents multiple parameters

    FILE indicates the list of parameters represented by this parameter is within a file

    <file name> the file relative to the install directory that contain
    the parameters this parameter encapsulates.  The file should contain a list of guilines.

    DELIM allows you to change the delimiter for the container to <char> when
    this is done, the values will be SDF concatenated.

    INLINE indicates the multiparameter should be shown directly in the dialog rather as
    its own separate dialog.  The latter is usually used only from within a table context.

Note: when used with a MULTIPARAMCONTROLLER, the config string can be left blank.
IN this situation, the list of parameters encapsulated by this parameter is set by
the MULTIPARAMCONTROLLER parameter instead of via the config line.

Note: If used with a multiparamcontroller, the GUI adds a FME_CONTROLLER_QUERY_FILE key/value
pair to the value of the multiparameter so it knows which choice the value is associated with.  
This allows the gui to analyze the multiparametervalue without having access to the 
controller value (useful especially in tables). The value of FME_CONTROLLER_QUERY_FILE is a FMEParsableText string
of the *.fme file associate with the choice relative to the fmx file. Mostly, coders won't care.  
However, if creating a default value for your multiparameter this macro must also 
be included. You can search the transformers directory for 'FME_CONTROLLER_QUERY_FILE' to
find examples

Syntax


In a Reader/Writer (*.fmf, *.fmi) File

Syntax

[DEFAULT_VALUE <macroName> <defaultValue>]
MULTIPARAMETER <macroName> <config> <label>

Example

GUI MULTIPARAMETER MYPARAM FILE%transformers/dependencies/ftp/DownloadNoDefault.fme My Param Set: