Skip to main content

SOAP web service

Call a SOAP service - common on older LIS and hospital systems.

Web↑ Outbound
Type codeSOAP
Camel componentcamel-cxf
Formats carried
XMLHL7 v2
Terms used on this page

LIS - Laboratory Information System - the lab's own software for orders and results · WSDL - Web Services Description Language - the document that describes a SOAP service

See the Glossary for every term.

Outbound only

This connector calls a SOAP service; it cannot receive from one. Test connection reads the WSDL with the credential.

Worked example​

Legacy LIS service (SOAP) · Outbound · XML · Test passes on any engine: No - placeholder values

Placeholder service on example.com - replace with the LIS's WSDL address and login.

Values entered by Fill example
{
"direction": "Outbound",
"format": "XML",
"settings": {
"wsdlUrl": "https://lis.example.com/OrderService?wsdl",
"operation": "SubmitResult"
}
}
Placeholder values

The addresses above are placeholders on example.com. Replace them with your partner's real details before running Test connection.

This is what the console's Fill example button enters. Secrets are never part of an example. Every setting is explained below.

Settings​

Required fields are marked Yes. Fields marked 🔒 (password) are stored encrypted and never sent back to the browser - the console only shows Set / Not set. A field marked inbound only or outbound only appears just for that direction.

SettingTypeRequiredDefaultWhat to enter
wsdlUrl
WSDL URL
textYeshttps://Required: the service's WSDL, e.g. https://host/service?wsdl.
operation
Operation
textNo—The operation to call, e.g. SubmitOrder.
username
Username
textNo—WS-Security or Basic account, if the service needs one.
password
Password
passwordNo—🔒 secret. Its password. Stored encrypted.

What "Test connection" checks​

The WSDL can be read with the credential.

Test connection is read-only and says how far it got: verified, reached, checked or failed. See Testing a connection, and Troubleshooting if it fails.