[Name] WEB_SELECT

[Description] Allows the user to launch a dialog to pick files from a specified service.

Behavior Options:
   NO_SEARCH : Hides the search bar for formats that do not support search
   SERVICE : Specifies the name of the service used.  Names containing spaces need to be quoted.
   Name is used to find the corresponding python module that implements the browsing functions.
   DEPENDENT_PARAMETERS: specifies the names of the parameters.
   KEYVALS: specifies any extra FMEParsableText encoded comma-separated key-value pairs to send to the python module as parameters
   SHOWID: If present the value of the parameter will be set to the id of the chosen file instead of the url
   SELECTION : a choice of either ITEMS_ONLY or CONTAINERS_ONLY or BOTH. Default value is ITEMS_ONLY. Alternatively, supply comma-separated list of one ore more of the following: ITEMS, CONTAINERS, NO_ROOT. When NO_ROOT is supplied, users will not be able to select the root Folder. Supplying ITEMS and CONTAINERS in the list is equivalent to BOTH.
   PROMPTFORTITLE: Use the parameter prompt in the dialog title of the web browser. e.g. if prompt is "Bucket:" title is "Select Bucket From <Service>"
   ALLOW_MULTISELECT : whether to allow the user to pick multiple items which will be returned space delimited
   SINGLEDEPTH : Indicates that the contents being displayed have a depth of one, the root. In this case, the browse path buttons will be hidden, and the reload button will be moved to the bottom left of the browser. Additionally, a filter box is displayed that applies a front-end only filter on the contents returned by the python module
   MODULE : Specifies the name of the python module to use. If not specified, the SERVICE with spaces removed and lowercased is the python module name used for this WEB_SELECT.
   CONTAINER_ICON: The icon to be shown next to containers in the web browser. If not specified, the icon will be the default folder icon. If specified but left empty, there will be no icon. Icon path must be relative to the FME ROOT Folder for installed transformers or the .fmx folder for packages or a resource path if icon is compiled in.
   ITEM_ICON: The icon to be shown next to items in the web browser. If not specified, the icon will be the default file icon. If specified but left empty, there will be no icon. Icon path must be relative to the FME ROOT Folder for installed transformers or the .fmx folder for packages or a resource path if icon is compiled in.


In a Transformer (*.fmx) File

   Syntax

      PARAMETER_NAME: <macroName>
      PARAMETER_TYPE: WEB_SELECT SERVICE:<Service Name>%DEPENDENT_PARAMETERS:[Parameter Name]*[%KEYVALS:<Key>,<Value>*][%NO_SEARCH][%SELECTION:<Container Selection>][%ALLOWMULTISELECT][%MODULE:<Python Module Name>][%CONTAINER_ICON:<Icon Path>][%ITEM_ICON:<Icon Path>]
      PARAMETER_PROMPT: <label>
      PARAMETER_DEFAULT: [<defaultValue>]

   Example

      PARAMETER_NAME: S3_FILE
      PARAMETER_TYPE: WEB_SELECT SERVICE:Amazon<space>S3%DEPENDENT_PARAMETERS:CONNECTION:KEYGROUP:AWS_ACCESS_KEY:AWS_SECRET_KEY%SELECTION:ITEMS,CONTAINERS,NO_ROOT%NO_SEARCH%KEYVALS:MODE,PATH%ALLOW_MULTISELECT%MODULE:amazons3%CONTAINER_ICON:./dependencies/foo1.jpg%ITEM_ICON:./dependencies/foo2.jpg
      PARAMETER_PROMPT: Select File(s):
      PARAMETER_DEFAULT:


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

   Syntax

      [DEFAULT_VALUE <macroName> <defaultValue>]
      GUI WEB_SELECT <macroName> SERVICE:<Service Name>%DEPENDENT_PARAMETERS:[Parameter Name]*[%NO_SEARCH][%FILTER:<File Filter>][%SHOWID][%SELECTION:<Container Selection>][%ALLOWMULTISELECT][%MODULE:<Python Module Name>][%CONTAINER_ICON:<Icon Path>][%ITEM_ICON:<Icon Path>]  <label>

   Example

      GUI WEB_SELECT GOOGLE_FILE SERVICE:Google<space>Drive%DEPENDENT_PARAMETERS:CONNECTION%FILTER:CSV|*.csv%SELECTION:BOTH%MODULE:googledrive Select File or Folder: