Enabling and testing the REST SOE on a service
Once your server object extension (SOE) and property page is registered, you can enable the SOE on a service. In this section of the walkthrough, you’ll publish a map service from the Yellowstone sample data in the .NET ArcObjects software development kit (SDK). You’ll enable the SOE on the map service and test the SOE using the Services Directory.
The following instructions explain how to package the Yellowstone map into a service definition and publish that service definition using Manager. These steps are included because they support a variety of potential server architectures under which you might be trying this walkthrough.
- Start ArcMap and click File > Open.
- Browse to or type the location of Yellowstone.mxd, which is located in <ArcGIS developer kit install location>\Samples\data\Yellowstone.
- Click File > Share As > Service.
- Click "Save a service definition file" and click Next.
- Choose "No available connection" and check "Include data in service definition when publishing".
- Change the Server type to ArcGIS Server.
- Leave the Service name as Yellowstone and click Next.
- Choose a location where you want to save the service definition, then click Continue.
- Click Stage to create the service definition. In the success message, note the path of your service definition (.sd).
- Copy the Yellowstone.sd file to the machine running ArcGIS Server Manager.
- On the machine running ArcGIS Server Manager, log in to Manager and click Services.
- If necessary, click the Manage Services tab.
- Click Publish Service.
- Click Browse, browse to the location of Yellowstone.sd, and click Open. Then click Next.
- Accept the default properties for the service by clicking Next.
- In the list of available capabilities, find your Spatial Query REST SOE and check the box to enable it. Then click Publish. This creates the service.
- In the list of running services, click the name of your Yellowstone service.
- Click Capabilities and click Spatial Query REST (be careful not to uncheck the box). You are now viewing the properties page for the service. Ensure that the LayerName is "veg" (no quotes) and that the FieldName is "PRIMARY_" (no quotes).
- If you had to make changes to the LayerName and FieldName properties, click Save and Restart. Your SOE is now enabled and the properties set. You can easily test it using the Services Directory.
- Access your services directory by opening http://<server name>:6080/arcgis/rest/services in a web browser.
- Click Yellowstone, scroll down to the bottom of the page, and click SpatialQueryREST. You’re now at the root resource page of your SOE.
- Click the one operation available, SpatialQuery. You can test this operation by adding some simple JavaScript Object Notation (JSON) parameters in the input boxes.
- Type {x:544000,y:4900000} in the location box.
- Type 5000 in the distance box.
- Click the SpatialQuery (GET) button.
You should see a long JSON response containing the clipped polygon geometries from the spatial query. Scroll to the bottom of the response and you’ll see a list of the total areas for each vegetation type. This information structure isn’t easy to read for a human, but it’s great for a web browser or application programming interface (API). In the next section of the walkthrough, you’ll learn how to put this information in maps and tables in a web application.
See Also:
Walkthrough: What's in the REST SOEHow to develop the REST SOE
How to deploy the REST SOE
How to develop a property page for the REST SOE
How to use the REST SOE in a Web application
Sample: Spatial Query REST SOE