Please enable JavaScript to view this site.

Altova MapForce 2020 Enterprise Edition

Designing Mappings

Supplying Parameters to the Mapping

Scroll Home Prev Top Next More

You can pass simple values to a mapping by means of simple input components. On the mapping area, simple input components play the role of a source component which has a simple data type (for example, string, integer, and so on) instead of a structure of items and sequences. Consequently, you can create a simple input component instead of (or in addition to) a file-based source component.


You can use simple input components in any the following MapForce transformation languages:


BUILT-IN (when you preview the mapping transformation directly in MapForce, from the Preview tab)

BUILT-IN (when you run a compiled MapForce Server execution file)

XSLT 1.0, XSLT 2.0






In case of mappings executed with MapForce Server or by means of generated code, simple input components become command line parameters. In case of mappings generated as XSLT transformations, simple input components correspond to stylesheet parameters in the generated XSLT file.


You can create each simple input component (or parameter) as optional or mandatory (see Input Component Settings). If necessary, you can also create default values for the mapping input parameters (see Creating a Default Input Value). This enables you to safely run the mapping even if you do not explicitly supply a parameter value at mapping execution time.


Input parameters added on the main mapping area should not be confused with input parameters in user-defined functions (see User-Defined Functions). There are some similarities and differences between the two, as follows.


Input parameters on the mapping

Input parameters of user-defined functions

Added from Function | Insert Input menu.

Added from Function | Insert Input menu.

Can have simple data types (string, integer, and so on).

Can have simple as well as complex data types.

Applicable to the entire mapping.

Applicable only in the context of the function in which they were defined.


When you create a reversed mapping (using the menu command Tools | Create Reversed Mapping), a simple input component becomes a simple output component.


For an example, see Example: Using File Names as Mapping Parameters.

© 2020 Altova GmbH