Extending Esri Maps for SharePoint using the JavaScript API

Dara Burlo, Elitsa Baklova

Agenda

• Overview of Esri Maps for SharePoint• Extending Esri Maps for SharePoint• Writing Extensions• Creating Extension Packs• Adding Extension Packs to Esri Maps for SharePoint• Putting it all together

Introduction to Esri Maps for SharePoint

Esri Maps for SharePoint

• Bring Maps and Location-Based Analysis to SharePoint, the platform everyone in your company uses.

• Extensible, full-featured product built on the latest HTML technology, targeting both SharePoint on-premises and online.

Esri Maps for SharePoint

• Geoenable/Geoenrich lists, including external lists connecting to SQL Server

• Visualize locations of list items

Esri Maps for SharePoint

• Build web pages with maps and map-based analytics

Esri Maps for SharePoint

• Share beyond SharePoint through ArcGIS

Create Rich Interactive Web Maps

• JavaScript-based• Create, edit and publish with

simple dialog-driven control• Mash up your data from

SharePoint Lists, SQL ServerTables, your published MXDsand the global content on Esri’splatform

Esri Maps for SharePoint

• Search for world addresses and places• Geo-statistical hot spot analysis• Point-to-point routing• Polygon and polyline feature support• Setups in 26 languages

Extending Esri Maps for SharePoint

Extensibility Technology

• Familiar & Non-Disruptive- Dojo- ArcGIS JavaScript API

ArcGIS JavaScript API

Dojo

ArcGIS JavaScript API

Dojo

Esri Maps for SharePoint Extensibility

What Are You Extending?Main menu

Map contents toolbar

Map

Too

ls

Layer menu

Select tools

Popup tools

Extension Points

• Tools- E.g. when a button on a tool bar is clicked- User-driven- Functionality initiated by user action

• Behaviors- E.g. when a layer is added to the map- Event-driven- Functionality triggered by events

• Picture Marker Sets- E.g. your organization’s custom symbols

• Packaged in an Extension Pack

Extension Packs

• Extension Pack – folder which contains:- Manifest

- List of tools, behaviors and picture marker symbols

- Tools- Behaviors- Picture Marker Sets- Supporting files

Writing Extensions

App Object

• Entry point into Esri Maps for SharePoint’s extensibility• Exposes map functionality

Tools

• Functionality associated with a button on a toolbar/menu- E.g. when a button on a tool bar is clicked

Creating a Tool

• Dojo Class Inheriting from _Tool

_Tool

MyTool

Behaviors

• Functionality invoked when an event occurs• E.g. when a layer is added to the map

Creating a Behavior

• Dojo Class Inheriting from _Behavior or a Subclass

_Behavior

MyBehavior

Empowering Extensions: Working with SharePoint Data

• SharePoint layers- Is a JS API FeatureLayer based on feature collection

FeatureLayer

Creating Picture Marker Sets

- Symbolize your data using custom symbols- Images such as pngs, jpgs and urls to an image- Define properties such as:

- type- url- width- height- xoffset- yoffset

Picture Marker Sets

• Identify url location of each symbol

Creating Extension Packs for Esri Maps for SharePoint

Creating Extension Packs

• Extension Pack – folder which contains:- Manifest

- List of tools, behaviors and picture marker symbols

- Tools- Behaviors- Picture Marker Sets- Supporting files

Creating the Manifest

• List of Tools, Behaviors and Picture Marker Sets in the Extension Pack• E.g. your organization’s custom symbols

E.g. your organization’s custom symbols

Upload Extension Packs: 3 Options

Adding Extension Packs to Esri Maps for SharePoint

Adding custom tools/behaviors to an Esri Map Web Part

• Upload extension pack to the site• Edit existing Esri Maps Web Part • Configure the Esri Map Web Part • Click the extension point in the Esri Maps

Web Part you would like to add the tool/behavior to

• Add the tool/behavior• Configure the tool/behavior’s settings if necessary• Save map web part

Adding custom tools/behaviors as part of default Esri Map Web Part

• Upload extension pack to the site• Modify Esri Maps Configuration Files

- Found under Site Settings- Edit tool_collection.json & behavior.json- Save changes

• Adds to new Esri Maps Web Parts • Note: Applies to newly created

Esri Map Web Parts

Putting it all together

Tips to Start Developing Extensions

• Download pre-existing samples from help system- Unzip sample

• Edit contents in your preferred IDE (Visual Studio, Source View, Notepad, etc.)- Add code for tool or behavior - Include tool, behavior or picture marker symbols in the manifest file- Include any supporting files (html, graphics, etc.)

• Deploy folder to your preferred web server (IIS, Apache, etc.)

• Add extension as url to SharePoint

• Add an Esri Map Web Part to page

• Configure the Esri Map Web Part to include your tool or behavior

• Debug in your preferred browser- If changes are needed edit files and reload the page

Elitsa BaklovaDemo

Esri Maps for SharePoint Roadmap

Release Roadmap

Already Released• 3.0.1 - current release

(download today from the list of Location Analytics apps at www.arcgis.com)• 4.0 Beta 2 - current beta

(join today at betacommunity.esri.com)

Coming Soon• 4.0 - Late Spring 2015• 4.0.1 - Localization release Summer 2015

Q&A

Rate This Sessionwww.esri.com/RateMyDevSummitSession