ArcGIS Enterprise Extending Services. Bill Major

Transcription

1 ArcGIS Enterprise Extending Services Bill Major

2 Agenda Introduction Geoprocessing tools Server Object Extensions Server Object Interceptors Demo

3 APPS Desktop Web Device SHARING SERVICES Portal API DATA GIS Servers

4 CREATE Desktop Web Device CUSTOMIZE Portal API EXTEND GIS Servers

5 CREATE CUSTOMIZE EXTEND Mobile applications Desktop applications Web applications Application templates Look and feel of websites Geoprocessing tools Server object extensions Server object interceptors

6 Why extend? Out of the box capability is not enough Custom business logic - Security - Analytical tools - QA/QC workflows - Notification Java or.net developers on staff Experience with Esri s Arcobjects API

7 You need not worry about Framework handles - Identity - Authentication - Authorization - Scalability - Availability SDK provides - IDE integration with Java and.net - Boiler plate code - SDK and samples You focus on writing code

8 Options Geoprocessing Tools Server Object Interceptors Server Object Extensions

9 Geoprocessing tools Custom analysis models and functions Ability to call into external analytical libraries Asynchronous (optional) Scalable

10 Server object extensions Available since 9.2 Adds new geospatial capability to the server s Map and Image services New API and web endpoint Custom clients needed to work with new API and web endpoint

11 Server object extensions internals Well defined API APPS GIS Server Map Services SOE New custom API Image Services SOE CUSTOM APPS

12 Developing a server object extension IDE Install SDK for Java or.net Enable debugging and attach breakpoint DEBUG IMPLEMENT Implement specific interfaces TEST PACKAGE Package as.soe Upload through Server Manager DEPLOY

13 Interfaces Name Functions Purpose IServerObjectExtension IRESTRequestHandler IRequestHandler2 init( ) shutdown() getschema() handlerestrequest( ) handlestringrequest( ) handlebinaryrequest( ) TIP: This should execute very quickly! Initialization of SOE Cleanup Define the API as resources and operations Handle all REST resources and operation requests Handle SOAP requests Handle binary requests from ArcMap

14 Packaging and deployment

15 Configuration

16 Server object extensions use cases Advanced editing Advanced symbology and rendering Data extraction Advanced raster functions Raster management

17 Server object interceptors Available from Intercepts requests and responses on Map and Image services No new API or web endpoint All Map and Image service clients continue to work Does not work for tiled map services and hosted feature services

18 Server object interceptors internals Well defined API APPS SOI GIS Server Map Services EXISTING APPS SOI Image Services

19 Server object interceptors execution sequence Well defined API APPS REST HANDLER GIS Server SOI ArcSOC.exe New API Map Service Object FILTER REQUESTS AND RESPONSES EXTERNAL RULE DATABASE

20 Server object interceptors use cases Advanced security - E.g. Layer level access Filtering content - E.g. Attribute filtering Post-processing content - E.g. Watermark Notifications Augmenting spatial information - E.g. Merging spatial assets and observations

21 Interfaces Name Functions Purpose IServerObjectExtension IRESTRequestHandler IRequestHandler2 init( ) shutdown() getschema() handlerestrequest( ) handlestringrequest( ) handlebinaryrequest( ) Initialization of SOE Cleanup Define the API as resources and operations Handle all REST resources and operation requests Handle SOAP requests Handle binary requests from ArcMap IWebRequestHandler handlestringwebrequest( ) Handle OGC requests

22 Packaging and deployment

23 Configuration

24 Server object interceptors chaining New at 10.4 Allows for a chain of interceptors on Map and Image services Ideal for mixing in-house and third-party interceptors Interceptors can be repeated - Useful for ensuring security At 10.4, only admins can deploy interceptors/extensions by default

25 Chained server object interceptors execution sequence Well defined API APPS REST HANDLER GIS Server ArcSOC.exe New API SOI 1 SOI 2 Map Service Object EXTERNAL SYSTEM

26 Demo Server Object Interceptor Security Classification Access

27 Best practices Start with SDK samples - Contains boiler plate code For server object interceptors, you cannot change the Map and Image services API - This will break client applications - For new API use server object extensions Use server s logger to log useful status about your interceptor/extension - Variety of log levels to suit the granularity

28 Tips One instance of interceptor/extension per Map or Image instance Enable debugging through Manager.NET Attach to all ArcSOC.exe processes Java Attach IDE to debugging port Disable extension debugging in production Copy dependent JARs to server and list dependent JAR files in MANIFEST.MF class-path Register.NET dependencies in GAC

29 References ExportImageSOI by Mansour Raad Help on extending services Security Classification Code

30 Please Take Our Survey on the Esri Events App! Download the Esri Events app and find your event Select the session you attended Scroll down to find the survey Complete Answers and Select Submit

31