DATASET  Examples

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"
     description ="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:


Restrictions:


Notes:


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. 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 Back to Top
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 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
<?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. 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>

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