SHAPEWORKSPACE

SHAPEWORKSPACE

Used in: CONFIG   REQUEST
Servers: Image   Query   Feature   Extract   Geocode
Parent elements: WORKSPACES

<SHAPEWORKSPACE	Attribute Description Table
*directory ="string"* *name ="string"* codepage ="string" geoindexdir ="string" [same as directory with shapefile] shared ="true \| false" [false] > No Child Elements </SHAPEWORKSPACE >
Bold: Attribute or child element is required.

Description:

Defines a shapefile data source directory.

Restrictions:

Must refer to an existing data source directory.
Not valid with ArcMap Server.
When using the attributes codepage, geoindexdir, and shared, you should be aware of the following. Workspaces are not duplicated inside the Spatial Server. Therefore, if you start one service using SHAPEWORKSPACE "A" and a second service, also using SHAPEWORKSPACE "A", the attribute values for codepage, geoindexdir, and shared from the first service are used as the values for the second service. If in the first service you set shared="false", and in the second service you set shared="true", the Spatial Server will ignore shared="true" and use share="false" instead. The same is true for values used in codepage and geoindexdir. Note that the attribute value for name can be different for each service.

Notes:

None

Attribute Descriptions for SHAPEWORKSPACE:

Attribute	Usage	Back to Top
codepage	Defines the codepage if it is not defined in the DBF header. The value is the name of the ICU transcoder. Examples include cp1252 and UTF8. The value used in codepage is valid only if the LDID byte in the DBF header is "0". If the LDID byte is not "0", then the value used in codepage is ignored, and the value used in the LDID byte is used instead.
directory	Directory containing shapefiles. UNC pathnames can be used (\\myComputer\shapefiledirectory).
geoindexdir	Directory where geocoding index is built.
name	Workspace name. Must be unique among all data sources.
shared	When set to "true", the ArcIMS Spatial Server checks if a shapefile has been modified outside of ArcIMS. While a shapefile is being edited, ArcIMS sends a message to the ArcIMS Spatial Server log files notifying them that an update is in progress. When set to "false", the ArcIMS Spatial Server does not check whether a shapefile has been updated. Access to the shapefile is faster, but the integrity of the shapefile is at risk if it is modified. It is recommended to use "true" unless safeguards are in place to assure that the shapefile is not edited. Note: In general, access to shapefiles is much faster if the shapefiles reside on the same machine as the ArcIMS Spatial Server. If the shapefiles are on a separate machine, access is faster when set to "false", but the integrity of the shapefile is at risk.

Examples for SHAPEWORKSPACE:

Example 1: When in CONFIG and REQUEST.

Back to Top

<?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="-178.21" miny="18.92" maxx="-66.96" maxy="71.41" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="CITIES" visible="true" id="2">
      <DATASET name="CITIES" type="point" workspace="shp_ws-0" />
      <SIMPLERENDERER>
        <SIMPLEMARKERSYMBOL type="square" width="5" />
      </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>