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

Get(RegionMonitorEvents)

Returns events that caused the script specified in the Configure Region Monitor Script script step to run.

Format 

Get(RegionMonitorEvents)

Parameters 

None

Data type returned 

text

Originated in 

FileMaker Pro 16.0

Description 

If an event causes the script specified in the Configure Region Monitor Script script step to run, this function returns:

the name of the region monitor

the timestamp when the iOS device entered or exited the monitored region

The timestamp is formatted based on the settings for the solution, using either the locale that the solution was created in or the system locale.

1 if the iOS device entered the monitored region; otherwise it returns 0

The events for each monitor are displayed in chronological order, starting with the earliest event, in the following format:

<region name>

<timestamp>; <1 or 0>

<timestamp>; <1 or 0>

<timestamp>; <1 or 0>

Notes 

If a user entered or exited a monitored region while FileMaker Go was suspended, iOS notifications are delivered after FileMaker Go returns to the foreground. This may cause the Get(RegionMonitorEvents) function to return multiple values.

Example 1 

In the following example, a solution uses the Configure Region Monitor Script script step to monitor a region for iBeacons. The name of the monitor is BeaconMonitor. The script uses a dialog box to display information about iOS devices entering or exiting the monitored region.

Show Custom Dialog ["New iOS device Detected" ; Get(RegionMonitorEvents)]

In this example, the solution was created with a German locale, and FileMaker Go is using the system settings. The dialog box displays the following information if an iOS device entered the region at 10:45 AM on January 27, 2019, and exited a few hours later.

BeaconMonitor
27/1/2019 10:45 AM;1
27/1/2019 1:26 PM;0

Related topics 

Functions reference (category list)

Functions reference (alphabetical list)

RangeBeacons function

About formulas

About functions

Defining calculation fields

Using operators in formulas