xBus

standard.conf
Transformation

The parameters from this section configure the transformation of one data structure into another before sending it to a destination system or after receiving a response. Default transformers are defined for each applicable pair of message types. But those values may be overwritten for a concrete pair of interfacing systems.

Note that all parameters for the transformation have the configurable "Section" and "Key" in their keywords:

  • the logical names from the source and destination systems accordingly and the nmessage function for the source system.

system-specific    optional

chapter section key example
Transformer source system.function destination system Transformer_StockCheckAutolineRequest.Default_StockCheckAutolineResponse=CloneTransformer

To create the appropriate Transformer object, which is needed to transform the received data into the format needed for sending it to the destination, the class name will be read from the xbus.conf. All used short names for the Transformer classes must be defined in the xBus configuration.

This parameter specifies the short name of the suitable transformer for transformation from the source system processing the message function to the destination system.

The parameter is optional because usually the transformer is chosen by the corresponding global parameter based on the involved messages. Only deviations from the default have to be specified explicitely.

The following parameter is needed for the RecordTypeTransfomer and the XSLTTransformer.


system-specific    optional

chapter section key example
XSLTStylesheet source
system name
destination
system name
XSLTStylesheet_PartsOrderAutoline_PartsOrderIMPHDL=PO_AL2IHL.xsl

It is only necessary for the RecordTypeTransfomer and the XSLTTransformer, which perform transformations by application of a XSL style sheet to the internally used DOM tree of the source data.

This parameter specifies which style sheet to choose for it. Only the name of the XSL file (without path) is expected as value. All style sheets are stored in the directory XBUS_HOME/etc/xsl (where XBUS_HOME is the xBus home directory).
Information about its structure for RecordTypeMessages are listed in the section XSL transformation style sheets.

Note that this parameter is system-specific and must be defined for each pair of the systems (receiver-sender) only if one of the two mentioned transformers is used.
This is especially the default case if Message=RecordTypeMessage was configured in the System definitions for both systems.


system-specific    optional

chapter section key example
TransformInput source
system name
destination
system name
TransformInput_WarrantyClaimsAutoline_WarrantyClaimsGIS=Object

Before applying the transformation the content will be read from the source message. This is done by using the default type of the message. Sometimes this default type may be not convenient if a message can be used in different ways.

This parameter specifies which message type is used for extracting the content from the source message.