WORKSPACES

Used in

Servers

Image Query Feature Extract Geocode Metadata (Publish)

Parent elements

GET_EXTRACT GET_FEATURES GET_IMAGE MAP MARKUP METADATA_CONFIG

Syntax

<WORKSPACES >
     No Attributes

     When parent element is GET_FEATURES:
     (m)<SDEWORKSPACE... />
     (m)<SHAPEWORKSPACE... />

     When parent element is MAP in a map configuration file, GET_IMAGE, GET_EXTRACT:
     (m)<IMAGEWORKSPACE... />
     (m)<SDEWORKSPACE... />
     (m)<SHAPEWORKSPACE... />

     When parent element is MAP in a viewer configuration file:
     (m)<FEATURESERVERWORKSPACE... />
     (m)<IMAGESERVERWORKSPACE... />
     (m)<IMAGEWORKSPACE... />
     (m)<SDEWORKSPACE... />
     (m)<SHAPEWORKSPACE... />

     When parent element is MARKUP:
     (m)<FEATURESERVERWORKSPACE... />

     When parent element is METADATA_CONFIG used with the Metadata Server:
     <SDEWORKSPACE... />

</WORKSPACES >

(m): Child element can be used multiple times.

Description

Specifies a collection of workspaces or directories where the data is located.

Restrictions

At least one workspace should be defined in the WORKSPACES element, or no map is generated.
All DATASET layer names referenced throughout the configuration file or request must be included in WORKSPACES.
The child elements FEATURESERVERWORKSPACE, IMAGESERVERWORKSPACE, MOIMSWORKSPACE, and AVIMSWORKSPACE can only be used in viewer configuration files such as default.axl from ArcIMS Designer or output from ArcExplorer-Java Edition or the ArcIMS Java Viewers. They cannot be used in a map configuration file.
Not valid with ArcMap Server.

Notes

If a layer does not show up as expected, double-check that the WORKSPACES directory information is correct for that layer.
When adding dynamic layers in a request with a new workspace, the WORKSPACE for the data location should be included in the map configuration file instead of the request whenever possible.
For additional information on using WORKSPACES in configuration files, see Using Configuration Files.

Examples for WORKSPACES

Example 1: When in CONFIG and REQUEST.

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-0" directory="<path to WORLD ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="forests" visible="true" id="0">
        <DATASET name="forests" type="polygon" workspace="shp_ws-0" />
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="0,153,255" />
        </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>