How to migrate to the ArcIMS API

In this topic

Migrating .NET Link applications

The 9.3 Web Application Developer Framework (ADF) contains a complete ArcIMS application programming interface (API) for .NET development. The ArcIMS API utilizes the basic ArcXML pass-through mechanism available in .NET Link, to communicate with an ArcIMS server; however it parses and processes ArcXML, which provides a set of .NET objects to develop with. 
Do the following steps to migrate a .NET Link application to the ArcIMS API:
  1. If necessary, use the project conversion wizard in Visual Studio 2005 to convert the project (minimum .NET 2.0 is required to use 9.3). If a message appears indicating that ESRI.ArcGIS.Server.dll cannot be found, do the following steps in Visual Studio 2005 to resolve this message.
    1. Remove the reference to ESRI.ArcIMS.Server.dll.
    2. Add a reference to ESRI.ArcGIS.ADF.Connection.Core.dll.
  2. In the source code, replace old references with new references by clicking Edit, Find and Replace, and Replace in Files. 
  3. Change ESRI.ArcIMS.Server to ESRI.ArcGIS.ADF.Connection in all files in the solution.
  4. Change the connection type for each reference to a .NET Link ServerConnection by using TCPConnection for Transmission Control Protocol (TCP) connections to ArcIMS. See the following code example:
[C#] 
ESRI.ArcGIS.ADF.Connection.IMS.TCPConnection tcpconnection = new
    ESRI.ArcGIS.ADF.Connection.IMS.TCPConnection();
  1. Use HTTPConnection for Hypertext Transfer Protocol (HTTP) connections to ArcIMS. Include the uniform resource locator (URL) to the Web server on which the ArcIMS servlet connection is available as the first parameter in the HTTPConnection constructor. See the following code example:
[C#] 
ESRI.ArcGIS.ADF.Connection.IMS.HTTPConnection httpconnection = new
    ESRI.ArcGIS.ADF.Connection.IMS.HTTPConnection("http://webservername");
  1. Do the following if migrating a BlueViewer Web application (sample included with ArcIMS 9.1) from .NET Link to the ArcIMS API:
    1. Exclude the readme.htm file from the project. When building the application, strict adherence to Hypertext Markup Language (HTML) standards in Visual Studio 2005 causes the readme.htm file to return errors. Since readme.htm is not required for the application to function, remove or exclude it from the project.
    2. To exclude it from the project, in Visual Studio 2005, right-click the file in the Solution Explorer and click Exclude From Project.
For more information on the ArcIMS API, see Working with the ArcIMS API.

Migrating ActiveX Connector applications

There is no direct path to migrate ActiveX Connector applications to the Web ADF or ArcIMS API; therefore, re-create the application. 

Migrating HTML or Java viewers

There is no direct path to migrate HTML or Java Viewer applications to the Web ADF or ArcIMS API; therefore, re-create the application. However, ArcIMS Web Manager provides a similar application creation functionality to ArcIMS Designer. ArcIMS Web Manager has a set of dialog boxes to select services and controls, and build Web applications using the Web ADF Web Mapping Application template. For more information on working with Manager and the Web Mapping Application template, see Working with the Web Mapping Application.