Unlike databases, directory services, and text files, SOAP Web Service do not go via the . Apps call the Web Service via a Web Service proxy on the PerfectApps server.
Check the Service URL Encode params check box to ensure any data sent to the Web Service is properly encoded.
Permissions:
For more information on applying permissions to connections see Connection and Action Permissions
Proxy Web Service Calls
In many cases, you will not have any control over the Web Service you are calling and so you should select the Use Proxy check box when defining your Web Service action. This will ensure that the call is made through PerfectApps rather than directly to the Web Service.
|
SOAP Headers
Web Service connection communication enables you to include Send parameters in the header, instead of the body of the SOAP request.
The list of Send parameters is not automatically populated with Header parameters by querying the WSDL. They need to be added manually to the list and are differentiated from body parameters by adding a "*" character at the beginning of the name. For example,
*username
*password
|
Use of Namespaces in Send Parameters
In WebService Connection Actions it is possible to include namespaces in send parameters like this:
*wsse:Security[wsse=http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd]
*wsse:Security.Username
*wsse:Securtity.Password
Which results in a SOAP header like this:
<soap:Header xmlns:wsse=”http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd”>
<wsse:Security>
< wsse:Username>…</ wsse:Username>
< wsse:Password>…</ wsse:Password>
</ wsse:Security>
</soap:Header>
Syntax:
- Add namespace prefix before tag name, separated by “:”
- Define namespace by appending [<Prefix>=<URI>] at the end of the parameter
- The namespace only needs to be defined once, for the first parameter which uses it, all following parameters can just refer to it using the prefix
Web Services with namespaces will support array operations.
|
See also: SOAP Web Service Connection Actions, REST Web Services Connections, Connection and Action Permissions
Return to: Creating PerfectApps Connections, Integration