Skip To Content

Connect the map to other web parts

The ArcGIS Maps web part allows for connections between the map web part and a List web part. if both are contained on the same page. This functionality is available in SharePoint 2010, 2013, and 2016. In SharePoint 2010, you can also connect to a Chart web part, but due to a change in SharePoint 2013, the Chart web part connection is not available.

Web part communication works by associating a primary key as a connection between a layer in the map contained in ArcGIS Maps web part the and a field in a list contained in a SharePoint web part. 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 connect that to a list of cities. By setting the map web part that contains the States layer as the provider, when you select a state on the map, the list filters to show the cities located in that state. Alternatively, you can set the Cities list web part as the provider, in which case you select a city in the list and the state on the map in which that city is located is selected.

Connections are one to many; therefore, you can only have a single feature selected on the map to display the corresponding items in the list. If you select multiple features in the map, the attribute table displays and you must select a specific feature on the map to filter the list web part. The steps below provide detailed information about configuring the map web part, list web part, and connections.

The ArcGIS Maps web part 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 ArcGIS Maps web part does not provide direct support for filtering a list and having the respective features filtered on the map.

Initial setup

Caution:

Page refreshes occur often during SharePoint web part communication. For example, a page refresh occurs when selecting a feature in one web part and sending that information to another web part. Be aware that a page refresh may cause you to lose changes you have made to the ArcGIS Maps web part. To avoid losing changes, click Apply on the Properties pane frequently while you are configuring the ArcGIS Maps web part.

Note:

  • If you are using a list that was created by importing an Excel spreadsheet, be aware that SharePoint takes the first text column in your spreadsheet and sets that as the title field with a hyperlink to the original spreadsheet (see SharePoint lists III: Create a list based on a spreadsheet). The ArcGIS Maps web part does not include hyperlinked fields when adding data to the map or in web part communication. This means that you may need to modify your default list view in SharePoint to include the appropriate fields for displaying information in pop-ups and for connecting web parts.
  • To connect ArcGIS Maps to a spreadsheet, you must import it from SharePoint; web part connection will not work with spreadsheets exported to SharePoint from Excel.

The following steps are common to all workflows in which you are connecting the ArcGIS Maps web part to a List or Chart web part.

  1. Add a map to the page.
  2. Insert the applicable List or Chart web part on the same page as the ArcGIS Maps web part.

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

  3. Place the ArcGIS Maps web part into edit mode.
  4. Click the Configure button Configure to display the configuration options.
  5. From the list of configuration options, click Behaviors and choose web part Connectivity Behavior.
  6. Click the Settings button Settings at the top of the panel.
  7. Select the applicable layer from the drop-down menu on the web part Connectivity Connection panel and click OK on each of the panels to close the configuration panel.
  8. Click Apply on the ArcGIS Maps web part properties to apply the changes.

    You must click Apply on the ArcGIS Maps web part properties pane to persist the selected layer for web part communication.

Connections > Send Row To

Prerequisite:

Ensure pop-ups are allowed in your browser for the current SharePoint site; otherwise, the SharePoint Choose Connections dialog box will not appear.

In web part communication, setting the ArcGIS Maps web part to Send Row To the List web part allows you to select a feature on the map and have the list filtered to show only the selected items. In the workflow below, the map web part that contains the States layer is set as the provider. When a state (feature) is selected on the map, the Cities list filters to show only those cities located in the selected state.

  1. With the ArcGIS Maps web part in edit mode, click Connections > Send Row To > <List>.
    Connections: Send Row To List
  2. On the Choose Connections dialog box, you are asked to Select the connection type for <list>. Choose Get Filter Values from in the drop-down list.
    Note:

    If the Choose Connections window does not appear, check that pop-ups are allowed in your browser for your SharePoint site.

  3. Next, specify the Provider and Consumer field names. In this case, the map is the provider, and the list is the consumer. For example, with a Cities list and States layer, you are connecting the Map web part and the List web part using the State field (both the Cities list and States layer have this field).
  4. Click OK on the ArcGIS Maps web part properties pane to apply changes and stop editing.
  5. Click Save on the SharePoint page to save the page.

    If the page is still editable, selecting features can cause a refresh to occur and currently selected features will be unselected.

  6. With the configured page in Run mode, use the Select tool in the ArcGIS Maps web part to select features on the map. Connections are one to many; therefore, you can only have a single feature selected on the map to display the corresponding items in the list. If you select multiple features in the map, the attribute table displays and you must select a specific feature on the map to filter the list web part.
    • One feature selected—List web part filters to the corresponding items.
    • Multiple features selected—Attribute table displays and you must click the Go to icon to select a single feature to filter the List web part.
      Attribute table Go to button

Connections > Get Parameters From

Prerequisite:

Ensure pop-ups are allowed in your browser for your SharePointsite; otherwise, the SharePoint Choose Connections window will not appear.

In web part communication, setting the Map web part to Get Parameters From the List web part enables you to select an item in the list and have the corresponding item selected on the map. In this workflow, the List web part containing the cities is set as the provider.

  1. With the ArcGIS Maps web part in edit mode, click Connections > Get Parameters From > <List>.
    Connections - Get Parameters From Cities layer
  2. On the Choose Connections dialog box, specify the Provider and Consumer field names. In this scenario, the list is the provider and the map is the consumer. For example, with a Cities list and States layer, you connect the Map web part and the List web part using the State field (both the Cities list and States layer have this field).
  3. Click OK on the ArcGIS Maps web part properties pane to save your changes and stop editing.
  4. Select the applicable item in the List web part to filter the items displayed in the ArcGIS Maps web part. You can select only one item at a time. Select the row by clicking in the Select column as shown below.
    Select column for web part connectivity
  5. Click OK on the Map web part properties to apply the changes and exit edit mode.

Connect to a Chart web part

Connections from the ArcGIS 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.

    The Connect Chart to Data wizard opens.

  2. Click Connect to another web part and click Next.
  3. Choose the ArcGIS Maps web part and click Next.
  4. Choose Table as the Data Format and click Next.
  5. 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 ArcGIS Maps web part.

  6. Select features in the ArcGIS Maps web part to display them on the chart. Only selected features display.

Remove the connection

  1. To remove a web part connection, place the ArcGIS Maps web part in edit mode.
  2. On the ArcGIS 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. On the Configure Connection dialog box, click Remove Connection.