Creating and Modifying User Parameters

User Parameter Type	Description	Add/Edit Parameter Dialog
To add a new user parameter that has no existing properties	Right-click the User Parameters icon in the Navigator, and click Add Parameter. This is a new parameter, so you will have to fill in all required fields. Click OK to add the parameter to the workspace.
To create a user parameter from an existing workspace parameter	Right-click a Workspace Parameter in the Navigator, and click Create User Parameter. Most fields are already filled in based on the parameter's existing information. You can edit the fields; however, changing the Type is not recommended. Click OK to add the parameter to the workspace.
To create a user parameter from an existing transformer parameter (Navigator)	Right-click a Transformer parameter in the Navigator, and click Create User Parameter. Most fields are already filled in based on the parameter's existing information. You can edit the fields; however, changing the Type is not recommended. Click OK to add the parameter to the transformer. Detailed example
To create a user parameter from an existing transformer parameter (Transformer Parameters dialog)	Click the menu beside a parameter in the parameters dialog of a transformer and click User Parameter > Create User Parameter. You can edit all the fields. Click OK to add the parameter to the transformer.

Type

Note: Parameter values are passed as text strings without testing for Type. For example, if Type is Number, and the value is an expression from the Arithmetic Editor that does not evaluate to a number, FME does not return an error.

Attribute List (Comma Delimited and Space Delimited): Creates a parameter for selecting items from a comma-delimited or space-delimited attribute list.

Attribute Name: Creates a parameter for choosing the name of a feature type attribute.

Note: To use the attribute name as a value, convert using the @Value, @XValue, @YValue, or @ZValue feature functions.

Choice: Creates a parameter that allows you to choose one of x values (for example, a or b or c...).

Choice (Multiple): Creates a parameter that allows you to choose multiple values (for example, a and b and c....).

Choice or Text: Enter a text string or select one from a pick-list.

Choice with Alias: Similar to Choice, but allows you to map a user-friendly display value (alias) to an actual value. Choice with Alias is useful when actual values have little meaning or may be misunderstood by the user. For example, you can display a full format name but alias it to an abbreviated format name or file extension.

Choice with Alias (Multiple): Similar to Choice with Alias but you can map multiple values to the same alias. For example, you might want to display Park but alias this to Recreation Center, Community Pool, and Playground).

Color Picker: Creates a parameter for selecting the FME color value.

Coordinate System Name: Creates a parameter for choosing a coordinate system.

Date: Creates a parameter for entering a date. The value is output in the format yyyymmdd. For more information, see Standard FME Date/Time Format.

Date/Time: Creates a parameter for entering a date and time. The value is output in the format yyyymmddhhmmss.xxx+zz. For more information, see Standard FME Date/Time Format.

Filename (Existing and Output): Creates a parameter for choosing the name and path of an existing file, or an output file.

Filename (Multiple): Creates a parameter for choosing the name and path of multiple existing files.

Folder (Existing and Output): Creates a parameter that allows you to choose the name (and path) of an existing folder, or an output folder.

Number: Creates a parameter for entering an integer or floating point number. The number can be bounded or unbounded based on the specified Configuration.

Password: Creates a parameter for entering a password.

Scripted (Python): Creates a parameter value from a Python script (Private parameter only).

Scripted (Tcl): Creates a parameter value from a Tcl script (Private parameter only).

Text: Creates a parameter for entering a text string.

Note: Any leading or trailing white space, commas, or other common delimiters are automatically trimmed. To maintain delimiters, use Text (Multiline).

Text (Multiline): Opens an editor to enter a multi-line text string. The first line will show in the parameter but to edit the text, you must open the editor.

Note: Any leading or trailing white space is maintained.

Text (Multiline or Number): Opens a text editor for entering a multi-line text string, or an arithmetic editor for entering a number. If the Default Value field is blank or created using the text editor, then a text editor opens. If the Default Value field is created using the arithmetic editor, then an arithmetic editor opens.

URL: Creates a parameter for entering a URL.

Name

Enter a name. This will appear under the Published Parameters icon in the Navigator pane.

Published

If you uncheck this box, the parameter will be created as a Private parameter. See About Parameters.

Optional

Flagging the parameter as Optional means that an input value is not required for this parameter. If a parameter is not Optional, the workspace will not run unless the user inputs a value.

Prompt

Enter the prompt that will appear when you run the workspace.

Configuration

The parameters required in this field are dependent on the Parameter Type you choose. Click the browse button beside the parameter to see the applicable configuration choices. For example, you can:

Populate a list and the contents will be displayed in a pull-down menu when the parameter is published;
Point to a file or folder;
Import attribute values from other datasets;
Add readers, writers and coordinate systems

If Type is Filename, click the ellipsis (...) to apply filters on the filenames that can be selected. In the Edit File Filter dialog, specify the filter in the Filter field, and an optional description in the Description field. Wildcard characters and logical operators are supported in the Filter field. For example, to allow any file with a .shp extension, specify *.shp. To add or remove filters, or move filters higher or lower in the list, click the add (+), remove (-), or directional arrow symbols. To specify more than one condition in the same filter, use the OR operator; for example, *.shp OR *.dbf. To allow any file to be selected, leave this field blank.

If Type is URL, click the ellipsis (...) to specify the URL protocols that are allowed. In the Edit Valid URL Protocols dialog, http, https, and ftp are listed by default. To specify other protocols, double-click inside an empty row, type the protocol, and press enter. To add or remove protocols, select and click + or -, respectively.

Attribute Assignment

This setting controls whether the end user can select an attribute to provide values to a user parameter.

Default: When the workspace runs, FME determines if the user can specify an attribute value for the value of the user parameter, in addition to any values allowed by the user parameter Type. FME may or may not allow specifying an attribute value, depending on whether the parameter to which the attribute is connected allows this assignment.
Off: When the workspace runs, this option will not allow the user to specify an attribute value for the value of the user parameter. For example, if Type is Text, the user is limited to entering a text value.

Default Value

Choose the default value that will be used.

Edit

Select the parameter, right-click, and select Edit Value or Edit Definition.

Edit the desired fields and click the OK button.

Tip: To quickly change a value only, double-click on a parameter.

Delete

Select a parameter, right-click, and select Delete.

Apply to

Select the parameter, right-click, and select Apply to.
In the Apply Published Parameter dialog, click the checkbox next to other workspace parameters.

Tip: If you filter the list by keyword, the list will dynamically update as you enter the keyword – clicking OK will close the dialog.

Click OK to copy the published parameter to the additional selected parameters.

Converting Between Published and Private Parameters

Right-click on the parameter and select Convert To Private Parameter or Convert to Published Parameter, or
Edit the Parameter settings and uncheck the Published checkbox.

Creating and Modifying User Parameters

Add/Edit Parameter Dialog Fields

Usage Notes

Modifying User Parameters