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 : and and
These two files are used to store the input and output maps for an adapter.


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
*Input Map (XML Format)
<map version="1.1">
<param name="<AdapterParameterName>" type="
<java_type:value> " value=" " OR @<DSNAME> />
*Output Map
*Output Map (XML Format)
<map version="1.1">
<param name="<AdapterParameterName>" type="
<java_type:value> " value=" "OR @<DSNAME> />

Adapter maps

The maps are explained in the following table.
Table 4. Adapter Maps
Map parameter
The name of an adapter parameter, whose value is set by the mapper. The adapter parameter should be of type "I", "IO", or "C".
The name of a dataslot, whose value is set by the mapper. The dataslot should be output or input/output for the workstep.
The Java data type, to which the data should be converted before setting the adapter parameter.
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 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"/>

Input mapping

The input dataslot mapping is as follows.

Output mapping

The output mapping from the adapter is provided below.

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"/>