LAYERLIST  Examples

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:


Restrictions:


Notes:


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. Layers in an ArcMap Image Service cannot be reordered.

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