Introduction
FME Form supports a variety of licensed, installed versions of Esri ArcMap and Esri ArcGIS Pro applications. What if a system has both Esri ArcMap and Esri ArcGIS Pro installed and licensed? How does FME Form select the appropriate Esri libraries to ensure workspace compatibility with a preferred or even necessary Esri product?
Setting Esri ArcGIS Compatibility for a Workspace
The Esri ArcGIS Compatibility workspace parameter supports systems with licensed and installed versions of both Esri ArcMap and Esri ArcGIS Pro applications. This parameter allows users to specify the Esri library requirements for their workspaces, enhancing workspace compatibility with a preferred Esri product. This parameter may be accessed from the FME Workbench Navigator window under Workspace Parameters > Spatial (Workspace Parameters > Translation in FME 2025.1 and older).
Double-click the Esri ArcGIS Compatibility parameter and, in the dialog that opens, expand the drop-down menu to reveal three options:
Auto (default) - if required, Esri ArcMap, Esri ArcGIS Pro, or equivalent must be installed and licensed on the system. This setting prefers Esri ArcMap libraries and falls back to Esri ArcGIS Pro libraries if ArcMap libraries are not found.
Esri ArcMap - Esri ArcMap or equivalent must be installed and licensed on the system.
Esri is sunsetting ArcMap in March of 2026, and ArcMap will therefore no longer be supported by FME 2026.1. As such, the ArcGIS setting will be renamed in FME Form.
- 2025.2 and older: Esri ArcMap
- 2026.1 and newer: Esri ArcGIS Server Legacy (ArcMap Compatible)
Esri ArcGIS Pro - Esri ArcGIS Pro or equivalent must be installed and licensed on the system. This setting is recommended if you are reading and/or writing ArcGIS Pro annotation features, Esri Knowledge graphs, and any other ArcGIS Pro-specific formats/features.
Alternatively, the default Esri ArcGIS Compatibility workspace parameter can be accessed from the FME Options menu, located in the Utilities menu of FME Workbench (Tools menu in 2025.1 and earlier).
Setting the parameter from FME Options to either Esri ArcMap or Esri ArcGIS Pro will change the default value in the associated Navigator parameter for all subsequent initiated workspaces. Setting the parameter from the Navigator will not affect the default value set in FME Options.
Esri ArcGIS Compatibility and Python Compatibility
There is another workspace parameter to consider when selecting your Esri ArcGIS Compatibility. The related Python Compatibility parameter controls which Python interpreter FME loads to execute user-specified Python scripts in a workspace (e.g., PythonCaller, Startup, or Shutdown Python scripts). The Python Compatibility parameter is accessible from within the FME Workbench Navigator window.
FAQs
FME Form Related
Do I have to set both the Esri ArcGIS Compatibility and the Python Compatibility Workspace Parameters?
No, it is not mandatory to set both workspace parameters. However, it is important to note that these two parameters are not completely independent of one another; the Python Compatibility parameter still offers Esri ArcGIS Python x.x options and remains linked to the behavior of Esri-related workspace elements. Where this link is important is when you want to select Esri ArcMap for your Esri ArcGIS Compatibility parameter.
If you choose a Python Compatibility option without the Esri prefix (i.e., Python 3.9+), you may choose any option for the Esri ArcGIS Compatibility parameter, including Esri ArcMap. The user-specified Python scripts in the workspace will utilize the Python interpreter set by the selected Python Compatibility parameter, and the Esri-related components of the workspace will use those settings specified by the selected Esri ArcGIS Compatibility parameter.
What happens if I select a Python Compatibility option that won’t work with my target Esri ArcGIS Compatibility option?
If you choose an Esri-prefixed option for the Python Compatibility parameter (e.g., Esri ArcGIS Python 3.7+), you will not be able to select Esri ArcMap for the Esri ArcGIS Compatibility parameter of your workspace. This is by design, to avoid Python interpreter conflicts between Esri ArcMap (which utilizes the now-deprecated Python 2.7 interpreter) and one of these Esri ArcGIS Python 3.x options. In such instances, the following dialog will be displayed:
Essentially, in specifying an Esri-prefixed Python Compatibility parameter, you are telling your workspace to apply one of the more current Python 3.x interpreters to Esri-related workspace elements. This will function as expected for Esri ArcGIS Pro-related workspace elements, as Esri ArcGIS Pro makes use of Python 3.x exclusively.
However, if you try to specify an Esri-prefixed Python Compatibility parameter as well as the Esri ArcMap option for the Esri ArcGIS Compatibility parameter, you are trying to tell your workspace to make use of two different Python interpreters (Python 3.x and Python 2.7, respectively) for Esri-related workspace elements. You will receive the warning dialog shown above, which informs you of a conflict between the two workspace parameters and suggests a way to resolve it. In general, if you want to set your Esri ArcGIS Compatibility parameter to Esri ArcMap, you must make use of a Python Compatibility option that is not Esri-prefixed to avoid Python interpreter conflicts with Esri-related workspace processes.
I have selected Esri ArcMap as my Esri ArcGIS Compatibility option, and have verified that my Python Compatibility parameter is not set to an Esri-prefixed option. Why is my workspace still showing translation errors?
Esri ArcMap is a 32-bit application. If you are attempting to use ArcMap libraries with a 64-bit version of FME Form, you must have a version of 64-bit Background Geoprocessing installed on your system that matches the version of ArcMap installed. For example, if you have ArcMap 10.6.1 installed, you must also have 64-bit Background Geoprocessing 10.6.1 (and ONLY this version) installed. Version mismatches between Esri ArcMap and 64-bit Background Geoprocessing, as well as multiple installations of 64-bit Background Geoprocessing, are often the cause of errors in FME translations involving Esri formats.
I recently upgraded FME Form, and now my ArcGIS-related translations won’t work no matter how I set my Esri ArcGIS Compatibility or Python Compatibility parameters! What might be going on?
Verify the version of ArcGIS product installed to ensure its compatibility with the upgraded version of FME Form. Please see our Notes on FME and Esri Versions and Compatibility article for more information on compatibility of Esri and FME products.
FME Flow Related
If I see error(s) in my FME Flow job logs related to Esri formats, will this new workspace parameter resolve them?
While it is possible that setting the Esri ArcGIS Compatibility workspace parameter may help, if the workspace involved is not showing errors related to Esri compatibility in FME Form, then there is likely another issue underlying the error(s) shown in the FME Flow job logs. A good place to start investigating FME Flow and Esri product compatibility issues is by reading through our Using FME Flow with Esri ArcGIS Software article.
Additional Resources
FME and Esri ArcGIS Troubleshooting Guide
Errors with FME 64-bit and ArcGIS Background Geoprocessing
FME 2021 and Python 2.7 Error - FME Community Question Thread
Note: the Python Compatibility information discussed above assumes that no custom Python interpreter is used by the workspace. In other words, the Preferred Python Interpreter setting under the Translations menu in FME Options does not specify a custom Python interpreter.