Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
11g Release 2 (11.1.2.1.0)

E17490-02

<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
defaultColor java.lang.String no 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 no 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 no Specifies the color of the border for each series. Enter values in RGB hexadecimal. The example color="#000000" specifies black. 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 no 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 no 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 no Specifies the default line width of series lines in pixels. This attribute is relevant only for line, scatter, and combination graphs. The width is 5 pixels by default.
defaultMarkerShape java.lang.String no The default marker shape for each series. This attribute is relevant only for line, scatter, polar, combination, 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 no 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 no 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.
seriesMap java.util.Map no Specifies a Map containing Series child components. A reference to a backing bean that returns a java.util.Map.
lineDisplayed boolean no Specifies whether data lines appear in a line graph. Valid values are:
  • true - (Default) Displays data lines in a line graph.
  • false - Does not display data lines.
Note: Do not set both this property and markerDisplayed to "false".
markerDisplayed boolean no Indicates whether markers appear in a line or area graph. Valid values are:
  • true - Displays markers in a line or area graph.
  • false - (Default) Does not display markers.
Note: Do not set both this attribute and lineDisplayed to "false".
barShape java.lang.String no 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".