DATASET

DATASET

Used in: CONFIG   REQUEST
Servers: Image   Query   Feature   Extract   ArcMap
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"* showcolormaplegend ="true \| false" [true] 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 dataset 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.
ArcMap Server supports only the attribute fromlayer. References can be made only to layers that already exist in an ArcMap Image Service.

Notes:

There are five different ways to access images and GRIDs in an Image Service 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 WorldImage, use name="WorldImage".
Use an image in ArcSDE.	Use SDEWORKSPACE.	Name is the full ArcSDE name including the field name where the image resides. In the following examples, "IMAGE" is the field where the image resides: For Oracle, assuming a user of "RASTER" and an image layer named "MYIMAGE", the name is RASTER.MYIMAGE.IMAGE. For SQL Server, Informix, and DB2, assuming a user and database named "RASTER" and an image layer named "MYIMAGE", the name is RASTER.RASTER.MYIMAGE.IMAGE

For a listing of supported images, see Using ArcIMS.
For an image layer, you have the option to include or not include the pixel values in the legend using the showcolormaplegend attribute. The following rules apply:
- When the image has no colormap and RASTER_RENDERER is not used, only the image name is displayed in the legend.
- When the image has a colormap and RASTER_RENDERER is not used, the colormap values are displayed in the legend. If you do not want the colormap to display in the legend, set showcolormaplegend to "false". Image formats that support colormaps are ArcSDE raster, GRID, BIL, and BSQ.
- When the image has a colormap and RASTER_RENDERER is also used, the values from RASTER_RENDERER take precedence, and these values are displayed in the legend. If you do not want the RASTER_RENDERER values to display in the legend, set showcolormaplegend to "false".
- When RASTER_RENDERER is used and there is no colormap, the RASTER_RENDERER values are displayed in the legend. If you do not want the RASTER_RENDERER values to display in the legend, set showcolormaplegend to "false".
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 Service 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 Service layers in a viewer configuration file. Use the name of the Image Service. For example, if the service 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.
showcolormaplegend	When set to "true", pixel value information is displayed in the legend. When set to "false", only the layer name is included in the legend. For more details, see the Notes section.
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 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="Countries" visible="true" id="1">
      <DATASET name="1" type="polygon" workspace="ifs_ws-1" />
      </LAYER>
    </MAP>
    <SCALEBAR backcolor="192,192,192" fontcolor="0,0,0" mapunits="decimal_degrees" scaleunits="feet" screenunits="inches" />
  </CONFIG>
</ARCXML>

Example 3: 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>