Call Webservice
Description
This part allows you to enable your logicnet-based application to perform a web service call and retrieve a response.
Use
The call webserice part is available from the web services option in a process node. When you select the part, enter the connection information for the webservice to which to connect. The system can store the response in the application context.
Editor Fields
| Field Name |
Description |
Type/Options |
Optional/Mandatory |
| Result code path |
This is the path of the data object in which the result code will be saved. |
Data Object |
Mandatory |
| Response type |
With this option it can be defined if the response is presented as a downloadable file or to a data object. | Data Object | File | Mandatory |
| Filename |
The name of the file to download if the [Response type] is set to file. |
Text |
Optional |
| Response path |
This is the path of the data object in which the response will be saved. |
Data Object |
Mandatory |
| Trace full request and response |
Check this box to have the full request and response data output to debug tracing (only traced if debug tracing is enabled). |
Checkbox |
Mandatory |
| Host |
This is the hostname of the web service to which to connect. |
Text |
Mandatory |
| Port |
This is the port number of the web service to which to connect. |
Text |
Mandatory |
| Type |
This is the connection type. |
HTTP | HTTPS |
Mandatory |
| Minimum TLS version |
Specifies the minimal TLS version to accept on an HTTPS connection. |
v1.2 | v1.1 | v1.0 |
Optional |
| Maximum TLS version |
Specifies the maximum TLS version to accept on an HTTPS connection. |
v1.2 | v1.1 | v1.0 |
Optional |
| Method |
This is the call method associated with the particular web service. |
GET | POST |
Mandatory |
| Path |
This is the path of the web service call. |
Text |
Optional |
| Content type |
This is the content type for the web service call. |
Text |
Optional |
| Charset |
This is the character set for the web service call. |
Text |
Optional |
| Soap action |
This is the SOAP soap action of the web service call. |
Text |
Optional |
| Http version |
This is the version of the HTTP for the web service call. |
Text |
Optional |
| Maximum redirects |
This is the maximum number of redirects the system should allow for the web service call. |
Number |
Optional |
| Custom headers |
This is where the user enters any customized headers the system should add to the web service call. |
Collection |
Optional |
| Request |
This field is only required when the method is set to "POST". It is the request that the system should send. |
Text |
Optional |
| Use certificate |
This field is only available when the type is "HTTPS". It tells the system to verify certificates (see article Certificate verification for more information) provided by the remote end point. This option must also be checked when a client certificate needs to be passed for authentication |
Checkbox |
Optional |
| Server certificate path |
This field is only available when the "Use certificate" checkbox is checked. It is the file path for the local certificate store containing all valid server certificates. The certificate provided by the remote end point is validated against the certificate(s) in the configured file. This file needs to contain all the certificates in the certificate chain used by the presented remote end's certificate. When this field is left empty, the default certificate store is used (see article Certificate verification for more information). |
Text |
Optional |
| Client authentication |
This field is only available when the "Use certificate" checkbox is checked. It tells the system to enable or disable client authentication. |
Checkbox |
Optional |
| Client public certificate path |
This field is only required when the "Use certificate" checkbox is checked. It is the file path of the public client certificate. |
Text |
Optional |
| Client private key path |
This field is only required when the "Use certificate" checkbox is checked. It is the file path of the client's private certificate key. |
Text |
Optional |
| Verify hostname |
This field is only available when the "Use certificate" checkbox is checked. It it tells the system to enable or disable hostname verification. |
Checkbox |
Optional |
| Hostname |
This field is only required when the "Verify hostname" is checked. It is the hostname to be verified. |
Text |
Optional |
| Asynchronously |
Yes: Call the webservice asynchronously. |
Yes | No |
Mandatory |
| Worker-handle |
This is only required when "Asynchronously" is set to "Yes". It is the name of the worker handle to handle the asynchronous web service call. |
Text |
Optional |
| Authorization |
None: Do not use authorization. |
None | Basic | Custom Text |
Optional |
| Username |
This is only required when "Authorization" is set to "Basic". It is the username required for authorizing the connection. |
Text |
Optional |
| Password |
This is only required when "Authorization" is set to "Basic". It is the password required for authorizing the connection. |
Text |
Optional |
Error Messages
| Error Message | Description |
| Unknown connect error |
The host can be reached, but the socket on the server is not opened for receiving a connection. |
| Cannot connect |
The server hostname is not correctly configured if HTTPS is used. |
| Host not found |
The server hostname is not correctly configured if HTTP is used. |
| Error initializing locations |
The path to HTTPS server certificate is not valid or the certificates in that configured path are not valid. |
| Unable to get local issuer certificate |
The server certificate cannot be validated. Please check whether all certificates in the server certificate chain are saved in the configured certificate file. |
| Could not set client certificate key |
The configured client certificate private key is corrupt or the private key does not belong to the configured client certificate. |
| Failed to set client certificate |
The configured client certificate is corrupt. |
| HTTP Error 401.2 - Unauthorized |
You are not authorized to view this page due to invalid authentication headers. This could be caused because an invalid client certificate was used. |
| HTTP Error 403.16 - Forbidden |
Your client certificate is either not trusted or is invalid. |
| HTTP Error 403.17 - Forbidden |
Your client certificate has expired or is not yet valid. |
| Failed to Connect; error=5; verification result code=0; description=ok |
The configured TLS version is incorrect; for example, TLS 1.0 is configured but you are connecting to a webservice that accepts only TLS 1.2. |
| Failed to Connect; error=1; verification result code=62; description=Hostname mismatch |
The hostname does not match the configured verification hostname. This could mean that the endpoint cannot be trusted. |
Extended Error Logging
It is possible to enable extended error logging for web services. This is only possible when you have access to your LogicNets run-time installation (server access).
- Open or create a configuration file: e.g. c:\logicnets\dat\bnt\yourcompany\settings.cfg
- Add a setting in the "session" section of the configuration called 'log_webservice_calls' with value 1
_session = { log_webservice_calls = 1 } - Run your application
- Check the log files in c:\logicnets\dat\log\
host: test port: 8080 TLS version: 1.2 Connection type: HTTP server validation certificate file: nil client identification certificate file: nil client identification private key file: nil ------------------- Full request ------------------- POST /examplecall HTTP/1.1 Host: test Content-type: text/plain; charset="utf-8" Content-length: 0 SOAPAction: "Action" ------------------- End ------------------- >> Starting call Error: "cannot connect: host not found" ------------------- Response ------------------- nil ------------------- End -------------------
Example
For several examples of using the Call Webservice part, download the following sample project in your workspace.