DATASET

Used in

Servers

Image Query Feature Extract

Parent elements

Syntax

<DATASET	Attribute Description Table
When parent element is LAYER or TARGETLAYER and the layer type is featureclass: *(r)name="string"* (r)type="point \| line \| polygon" *(r)workspace="string"* When parent element is LAYER and the layer type is image: *(r)name="string"* *(r)workspace="string"* description="string" showcolormaplegend="true \| false" [true] type="image" When parent element is LAYER or TARGETLAYER in GET_IMAGE or GET_EXTRACT: (r)fromlayer="Layer ID of previously defined layer" > (m)<PARTITION... /> </DATASET >
(r): Attribute or child element is required. (m): Child element can be used multiple times.

Description

Defines the dataset used in the layer.

Restrictions

In a GET_IMAGE or GET_EXTRACT request to an Image Service, use either
name, type, and workspace
or use
fromlayer
One of these two attribute sets is required. The first option must be used when adding a new layer. The second option can be used to reference a previously defined layer in the map configuration file or the request.
The attribute type is required if the layer is a featureclass type (point, line, or polygon). Type is not required for raster image layers.

Notes

The different ways to access images and GRIDs in an Image Service are 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 raster column where the image resides. For Oracle, use <user>.<image layer>.<raster column>. If the user is "SDEUSER", the image layer is "MYIMAGE", and the raster column is "RASTER", the DATASET name is SDEUSER.MYIMAGE.RASTER. For SQL Server, Informix, and DB2, use <database>.<user>.<image layer>.<raster column>. If the database is "SDE", the user is "SDEUSER", the image layer is "MYIMAGE", and the raster column is "RASTER", the DATASET name is SDE.SDEUSER.MYIMAGE.RASTER. Performance is generally better if the field name is all upper case.

For a listing of supported images, see ArcIMS Help.
In Image Services, GeoTIFF files display correctly if the x and y values for each cell are the same (each cell is a square). If the x and y values of cells are not the same, the image will appear stretched. You can fix this problem by including a world file for the image. For more information on world files, see ArcIMS Help.
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 theRASTER_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 or TARGETLAYER and the layer type is featureclass:

Attribute	Usage
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. Performance is generally better if the field name is all upper case. 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
description	The value of this attribute is the name of the description table in ArcSDE that corresponds to the colormap of an ArcSDE Raster. If the name of the dataset is "MYRASTER.ELEVMAP.IMAGE", then the corresponding description table would be named something like "MYRASTER.ELEVMAPDESC". <LAYER type="image" name="MYRASTER.ELEVMAP" visible="true" id="0"> <DATASET name="MYRASTER.ELEVMAP.IMAGE" description="MYRASTER.ELEVMAPDESC" showcolormaplegend="true" workspace="sde_ws-0"/> </LAYER> The description table must contain two string fields (columns) named COLORMAP_INDEX and DESCRIPTION. The first column contains the index values that correspond to the same index values in the colormap. The second column contains the descriptions for these indexes. The table must be stored in the same database location as the raster. When included, the description for each raster value is displayed in the legend instead of the colormap values. In order for the descriptions to be displayed in the legend, showcolormaplegend must be set to "true".
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 or TARGETLAYER in GET_IMAGE or GET_EXTRACT:

Attribute	Usage
fromlayer	References a previously defined layer in a map configuration file or in the request. Use the layer ID, not name.

Examples for DATASET

Example 1: When used in a map configuration file.

<?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>

Example 2: When in a viewer configuration file.

<?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.

<?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 4: When specifying one image by name.

Example 5: When specifying multiple images in a directory.

Example 6: When specifying an image catalog.

Example 7: When specifying a GRID.

<?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="192837" miny="3769109" maxx="197809" maxy="3773771" name="Initial_Extent" />
        <MAPUNITS units="meters" />
        <FILTERCOORDSYS id="54030" />
        <FEATURECOORDSYS id="54030"/>
      </PROPERTIES>
      <WORKSPACES>
       <IMAGEWORKSPACE directory="<path to parent directory above INFO and GRID directory>" name="jai_ws-15" />
      </WORKSPACES>
      <LAYER type="image" name="Mt St. Helens" visible="true" id="0">
       <DATASET name="<GRID directory>" type="image" workspace="jai_ws-15" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 8: When accessing an ArcSDE Raster layer in SQL Server, DB2, or Informix. The DATASET name is <database>.<user>.<layer name>.<raster column>, which in this example equates to SDEDATABASE.SDEUSER.SDELAYER.RASTER

<?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="dialog" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="192837" miny="3769109" maxx="197809" maxy="3773771" name="Initial_Extent" />
        <MAPUNITS units="meters" />
        <FILTERCOORDSYS id="54030" />
        <FEATURECOORDSYS id="54030"/>
      </PROPERTIES>
      <WORKSPACES>
      <SDEWORKSPACE name="sde_ws-0" server="myserver" instance="port:5151" database="sdedatabase" user="sdeuser" encrypted="true" password="UIUXIOPP" geoindexdir="d:\temp\" />
      </WORKSPACES>
      <LAYER type="image" name="SDEDATABASE.SDEUSER.SDELAYER.RASTER" visible="true" id="1">
      <DATASET name="SDEDATABASE.SDEUSER.SDELAYER.RASTER" workspace="sde_ws-0" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 9: When accessing an ArcSDE Raster layer in Oracle. The DATASET name is <user>.<layer name>.<raster column>, which in this example equates to SDEUSER.SDELAYER.RASTER

<?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="dialog" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="192837" miny="3769109" maxx="197809" maxy="3773771" name="Initial_Extent" />
        <MAPUNITS units="meters" />
        <FILTERCOORDSYS id="54030" />
        <FEATURECOORDSYS id="54030"/>
      </PROPERTIES>
      <WORKSPACES>
      <SDEWORKSPACE name="sde_ws-0" server="myserver" instance="port:5151" database="" user="sdeuser" encrypted="true" password="UIUXIOPP" geoindexdir="d:\temp\" />
      </WORKSPACES>
      <LAYER type="image" name="SDEUSER.SDELAYER.RASTER" visible="true" id="1">
      <DATASET name="SDEUSER.SDELAYER.RASTER" workspace="sde_ws-0" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>