CMaps Plugin for SAP Dashboards functions as a selector, allowing an end user to click on any data point or polygon shape to navigate, drill, or trigger any other dashboard functionality. There are multiple properties in the map component that can be combined in any form to create the exact user experience you desire within your dashboard.
General Selector Properties
Series Name DestinationÂ
Source DataÂ
Destination
Insertion Type
Selector Behavior Properties
Selected Item
Show Windows on Selected Item
Multi-Selection
Series Name Destination
Series Name Destination is a single cell where CMaps Plugin / GMaps Plugin will insert the series name, as data points, polygons, etc are selected. This property allows you to capture the current selected series so you can trigger additional advanced behaviors like filtering and drilling through multiple regions.
Source Data
Source data is a single value or range of values associated with a single data point, line segment, or polygon shape within a single series. The source data property is enabled for the following insertion types and is detailed below with each insertion type:
ROW
COLUMN
Destination
The Destination property defines where source data is inserted once a data point, line segment, or polygon is selected. How the destination range is defined, depends on which insertion type is selected. A description of the destination requirements is listed below for each data insertion type.
Insertion
CMaps Plugin and GMaps Plugin both offer a variety of standard SAP Dashboards selector insertion options:
Label Insertion
When a data point or polygon shape is selected, CMaps Plugin and GMaps Plugin will insert the assigned label into the destination property.
Destination– The destination property should be linked to a single cell. CMaps Plugin and  GMaps Plugin will only insert label into the destination range when a data point is clicked.
Position Insertion
When a data point or polygon shape is selected, CMaps Plugin and  GMaps Plugin will insert the position relative to the data range selected in the map data overlay property.
Destination– The destination property should be linked to a single cell. CMaps Plugin and GMaps Plugin will only insert position or value into the destination range when a data point is clicked.
Row Insertion
When a data point or polygon shape is selected, CMaps Plugin and GMaps Plugin will insert the corresponding row from the Source Data Property into the destination row.
Source Data-Â When selecting Row Insertion option, the Source Data property will be enabled. When defining the Source Data property, you will define a data range with the same number or rows as Labels with unlimited columns.
Destination– The destination property should be linked to a single cell. CMaps Plugin and GMaps Plugin will only insert position or value into the destination range when a data point is clicked.
Column Insertion
When a data point or polygon shape is selected, CMaps Plugin and GMaps Plugin will insert the corresponding column from the Source Data Property into the destination column.
Source Data-Â When selecting Row Insertion option, the Source Data property will be enabled. When defining the Source Data property, you will define a data range with the same number of Columns as there are Labels.
Destination– The destination property should be linked to a single cell. GMaps Plugin will only insert position or value into the destination range when a data point is clicked.
Multi-Selection
CMaps Plugin and GMaps Plugin provides multi-select capabilities, allowing end users to select multiple data points, and then capture the selected data using Rows Insertion.
*NOTE: Multi-selection is only available with the Rows Insertion option.
Changes to the Destination Property for Multi select-Â When multi select is enabled, the destination range will be set to a data range rather than a single row. This will enable GMaps Plugin to populate the range as each data point or polygon is selected.
Selected Item Property
Select any icon or polygon using other components or excel logic outside of the map. The purpose is to enable dashboard developers to control what icon(s) are selected at all times. The following comma separated syntax is required to successfully select a data point within a given series. Selected item is automatically triggered any time either value changes
[Series #],[Position #]
Example: “1,2� will select the “first series�, and the “second data point� in the series.
Example: “2,4� will select the “second series� and the “fourth data point� in the series.
Example: “2� will select “all data points� in the “second series�
De-Selection
In many cases, specifically when using “Multi-Select” properties you may want to de-select the icons or polygons and start your selections over again. To force CMaps Plugin and GMaps Plugin to de-select all data points in the map, insert a “-1” value in the bound “Selected Item” property.
Show Windows on Selected Item Change
When using Selected Item property, you can enable or disable weather the info window(s) are displayed. When this property is un-checked it will only display info windows using the default map behavior.