LAYERLIST

Used in

Servers

Image Extract ArcMap

Parent elements

Syntax

<LAYERLIST	Attribute Description Table
When parent element is GET_EXTRACT: nodefault="true \| false" [false] When parent element is GET_IMAGE or DATAFRAME using the ArcMap Server: order="true \| false" [false] When parent element is GET_IMAGE using the Image Server: dynamicfirst="true \| false" [false] nodefault="true \| false" [false] order="true \| false" [false] > (m)<LAYERDEF... /> </LAYERLIST >
(m): Child element can be used multiple times.

Description

Defines list of layers to be drawn on the map in a GET_IMAGE request or extracted in a GET_EXTRACT request.

Notes

By default in a GET_IMAGE request, the layers are drawn in the following order:
1. Layers in the ArcIMS service in the order they are defined in the service including acetate layers.
2. Dynamic layers added in the request in the order they are defined in the request.
When using the Image Server, the layer order can be changed by using the order attribute. When order is set to "true", layers are drawn in the order they are listed in the LAYERLIST. This means that dynamic layers can be intermingled among the layers from the service. Both service layers and dynamic layers must be identified using LAYERDEF. The LAYER id must be unique among all service layers and dynamic layers.
The attribute dynamicfirst is ignored if nodefault and/or order is set to true.
For more information about using LAYERLIST 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 LAYERLIST

When parent element is GET_EXTRACT:

Attribute	Usage
nodefault	When set to "true", only the layers listed in the LAYERLIST are extracted. Only ArcIMS service and dynamic layers of type featureclass are extracted. Acetate and image layers included in the LAYERLIST are not extracted. If visible is set to "false" in LAYERDEF, then the layer is not included.

When parent element is GET_IMAGE or DATAFRAME using the ArcMap Server:

Attribute	Usage
order	When set to "true", only layers in the LAYERLIST are drawn. All layers, including acetate layers, must have a unique ID. Layers in an ArcMap Image Service cannot be reordered.

When parent element is GET_IMAGE using the Image Server:

Attribute	Usage
dynamicfirst	When set to "true", draws all dynamic layers before any layers defined in the service.
nodefault	When set to "true", only ArcIMS service, dynamic layers, and acetate layers included in the LAYERLIST are displayed on the map. Service layers are displayed first followed by dynamic layers in the order they appear in the map configuration file and request, respectively. When nodefault is "false", all dynamic and service layers are included. In both cases, if visible is set to "false" in LAYERDEF, then the layer does not display.
order	When set to "true", draws layers in the order listed in the LAYERDEF elements. Only layers in the LAYERLIST are drawn. Can include ArcIMS service layers, dynamic layers, and acetate layers in any order. All layers, including acetate layers, must have a unique ID.

Examples for LAYERLIST

Example 1: When specifying the order that layers should be drawn in a GET_IMAGE request.

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE show="">
      <PROPERTIES>
        <ENVELOPE minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0" />
        <IMAGESIZE width="800" height="600"/>
        <LAYERLIST dynamicfirst="false" nodefault="false" order="true">
          <LAYERDEF id="0" visible="true" />
          <LAYERDEF id="333" visible="true" />
          <LAYERDEF id="2" visible="true" />
          <LAYERDEF id="3" visible="true" />
          <LAYERDEF id="1" visible="true" >
            <SIMPLERENDERER>
              <SIMPLEPOLYGONSYMBOL filltransparency="0.5" filltype="solid" fillcolor="255,255,153" />
              </SIMPLERENDERER>
          </LAYERDEF>
          <LAYERDEF id="4" visible="true" >
            <SPATIALQUERY where="POPULATION > 2000000" >
              <SPATIALFILTER relation="area_intersection">
                <ENVELOPE minx="-14.0" miny="35.0" maxx="33.0" maxy="64.0" />
              </SPATIALFILTER>
            </SPATIALQUERY>
            <SIMPLERENDERER>
              <SIMPLEMARKERSYMBOL type="star" color="0,155,0" width="12.0" />
            </SIMPLERENDERER>
          </LAYERDEF>
        </LAYERLIST>
      </PROPERTIES>

      <LAYER type="featureclass" name="new_CNTRY94" id="333" >
        <DATASET fromlayer="1" />
        <SPATIALQUERY where="NAME='Brazil'" />
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="255,0,0" />
        </SIMPLERENDERER>
      </LAYER>

      <LAYER type="acetate" name="WorldText" id="444">
        <OBJECT units="database">
          <TEXT coords="0 0" label="The World">
            <TEXTMARKERSYMBOL fontstyle="bold" fontsize="32" font="Arial" fontcolor="0,0,0" glowing="255,255,0" />
          </TEXT>
        </OBJECT>
      </LAYER>

      <LAYER type="acetate" name="WorldBox" id="555" >
        <OBJECT units="pixel">
          <LINE coords="10 40;400 40;400 80;10 80;10 40">
            <SIMPLELINESYMBOL color="0,0,0" />
          </LINE>
        </OBJECT>
      </LAYER>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 2: When in a GET_EXTRACT request.

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_EXTRACT>
      <ENVIRONMENT>
        <SEPARATORS cs="#" ts="*" />
      </ENVIRONMENT>
      <PROPERTIES>
        <ENVELOPE minx="-130" miny="30" maxx="-90" maxy="60" />
        <LAYERLIST>
          <LAYERDEF id="Ocean" visible="true" />
          <LAYERDEF id="Countries" visible="true" />
          <LAYERDEF id="States" visible="true" />
          <LAYERDEF id="Provinces" visible="false" />
          <LAYERDEF id="Cities" visible="true" >
            <SPATIALQUERY>
              <SPATIALFILTER relation="area_intersection">
                <POLYGON>
                  <RING>
                    <COORDS> -125#39*-125#63*-90#63*-90#39*-125#39 </COORDS>
                  </RING>
                </POLYGON>
              </SPATIALFILTER>
            </SPATIALQUERY>
          </LAYERDEF>
        </LAYERLIST>
      </PROPERTIES>
    </GET_EXTRACT>
  </REQUEST>
</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>