Please enable JavaScript to view this site.

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

 

gui_mf_pro_ent

MapForce graphical user interface (MapForce Professional 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.

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

 

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.

gui_project_window

 

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.

dlg_xslt_code_folding

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.

gui_dbquery_pane

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.

gui_output_pane

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 (https://www.altova.com/stylevision.html), 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.

tab_overview

 

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

tab_messages

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:

 

Icon

Description

valid_ok

Operation completed successfully.

validate_wf

Operation completed with warnings.

validate_bad

Operation has failed.

 

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

 

Icon

Description

_ic_validator_info

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

_ic_validator_warning

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.

_ic_validator_error

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:

 

Icon

Description

_ic_msg_filter

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.

_ic_msg_next

Jump to next line.

_ic_msg_prev

Jump to previous line.

_ic_msg_clipboard

Copy the selected line to clipboard.

_ic_msg_clipboard_children

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

_ic_msg_clipboard_all

Copy the full contents of the Messages window to clipboard.

_ic_msg_find

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.

_ic_msg_find_next

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

_ic_msg_find_prev

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

_ic_msg_clear

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