Configure Region Monitor Script
Purpose
Configures a specified script to run when an iOS device enters or exits a specified region.
See also
Format
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>]
Configure Region Monitor Script [Monitor: Clear; Name: <formula>]
Options
•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:
•Latitude specifies the latitude for the region to monitor.
•Longitude specifies the longitude for the region to monitor.
•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.
Compatibility
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 |
Originated in
FileMaker Pro 16.0
Description
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.
Notes
•You can monitor up to 20 regions at a time.
•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.
Example 1
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]
Related topics