FME Form: 2025.2 BETA
User parameters are parameters that you can expose in the workspace. This is useful if you want to set visible default values, or if you want to be able to easily change a parameter from workspace to workspace.
You can create user parameters to set many different types of data, such as references to datasets, attributes, coordinate systems, grid shift files, geometries, database and web connections, text, numbers, dates, and others.
Types of User Parameters
| Parameter Type | Creates a Parameter to... |
|---|---|
| Choice | Choose one or more values. |
| Color | Select a color value. |
| Datetime | Enter a date and time. For information about output formats, see Standard FME Date/Time Format. |
| File/Folder/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. |
| Table |
Enter data in a table. |
| Text | Enter a text string. |
| Yes/No | Select or unselect a checkbox. |
| Attribute Name | Choose names of feature type attributes, or items from a comma-delimited or space-delimited attribute list. Choices only populate in the context of a reference to the user parameter in the workspace, such as when the Attributes parameter of a StringReplacer transformer references an Attribute Name user parameter. |
| Coordinate System | Choose a coordinate system. |
| Database Connection | Choose a database connection. |
| Geometry |
Enter a geometry as a set of spatial coordinates in GeoJSON. When a workspace containing a visible Geometry parameter is run from FME Flow, 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. Tip To handle the JSON data returned by 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]. |
| Reprojection File | Choose a grid shift file for reprojecting data. |
| Web Connection | Choose a web connection. |
| Advanced > Scripted Selection | Access a callback method in a Python module that returns values available for selection and which may be obtained remotely, such as from a web service. Scripted selection parameters are useful in configuring *Connector transformers to access resources (for example, the Folder parameter of the GoogleDriveConnector transformer). For more information about using Python with scripted selection parameters, see the FME Packages SDK Guide. |
| Advanced > Scripted Value | Write a Python script that assigns the value of a parameter to the workspace at runtime. |
Visible or Hidden Parameter?
Visible Parameters
When you define a parameter, you can choose to be prompted for information that might change when the workspace is run. This makes the workspace more portable.
Alternatively, you can control the visibility of a parameter depending on the values of other parameters that are specified previously in the prompt.
Visible parameters display in the log file as they would appear on the command line, which allows for simpler migration of workspaces to a command-based environment.
Note Reader and Writer dataset parameters are visible by default. If, for example, a file is missing, you will see a warning.
For more information, see Running a Workspace with User Parameters.
Hidden Parameters
Hidden parameters are used internally, mainly to share a parameter value across multiple transformers. For example, multiple SchemaMappers may reference a single parameter for its schema mapping table dataset. You can also create parameters for username/password fields in commonly accessed database tables.
Hidden parameters are nearly identical to visible parameters, but they have the following differences:
- Prompt-and-run does not prompt for hidden parameter values.
- The command line, at the top of the translation log and
.fmwfile, does not show the command line argument to set hidden parameters. (However, since they are macros in the mapping file, you can still modify them.)
Creating User Parameters
When you create a user parameter, you specify the type of parameter, whether it is visible or hidden, and all of its other properties. For more information, see Creating and Modifying User Parameters.
Using Parameters
Once you create a user parameter, you can use it in several ways:
- Right-click on the parameter and select Duplicate to create another parameter with similar settings, and edit as desired.
- Right-click on the parameter and select Copy. To reuse the parameter in another workspace, right-click in the canvas and select Paste. The parameter is applied to the new workspace, along with any other parameters it references.
- Right-click on the parameter and select Apply To to apply that parameter to another setting in the workspace.
- Use the ParameterFetcher transformer with the parameter name specified.
Examples
The FME Community includes additional information and examples of user parameters.