extending esri maps for sharepoint with the javascript api
TRANSCRIPT
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