Manual Parameters Editor

The Manual Parameters Editor allows you to create output parameters that allow for different types of user input at workspace runtime.

In the editor dialog, the left pane lists all the existing manual parameters for the automation. You can use the toolbar icons to perform the following:

  • Add a parameter: Click the Insert icon (+) and select the type of parameter you want to add (see Manual Parameter Types, below). The parameter is added below the currently-selected parameter . In the right pane, configure the properties of the parameter according to its type (see Parameter Properties (Right Pane), below).
  • Edit a parameter: Click on one to select it. The parameter's properties display on the right pane.
  • Change the order of the parameter at runtime.
  • Remove a parameter.

When finished, click OK.

Manual Parameter Types

Type Creates a Manual Parameter that allows a user to...
Choice Choose one or more values.
Color Select a color value.
Date Time Enter a date and time.
File/URL Choose the names and paths of existing files or folders, an output file or folder, or a URL.
Message Display a message at runtime.
Number Enter an integer or floating-point number. The number can be bounded or unbounded based on the specified Configuration.
Password Enter a password.
Text Enter a text string.
Yes/No Select or unselect a checkbox.
Geometry

Enter a geometry as a set of spatial coordinates in GeoJSON. When a workspace containing a Geometry manual parameter runs, an interface is available for displaying the specified coordinates on a map and specifying the desired geometry. For more information, see Using the Geometry Parameter in FME Flow.

Tip  To handle the JSON data in this parameter:
  • Use a GeometryReplacer transformer to turn the parameter value into a real geometry. Specify GeoJSON as the GeometryEncoding.
  • Use a JSONExtractor transformer to extract the coordinate values. For example, to extract X/Y coordinate values to a point feature, specify json["coordinates"][0] and json["coordinates"][1].

Parameter Properties (Right Pane)

A short, unique name for the parameter. This name is used to reference the parameter in values (for example, $(myIdentifier)) and menus.

The prompt for the parameter that appears when you run the workspace.

If checked, the workspace does not run unless the user inputs a value. If unchecked, an input value is not required for this parameter.

These settings depend on the parameter type you choose.

You can populate the choices to display in a Dropdown, List, or Tree.

Tip  Limit Dropdown to a single selection from a small number of choices. To allow selecting from a large number of choices, use List, and check or uncheck Allow Multiple Selection accordingly.

If Tree is selected, specify a Tree Node Delimiter for the nodes of the tree. Then specify the Choices, using the delimiter to indicate under which node to place the value.

For example, this configuration uses a comma to delimit building choices by building site:

Mouse-over to view:

The choices, when presented, appear like this:

Mouse-over to view:

Choose the default value that will be used.