LAYERDEF

Used in

Servers

Image Extract ArcMap

Parent elements

Syntax

<LAYERDEF	Attribute Description Table
When parent element is LAYERLIST in GET_IMAGE, GET_LAYOUT, or GET_EXTRACT request: *(r)id="string"* name="string" visible="true \| false" When parent element is OVERVIEWMAP in a viewer configuration file: name="string" > When parent element is LAYERLIST in GET_EXTRACT request: <QUERY... /> [Either SPATIALQUERY or QUERY but not both] <SPATIALQUERY... /> [Either SPATIALQUERY or QUERY but not both] When parent element is LAYERLIST in GET_IMAGE request - ArcMap Server: <SIMPLERENDERER... /> <QUERY... /> [Either SPATIALQUERY or QUERY but not both] <SPATIALQUERY... /> [Either SPATIALQUERY or QUERY but not both] When parent element is LAYERLIST in GET_IMAGE request - Image Server: <QUERY... /> [Either SPATIALQUERY or QUERY but not both] <SPATIALQUERY... /> [Either SPATIALQUERY or QUERY but not both] <GROUPRENDERER... /> [Or] <SCALEDEPENDENTRENDERER... /> [Or] <SIMPLELABELRENDERER... /> [Or] <SIMPLERENDERER... /> [Or] <VALUEMAPLABELRENDERER... /> [Or] <VALUEMAPRENDERER... /> [Or] When parent element is LAYERLIST in GET_LAYOUT request - ArcMap Server: No Child Elements When parent element is OVERVIEWMAP in a viewer configuration file: No Child Elements </LAYERDEF >
(r): Attribute or child element is required.

Description

When parent element is LAYERLIST in a request, LAYERDEF is used to define new properties for an existing layer in an Image Service or in the request. Changes include modifying the rendering and setting a filter using a query. It is also used to turn a layer on or off.
When the parent element is OVERVIEWMAP in a viewer configuration file, LAYERDEF is used to set which layers are visible in the overview map.

Restrictions

Used only in GET_IMAGE and GET_EXTRACT requests.
New queries added are restricted by any queries that are already defined for this layer in the ArcIMS service.
When used with GET_EXTRACT, the resulting shapefile names by default are based on the LAYERDEF id. Characters are limited to those that are also valid for a filename. An alternative to using the LAYERDEF id is to use EXTRACTPARAMS for a LAYER in a map configuration file.

Notes

For more information about using LAYERDEF in a request, including more examples, see Using GET_IMAGE and IMAGE with Image Services, Using GET_IMAGE and IMAGE with ArcMap Image Services, and Using GET_EXTRACT and EXTRACT.

Attribute Descriptions for LAYERDEF

When parent element is LAYERLIST in GET_IMAGE, GET_LAYOUT, or GET_EXTRACT request:

Attribute	Usage
id	Reference to unique layer ID as defined in map configuration file or in a dynamic layer in the request.
name	Reference to layer name as defined in map configuration file or in a dynamic layer in the request.
visible	Turns layer on or off. When using Image Services, the default for visible is as it is defined in the map configuration file in all cases. When using ArcMap Image Services and LAYERLIST order="false", the default for visible is as it is defined in the ArcMap document. However, when LAYERLIST order="true", the default for LAYERDEF visible is "false", even if the layer is visible in the ArcMap document. Therefore, you must explicitely set visible to "true" if you want the layer to be displayed.

When parent element is OVERVIEWMAP in a viewer configuration file:

Attribute	Usage
name	Reference to layer name.

Examples for LAYERDEF

Example 1: When in a GET_IMAGE request.

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
  <GET_IMAGE>
    <PROPERTIES>
      <LAYERLIST>
        <LAYERDEF id="1">
          <SIMPLERENDERER>
            <SIMPLEMARKERSYMBOL width="16" color="0,0,0" />
          </SIMPLERENDERER>
         <SPATIALQUERY>
            <SPATIALFILTER relation="area_intersection">
            <ENVELOPE maxy="60" maxx="60" miny="0" minx="0" />
         </SPATIALFILTER>
         </SPATIALQUERY>
      </LAYERDEF>
      </LAYERLIST>
      <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" />
   </PROPERTIES>
  </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 2: When used in OVERVIEWMAP.

<?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="-116.016078" miny="36.252371" maxx="-100.855887" maxy="46.622450" 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="STATES" visible="true" id="0">
      <DATASET name="STATES" type="polygon" workspace="shp_ws-0" />
      <SIMPLERENDERER>
        <SIMPLEPOLYGONSYMBOL fillcolor="255,0,0" />
      </SIMPLERENDERER>
      </LAYER>
    </MAP>
    <OVERVIEWMAP backgroundcolor="255,255,255" framefillcolor="255,0,0" frameoutlinecolor="255,0,0" zoomfactor="4.0">
      <LAYERDEF name="STATES" />
    </OVERVIEWMAP>
  </CONFIG>
</ARCXML>

Example 3: When used in GET_LAYOUT

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_LAYOUT>
      <DATAFRAME id="Mexico">
       <LAYERLIST order="true">
         <LAYERDEF id="2" visible="false" />
         <LAYERDEF id="1" visible="false" />
         <LAYERDEF id="0" visible="true" />
       </LAYERLIST>
      </DATAFRAME>
    </GET_LAYOUT>
  </REQUEST>
</ARCXML>