Get(ConnectionState)
Purpose
Returns a number representing the security state of the network connection for the current file.
Format
Get(ConnectionState)
Parameters
None
Data type returned
number
Originated in
FileMaker Pro 12.0
Description
Secure connections are encrypted using SSL. If security is important in your environment, your server administrator needs to install a custom SSL certificate.
Returns:
•0 for no network connection for the current file.
•1 for a connection that is not encrypted (FileMaker Server with SSL disabled, or to a FileMaker Pro host).
•2 for a connection that is encrypted but for which the SSL certificate for FileMaker Server cannot be verified. You may be connected to a server pretending to be your actual destination, which could put your confidential information at risk.
•3 for a connection that is encrypted with a verified SSL certificate.
Notes
•Get(ConnectionState) is intended for FileMaker Pro or FileMaker Go client connections. If a script is run on FileMaker Server (via FileMaker WebDirect, Custom Web Publishing, FileMaker Server scheduled scripts, or the
Perform Script On Server script step), there may be no network connection to verify. In this case, this function returns only 1 or 2.
For FileMaker WebDirect, this function does not reflect the state of the connection between the web browser and FileMaker Server. Instead, the web browser verifies and displays the state of its connection to FileMaker Server.
Examples
Returns 3 when the connection is encrypted with a verified SSL certificate.
Related topics