Marpforce service V2

MapForce Service Version 2

The MapForce Service Versoin 2 is a service in which a MapForce generated mapping can be loaded. The result of the service is the result of applying the mapping on the configured MessagePart.

You can upload a mapping by pressing the upload-button , located next to the Mapping Classname attribute. You will get the pop-up below to select a zip file with the MapForce Java source.

Drop your MapForce zip file in the box to upload it to ConnectPlaza.

MapForce Java sources you upload using the description above, are compiled in the background: In the zip-file is a Java source code which can be generated by MapForce. This will be transformed to Java byte code by ConnectPlaza.

After uploading your .zip file the resources will show you the functions in the mapforce.jar we just uploaded via the .zip file. You can select these functions and drag them to your Mapping Classname field if you like.

In the table below, you will find an explanation of these properties. All attributes with a ‘*’ are mandatory.

Attribute

Description

Name*

By default, we fill this out with the technical ‘tag’, followed by a serial number. Changing the name is optional.

Enabled

Set this value to true, if you want this service to be enabled.

Run Class Name

Name of the class to run when using Mapforce mappings.

Input-Mapping

Input function for the input message part. There can be more than 1 inputs in your MapForce. Here the software displays the input parameter name, match in this box the message part you want to use. 

Output-Mapping

Here you can select the message part to use for this specific output. You can also set the type for this output message part. 

If you have multiple outputs in your MapForce, you will notice that you have multiple Classes you can add via the Run Class Name. The service can only have one output, if you want to use both Classes to get multiple outcomes, you have to 2 MapForce Services. 

 

Using Mapforce

If you are using Altova's MapForce, always check if your process has at least one entry as input and at least one entry as an output. This output cannot be a single String value as in this MapForce Example

You cannot have any output to a databases or other external files within your MapForce mapping. This is not supported by ConnectPlaza. Your zip-file will not upload or your connector will not work at all.