This is an archive related to a previous version of Esri Maps for SharePoint. If you need the current version go to http://doc.arcgis.com/en/maps-for-sharepoint/.

Web part communication

The Esri 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 and 2013. In SharePoint Server 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 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 connect that to a list of cities. By setting 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 as the provider, in which case you select a city or cities in the list, and the states on the map in which those cities are located are selected.

Connections are one to one; 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. See the steps below for detailed information on configuring the Map Web Part, lists, and connections.

The Esri 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 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 a List Web Part or Chart Web Part.

  1. Add the Esri Maps Web Part to the page.

    Web part communication is only available for the JavaScript-based Esri Maps Web Part.

  2. Insert the applicable List or Chart Web Part on the same page as the Esri Maps Web Part.

    The Chart Web Part is only available in SharePoint Server 2010.

  3. Place the Esri Maps Web Part into Edit mode.
  4. Configure Click the Configure button 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 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 Esri Maps Web Part properties to apply the changes.

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

Connections > Send Row To

Prerequisite:

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

In web part communication, setting the Map Web Part to Send Row To the List Web Part enables 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 layer, States, 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 Esri 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.
  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 Esri 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. Use the Select tool in the Esri Maps Web Part to select features on the map. Connections are one to one; 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.
    • 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 on your site; otherwise, the SharePoint Choose Connections dialog box 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 Esri 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 Esri 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 Esri Maps Web Part. Only one item can be selected 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 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.

    The Connect Chart to Data wizard opens.

  2. Click Connect to another Web Part and click Next.
  3. Choose the Esri 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 Esri Maps Web Part.

  6. Select features in the Esri 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 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. On the Configure Connection dialog box, click Remove Connection.