Configure Region Monitor Script

Configures a specified script to run when an iOS device enters or exits a specified region.

Configure Region Monitor Script [Monitor: iBeacon; Name: <formula>; Script: "<script>"; Parameter: <parameter>; UUID: <formula>; Major: <formula>; Minor: <formula>]

Configure Region Monitor Script [Monitor: Geofence; Name: <formula>; Script: "<script>"; Parameter: <parameter>; Latitude: <formula>; Longitude: <formula>; Radius: <formula>]

•Monitor specifies whether the monitored region is defined by an iBeacon or a geofence. Use the Clear option to stop monitoring a region.

•Name specifies a name for the monitor. You must specify a unique name for each monitor, whether the region is defined by a geofence or an iBeacon. If you specify the name of an existing monitor, the existing monitor is canceled, and a new monitor with the same name is configured.

•Script specifies the script that will run when an iOS device enters or exits the monitored region.

•Optional script parameter specifies a script parameter for the script.

The following options are used only for iBeacons:

•UUID specifies the universally unique identifier for iBeacons to monitor. The UUID identifies one or more iBeacons as a specific type or from a specific organization. For example, iBeacons for all branches of a department store could share the same UUID.

•Major (optional) specifies the value identifying a group of iBeacons. For example, all iBeacons in a specific branch of a department store could share the same major value. The major value must be between 0 and 65535.

•Minor (optional) specifies the value identifying specific iBeacons within a group of iBeacons. For example, all iBeacons in the toys section of a specific branch of a department store could share the same minor value. The minor value must be between 0 and 65535.

The following options are used only for geofence:

•Radius specifies the radius (in km) for the region to monitor. The value must be greater than zero and less than the maximum value defined by the device and the iOS version.

Where the script step runs	Supported
FileMaker Pro	No
FileMaker Server	No
FileMaker Go	Yes
Custom Web Publishing	No
FileMaker WebDirect	No
Runtime solution	No

Use this script step to run a specified script when an iOS device enters or exits a region. The region can be defined by an iBeacon or a geofence. For example, you can use iBeacons in different galleries at a museum, then configure different scripts to provide supplementary audio or video content as visitors approach each gallery.

To stop monitoring a region, use the Clear option and specify the name of the monitor to stop. If there are no region monitor names specified to clear, all active region monitors are stopped.

Each time a device enters or exits the defined region, iOS notifies FileMaker Go. If FileMaker Go is running in the background when the notification arrives, the solution receives the notification after FileMaker Go returns to the foreground.

•If the value for any of the required options is missing, the script will not be configured.

•Each region monitor is associated with the window that is displayed when the specified script runs. Closing a window clears all configured monitors for that window.

•If the specified value for latitude is outside the range of -90 to 90, the returned value is latitude - i*90, where i is the quotient of latitude divided by 90. The returned value has the same sign as latitude, and the absolute value is less than 90.

•If the specified value for longitude is outside the range of -180 to 180, the returned value is longitude - i*180, where i is the quotient of longitude divided by 180. The returned value has the same sign as longitude, and the absolute value is less than 180.

•If this script step is not configured correctly, FileMaker Go displays an error. Use the Get(LastExternalErrorDetail) function for information about any errors you receive.

Runs the PopArtVideo script when an iOS device enters or exits the range of the specified iBeacon in the Pop Art gallery.

Configure Region Monitor Script [Monitor: iBeacon; Name: MonitorName; Script: "PopArtVideo"; UUID: "BA37611E-FB73-4FFD-8FD3-63459D3FF280"; Major: 10; Minor: 1]