DATASET

Used in

CONFIG  REQUEST  

Servers

Image  Query  Feature  Extract  ArcMap  

Parent elements

LAYER  TARGETLAYER 

Syntax

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


Notes


Attribute Descriptions for DATASET


When parent element is LAYER or TARGETLAYER and the layer type is featureclass:
AttributeUsage
nameThe 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".
typeSource layer feature type. Required when the layer source defined in LAYER is featureclass.
workspaceReferences the workspace name where the data resides.

When parent element is LAYER and the layer type is image:
AttributeUsage
descriptionThe 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".
nameFor images, see the table in the Notes section for details on accessing and naming image files.
showcolormaplegendWhen 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.
typeLayer source type is optional for image layers.
workspaceReferences the workspace name where the data resides.

When parent element is LAYER or TARGETLAYER in GET_IMAGE or GET_EXTRACT:
AttributeUsage
fromlayerReferences a previously defined layer in a map configuration file or in the request. Use the layer ID, not name.
Back to top 

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.
<?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 image>" name="jai_ws-0" />
      </WORKSPACES>
      <LAYER type="image" name="reno.sid" visible="true" id="0">
        <DATASET name="reno.sid" type="image" workspace="jai_ws-0" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 5: When specifying multiple images in a directory.
<?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>
        <IMAGEWORKSPACE directory="<path to image directory>" name="jai_ws-0" />
      </WORKSPACES>
      <LAYER type="image" name="*ImageDirectory" visible="false" id="0">
        <DATASET name="*ImageDirectory" type="image" workspace="jai_ws-0" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 6: When specifying an image catalog.
<?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 name="jai_ws-15" directory="<path to image catalog dbf file>"/>
      </WORKSPACES>
      <LAYER type="image" name="Mammoth Area" visible="true" id="0">
        <DATASET name="mammoth.dbf" type="image" workspace="jai_ws-15" />
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

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>

Back to top