Connect a Microsoft SharePoint web part to ArcGIS for SharePoint

Note:

Some workflows may require specific privileges. For more information about user types, roles, and privileges, see the Accounts topic.

You can connect a Microsoft SharePoint web part to ArcGIS for SharePoint. See Maps to learn about maps and layers.

The dynamic data feature allows you to interact with an ArcGIS for SharePoint web part through a SharePoint list or another client-side Microsoft SharePoint web part added by your administrator.

When you add ArcGIS for SharePoint and another SharePoint web part to a SharePoint page, you can connect the two web parts and interact with the map layers using the added list or client-side web part. Once a link is established between the two web parts, you can use the SharePoint list or other web part to interact with the map. For example, you can select rows from a SharePoint list web part and view the filtered features on the map.

For more information about client-side SPFx web parts, see the Using dynamic data extensibility blog article or the SharePoint Extensions Sample wiki. 

Note:

A SharePoint list web part can be independent of layers added to the ArcGIS for SharePoint map.

Set up the connections

To connect a SharePoint web part to ArcGIS for SharePoint, complete the following steps:

1. Ensure that the page is in edit mode.
2. Sign in to an ArcGIS account.
3. From the map tools, click Layers .

   The Layers pane appears.

4. Add a layer to your map either from SharePoint or from ArcGIS.
5. Add a SharePoint list or client-side web part to the page.
6. On the ArcGIS for SharePoint web part, click Edit web part .

   The ArcGIS pane appears.

7. Expand the Connect web parts section.

   The toggle button is turned off by default. Turn it on to activate the Add connection link. You can add up to five connections.

   

8. Click Add connection.

   The Exact match toggle button is turned on by default.

   If you turn it off, the query results are filtered to show a fuzzy match.

9. Choose a connecting web part from the Web part source drop-down menu.

   You can add multiple layers to the map. You can also add multiple lists and web parts from SharePoint. The Web part source drop-down menu reflects the web parts that have been added.

10. If you connected to a list web part, click the Choose list column drop-down menu and choose a column name.

    The list column is connected to the selected map layer.

11. Choose a layer to join from the Map layer drop-down menu.
12. Click Choose layer column and choose a column in the map layer to connect the two web parts.

    The connections are automatically made.

13. Repeat steps 8 through 12 to set up multiple web part connections.

    Caution:

    You cannot duplicate connections.

14. If you connect to a list web part, click the Validate button to verify that matching records exist.

    Note:

    You can only validate connections between a SharePoint list web part and an ArcGIS map web part.

    You can perform validation for each connection. The top 100 unique records from the columns you specified are matched. A percentage bar appears, indicating a percentage match. If there is no match, a warning message appears. You can cancel the validation process at any time.

15. Optionally, click Delete to remove a connection.

Interact with the map

When you select rows from the list or other web parts, each selection reflects the number of matches on the map. A notification appears on the map showing the number of matches or that no rows were matched. If there are hidden layers in the Layers pane, the notification reflects that as well.

Tip:

You can filter rows in the list using the column drop-down arrows. Once filters are applied, the list shows only the filtered rows.

Publish and share

You must have the correct Microsoft permissions to filter SharePoint lists, view the features on the map, or interact with the map and connected list.

Select features or filter a SharePoint list web part

When you use a selection tool in the Select features pane, only selected features on the map are highlighted; unselected features are not available.

When you select records from a connected SharePoint list, unfiltered features are not available, so only the filtered features are shown on the map.