Dynamically specifying maps at runtime

At run time, you can override the compiled map that you specified in the WTX Map service with a compiled map that is specified in process data.

A business process can derive either the map name or the map itself from process data. For example, the /ProcessData/here document can contain the name of another ProcessData document, /ProcessData/there:
/ProcessData/here="ProcessData/there"
/ProcessData/there="hello"
  • When /ProcessData/here is used as an XPATH expression, it resolves to hello.
  • When /ProcessData/here is not used as an XPATH expression, it resolves to /ProcessData/there.
A business process searches for the map to execute in this order:
  1. A map from a document

    A compiled map can be stored in process data and passed to the WTX Map service.

    Source
    Process data
    Location
    A document called dynamicMap
    Purpose
    To run the compiled map that is supplied as an array of bytes in the process data.
    Result
    The WTX Map service runs the supplied map.

    Storing large maps in the dynamicMap property can affect performance and memory usage. In general, write a large map to disk and reference it from the MapServerLocation property.

  2. A map in the Sterling B2B Integrator repository
    Source
    WTX Map service
    Location
    /ProcessData/MapName
    Purpose
    To run a compiled map that is stored in the Sterling B2B Integrator Map Repository.
    Result
    The specified map runs, unless it is overridden by MapServerLocation or dynamicMap.
  3. A map from a file system on the Sterling B2B Integrator server
    At runtime, override the map server location with the map server location that was placed in the process data by a prior service in the business process:
    Source
    The file system

    Location
    /ProcessData/MapServerLocation
    Purpose
    To run a compiled map that is in a location other than the location that is configured on the WTX Map service.
    Result
    The Sterling B2B Integrator business process overrides the map server location with the location that you specified in the process data, and the WTX Map service runs the map from this location instead.

To specify a map in the map repository, omit the file extension from the MapName. To specify a map in the file system on the server, include the file extension in the map name.

When a map name includes a file extension, IBM Transformation Extender for Sterling B2B Integrator searches for the map on the file system of the Sterling B2B Integrator server. If the map is not in the file system, IBM Transformation Extender for Sterling B2B Integrator strips the file extension from the map name and searches for the map name in the Sterling B2B Integrator map repository.

When a map name omits a file extension, IBM Transformation Extender for Sterling B2B Integrator searches the map repository first, then searches the file system.

For more information about process data, see the Sterling B2B Integrator documentation.