How to use
See How to use ArcGIS samples for help on compiling, setting up the debugger, and running the sample. If the sample has associated data, you will find that the sample's zip file includes a "data" folder alongside the language folders. However, you will need to update the sample to point to the location of the data once you have extracted all the files.
Deploy the SOE
- Log in to ArcGIS Server Manager and click Site.
- Click Extensions.
- Click Add Extension.
- Click Browse and navigate to the .soe file, which by default is located at <ArcGIS DeveloperKit install location>\Samples\ArcObjectsNet\ServerFindNearSOAPSOE\CSharp\FindNearFeaturesSoapSOE\bin\Debug\FindNearFeaturesSoapSOE.soe.
- Click OK.
Enable the SOE on a service
- Start ArcMap and click File > Open.
- Browse to or type the location of USA.mxd, which is located in <ArcGIS Developer Kit Location>\Samples\data\Usa.
- Click File > Share As > Service.
- Click "Save a service definition" and click Next.
- Choose "No available connection" and select "Include data in service definition when publishing."
- Change the Server type to ArcGIS Server.
- Leave the Service name as USA 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) file.
- Copy the USA.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 USA.sd on the local machine, click Open, then click Next.
- Accept the default properties for the service by clicking Next.
- Click Publish. This creates the USA map service.
- On the Services tab of Manager, select the USA map service, then select Capabilities. In the list of available capabilities, find ".NET Find Near Features SOAP SOE" and select the check box to enable it. If there is a list of available operations allowed, select all of them.
- Click the Save and Restart button to restart the service.
Use the SOE in a client application
- In Visual Studio, open the FindNearFeaturesSoapClient<vs_version> solution (for example, FindNearFeaturesSoapClient2010.sln). The <vs_version> references the Visual Studio version of the solution. The application contains a simple Windows form with a button and a text box.
- A Web Reference has been added to the project to reference the SOE SOAP endpoint hosted within the ArcGIS Server Web service instance. Open the code behind for Form1 (Form1.cs).
- In the click event for the button, change the URL property of the proxy instance to reference the HTTP URL to the map service created in the previous section, then append the path to the FindNearFeaturesSOAPSOE (for example: http://<server name>:6080/arcgis/services/USA/MapServer/FindNearFeaturesSoapSOE), where USA is the map service name on which the Find Near Features SOE has been enabled.
- Run the application and click Execute. Layer information for all layers and features near the center of the default map extent for the service will be returned. All returned content displays in the rich text box in the form.
FindNearFeaturesSoapSOE\FindNearFeaturesSoapSOE.cs | Core SOE implementation for the SOAP Web service. |
FindNearFeaturesSoapSOE\CustomLayerInfo.cs | Custom layer type used in the SOE implementation. |
FindNearFeaturesSoapSOE\bin\Debug\FindNearFeaturesSoapSOE.soe | The deployable SOE file. |
FindNearFeaturesSoapClient\Form1.cs | Code behind for desktop client used to consume SOE via a SOAP Web service. |
Download the files for all languages