ignoreSslErrors()
Instructs the Maps Widget to ignore specific SSL errors when loading map tiles.
Synopsis
bool ignoreSslErrors(dyn_string errorList);
Parameter
| Parameter | Description |
|---|---|
| errorList | A list of SSL error codes that should be ignored. If an empty list is provided, previously ignored errors are no longer ignored. |
Return Value
The function returns TRUE upon success, and
FALSE if execution failed (e.g., invalid error codes).
Details
When tile downloads from a WMS server fail due to SSL certificate issues, the Maps
Widget will not display the affected tiles. The debug flag -dbg
maps can be used to identify the specific SSL error codes that occur.
The log output will contain messages like:
WCCOAui (2), maps, SSL errors for QUrl("https://...")
WCCOAui (2), maps, - UnableToGetLocalIssuerCertificate : "The issuer certificate of a locally looked up certificate could not be found"The second line contains the SSL error code (in this example
UnableToGetLocalIssuerCertificate). This code can then be
passed to ignoreSslErrors() to instruct the Maps Widget to ignore
that error.
Once set, the SSL errors are ignored for the runtime of the UI Manager.
Example
Call ignoreSslErrors() in the Maps Widget Initialize script to
ignore a specific SSL error:
main()
{
this.ignoreSslErrors(makeDynString("UnableToGetLocalIssuerCertificate"));
}To stop ignoring SSL errors, call the function with an empty list:
this.ignoreSslErrors(makeDynString());