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/.

Extend the ArcGIS Map Web Part

Esri Maps for SharePoint allows you to develop custom functionality for the ArcGIS Map Web Part by creating add-ins. Add-ins are Silverlight assemblies that contain one or more commands or map behaviors that interact with the Map Web Part. To help you write extensions, the Map Web Part provides a lightweight, flexible, and extensible application programming interface (API) included in the ArcGIS Extensibility SDK for Silverlight. The API provides access to the map and selected layer and allows you to show dialog boxes within the Map Web Part that can contain any Silverlight FrameworkElement.

While the extensibility API provides a few points of interaction with the Map Web Part, what you can include in an add-in is open-ended. Within an add-in, you can leverage any Silverlight library, including the ArcGIS API for Silverlight and the native Silverlight API. You can manipulate the map and layers, display any Silverlight user interface (UI), make your components configurable, interact with other Silverlight or JavaScript components on the page, make calls to web services such as those provided by SharePoint or ArcGIS Server, and much more.

Once you have written an add-in, the process for adding it to the Map Web Part is straightforward. Add the compiled Silverlight application (.xap) file to the Esri Maps Extensions library. Then when designers edit a Map Web Part within the same site collection, they can add the tools and behaviors contained in your extension through an easy-to-use UI. Tools that are added are exposed as buttons on the ribbon with a label and icon specified by the designer. Clicking a button invokes its associated command. Behaviors that are added are enabled when the Map Web Part loads and can be managed through a dialog box.

To add an add-in to the Map Web Part, complete the following steps:

  1. Create your add-in, referencing Write tools and Write map behaviors.
  2. Browse to the Site Settings page by opening the Site Actions menu and clicking Site Settings.
    Site Settings menu selection
  3. Under the Esri Maps for SharePoint Administration heading, click Legacy ArcGIS Mapping Settings > ArcGIS Mapping Extensions.
    Administration links
  4. Click Add Document.

    The Upload Document dialog box appears.

  5. Click the Browse button to open the Choose File to Upload dialog box.
  6. Locate and select the .xap file containing the add-in and click Open.
    Choose File to Upload dialog box

    The .xap file will be uploaded to the library. Once this is done, the tools and behaviors within the add-in package will be available when adding tools to ArcGIS Map Web Parts within the same site collection.