FME Form: 2024.1
Exporting Custom Transformers
The best way to share a transformer is to export it and distribute it just like any other file.
Transformer files are saved as .fmx
files in the following default locations:
- Windows:
C:\Users\<user>\Documents\FME\Transformers
- Linux: ~/.fme/Transformers
- OSX: ~/Library/Application Support/FME/Transformers
You can change the default location.
Export as Custom Transformer
- Open or create a custom transformer.
- On the workspace canvas, click the tab that contains the custom transformer.
- Select File > Export as Custom Transformer.
The Export as Custom Transformer dialog opens.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Use the default name that appears in this field, or type a new name. If you specify a duplicate name, you will be prompted to confirm the file replacement.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
You can assign an existing category to the transformer, create a new one, or leave the field blank. If you leave the field blank, the transformer will be listed only in the All category of the Transformer Gallery.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
The insert mode for the transformer determines how it is used in the workspace. When a transformer is embedded in a workspace, all of its properties are also copied to the workspace. However, you can also choose to link to the transformer, which is useful if you frequently update the transformer and you use it in many different workspaces. You can always change the default insert behavior after the custom transformer is exported. For more information, see Embedding or Linking a Custom Transformer.
Linked by Default: The default insert mode is Linked but you can still Embed the transformer.
Linked Always: If the transformer will be frequently updated, you might want to select this option so that updates in a shared folder can be more easily controlled.
Embedded by Default: The default insert mode is Embedded but you can still choose to Link the transformer.
Embedded Always: The transformer will be embedded into the workspace. This option is useful if the transformer is not part of a larger workflow, and will not be shared or reused.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
(Optional) Enter a password that users must provide before they can use the custom transformer.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
You might want to change the location for sharing purposes but to use the transformer in a workspace, it must reside in the default location.
After defining the parameters for the exported transformer, click the OK button in the Export as Custom Transformer dialog.
What can I do after I export a Custom Transformer?
- Select a linked transformer from the Transformer Gallery, and include it any number of times.
- Share it with other users.
- Create multiple versions of a linked transformer.
See also