FME Form: 2025.2 BETA

Getting Started with the Transformer Designer

To start a new transformer

  1. Click New Transformer on the Start page, click New on the Toolbar, or from the menu, select File > New.
  2. In the New Transformer dialog, provide the following:
    • Package Name: The name of the FME Package containing the functionality of the transformer.
    • Transformer Name: The name of the transformer.
    • Categories: One or more categories to which the transformer belongs. Categories display in the FME Workbench Transformer Gallery and in FME Hub. Click the ellipsis (...) to select categories. (You can edit this setting later when Configuring a Transformer.)
    • Related Keywords: One or more keywords to associate with the transformer. Specify multiple keywords with a space. To enter keywords that are properly delineated, click the ellipsis (...). (You can edit this setting later when Configuring a Transformer.)
    • Classification: This setting is used to classify the transformer when Controlling Search Results during Quick Add.
      • Neither Source nor Destination: The transformer does not read data from a source external to FME Workbench or write data to a destination external to FME Workbench.
      • Source: The transformer reads data from a source external to FME Workbench.
      • Destination: The transformer writes data to a destination external to FME Workbench.
      • Both Source and Destination: The transformer reads data from a source external to FME Workbench and writes data to a destination external to FME Workbench.
      • Based on Parameter Value: Classification depends on the value of a transformer parameter. After creating the transformer, you can define the parameter and configure the classification requirements when Configuring a Transformer.
    • Data Caching: This setting is not functional in this version of FME Transformer Designer.
    • Decoration Icon: If Classification is anything other than Neither Source nor Destination, you can specify which icon displays on the side of the transformer.
    • Note  If Classification is Destination, an icon displays on the right side of the transformer. For all other classifications, an icon displays on the left.
    • Historical Names: One or more names of the transformer to reference as aliases. Specify multiple names with a space. To enter names that are properly delineated, click the ellipsis (...). (You can edit this setting later when Configuring a Transformer.)
  3. Click OK. The Transformer Designer interface opens. Proceed to Configuring a Transformer.

To edit an existing transformer

Open a .fmx or .fmxj file from the recent files list on the Start page. Alternatively, drag and drop a file onto the Start page, click Open on the toolbar, or from the menu, select File > Open. If you open a .fmx file, you must agree to convert the file to a new .fmxj file before proceeding.

The file opens to the Transformer Designer interface. From here, you can proceed to:

Saving a Transformer

The FME Transformer Designer creates .fmxj files, which capture the transformer interface and can be read by FME Workbench.

Refer to the Package project structure documentation in the FME Packages SDK Guide for details on where to store the .fmxj within an FME Package.

Click Save on the toolbar, or from the File menu, select Save or Save As.

Sharing a Transformer to a Shared Directory

You can save a transformer to a shared directory that is accessible from FME Workbench, outside of the package. This approach is useful if you want to test the transformer interface in FME Workbench before saving it with the package.

  1. From the Utilities menu, select FME Options > Default Paths.
  2. Under Shared FME Folders, add your desired storage path. For more information, see Shared FME Folders.
  3. Save the .fmxj file to the Transformers directory within the path.
  4. In the FME Workbench Transformer Gallery, click the Reload button to force FME Workbench to update the fmxj file. The changes will only reflect on any new instances of transformers added in FME Workbench.