LAYERLIST

LAYERLIST

Used in: REQUEST
Servers: Image   Extract   ArcMap
Parent elements: DATAFRAME   PROPERTIES

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

GET_IMAGE

GET_EXTRACT

Restrictions:

None

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	Back to Top
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	Back to Top
order	When set to "true", only layers in the LAYERLIST are drawn. All layers, including acetate layers, must have a unique ID.

When parent element is GET_IMAGE using the Image Server:

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

Back to Top

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

Back to Top

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