DATASET

DATASET

Used in: CONFIG REQUEST
Parent elements: LAYER

<DATASET	Attribute Description Table
When parent element is LAYER and the layer type is featureclass: *name ="string"* type ="point \| line \| polygon" *workspace ="string"* When parent element is LAYER and the layer type is image: *name ="string"* *workspace ="string"* type ="image" When parent element is LAYER in GET_IMAGE or GET_EXTRACT: fromlayer ="Layer ID in map configuration file" > (m) <PARTITION... /> </DATASET >
Bold: Attribute or child element is required. (m): Child element can be used multiple times.

Description:

Defines the data set used in the layer.

Restrictions:

When in a request, can only be used with LAYER in a GET_EXTRACT or GET_IMAGE element.
In a GET_IMAGE request, use either
name, type, and workspace
or use
fromlayer
One of these two attribute sets is required.
The attribute type is required if the layer is a featureclass type (point, line, or polygon). Type is not required for raster image layers.
GRID, ASRP, IMAGINE, and USRP image formats are not supported on UNIX when used in ArcIMS MapServices. MrSID format is not supported on AIX. For more details on supported images, see Using ArcIMS.

Notes:

There are five different ways to access images and GRIDs as detailed in the table below.

Image Access Method	Workspace Location	DATASET Layer Name
Specify by name.	Use IMAGEWORKSPACE; attribute directory points to location of specified image.	Name of image including its extension.
Use all images in a directory. Images in the same directory automatically tile if they use the same coordinate projection and are drawn when they are within the extent requested.	Use IMAGEWORKSPACE; attribute directory points to location of the group of images.	Use ImageDirectory for the name: name="ImageDirectory"
Use an ArcView GIS image catalog.	Use IMAGEWORKSPACE; attribute directory points to location of catalog, not images.	Name of the image catalog DBF file. For instance, if catalog is named imagecat.dbf, use name="imagecat.dbf".
Add a GRID.	Use IMAGEWORKSPACE. A GRID has two directories: one for the GRID data and one for the INFO files. Both these directories should be grouped together under a parent directory. The directory attribute points to the parent directory above the GRID and INFO directories. A *.clr file can be included to color the GRID. This file should have the same name as the GRID and be included in the parent directory above the INFO and GRID directories.	Name of directory that contains GRID data; for a GRID named Blizzard, use name="blizzard".
Use an image in ArcSDE.	Use SDEWORKSPACE.	Name is the full ArcSDE name including the field name where the image resides. In this example, "REDLANDS" is the field where the image resides: RASTER.IMAGES.REDLANDS.

In a request, when using the fromlayer attribute on a layer, if this layer has been constrained with a query in the map configuration file, fromlayer inherits this query.

Attribute Descriptions for DATASET:

When parent element is LAYER and the layer type is featureclass:

Attribute	Usage	Back to Top
name	The value depends on whether DATASET is used in a map configuration file or a viewer configuration file. Map configuration file. For shapefiles, use the name of the data file without an extension such as STATES. For ArcSDE, use the full name of the layer such as DATA.STATES. Feature MapService layers in a viewer configuration file. Use the LAYER id in the map configuration file. For example, if the id for a layer is "0", then DATASET name="0". Image MapService layers in a viewer configuration file. Use the name of the MapService. For example, if the MapService is named "world", then DATASET name="world".
type	Source layer feature type. Required when the layer source defined in LAYER is featureclass.
workspace	References the workspace name where the data resides.

When parent element is LAYER and the layer type is image:

Attribute	Usage	Back to Top
name	For images, see the table in the Notes section for details on accessing and naming image files.
type	Layer source type is optional for image layers.
workspace	References the workspace name where the data resides.

When parent element is LAYER in GET_IMAGE or GET_EXTRACT:

Attribute	Usage	Back to Top
fromlayer	References an existing layer in a map configuration file. Use the layer ID, not name.

Examples for DATASET:

Example 1: When used in a map configuration file.

Back to Top

Example 2: When using fromlayer in a REQUEST.

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
        <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" />
        <IMAGESIZE width="643" height="502" />
      </PROPERTIES>
      <LAYER type="featureclass" name="select layer" visible="true" id="Selected">
        <DATASET fromlayer="1" />
        <SPATIALQUERY>
          <SPATIALFILTER relation="area_intersection">
            <POLYLINE>
              <PATH>
                <POINT x="-2.1079549837513" y="19.99815142335011" />
                <POINT x="28.99468788980437" y="15.88488432940315" />
                <POINT x="55.99468788980437" y="35.88488432940315" />
              </PATH>
            </POLYLINE>
          </SPATIALFILTER>
        </SPATIALQUERY>
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL fillcolor="0,255,0" filltype="cross" fillinterval="3" />
        </SIMPLERENDERER>
      </LAYER>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 3: When specifying one image by name.

Back to Top

Example 4: When specifying multiple images in a directory.

Back to Top

Example 5: When specifying an image catalog.

Back to Top

Example 6: When specifying a GRID.

Back to Top

Example 7: When in a viewer configuration file.

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="-180.0" miny="-90.0" maxx="185.6901927947995" maxy="90.0" name="Initial_Extent" />
      <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
      <IMAGESERVERWORKSPACE name="mapper_ws-0" url="http://mymachine.domain.com/servlet/com.esri.esrimap.Esrimap" service="background" />
      <FEATURESERVERWORKSPACE name="ifs_ws-1" url="http://mymachine.domain.com/servlet/com.esri.esrimap.Esrimap" service="world" />
      </WORKSPACES>
      <LAYER type="image" name="background" visible="true" id="0">
      <DATASET name="background" type="image" workspace="mapper_ws-0" />
      </LAYER>
      <LAYER type="featureclass" name="Ocean" visible="true" id="1">
      <DATASET name="0" type="polygon" workspace="ifs_ws-1" />
      </LAYER>
      <LAYER type="featureclass" name="Countries" visible="true" id="2">
      <DATASET name="1" type="polygon" workspace="ifs_ws-1" />
      </LAYER>
      <LAYER type="featureclass" name="States" visible="true" id="3">
      <DATASET name="2" type="polygon" workspace="ifs_ws-1" />
      </LAYER>
      <LAYER type="featureclass" name="Provinces" visible="true" id="4">
      <DATASET name="3" type="polygon" workspace="ifs_ws-1" />
      </LAYER>
      <LAYER type="featureclass" name="Cities" visible="true" id="5">
      <DATASET name="4" type="point" workspace="ifs_ws-1" />
      </LAYER>
    </MAP>
    <SCALEBAR backcolor="192,192,192" fontcolor="0,0,0" mapunits="decimal_degrees" scaleunits="feet" screenunits="inches" />
  </CONFIG>
</ARCXML>