Namespaces management of the WrapSoap function component

Technote (troubleshooting)


It is not possible to insert a body content which is namespace qualified but without the usage of a prefix (default namespace approach: xmlns="..").


The WrapSoap function component does not correctly handle SOAP body contents including elements defined in a namespace which are not prefix-qualified. Indeed in such cases it generates a prefix for the user-defined namespace and uses it to qualify the body elements defined in the namespace.

For example, for body content:

<MyRequest xmlns="">

the WrapSoap function component produces the following soap message:

<soap:Envelope xmlns:soapenv="" xmlns:xsd="" xmlns:xsi="" xmlns:soap="">
<ns1:MyRequest xmlns="" xmlns:ns1="">

on which the prefix "ns1" has been generated instead of the unnamed prefix used in the passed soap content. That is:

original: <MyRequest xmlns="">

generated: <ns1:MyRequest xmlns="" xmlns:ns1="">

In the generated SOAP message, the namespace "" is defined twice, since the original definition included in the body content in input is actually duplicated though the definition of the "ns1" prefix. Moreover the elements in the namespace are qualified with the attribute "ns1" (this might not be desired, since in the original message the user defines the element in the namespace as not prefix-qualified).
The final SOAP envelope is still well formed and the body is semantically equivalent to the one passed as input, but it is not in the form that user wanted (not prefix-qualified elements in the namespace).


The issue originated within the Axis library used by the WrapSoap function component and so it cannot be removed by fixing the ITDI code.

Resolving the problem

The simplest way to work around this limitation is adding the following declaration


to the "Namespace declarations to add to the SOAP Envelope" function component parameter.
It is formally incorrect (note :=), but the final result is to define the empty string prefix for the namespace in subject (instead of the generated "ns1") which, in turn, leads to the removal of the unwanted prefix being generated.

Rate this page:

(0 users)Average rating

Add comments

Document information

More support for:

IBM Security Directory Integrator

Software version:


Operating system(s):

All Platforms

Software edition:

All Editions

Reference #:


Modified date:


Translate my page

Machine Translation

Content navigation