transformmap.xml

The transformmap.xml file is a custom configuration file in transformation projects used to define transformation processes. This wiki page describes the format of this configuration file as well as each of the attributes. For a more in-depth view, the transformmap schema can be found in the src directory of the TransformSL module.

default namespace transformmap = "http://xml.netbeans.org/schema/transformmap"

start = 
    element transformmap {
        service*
    }

    element service {
        attribute partnerLinkType { xsd:QName },
        attribute roleName { xsd:string },
        operation*
    }

    element operation {
        attribute opName { xsd:string },
        attribute inputVariable { xsd:string },
        attribute outputVariable { xsd:string },
        ( transform | invoke )+
    }

    element invoke {
        attribute partnerLinkType { xsd:QName },
        attribute roleName { xsd:string },
        attribute opName { xsd:string },
        attribute inputVariable { xsd:string },
        attribute outputVariable { xsd:string }
    }

    element transform {
        attribute file { xsd:string },
        attribute source { xsd:string },
        attribute result { xsd:string },
        param*
    }

    element param {
        attribute name { xsd:string },
        attribute type { xsd:string },
        attribute value { xsd:string },
        ( (element* { text }) | text)?
    }

Transformmap Elements

Element	Description
service	Represents the implementation of a service, identified by partnerLinkType and role.
operation	An operation element maps directly to a transformation process, meaning all children of this element are activities of the defined process. The process is the implementation of this operation provided by this service.
invoke	Declares the invocation of a service endpoint. An invoke is semantically similar to an operation, except that the operation element represents a provisioned endpoint whereas the invoke is a consumed endpoint.
transform	Represents the application of a transformation, such as an XSL stylesheet.
param	Specifies the runtime value of a transformation parameter. Any child elements of a param is considered to be the literal value of the parameter; correspondingly the "type" attribute should be "literal" if such child elements are present. Please see the TransformSL Param wiki page for more details on parameters.

Transformmap Attributes

Attribute	Required	Description
partnerLinkType	Y	The name of an endpoint's partnerLinkType, as defined in the wsdl.
roleName	Y	The name of the role mapped to the endpoint's portType in the wsdl.
opName	Y	operation: The name of the operation this process is implementing. invoke: The name of the operation to invoke.
inputVariable	N	The variable name for the input message. For operation, this is the message that initiates the process. For invoke, this is the message sent to the invoked endpoint. This value of this attribute defaults to the message definition name as defined in the WSDL.
outputVariable	N	The variable name for the output message. For operation, this is the message sent back to the consumer of this process' endpoint. For invoke, this is the message (or status) received from the invoked endpoint. This value of this attribute defaults to the message definition name as defined in the WSDL.
file	N	The transformation file to apply, such as an XSL stylesheet. If this attribute is absent, a pass-through transformation will be applied.
source	Y	The variable reference to the XML content to be transformed.
result	Y	The variable reference to which the transformation output is assigned.
name	Y	The parameter name.
type	Y	The parameter type, which MUST be one of the following values: "uri", "literal", "part". Please see TransformSL Param wiki page for more details on parameters.
value	N	For "uri" parameters, this is the file from which the parameter value is read. For "part" parameters, this MUST be a variable reference pointing to a message part to use as the parameter value. This attribute may be absent for parameter type "literal".

Backwards Compatibility

The following attributes are legal ONLY to support prior versions of transformmap, meaning these attributes should NOT be used going forward. When appearing in an operation or invoke element, an implicit transformation is defined and applied to the first (or only) part of the most recent incoming message.

file	N	The stylesheet to apply to the most recent incoming message. For operation, this is the message that initiated the process. For invoke, this is the message received as a reply from invoked endpoint.
transformJBI	N	To support multiple-part WSDL 1.1 message definitions, the JBI specification defines a message wrapper in section 5.5.1.1.4. Since the XsltSE does not lend itself to transforming multiple message parts, it supports the transformation of the entire JBI message wrapper. To enable this transformation, the 'transformJBI' attribute must be set to true; the default value is false. If this attribute is true, the XSL stylesheet MUST be capable of transforming the entire JBI message wrapper element.

This page (revision-2) was last changed on 19-Jul-07 14:14 PM, -0700 by KevanSimpson.
This page was created on 16-Jul-07 16:39 PM, -0700 by KevanSimpson.

More info...