Please enable JavaScript to view this site.

Altova MapForce 2021 Professional Edition

The graphical user interface of MapForce is organized as an integrated development environment. The main interface components are illustrated below. You can change the interface settings by using the menu command Tools | Customize.


Use the gui_window_buttons buttons displayed in the upper-right corner of each window to show, hide, pin, or dock it. If you need to restore toolbars and windows to their default state, use the menu command Tools | Restore Toolbars and Windows.


The image below illustrates the main parts of the MapForce graphical user interface .



Menu Bar and Toolbars

The Menu Bar displays the menu items. Each toolbar displays a group of buttons representing MapForce commands. You can reposition the toolbars by dragging their handles to the desired locations.


Libraries window

The Libraries window lists the MapForce built-in functions, organized by library. The list of available functions changes based on the transformation language you select either from the Output menu or from the Language Selection toolbar, see also Selecting a Transformation Language. If you have created user-defined functions, or if you imported external libraries, they also appear in the Libraries window.


To search functions by name or by description, enter the search value in the text box at the bottom of the Libraries window. To find all occurrences of a function (within the currently active mapping), right-click the function, and select Find All Calls from the context menu. You can also view the function data type and description directly from the Libraries window. For more information, see Functions.


Manage Libraries window

From this window you can view and manage all user-defined functions (UDFs) and imported custom libraries (including compiled Java .class files and .NET DLL assembly files) that are used by currently open mappings.


By default, the Manage Libraries window is not visible. To display it, do one of the following:


On the View menu, click Manage Libraries.

Click Add/Remove Libraries at the base of the Libraries window.


You can choose to view UDFs and libraries only for the mapping document (.mfd file) that is currently in focus (active), or for all open mapping documents. To view imported functions and libraries for all of the currently open mapping documents, right-click inside the window and select Show Open Documents from the context menu.


To display the path of the open mapping document instead of the name, right-click inside the window and select Show File Paths from the context menu.


For more information, see Managing Function Libraries.


Project window

MapForce supports the Multiple Document Interface, and allows you to group your mappings into mapping projects. The Project window shows all files and folders that have been added to the project. Project files have the extension *.mfp (MapForce Project). To search for mappings inside projects, click anywhere inside the Projects window, and press CTRL + F. For more information, see Working with Mapping Projects.



Mapping pane

The Mapping pane is the working area where you design mappings. You can add mapping components (such as files, schemas, constants, variables, and so on) to the mapping area from the Insert menu, see Adding Components to the Mapping. You can also drag functions from the Libraries window into the Mapping pane, see Adding Functions to the Mapping.


XSLT pane

The XSLT pane displays the XSLT transformation code generated from your mapping. To switch to this pane, select XSLT, XSLT 2 or XSLT3 as transformation language, and then click the tab with the same name.


This pane provides line numbering and code folding functionality. To expand or collapse portions of code, click the "+" and "-" icons at the left side of the window. Any portions of collapsed code are displayed with an ellipsis symbol. To preview the collapsed code without expanding it, move the mouse cursor over the ellipsis. This opens a tooltip that displays the code being previewed, as shown in the image below. Note that, if the previewed text is too big to fit in the tooltip, an additional ellipsis appears at the end of the tooltip.


To configure the display settings (including indentation, end of line markers, and others), right-click the pane, and select Text View Settings from the context menu. Alternatively, click the Text View Settings ic_text_view_settings toolbar button.


XQuery pane

The XQuery pane displays the XQuery transformation code generated from your mapping, when you click the XQuery button. This pane is available when you select XQuery as transformation language. This pane also provides line numbering and code folding functionality, which works in a similar way as in the XSLT pane (see above).


DB Query pane

The DB Query pane allows you to directly query any major database. You can work with multiple active connections to different databases.


For more information, see Browsing and Querying Databases.


Output pane

The Output pane displays the result of the mapping transformation (for example, an XML file), when you click the Output button. If the mapping generates multiple files, you can navigate sequentially through each generated file.


This pane also provides line numbering and code folding functionality, which works in a similar way as in the XSLT pane (see above).


StyleVision Output buttons

If you have installed Altova StyleVision (, the StyleVision output buttons enable you to preview and save the mapping output in HTML, RTF, PDF, and Word 2007+ formats. This is possible by means of StyleVision Power Stylesheet (SPS) files designed in StyleVision and assigned to a mapping component in MapForce.


Overview window

The Overview window gives a bird's-eye view of the Mapping pane. Use it to navigate quickly to a particular location on the mapping area when the size of the mapping is very large. To navigate to a particular location on the mapping, click and drag the red rectangle.



Messages window

The Messages window shows messages, errors, and warnings when you preview or validate a mapping.


To highlight on the mapping area the component or structure which triggered the information, warning, or error message, click the underlined text in the Messages window.


The results of a mapping execution or validation operation is displayed in the Messages window with one of the following status icons:





Operation completed successfully.


Operation completed with warnings.


Operation has failed.


The Message window may additionally display any of the following message types: information messages, warnings, and errors.





Denotes an information message. Information messages do not stop the mapping execution.


Denotes a warning message. Warnings do not stop the mapping execution. They may be generated, for example, when you do not create connections to some mandatory input connectors. In such cases, output will still be generated for those component where valid connections exist.


Denotes an error. When an error occurs, the mapping execution fails, and no output is generated. The preview of the XSLT or XQuery code is also not possible.


Other buttons in the Messages window enable you to take the following actions:





Filter messages by severity (information messages, errors, warnings). Select Check All to include all severity levels (this is the default behaviour).


Select Uncheck All to remove all severity levels from the filter. In this case, only the general execution or validation status message is displayed.


Jump to next line.


Jump to previous line.


Copy the selected line to clipboard.


Copy the selected line to clipboard, including any lines nested under it.


Copy the full contents of the Messages window to clipboard.


Find a specific text in the Messages window. Optionally, to find only words, select Match whole word only. To find text while preserving the upper or lower case, select Match case.


Find a specific text starting from the currently selected line up to the end.


Find a specific text starting from the currently selected line up to the beginning.


Clear the Messages window.


When you work with multiple mapping files simultaneously, you might want to display information, warning, or error messages in individual tabs for each mapping. In this case, click the numbered tabs available on the left side of the Messages window before executing or validating the mapping.


Application status bar

The application status bar appears at the bottom of the application window, and shows application-level information. The most useful of this information are the tooltips that are displayed here when you move the mouse over a toolbar button. If you are using the 64-bit version of MapForce, the application name appears in the status bar with the suffix (x64). There is no suffix for the 32-bit version.

© 2015-2021 Altova GmbH