[Name] FILENAME

[Description] This should be used when the file the user is entering does not 
              have to exist.  that is the 'save as' case. 
              
              Note that this also implies the file is an OUTPUT not and input file.
              thus file paths with this type will not include files in the 
              template creation or fme server upload (cf: FMEDESKTOP-11194). Use 
              FILENAME_MUSTEXIST or FILENAME_EXISTING if your parameter represents
              an input file.
              
              It allows the user to enter a filename or path.
              If the button is pressed, a file picker dialog appears and
              the user is able to pick files/folders based on the 
              filter (use asterisks (*) as a wildcard (e.g. *.txt).

              The filters are made in pairs, with a filter
              description(<filterDes>) and the actual filter. Spaces are not
              allowed in the description. Multiple extensions may be separated
              by a semicolon.

              Note: When the macro name starts with SourceDataset (case
              insensitive), the type it will be translated into a MULTIFILE
              type. This is to maintain reverse compatibility from before the
              MULTIFILE type even existed (see Example).


In a Transformer (*.fmx) File

   Syntax

      PARAMETER_NAME: <macroName>
      PARAMETER_TYPE: FILENAME [INCLUDE_WEB_BROWSER%]<filterDes>|<filter>[|<filterDes2>|<filter2>]*
      PARAMETER_PROMPT: <label>
      PARAMETER_DEFAULT: [<defaultValue>]

   Example

      PARAMETER_NAME: DestinationFile
      PARAMETER_TYPE: FILENAME Text_Files(*.txt)|*.txt|Word_Document(*.doc;*.rtf)|*.doc;*.rtf
      PARAMETER_PROMPT: Enter destination file:
      PARAMETER_DEFAULT:


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

   Syntax

      [DEFAULT_VALUE <macroName> <defaultValue>]
      GUI FILENAME <macroName> [INCLUDE_WEB_BROWSER%]<filterDes>|<filter>[|<filterDes2>|<filter2>]* <label>

   Example

      GUI FILENAME DestinationFile Text_Files(*.txt)|*.txt|Word_Document(*.doc;*.rtf)|*.doc;*.rtf Enter destination file: