Try OpenEdge Now
skip to main content
Managed Adapters Guide
Understanding the Managed Adapter framework : Framework components : File formats used in the Managed Adapter framework : input.map and output.map
 
input.map and output.map
These two files are used to store the input and output maps for an adapter.

Location

The files are located in the <Process_Directory>\maps\<WS_Name> directory.

Important note

The information in this section is given as a reference only. Neither Application Users nor Adapter Developers are expected to directly manipulate the mapping files.

Usage notes

Adapters introduced after Business Process Server 6.0 store the input and output map files in XML. Business Process Server versions prior to 6.0 stored this mapping data as a property file. Typically, the new map configurator (com.savvion.sbm.adapters.framework.GroupMapConfigurator) generates XML files, while the simpler one-tab map configurator (com.savvion.sbm.adapters.framework.TwoWayMapConfigurator) generates property files. Because both formats are supported by the run-time mapper, you can use either of the map configurators for custom adapters.

Property Map format

The format generated by the simpler one-tab map configurator is presented below (for the XML map format, see XML Map format):
*Input Map
AdapterParameterName=java_type:value...
*Input Map (XML Format)
<map version="1.1">
<param name="<AdapterParameterName>" type="
<java_type:value> " value=" " OR @<DSNAME> />
...
</map>
*Output Map
DataslotName=java_type:value...
*Output Map (XML Format)
<map version="1.1">
<param name="<AdapterParameterName>" type="
<java_type:value> " value=" "OR @<DSNAME> />
...
</map>

Adapter maps

The maps are explained in the following table.
Table 4. Adapter Maps
Map parameter
Description
AdapterParameterName
The name of an adapter parameter, whose value is set by the mapper. The adapter parameter should be of type "I", "IO", or "C".
DataslotName
The name of a dataslot, whose value is set by the mapper. The dataslot should be output or input/output for the workstep.
java_type
The Java data type, to which the data should be converted before setting the adapter parameter.
value
The value received from the dataslot or the output value as transferred to the dataslot.

ConfigForm example

The following example of the ConfigForm generates the input/output maps as shown in Figure 2.
<configform synchronous="true" version="1.3">
    <block title="Adapter Data" label="Configure input and output Excel
        cells" hidden="false">
            <param name="A10" access="I" label="A10"
                type="java.lang.Object" value=""/>
            <param name="Sheet2_B3" access="O" label="Sheet2_B3"
                type="java.lang.Object" value=""/>
    </block>
    <block title="Configuration" label="Specify the workbook and default
        worksheet" hidden="false">
            <param name="WORKBOOK" access="PRESET" label="Workbook"
                type="java.lang.String" value="D:\\new1.xls"/>
            <param name="WORKSHEET" access="PRESET" label="Default                 worksheet" type="java.lang.String" value="Sheet1"/>
            <param name="WORK_DIRECTORY" access="PRESET" label="Working                 directory" type="java.lang.String" value="D:\\temp"/>
            <param name="INPUTS" access="HIDDEN" label="Input cells list"
                type="java.lang.String" value="A10"/>
            <param name="OUTPUTS" access="HIDDEN" label="Output cells
                list" type="java.lang.String" value="Sheet2!B3"/>
    </block>
</configform>

Input mapping

The input dataslot mapping is as follows.
Price=java.lang.Object:@AskingPrice
VAT=java.lang.Object:0.08
WORKBOOK=java.lang.String:M:\\conf\\VAT.xls
WORKSHEET=java.lang.String:Sheet1
INPUTS=java.lang.String:Price=A1,VAT=B1
OUTPUTS=java.lang.String:Price=C1

Output mapping

The output mapping from the adapter is provided below.
UpdatedPrice=java.lang.Double:@Price

XML Map format

As mentioned before, the Managed Adapters in the current release use XML files to store the mapping data. The file names and locations are the same as prior releases, but the XML content is in the following format:
*Input Map
<map version="1.1">
<param name="INPUTS" type="java.lang.String" value="A10"/>
<param name="OUTPUTS" type="java.lang.String" value="Sheet2!B3"/>
<param name="WORKSHEET" type="java.lang.String" value="Sheet1"/>
<param name="WORKBOOK" type="java.lang.String" value="D:\\new1.xls"/>
<param name="A10" type="java.lang.Object" value="@dsin"/>
<param name="WORK_DIRECTORY" type="java.lang.String" value="D:\\temp"/></map>
*Output Map
<map version="1.1">
<param name="dsout" type="java.lang.String" value="@Sheet2_B3"/>
</map>