Skip To Content

Configure the map as a selector

In this topic

With Esri Maps for SAP BusinessObjects, you can easily add interactivity between components on your dashboard by configuring selectors. Selectors allow users to filter data based on selections made when viewing the dashboard.

Esri Maps for SAP BusinessObjects allows you to configure a map to update other components on the dashboard. When a user clicks or hovers over a map feature, or selects a point or region on the map, the Esri Map component writes data to specified cells in the embedded spreadsheet or to a query prompt. You can customize other dashboard components to use that data to display more detailed information.

You can configure map insertions on a selection, click, or hover over an event.

For example, you can configure a map that features subway station locations to insert ridership values from different years into specified destination cells in the embedded spreadsheet. Then, you can configure a line chart to use that data to drill down to display ridership for different locations when a user chooses a map feature. You can also configure the Esri Map component so that when a user makes a selection on the map, the pie chart is updated to display details about the selected points.

Esri Map component as a selector

In the same manner, you can configure the Esri map component as the target of a selector. See Configure the map as the target of a selector.

For more information about selectors and insertions in SAP Dashboards, see the SAP online help.

Create a map-enabled dashboard

Create a dashboard that includes an Esri map component and other dashboard components.

To configure a map as a selector, your dashboard must have at least two components on the canvas, one of which must be an Esri map component, and both the map and target components must have a location-based attribute in common. To allow your map to display data from your spreadsheet or other data source, you must bind the data to the dashboard component.

Follow the workflow described in Build a map-enabled dashboard.

Add data to the map

Before you can include interactive behaviors in your map, you must add data to the Esri map component using Esri Maps Designer and save the map.

Follow the workflow described in Add SAP BusinessObjects data to your map.


Only SAP BusinessObjects data can be used to configure insertions. You cannot configure an insertion on ArcGIS data added to the map.

Configure an insertion

  1. On the SAP Dashboards canvas, press the Esri map component, and press the Insertion button on the Property panel.
  2. Check the Enable Data Insertion check box.

    The Insertions box lists any existing insertions and the Add (+) and Delete (X) buttons become available. The Configure tab is active.

  3. Press the Add (+) button to add a new insertion.

    If you have already configured insertions for the Esri map component, these appear in the Insertions list. Choose an existing insertion to modify, or press Add (+) to add and configure a new insertion. To delete an insertion, choose it from the list and press Delete (X).

  4. Optionally, type a label for the insertion in the Insertion Name field.
  5. From the Insertion Type drop-down menu, choose the action type to use for the insertion.

    Choose from the following:

    • Grid—Use this to define an insertion of a grid of features based on a user's selection of a number of points on the map.

      For example, if a user selects four points on the map using the selection tool, the data for the selected points is copied from the source data and inserted into the defined Insertion Destination rows and columns on the spreadsheet. One row of data is copied for each point selected, to a maximum number of rows defined by the insertion destination.

    • Row—Use this to define an insertion of a row of features from the map based on the user's selection of a single map feature.

      For example, if the user chooses a point on the map, the data for that feature in the source data is copied to the Insertion Destination.

  6. From the Source Data drop-down menu, choose the map layer that contains the source data values to be bound or linked to the component.

    Only data added to the Esri map component using Esri Maps Designer can be used as source data to configure insertions.

  7. To specify the Insertion Destination binding, do one of the following:
    • Specify a destination in the embedded spreadsheet in your dashboard.

      • Select the range of cells to receive the data copied according to the user's selection at runtime.
      • Press the Bind button and choose Spreadsheet.

        The Select a Range dialog box shows the currently selected range of cells in the spreadsheet.

      • Press OK.

    • To bind your map to live data in a relational universe, you must first add a query with a filter prompt from the relational universe to your dashboard, using the standard SAP Dashboards Query Browser.

      • In the Insertion Destination field, press the Bind button and choose Query Data.
      • From the Select from Query window, choose the appropriate query from the pane on the left of the screen.
      • From the pane on the right, select a prompt to create the binding.
      • Press OK.

    Esri Maps for SAP BusinessObjects supports all standard SAP Dashboards query refresh options.

  8. Specify the Interaction Options.

    The specified option determines which action on the map will trigger events in other dashboard components.

    Choose from the following:

    • Selection—Selecting a point or region on the map using the Selection tools triggers an action in another dashboard component.

      The number of cells specified in the insertion destination determines the number of records retrieved during the map action. For example, the dashboard designer configures five rows as the insertion destination. If the user then selects 10 features on the map, only the first 5 features are inserted into the destination.

    • Mouse Over—Hovering over a point or region on the map using the mouse pointer triggers an action in another dashboard component.
    • Click—Clicking a point or region on the map triggers an action in another dashboard component.

    To automatically trigger interactive behaviors when the user selects features on the map, check the Enable Interaction check box. This feature applies only to interactions configured for a Selection. If this option is unchecked, users can manually trigger interactive behaviors using the Trigger Interaction tools.

  9. In the Default Selection section, specify the map feature that is selected by default when the dashboard loads.

    From the Item drop-down menu, select the number of the row that contains the data to be displayed by default.

    Default selection is supported only for Selection interaction options. If InsertOn is set to MouseOver or Click, the Default Selection option is not available.

Configure data insertion fields

  1. From the Insertions view of the Esri map component's Property panel, choose the Fields tab.

    The Available Fields box lists all the features available on the map layer based on the data added to the Esri map component.

  2. Place a check mark beside each field that you want to copy to the specified insertion destination.

    The Selected Fields box shows the fields that will be copied to the insertion destination.

  3. The order in which the fields are listed in the Selected Fields box must match the order of the values in the insertion destination in the spreadsheet. To change the order of the fields, choose a field name in the Selected Fields box and press the Up or Down arrow.

Configure other dashboard components

  1. Configure another component on your dashboard to interact with the Esri map component's insertion.

    SAP Dashboards does not support the Local Scenario and Reset buttons in add-on components, including Esri Maps for SAP BusinessObjects. For more information about SAP Dashboards components, see the SAP Dashboards online help.

    Esri Maps for SAP BusinessObjects does not support the SWF Loader component.

  2. Save your dashboard.
  3. To preview the dashboard with the interactive map, save the file to your SAP BusinessObjects Business Intelligence platform and view it in BI Launch Pad or publish it to your locally installed web server and view it in a supported browser. For more information, see Preview a map-enabled dashboard.