Please enable JavaScript to view this site.

Altova MapForce 2020 Basic 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.


MapForce graphical user interface (MapForce Basic Edition)


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. 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 Working with Functions.


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 into the Mapping pane functions displayed in the Libraries window (see Working with Functions).


XSLT (XSLT2) pane

The XSLT (or XSLT2) pane displays the XSLT 1.0 (or 2.0) transformation code generated from your mapping. To switch to this pane, select XSLT (or XSLT 2) as transformation language, and then click the XSLT tab (or XSLT2 tab, respectively).


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.


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).


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 execute a mapping (see Previewing the Output ) or perform a mapping validation (see Validating Mappings ).


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.

© 2019 Altova GmbH