Customize the Click Action on a Map Marker
If you click on a Map Marker on a map, by default Geo SCADA Expert will display one of the following:
-
Alarm View (if one is associated with the database item to which the Map Marker relates)
-
Help View (if one is associated with the database item to which the Map Marker relates)
-
Alarms List (if alarms can be raised on the database item to which the Map Marker relates)
-
Events List (filtered to just show entries that are associated with the database item to which the Map Marker relates).
Geo SCADA Expert performs one action from the above list (in the order shown above), depending on the configuration of the database item to which the Map Marker relates. For example, if a Help View is configured, but not an Alarm View, then the item's Help View is displayed. Likewise, if the item has neither an Alarm View or Help View configured, then the Alarms List is displayed if alarms can be raised on the database item, otherwise the Events List is displayed.
You can customize the left-click action so that Geo SCADA Expert performs one of the options that would be available from the database item's full context-sensitive menu, rather than the above actions. You do this by including the DefaultAction SQL column name in the query for the Map Marker.
The following SQL query triggers Geo SCADA Expert to display the Notes window for the point named 'My Analog Point' when a user clicks on the Map Marker for that point on a map:
SELECT FullName, gislocation->latitude, gislocation->longitude, Foreground, blink, background, 'Notes' as DEFAULTACTION FROM CPointAlgManual
WHERE FullName = 'Zone1.My Analog Point'
If Geo SCADA Expert is unable to perform the requested action that has been specified in the query, it will fall back to performing one of the above-mentioned default actions. (By determining whichever one applies to the database item to which the Map Marker relates.)
Be aware that the string that you specify for the action that you want Geo SCADA Expert to perform has to match the language of the logged on user's Locale (see Define the Regional Settings for a User). If this is likely to change between users or geographical regions, you can instead specify the Id of the action. Unlike the display string, the Id is language-independent. Both strings are case-sensitive.
| Action Display Name | Language-Independent Id |
|---|---|
| Acknowledge Alarms | executemethod.accept |
| Acknowledge With Comment | executemethod.acceptwithcomment |
| Display Alarm View | mimic.alarm |
| Display Alarms | alarms.self |
| Display Events | events.self |
| Display Help View | mimic.help |
| Notes | executemethod.notesself |
| View Status | executemethod.statusself |
The following SQL query triggers Geo SCADA Expert to display the Notes window for the point named 'My Analog Point' when a user clicks on the Map Marker for that point on a map. The action's Id is specified instead of the language-dependent display string for the action. This enables users to trigger the same action from the Map Marker, regardless of whether they log on with User Accounts that are configured to use different Locales.
SELECT FullName, gislocation->latitude, gislocation->longitude, Foreground, blink, background, 'executemethod.notesself' as DEFAULTACTION FROM CPointAlgManual
WHERE FullName = 'Zone1.My Analog Point'
Further Information
Context-sensitive menu: see Object Menu.