Introduction
All good things must come to an end, and FME Hub transformers are no different. To ensure that your transformer is the most up-to-date and useful for other users, it may need to be deprecated.
Step-by-step Instructions
1. Confirm FME Version
The FME version will need to be the same version that the transformer will be deprecated in. For example, a custom transformer uses the RasterObjectDetector transformer, which was deprecated in FME 2024.0. The custom transformer will need to be deprecated using FME 2024.0.
2. Download Transformer
Log into FME Hub and go to the transformer’s page. Click the Download button.
You can only deprecate custom transformers from a publisher that you have upload permissions for.
3. Open .fmx in FME
Open the transformer’s .fmx file in the version of FME you wish to deprecate it in.
In the Select Transformer Version dialog, ensure Create New Version is enabled, then click OK.
4. Set Deprecated Parameter
In the Navigator, expand Transformer Parameters > General, then double-click on Deprecated to open the parameters.
- Deprecated: Yes
5. Update Overview and History
As best practice, it is advised to update the transformer’s Overview and History about any replacements and who/why the transformer was deprecated.
Double-click on Overview in the Navigator to open the parameters.
For this example:
The AdvancedSorter has been deprecated in FME 2025.1 and replaced by the built-in Sorter. The 2025.1 Sorter has been upgraded to include an additional parameter called Sorting Exceptions, which handles null/missing/empty values.
Next, switch to the History tab and enter the following:
- Name: <your name>
- Date: <current date>
- Description: <reason the transformer was deprecated>
There is a known issue affecting versions. Before saving your transformer, confirm that the transformer is the correct version. See Known Issue: Custom Transformer Version Resetting to Version 1 for more details.
6. Save the Transformer
Once all of the parameters have been set, save the transformer.
7. Upload to FME Hub
Back in FME Hub, on the transformer page, click the Actions drop-down and select Edit Item.
On the Item Draft page, next to the transformer fmx, click the three dots and select Upload New Version.
In the Upload New Item dialog, browse to the newly saved .fmx, then click Upload Item.
After uploading, click Preview. Confirm the following:
- The FME Version is correct.
- The transformer version is correct.
- A Deprecation banner appears at the top of the page.
At the bottom of the Edit Item page, click Publish. Then in the pop-up dialog, click Publish again.
Additional Resources
FME Hub Transformer Deprecations
Working with Deprecated Custom Transformers