Please enable JavaScript to view this site.

Altova MapForce 2021 Professional Edition

Altova Global Resources > Global Resources in Various Execution Environments

Global Resources in MapForce Server

Scroll Home Prev Top Next More

When you compile a mapping to a MapForce Server execution file (.mfx), any Global Resource references used by the mapping are preserved, not resolved. This means that you will need to provide these references on the server side in order to run the mapping successfully. More specifically, in MapForce Server, the following is required to run an .mfx file which uses Global Resources:


1.The Global Resource XML file. On the machine where MapForce is installed, the file is called GlobalResources.xml, and you can find it in the Documents\Altova folder. You can copy this file to the machine where MapForce Server runs, and you can also create multiple such files if necessary. See also The Global Resources XML File.

2.The Global Resource configuration name. Each Global Resource has a default configuration called "Default", but you can create additional configurations if so required. If you created additional configurations as explained in Creating Global Resources, then you must specify the desired configuration name instead of "Default".


In MapForce, the Global Resource file path and the Global Resource configuration name are set or changed from the graphical user interface. In MapForce Server, these are specified at mapping runtime.


If you run the mapping through the command line interface, set the options --globalresourceconfig and --globalresourcefile after the run command, for example:


C:\Program Files (x86)\Altova\MapForceServer2021\bin\MapForceServer.exe run SomeMapping.mfx --globalresourcefile="C:\Users\me\Documents\Altova\GlobalResources.xml" --globalresourceconfig="Default"


If you run the mapping through the MapForce Server API, call the method SetOptions two times before calling the Run method. The first call is required to supply the Global Resource XML file path as option, and the second one is required to supply the Global Resource configuration name.


For more information, refer to the MapForce Server documentation (

© 2020 Altova GmbH