You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.
Two types of communication protocols are supported: SOAP 1.1 and REST. For the communication HTTP is used. If you want to use something else like JMS, you can create custom code which sends the SOAP message over JMS instead of HTTP.
Blueriq supports the WSDL 1.1 standard. It consists of service, binding, portType, message and type definitions. There are additional restrictions on the WSDL files:
- A WSDL file may only contain 1 service, 1 binding and 1 portType definition. If you need more of these elements, create a separate WSDL files and import them separately.
- The communication may only be done in document/literal style. Other styles are not supported.
- For the elements and data types used in the schema only the namespace http://www.w3.org/2001/XMLSchema is supported.
- WSDL:Fault messages are currently not supported, they are ignored.
- Chameleon Schemas not supported (http://www.xfront.com/ZeroOneOrManyNamespaces.html)
- For SimpleType Restrictions only the baseType is used. Restrictions on the domain are ignored (For example: <xs:maxInclusive value=“100”/> for a simpleType with base integer.)
- When you have multiple files, you have to zip them.
- No folders are allowed in ZIP files, they need to be 'flat'
- WS-Addressing is ignored (http://www.w3.org/Submission/ws-addressing/)
- The webservice has to be in the entry point module, or a mapping has to be made between the entrypoint module and the webservice module.
- When using AAAS, the WSDL should be WSI BP 1.2 compliant (http://ws-i.org/profiles/BasicProfile-1.2-2010-11-09.html).
- Only XML communication is supported with REST services.
- Empty fields in a message (example: <Number></Number>) are parsed as unknown. The exception are string fields. Those are parsed as empty string (””).
- Substitution Groups
- WS-SecurityPolicy is ignored (http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/)
The following table shows items that you can encounter in a WSDL/XSD and if we support them. An entry with 'Yes' is actively used, while entries which are 'Ignored' can be present in your WSDL/XSD, but nothing is done with them.
XSD element | Supported |
---|---|
all | Yes |
annotation | Ignored |
any | Yes, treated as String |
anyAttribute | Yes, treated as String |
appInfo | Ignored |
attribute | Yes |
attributeGroup | Yes |
choice | Yes |
complexContent | Yes |
complexType | Yes |
documentation | Ignored |
element | Yes |
extension | Yes |
field | Ignored |
group | Yes |
import | Yes |
include | Yes |
key | Ignored |
keyref | Ignored |
list | Yes, treated as String |
notation | Ignored |
redefine | Yes |
restriction | Yes |
schema | Yes |
selector | Ignored |
sequence | Yes, when minOccurs>1 a multivalued relation is used |
simpleContent | Yes |
simpleType | Yes |
union | Yes, it is treated as string |
unique | Ignored |