Summary

Tag name: <dvt:series>

The <dvt:series> tag is a child tag of a <dvt:seriesSet> tag used to override attributes of an individual series. Use a set of <dvt:series> tags, within a <dvt:seriesSet> tag, to change bar or line colors, for instance. Commonly used series attributes are - color, lineWidth (change dataline width on a Line graph ), marker type (change Marker to either bar, line, or area on a Combination graph ), assignedToY2 (change axis assignment on a Dual-Y graph), pieSliceExplode (separate a slice away from the rest of a Pie graph ), etc.

Relationship with other tags

The series tag is a child tag of the seriesSet tag.

The series tag can have the following child tag: specialEffects.

Example

The following example shows the XML for creating a dual-Y line graph.

In the series set tag, it specifies to all series that the data lines are set to 3 pixels wide, and are assigned to the Y1 axis.

For the first series, the line is red (ff0000) and the line style is dashed.

For the second series, the line is assigned to the Y2-axis and set to 5 pixels wide.

   <dvt:lineGraph subType="LINE_VERT_ABS_2Y"> 
      <dvt:seriesSet defaultLineWidth="3" defaultAssignedToY2="DY2_FALSE"> 
         <dvt:series color="#ff0000" lineStyle="LS_DASH"/> 
         <dvt:series assignedToY2="true" lineWidth="5"/> 
      </dvt:seriesSet>
   </dvt:lineGraph>

Attributes

Name Type Supports EL? Description
id java.lang.String no Specifies the identifier for this component.
index java.lang.String yes Specifies the zero-based index of the series. This is optional. If index is not specified, the order of series tags in the jspx page is used as index.
color java.lang.String yes Specifies the color that fills the lines, bars, and markers of a series. Valid values are RGB hexadecimal. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque.

Note: For line and radar graphs, the markerColor attribute will override this attribute for the color of the markers.
borderColor java.lang.String yes Specifies the color of the border for the series. Enter values in RGB hexadecimal. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque.
borderTransparent boolean yes Indicates whether the border of the graph series is transparent. To make the series transparent, set the borderTransparent to true and the color to transparent. Valid values are:
  • true - (Default) If the border of the series is transparent.
  • false - If the border of the series is visible.
Note: When an attribute or an object is transparent, it is not visible, but you can select it.
markerColor java.lang.String yes Specifies the color of the markers for line and radar graphs. If this attribute is not set, then the color of the markers is the same as the value of the color attribute. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque.
fitlineType java.lang.String yes Specifies the type of fitline, if any, for this series. Valid values are:
  • FT_NONE - (Default) Do not use fit lines.
  • FT_LINEAR - Use a linear fitline.
  • FT_LOGARITHMIC - Use a logarithmic fit line.
  • FT_EXPONENTIAL - Use an exponential fit line.
lineWidth int yes Specifies the default line width of series lines in pixels. This attribute is relevant only for line, scatter, radar and combination graphs. For pareto graph, use paretoLine tag to specify the line width. The width is 5 pixels by default.
lineStyle java.lang.String yes Specifies the style for the series line. Valid values are:
  • LS_SOLID - (Default) Use a solid line.
  • LS_DASH - Use a dash line.
  • LS_DOTTED - Use a dotted line.
  • LS_DASH_DOT - Use a line with combination of dashes and dots.
markerShape java.lang.String yes The default marker shape for each series. This attribute is relevant only for line, scatter, polar, combination, radar, area and bubble graphs (bubbles honor only MS_NONE, MS_AUTOMATIC, MS_CIRCLE, and MS_HUMAN setting) Valid values are:
  • MS_NONE - Do not use series markers.
  • MS_AUTOMATIC - (Default) Use default markers. In this case, the line, scatter, polar or combination graph assigns marker shapes to each series rotating through square, circle, diamond, plus sign, and triangle. The bubble graph assigns marker shapes to circle.
  • MS_SQUARE - Use square markers.
  • MS_CIRCLE - Use circular markers.
  • MS_DIAMOND - Use diamond markers.
  • MS_PLUS - Use plus sign markers.
  • MS_TRIANGLE_DOWN - Use triangular markers with the point down.
  • MS_TRIANGLE_UP - Use triangular markers with the point up.
  • MS_HUMAN - Use human shaped markers. When the markerSize is specified, the human marker is scaled so that its width matches the markerSize value.
markerType java.lang.String yes Specifies the default marker type for each series in this graph. This attribute is relevant for combination graphs and line graphs. All types apply to combination graphs. The different line types apply to line graphs. Valid values are:
  • MT_AREA - Use area markers.
  • MT_BAR - Use bar markers.
  • MT_MARKER - Use regular line.
  • MT_CURVE_LINE - Use curve line.
  • MT_STEPPED_LINE - Use regular stepped line.
  • MT_CENTERED_STEPPED_LINE - Use centered stepped line.
  • MT_DEFAULT - (Default) Use an appropriate marker based on graph type.
assignedToY2 boolean yes Indicates whether this series is to be assigned to the Y2-axis. Relevant only for dual-y graphs. Valid values are:
  • true - The series is assigned to the Y2-axis.
  • false - The series is assigned to the Y1-axis.
Note: The default value for all series is false except the second series.
pieSliceExplode int yes For the pie graph, specifies the percentage of explosion of this slice. The magnitude of explosion of a slice determines how far the slice is separated from other slices. Valid value is:
  • An integer from 0 to 100
  • 0 - (Default) represents no explosion
  • 100 - represents full explosion