LAYERLIST

Used in

REQUEST  

Servers

Image  Extract  ArcMap  

Parent elements

DATAFRAME  PROPERTIES 

Syntax

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


Attribute Descriptions for LAYERLIST


When parent element is GET_EXTRACT:
AttributeUsage
nodefaultWhen 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:
AttributeUsage
orderWhen 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:
AttributeUsage
dynamicfirstWhen set to "true", draws all dynamic layers before any layers defined in the service.
nodefaultWhen 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.
orderWhen 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.
Back to top 

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 &gt; 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=&apos;Brazil&apos;" />  
        <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>

Back to top