<dvt:seriesSet>

seriesSet series set


The rows in the grid usually appear as the series in a graph. In most graphs, a series appears as a set of markers that are the same color and or the same shape, for instance. The graph legend typically identifies each series in the graph, with a labeled symbol that shows color and other appropriate attributes. Use a set of <dvt:series> tags, within a <dvt:seriesSet> tag, to change bar or line colors, for instance. Bars in a Bar graph , datalines in a Line graph , and slices in a Pie graph , for instance, all use the series attribute "color" to define color. The <dvt:seriesSet> tag contains attributes that change the default attributes for all series. The <dvt:seriesSet> tag also contains the <dvt:series> tags that override attributes for individual series. 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.

Note: The graph's attribute "seriesObjectCount" determines the number of series that the graph stores properties for. The graph repeats series properties beyond that number.

Relationship with other tags

This component must be a child of one of the following components:

The seriesSet tag has the following child tag: series tag.

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 the component
barShape java.lang.String yes Shape of bars in a bar graph. Valid values are the following:
  • RECTANGLE - (Default) A flat rectangular data marker for bar graph.
  • CYLINDER - A cylindrical data marker for bar graph.
  • TRIANGLE - A triangular based bar data marker for bar graph.
  • DIAMOND - A diamond shaped based bar data marker for bar graph.

Note: Animation is only supported for bar graphs with barShape = "RECTANGLE".

defaultColor java.lang.String yes Specifies the default fill color in RGB Hex. Default value is "#ccff00". 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.
defaultMarkerColor java.lang.String yes Specifies the default marker color in RGB Hex. The example color="#000000" specifies black color. 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.
defaultBorderColor java.lang.String yes Specifies the color of the border for each series. Enter values in RGB hexadecimal. The example color="#000000" specifies black. The example color="#000000" specifies black color. 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.
defaultBorderTransparent boolean yes Indicates whether the border of the graph series is transparent.
  • true - (Default) If the border of the series is transparent.
  • false - If the border of the series is visible.
defaultFitlineType java.lang.String yes Specifies the default type of fitline, if any, that is displayed for each 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.
defaultLineWidth 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.
defaultMarkerShape 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_UP - Use triangle markers.
  • MS_HUMAN - Use human shaped markers. When the markerSize is specified, the human marker is scaled so that its width matches the markerSize value.
defaultMarkerType 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 stepped line.
  • MT_CENTERED_STEPPED_LINE - Use centered stepped line.
  • MT_DEFAULT - (Default) Use an appropriate marker based on graph type.
defaultAssignedToY2 java.lang.String yes Specifies the default assignment of each series for dual-Y graphs. Valid values are:
  • DY2_TRUE - Assign series to Y2-axis.
  • DY2_FALSE - Assign series to Y1-axis.
  • DY2_AUTO_ASSIGN - (Default) Use default assignment of series to an axis.
markerDisplayed boolean yes Indicates whether markers or data lines appear in a line graph. Valid values are:
  • true - Displays markers in a line graph.
  • false - (Default) Displays data lines rather than markers in a line graph.
Note: Do not set both this attribute and lineDisplayed to "false".
lineDisplayed boolean yes Specifies whether data lines appear in a line graph. Valid values are:
  • true - (Default) Displays data lines in a line graph.
  • false - Displays markers in a line graph rather than data lines.
Note: Do not set both this property and markerDisplayed to "false".
seriesMap java.util.Map only EL Specifies a Map containing Series child components. A reference to a backing bean that returns a java.util.Map.