Reference > Functions reference > Get functions > Get(ConnectionState)
 

Get(ConnectionState)

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 (to FileMaker Server with SSL disabled, or to a FileMaker Pro Advanced host).

2 for a connection that is encrypted but for which the SSL certificate 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 Advanced or FileMaker Go client connections. If a script is run via FileMaker WebDirect, the FileMaker Data API, Custom Web Publishing, or a server-side script, 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 or FileMaker Cloud. Instead, the web browser verifies and displays the state of its connection.

Example 1 

Returns 3 when the connection is encrypted with a verified SSL certificate.

Related topics 

Functions reference (category list)

Functions reference (alphabetical list)

About formulas

About functions

Defining calculation fields

Using operators in formulas

Opening shared files as a client