CHARTVALUE

CHARTVALUE

Used in: CONFIG REQUEST RESPONSE
Parent elements: CHARTSYMBOL

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

Description:

Although chart symbols draw on the map, no information about the chart symbols is displayed in the legend. ArcIMS 3.1 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 MapService, lookupfields cannot include fields from a joined table. In an Image MapService, fields from joined tables can be used.

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.

Attribute Descriptions for CHARTVALUE:

Attribute	Usage	Back to Top
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. For shapefiles with no joined tables, the field can be referenced using the short format. field="AREA" For shapefiles with joined tables, the name of the joined table must be included along with the field. field="JOINEDTABLE.AREA" Files with joined fields cannot be read locally in ArcIMS Author or ArcExplorer 3. For ArcSDE layers without joined tables, the field can be referenced using the short format. field="AREA" The full long name can also be used, but when a long name is used, the file cannot be read locally in ArcIMS Author or ArcExplorer 3. field="ARCSDENAME.TABLE.AREA" For ArcSDE layers with joined tables, joined fields must be referenced using the full long format. field="ARCSDENAME.TABLE.AREA" Files with joined fields cannot be read locally in ArcIMS Author or ArcExplorer 3. Joined tables are valid only with Image MapServices. They do not work with Feature MapServices.
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.

Back to Top

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

Back to Top

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

Back to Top

<?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" />
      </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>