Update your v2006 SOAP applications to work with the latest version of ArcWeb Services. Your credits automatically work in v2006.1.
To update your v2006 applications to v2006.1, perform a global find and replace to change your WSDL locationsfrom v2006 to v2006_1 and from .wsdl to ?wsdl.Toolkit | Instructions | Example |
Axis or Glue | Regenerate your client code using wsdl2java. | At the command line, within your intended directory: |
ColdFusion | Change the WSDL location in the "webservice” attribute of the cfinvoke tag. | <cfinvoke |
.NET | Update Web references. | In Solution Explorer>Web References, right-click the Web reference and choose Update Web Reference. |
NOTE TO GLUE USERS: Separate WSDLs are available for Glue users. This is due to webMethods' diminished support for its Glue toolkit.
Follow these steps to update your v2 ArcWeb Services applications to work with the latest version of ArcWeb Services. Your credits automatically work in v2006.1. See What's new for a complete list of new and enhanced features.
To update your v2 applications to v2006.1, perform a global find and replace to change your WSDL locationsfrom v2 to v2006_1 and from .wsdl to ?wsdl.
Open the ArcWeb site, click My Account (you'll need to log in with your ESRI Global account user name and password), click Migrate V2 POIs in the left sidebar, and follow the instructions to move your v2 POI data to v2006.1. |
Toolkit | Instructions | Example |
Glue or Axis | Regenerate your client code using wsdl2java. | At the command line, within your intended directory: |
.NET | Update Web references. | In the Solution Explorer > Web References, right-click the Web reference and choose Update Web Reference. |
NOTE TO GLUE USERS: Separate WSDLsare available for Glue users. This is due to webMethods' diminished support for its Glue toolkit.
Use the following guidelines to update v2 data source names in your applications to comply with the data source name format for v2006.1, for example, change GDT.Streets.US to ArcWeb:TA.Streets.US:
Add ArcWeb: to the beginning of the name |
Change GDT to TA |
Change Report data source providers from ESRIBIS.*.* to ESRI.*.* |
Change all Address Finder *.Address.* data sources to *.Streets.* (Set AddressFinderOptions.partialAddress=true to perform partial address geocoding.) |
Change GlobeXplorer.Premium.US to ArcWeb:GlobeXplorer.Premium.World See Service Finder for a list of valid data sources. |
In v2006.1, all requests require a token, even free "helper" methods such as getAvailableFieldNames. The only exception is the getVersion method. As a security measure, after verifying the client’s user name and password via the Authentication Web Service, ArcWeb Services sends the client a time-limited, binary encoded string called a token, which the client includes with an ArcWeb service request to confirm authenticity. See the getToken method for code examples. |
POI Manager functionality was incorporated into Data
Manager. Data Manager Web Service provides the ability to upload and
maintain points, lines, polygons, and metadata; and create custom map
and spatial query data sources. |
Proximity and Query were combined into Spatial Query. Spatial Query Web Service that consolidates Query and Proximity services functionality including the ability to find nearest features to a point, line, polygon, or extent; find features within a specified geometry; and perform queries with user-specified criteria. |
ArcWeb service | v2 method (no longer used) | Equivalent v2006.1 method |
Account Info | all methods | getServices and getUsage |
Address Finder | findAddress | |
Address Finder | getAddress | |
Address Finder | getCountries | |
Address Manager | findAddresses | |
Address Manager | getCountries | |
Authentication | getToken with expiration | |
Map Image | convertMapCoordToPixelCoord | |
Map Image | convertPixelCoordToMapCoord | |
Map Image | getBestMapEnvelope | |
Map Image | getMap | |
Map Image | getMyMarkerNames | |
Map Image | getThematicMap with thematicField | |
Map Image | getThematicMap with thematicData | |
Place Finder | getCountryCodes and getTypes | |
Utility | getProjectedEnvelope | Map Image getBestMapArea |
Utility | projectEnvelope |
v2 Object Name | v2006.1 object name | ArcWeb services using v2 object |
CircleDescription | Map Image, Route Finder | |
CoordinateSystem | Map Image, Report, Route Finder, Utility | |
Location | Address Finder, Address Manager, Place Finder | |
LocationInfo | Address Finder, Address Manager, Place Finder | |
LabelDescription | Map Image, Route Finder | |
LineDescription | Map Image, Route Finder | |
MarkerDescription | Map Image, Route Finder | |
SegDescription | Route Finder |
Update the input parameters for the following Map Image Web Service methods:
The first argument now uses mapArea instead of Envelope (which contains either Envelope or Center/Scale) in the following methods:
v2 method name | v2006.1 method name |
convertMapCoordToPixelCoord | |
convertPixelCoordToMapCoord | |
getMap | |
getThematicMap |
The second argument is now bufferPercent in the following methods:
v2 method name | v2006.1 method name |
getBestMap | |
getBestMapEnvelope |
For information on SOAP ArcWeb Services version 2, see the ArcWeb Services v2 documentation.
Visit the Feedback page to give comments or suggestions about the ArcWeb Developer's Guide.