Web Part communication

The JavaScript-based Map Web Part in Esri Maps for SharePoint allows for connections between the Esri Maps Web Part map web part and a list web part on the same page in both SharePoint 2010 and 2013. In SharePoint Server 2010 you can also connect to a chart web part, but due to a Microsoft SharePoint limitation, the chart web part connection is not available in SharePoint 2013.

Web part communication works by associating a primary key as a connection between a layer in the map and a field in the list. One web part must be the provider and the other web part is the consumer. This means, for example, that in your map you could have a States layer and then connect that to a list of Hospitals. If you set the States layer as the provider, then when you select a state on the map, the list is filtered to show the hospitals that are located in that state. Alternatively, you can set the Hospitals list as the provider, in which case you select Hospitals in the list and the States on the map in which those hospitals are located are selected. See the steps below for detailed information on configuring the map web part, lists, and connections.

The Esri Maps Web part primarily supports connections to a List web part. You can then select features on the map to filter items in the list, and select features in the list and have them selected on the map. The Esri Maps Web Part does not provide direct support for filtering a list and having the respective features filtered on the map.

Initial setup of web part communication

The following steps are common to all workflows in which you are connecting the Esri Maps Web Part to either a list web part or chart web part.

  1. Insert the Esri Maps Web Part onto the page.

    As mentioned previously, web part communication is only available for the JavaScript-based web part.

  2. Insert the desired list or chart web part onto the same page as the Esri Maps Web Part.

    The Chart web part is only available in SharePoint Server 2010.

  3. Ensure the Esri Maps Web Part is in Edit mode.
  4. Click Configure and select Web Part Connectivity from the list of settings on the left side of the dialog box.
  5. Choose the desired layer from the drop-down menu on the Web Part Connectivity Connection page.

    A warning message may appear stating, "Selected layer cannot be used for Chart Web Part connectivity". If your layer contains number columns you can disregard this message.

  6. Click OK to close the dialog box.
  7. Click Apply on the Esri Maps Web Part properties to apply the changes.

Filtering list items based on selected items in the map

In this workflow, the map layer, 'States', is set as the provider. When a state (feature) is selected on the map, the 'Hospitals' list is filtered to show only those hospitals that are located in the selected state.

  1. With the Esri Maps Web Part is in Edit mode, click Connections > Send Row To > <List>

    Ensure pop-ups are allowed on your site otherwise the SharePointChoose Connections dialog box will not appear.

  2. In the Choose Connections dialog box, specify the Provider and Consumer field names. For example, with a Hospitals list and States layer, we are connecting the map web part and the list web part using the "State" field (both the Hospitals list and States layer have this field).
  3. Click OK on the Esri Maps Web Part properties pane to stop editing.
  4. Use the Select tool in the Esri Maps Web Part to select features on the map. This list web part will be filtered to only show the features that are selected on the map.

Selecting items on the map based on selected items in a list

In this workflow, the list web part containing the 'Hospitals' is set as the provider. When an item in the list is selected, the corresponding item from the 'States' layer is selected on the map.

  1. With the Esri Maps Web Part in Edit mode, click Connections > Get Parameters From > <List>

    Ensure pop-ups are allowed on your site otherwise the SharePointChoose Connections dialog box will not appear.

  2. In the Choose Connections dialog box, specify the Providerand Consumer field names. For example, with a Hospitals list and States layer, we are connecting the map web part and the list web part using the "State" field (both the Hospitals list and States layer have this field).
  3. Click OK on the Esri Maps Web Part properties pane to stop editing.
  4. Select the desired items in the list web part to filter the items displayed in the Esri Maps Web Part.
  5. Click OK on the Map Web Part properties to apply the changes and exit Edit mode.

Connecting to a chart web part

Connections from the Esri Maps Web Part to a Chart web part are only supported in SharePoint 2010 Server.

  1. On the Chart web part, click Data and Appearance and click Connect Chart to Data.
  2. In Step 1 of the wizard, select Connect to another Web Part and click Next.
  3. In Step 2 of the wizard, select the Esri Maps Web Part and click Next.
  4. In Step 3 of the wizard, select "Table" as the Data Format and click Next.
  5. In Step 4 of the wizard, specify the property of the series and the X and Y fields and click Finish.

    The chart is now configured to display data from the Esri Maps Web Part.

  6. Select features in the Esri Maps Web Part to display them on the chart. Only selected features are displayed.

Remove the connection

  1. To remove a web part connection, first place the Esri Maps Web Part in edit mode.
  2. On the Esri Maps Web Part menu, click Connections > Get Parameters From > <List> or Connections > Send Rows To > <List>, depending on the type of connection you have created.

    The Configure Connection dialog box appears.

  3. In the Configure Connection dialog box, click Remove Connection.