English

How To: Incorporate ArcSDE raster data into an ArcIMS map service

Summary

Instructions provided demonstrate how to add ArcSDE raster data to an ArcIMS map configuration file (AXL). ArcSDE raster layers must be added to map configuration files by manual edits using a text editor.

Procedure

This article assumes that a map configuration file with ArcSDE feature class layers has been created.

  1. Open a map configuration file using a text editor such as Notepad or WordPad.
  2. Verify that the SDEWORKSPACE element includes the correct information about the database where the ArcSDE raster data is stored. If the map configuration file does not include an SDEWORKSPACE element, edit the file to include the appropriate database information. For example,

    Code:
    <WORKSPACES>
    <SDEWORKSPACE name="sde_ws-0" server="Helium" instance="port:6161" database="ARCIMS" user="ARCIMS" encrypted="false" password="turtle" />
    </WORKSPACES>

  3. Add a new LAYER element to the map file, making sure to include the following required attributes: name, type, visible, and id. For example,

    Code:
    <SDEWORKSPACE name="sde_ws-0" server="Helium" instance="port:6161" database="ARCIMS" user="ARCIMS" encrypted="false" password="turtle" />
    </WORKSPACES>
    <LAYER type="image" name="2004 Orthophoto" visible="true" id="2004_orthophoto">


    Note:
    Refer to the ArcIMS ArcXML Programmer's Reference for optional LAYER attributes.

  4. Add a new DATASET element to the map file, making sure to include the following required attributes: name, type, and workspace. For example,

    Code:
    <SDEWORKSPACE name="sde_ws-0" server="Helium" instance="port:6161" database="ARCIMS" user="ARCIMS" encrypted="false" password="turtle" />
    </WORKSPACES>
    <LAYER type="image" name="2004 Orthophoto" visible="true" id="2004_orthophoto">
    <DATASET name="ARCIMS.ARCIMS.ORTHOPHOTO.IMAGE" type="image" workspace="sde_ws-0" />


    Warning:
    The .IMAGE extension must be added to the end of the dataset name specified in the name attribute for ArcSDE raster layers. If this extension is not included, then ArcIMS Administrator will fail to create a map service for the map configuration file, yielding the following error: "ArcIMS Service ... cannot be created. Check your map file's layers and data source connections."

  5. Add the closing LAYER element to the map configuration file.

    Code:
    <SDEWORKSPACE name="sde_ws-0" server="Helium" instance="port:6161" database="ARCIMS" user="ARCIMS" encrypted="false" password="turtle" />
    </WORKSPACES>
    <LAYER type="image" name="2004 Orthophoto" visible="true" id="2004_orthophoto">
    <DATASET name="ARCIMS.ARCIMS.ORTHOPHOTO.IMAGE" type="image" workspace="sde_ws-0" />
    </LAYER>

  6. Open ArcIMS Administrator and create an Image Map service for the map configuration file containing the ArcSDE raster data. If the map service fails to build, recheck the previous steps.

Related Information