VALUEMAPRENDERER

Used in

Servers

Image Feature

Parent elements

GROUPRENDERER LAYER LAYERDEF LAYERINFO SCALEDEPENDENTRENDERER

Syntax

<VALUEMAPRENDERER	Attribute Description Table
*(r)lookupfield="string"* > (m)<EXACT... /> <OTHER... /> (m)<RANGE... /> </VALUEMAPRENDERER >
(r): Attribute or child element is required. (m): Child element can be used multiple times.

Description

Renders features according to the value in a specified field. Based on this field, a value map can be created to classify data. This is useful when different types of data are stored in the same layer.

Notes

Within the same value map, different types of symbols can be used. As an example, if a value map is done on a point layer, some points could be SIMPLEMARKERSYMBOLs, some points could be RASTERMARKERSYMBOLs, and some points could be TRUETYPEMARKERSYMBOLs.
If the same symbol type is used throughout a value map, different attribute values can be used. For example, with SIMPLEPOLYGONSYMBOL some polygons can be solid while others cross diagonally.
If you wish to display only a subset of features from a layer, use SPATIALQUERY rather than a VALUEMAPRENDERER whenever possible. Using a spatial query to filter data is better performing than using a rendererer.
For more information on using renderers, see Using ArcXML Renderers.

Attribute Descriptions for VALUEMAPRENDERER

Attribute	Usage
lookupfield	Name of field used to specify ranges for RANGE or exact values for EXACT. The field can be in the layer table or in a joined table. Performance is generally better if the field name is all upper case. When joined DBF table names or fully qualified ArcSDE names are used for the field name in a map configuration file, this file cannot be read locally in ArcIMS Author or ArcExplorer-Java Edition. For shapefiles with no joined tables, the field can be referenced using the short format. lookupfield="AREA" For shapefiles with joined tables, the name of the joined table must be included along with the field. lookupfield="JOINEDTABLE.AREA" For ArcSDE layers without joined tables, the field can be referenced using the short format. lookupfield="AREA" The fully qualified name can also be used. lookupfield="ARCSDENAME.TABLE.AREA" For ArcSDE layers with joined tables, joined fields must be referenced using the fully qualified format. lookupfield="ARCSDENAME.TABLE.AREA"

Attribute

Usage

lookupfield

Name of field used to specify ranges for RANGE or exact values for EXACT. The field can be in the layer table or in a joined table. Performance is generally better if the field name is all upper case. When joined DBF table names or fully qualified ArcSDE names are used for the field name in a map configuration file, this file cannot be read locally in ArcIMS Author or ArcExplorer-Java Edition.

For shapefiles with no joined tables, the field can be referenced using the short format.
lookupfield="AREA"
For shapefiles with joined tables, the name of the joined table must be included along with the field.
lookupfield="JOINEDTABLE.AREA"
For ArcSDE layers without joined tables, the field can be referenced using the short format.
lookupfield="AREA"
The fully qualified name can also be used.
lookupfield="ARCSDENAME.TABLE.AREA"
For ArcSDE layers with joined tables, joined fields must be referenced using the fully qualified format.
lookupfield="ARCSDENAME.TABLE.AREA"

Examples for VALUEMAPRENDERER

Example 1: When using EXACT.

Example 2: When using RANGE.

<?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="-180" miny="-90" maxx="180" maxy="90" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
         <SHAPEWORKSPACE name="shp_ws-0" directory="<path to WORLD ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="Countries" visible="true" id="1">
        <DATASET name="CNTRY94" type="polygon" workspace="shp_ws-0" />
        <VALUEMAPRENDERER lookupfield="AREA">
        <RANGE lower="0.0" upper="1000000.0" label="Small">
          <GRADIENTFILLSYMBOL type="horizontal" startcolor="255,0,0" finishcolor="0,255,0" overlap="true" />
        </RANGE>
        <RANGE lower="1000000.001" upper="3000000.000" label="Medium">
          <SIMPLEPOLYGONSYMBOL filltype="cross" fillinterval="4" fillcolor="255,146,0" />
        </RANGE>
        <RANGE lower="3000000.001" upper="10000000" label="Large">
          <SIMPLEPOLYGONSYMBOL filltype="bdiagonal" fillinterval="6" fillcolor="255,37,0" />
        </RANGE>
        <OTHER>
          <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="128,128,128" />
        </OTHER>
        </VALUEMAPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 3: When creating a complex symbol for "Freeway".

<?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="-73.933" miny="40.795" maxx="-73.911" maxy="40.811" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
         <SHAPEWORKSPACE name="shp_ws-0" directory="<path to data>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="nyc_roads" visible="true" id="4" maxscale="1:35000">
      <DATASET name="nyc_roads" type="line" workspace="shp_ws-0" />
        <GROUPRENDERER>
          <VALUEMAPRENDERER lookupfield="ROAD_TYPE">
          <EXACT value="Freeway">
            <SIMPLELINESYMBOL type="solid" width="9" captype="square" jointype="round" color="0,0,0" />
          </EXACT>
          <EXACT value="Street">
            <SIMPLELINESYMBOL type="solid" width="8" captype="square" jointype="round" color="0,0,255" />
          </EXACT>
          <OTHER>
            <SIMPLELINESYMBOL type="solid" width="1" captype="round" jointype="round" color="0,0,255" />
          </OTHER>
          </VALUEMAPRENDERER>
          <VALUEMAPRENDERER lookupfield="ROAD_TYPE">
          <EXACT value="Freeway">
            <SIMPLELINESYMBOL type="solid" width="7" captype="square" jointype="round" color="255,0,0" />
          </EXACT>
          </VALUEMAPRENDERER>
          <VALUEMAPRENDERER lookupfield="ROAD_TYPE">
          <EXACT value="Freeway">
            <SIMPLELINESYMBOL type="solid" width="3" captype="square" jointype="round" color="0,0,0" />
          </EXACT>
          </VALUEMAPRENDERER>
          <VALUEMAPRENDERER lookupfield="ROAD_TYPE">
          <EXACT value="Freeway">
            <SIMPLELINESYMBOL type="solid" width="1" captype="round" jointype="round" color="255,255,255" />
          </EXACT>
          </VALUEMAPRENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>