Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
11g Release 2 (11.1.2.3.0)
E17490-04

<dvt:series>

series 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.
shape java.lang.String no Specifies the shape for this series.The predefined shapes are circle,diamond,square,automatic,none,plus,triangle-down,triangle-up.If the shape starts with custom prefix then,the shape will be defined by the svg file specified in the skin file.For example if the shape is customFoo then the skin file should have a .AFDVTShapeCustomFoo:alias selector defined or the graph specific af|dvt-graph::shape-customFoo defined which has the -tr-path property pointing to the svg file.
shapePath java.lang.String no the path to the svg file to use as custom shape
index java.lang.String no Specifies the zero-based index of the series. This is optional. If index is not sepcified, the order of series tags in the jspx page is used as index.
color java.lang.String no 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 no 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 no 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 no 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 no 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 no Specifies the default line width of series lines in pixels. This attribute is relevant only for line, scatter, and combination graphs. The default width is specified in the skin.
lineStyle java.lang.String no 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 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_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 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 regular stepped line.
  • MT_CENTERED_STEPPED_LINE - Use centered stepped line.
  • MT_DEFAULT - (Default) Use an appropriate marker based on graph type.
assignedToY2 boolean no 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 no 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
displayInLegend java.lang.String no Specifies Whether this series is shown in the legend.