CHARTVALUE

Used in

Servers

Image Feature

Parent elements

Syntax

<CHARTVALUE	Attribute Description Table
*(r)lookupfield="string"* color="0,0,0 - 255,255,255" [0,0,0] lower="integer" upper="integer" value="integer" > No Child Elements </CHARTVALUE >
(r): Attribute or child element is required.

Description

Sets which fields are used in pie and bar diagrams.

Although chart symbols draw on the map, no information about the chart symbols is displayed in the legend. ArcIMS 9 does not support displaying chart values in the legend.

Restrictions

The attribute lookupfield is not required when value is used. It is required in all other cases.
In a Feature Service, lookupfield cannot include fields from a joined table. In an Image Service, fields from joined tables can be used.
Not valid with ArcMap Server.

Notes

All fields listed in CHARTVALUE lookupfield must also be listed in SIMPLELABELRENDERER field or VALUEMAPLABELRENDERER labelfield.

The attributes lower and upper are used together to change the color of a chart segment depending on the value for a feature. For example, a segment might be blue for population less than 1,000,000 and red for population greater than 1,000,000. For each range, a new CHARTSYMBOL should be used for referencing the same lookupfield such as in the following example:

The attribute value is used to change the color of a chart segment depending on user-assigned integer values. All values within the CHARTSYMBOL group are a ratio of the sum of the values. For example, assume two CHARTVALUEs are used to build a chart, and the values are 14018000 and 15743000. The sum of these values is 29761000. Therefore, the size of the first chart segment is 14018000 / 29761000, or 47 percent of the chart. The second segment is 53 percent.

In the following example, values were calculated ahead of time for populations under 30 and 30 and over for California. These two values were then assigned to two CHARTVALUEs. The VALUEMAPLABELRENDERER labelfield must be present even though it is not used. For the ArcXML string to parse properly, a valid field name in labelfield must be included. If SIMPLELABELRENDERER were used, field would be used instead. Again, a valid field name must be included. In CHARTVALUE, no lookupfield is needed.

The lookupfield order must be the same order as fields listed in SIMPLELABELRENDERER field or VALUEMAPLABELRENDERER labelfield.
This element is not available from the ArcIMS Author interface.

Attribute Descriptions for CHARTVALUE

Attribute	Usage
color	Color used for segment of pie or bar chart using RGB values.
lookupfield	Lookup field for chart segment. The field can be in the layer table or a joined table. Performance is generally better if the field name is all upper case. 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" Joined tables are valid only with Image Services. They do not work with Feature Services.
lower	Used together with upper to determine the minimum value for drawing a chart segment.
upper	Used together with lower to determine the maximum value for drawing a chart segment.
value	Used to change the color of a chart segment depending on user-assigned integer values. All values within the CHARTSYMBOL group are a ratio of the sum of the values.

Examples for CHARTVALUE

Example 1: Using an ArcSDE layer.

<?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="-127.34083168343714" miny="27.246314948863663" maxx="-97.31362835016226" maxy="50.018623517052" name="Initial_Extent" />
      <MAPUNITS units="decimal_degrees" />
      <FILTERCOORDSYS id="4326" />
      <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
        <SDEWORKSPACE name="sde_ws-4" server="ARCSDENAME" instance="port:5151" user="SDE" encrypted="true" password="OCOBLVWKFCAEHC" />
      </WORKSPACES>
      <LAYER type="featureclass" name="SDE.US_STATES" visible="true" id="0">
      <DATASET name="SDE.US_STATES" type="polygon" workspace="sde_ws-4" />
      <GROUPRENDERER>
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL fillcolor="27,27,227" />
        </SIMPLERENDERER>
          <SIMPLELABELRENDERER field="SDE.US_STATES.POP1999 SDE.US_STATES.POP1990">
            <CHARTSYMBOL size="30" >
              <CHARTVALUE lookupfield="SDE.US_STATES.POP1990" color="255,0,0" />
              <CHARTVALUE lookupfield="SDE.US_STATES.POP1999" color="0,0,255" />
            </CHARTSYMBOL>
          </SIMPLELABELRENDERER>
      </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: Using upper and lower attributes.

<?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="-127.87777503188939" miny="30.378245451392196" maxx="-101.1629831289576" maxy="48.55733555119212" name="Initial_Extent" />
      <MAPUNITS units="decimal_degrees" />
      <FILTERCOORDSYS id="4326" />
      <FEATURECOORDSYS id="4326"/>
    </PROPERTIES>
    <WORKSPACES>
      <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>" />
    </WORKSPACES>
    <LAYER type="featureclass" name="States" visible="true" id="0">
      <DATASET name="states" type="polygon" workspace="shp_ws-0" />
        <GROUPRENDERER>
          <SIMPLERENDERER>
            <SIMPLEPOLYGONSYMBOL fillcolor="127,127,27" />
          </SIMPLERENDERER>
          <SIMPLELABELRENDERER field="POP1990 POP1999">
            <CHARTSYMBOL size="40" transparency="1.0" >
              <CHARTVALUE lookupfield="POP1990" color="255,0,0" lower="0" upper="1000000" />
              <CHARTVALUE lookupfield="POP1990" color="155,0,0" lower="1000001" upper="7000000" />
              <CHARTVALUE lookupfield="POP1990" color="55,0,0" lower="7000001" upper="200000000" />
              <CHARTVALUE lookupfield="POP1999" color="0,0,255" />
            </CHARTSYMBOL>
          </SIMPLELABELRENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 3: Using the value attribute.

<?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" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="-178" miny="18" maxx="-66" maxy="71" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-0" directory="Path to USA ESRIDATA" />
      </WORKSPACES>
      <LAYER type="featureclass" name="STATES" visible="true" id="0">
        <DATASET name="STATES" type="polygon" workspace="shp_ws-0" />
        <GROUPRENDERER>
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL fillcolor="27,127,227"/>
        </SIMPLERENDERER>
        <VALUEMAPLABELRENDERER lookupfield="STATE_NAME" labelfield="POP1999" >
          <EXACT value="Nevada">
              <CHARTSYMBOL size="30" >
                <CHARTVALUE color="255,0,0" value="526000" />
                <CHARTVALUE color="0,0,255" value="676000" />
              </CHARTSYMBOL>
          </EXACT>
          <EXACT value="California">
              <CHARTSYMBOL size="50" >
                <CHARTVALUE lookupfield="MALES"  color="255,0,0" value="14018000" />
                <CHARTVALUE lookupfield="MALES" color="0,0,255" value="15743000" />
              </CHARTSYMBOL>
          </EXACT>
        </VALUEMAPLABELRENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>