Contains all the chart elements Represents text styling within the chart. Defines how the background of this portion of the chart is filled in. This can either be a gradient, color or pattern. This element represents one or more pies and pie slices based on the data used to create it. Each row will result in a new pie chart. Each row will result in a new slice in each of the pies. Each slice will also appear in the legend. There is no axis definition associated with the pie slices. This element represents the labels that will be drawn if multiple pies are rendered. If this element does not exist, no labels will be rendred. This, with the axis title, can be considered similar to the ordinal axis of other charts. For a radar chart, the radius of each point along each radar line is determined by the measure. Each radial point in the chart will be for a single member. Progressive chart can also be called a waterfall chart. Represents the numerical axis for the progressive chart. If it is not present, no axis labels, axis titles or gridlines will be drawn. The presence of this element indicates that there should be a full bar rendered a the end of the bars to indicate the overall total. The dataSource represents the label for this member. Represents the color, gradient or pattern of the total column on the progressive chart. This defines the label to be rendered for the total column. Defines the color, gradient or pattern to be used for the first column in the progressive chart. Defines the color, gradient or pattern to be used for columns in the progressive chart that represent positive values. Defines the color, gradient or pattern to be used for columns in the progressive chart that represent negative values. The combination chart can display many measures. Each measure can be rendered as a line, area or bar. The chart can have 2 measures axis and can be rendered bipolar if it has two axis. This element represents a pareto chart which is basically a bar chart with an accumulation line. The presence of this element indicates whether or not a cumulation line is rendered. The chartContents indicates whether or not text is associated with the line. The cumulation line is plotted against the Y2 axis shows values between 0 and 100%. If the stacked100MeasureAxis element is not present, a default will be generated. Data item references will appear at the overall level of both edges in the QRD. Bars for a pareto chart are similar to those of a bar chart except that that axis must be stacked. Represents the clusters in a pareto chart. Axis defintion for a pareto chart. This element represents a marimekko chart which is basically a bar chart where the width of the bars has meaning. Bars for a pareto chart are similar to those of a bar chart except that that axis must be stacked. Represents the clusters in a pareto chart. This element represents a win / loss chart. Data comes into this chart and is converted to either a 1 or -1 and optional 0 based on the winLossValue. If the data point is greater than the winLossValue it is converted to a 1, all other values are converted to -1. If allowTies is set to true, data points that exactly equal the winLossValue are converted to 0. The scatter chart is an x-y graph that requires exactly two measures. Bubble chart shows 3 measures, one for the x and y axis and one for the size of each bubble. Can also be used to represent the 1.x quadrantChart. Measure that indicates the size of each bubble. The polar chart is a two measure graph. One measure for the radius of points and one measure for the angular position of the point. Measure that defines the angle of each point. Represents the angular axis of the chart. If this element is not present, no axis line, grid lines, axis labels or axis titles will be drawn. Three D or 3D Axis chart. Defines the collection of things to draw on the combination chart. This includes any number of bars, lines and areas in any order. Represents the bars of a 3D combo chart. Represents the lines of a 3D combo chart. Represents the areas of a 3D combo chart. Collection of baselines to be rendered in the 3D combination chart. Baselines in 3D combo charts have special limitaions; they do not have a label and can only be rendered against the numerical Z axis. Definition of a baseline in a 3D Combo chart. Ordinal Axis definition. Ordinal Axis definition. This is 3D version of the scatter chart. Measure that will run in the Z-plane on the graph. Represents the Z axis of the chart. If this element is not present, no axisline, gridlines, axis labels or axis titles will be drawn. Represents the list of baselines to draw in a 3D Scatter chart. These baselines have special restrictions; they can only be positioned on the numerical Z Axis. Represents a baseline on a 3D Scatter chart. This element represents one or more gauges. It is similar in capability to a pie chart. Each row will result in a new gauge chart. Each row will result in a indicator (needle) in each of the gauges. Each indicator will also appear in the legend. There is no axis definition associated with the indicators. This element represents the labels that will be drawn if multiple pies are rendered. If this element does not exist, no labels will be rendred. This, with the axis title, can be considered similar to the ordinal axis of other charts. Represents the ranged arc of the gauge chart. This element represents a map chart. Colored regions, colored points and point sizes indicate measure values. Points to a layer that has defined points. The color and the size of each point is determined by their respective measure. Measure that controls the size of the points. If this element is not present, all points will be drawn the same size. If this element is present, the point size on the pointLayer is ignored. Measure that controls the color of each point. Location information from the model used to match region feature names in the map. Location information from the model that is used to qualify the parent element. For example, if the parent element is set to city, this could set to country for extra qualification. This defines a title within the legend above the palette for the point size. If this element is not defined, no additional title is drawn. If no legend is drawn, this element is ignored. Styling for this element is inherited from the legend title element. This defines a title within the legend above the palette for the point color. If this element is not defined, no additional title is drawn. If no legend is drawn, this element is ignored. Styling for this element is inherited from the legend title element. Points to a layer in the map that has defined regions. Each region will be colored differently based on the measure. Measure that controls the color of each region. This defines a title within the legend above the palette for the region color. If this element is not defined, no additional title is drawn. If no legend is drawn, this element is ignored. Styling for this element is inherited from the legend title element. Location information from the model used to match region feature names in the map. Location information from the model that is used to qualify the parent element. For example, if the parent element is set to city, this could set to country for extra qualification. Collection of layers that are shown purely for display purposes, i.e., they are not data driven. Layer that is shown only for display purposes. This could be a set of rivers or municipal boundries. Use the dictionary if the string in the data does not exactly match the string in the map. For example, if you want China to match People's Republic of China, use the dictionary. Forces a match between data strings and map feature names. Most useful in the case of errors in the data or the map. For example, if the map has a feature TRONTO and the data has TORONTO, define a map entry for both and they will be treated the same. This attribute defines what locale the data is in. This is important in maps because the server needs to know which names in the map file to try and match with the data. Normally this does not need to be set since the default will work. However, if the data is in english and the run locale is set to russian, depending on the map, you could run into trouble. In this case you would set the data locale to be english. This is same as the metrics manager history chart. This element represents the tolerance range of tolerance marker. If this element is not presence, no tolerance will be drawn. This element represents the target range or tolerance marker. If this element is not presence, no marker will be drawn and the chart will essentially be a simple combination chart. This is the label for the target range that will be drawn in the legend. This is the label for the tolernace range that will be drawn in the legend. This is the label for the target diamond marker that will be drawn in the legend. Defines the axis line for a non-numeric axis. Styling is applied to axis line. Collection of baselines to draw on the chart. The baselines can be either horizontal or vertical. The position of the baseline can be determined by a static value, an expression or a specific member. Each baseline can be data driven from another query. If refQuery is not present, it is assumed to apply to the query of the chart. If the baseline is data driven and multiple rows are returned for the this value, the value of the first row will be used rather than returning an error. Data items referenced here will go into the overall level of both edges in the QRD unless it comes from a different query in which case it will have its own QRD. Indicates what value the baseline will be drawn at. Note that it is possible to draw a baseline at a specific member, like 'Canada', for example. This will be done by either specifying the correctstatic value or by the correct expression. The author tool should prevent the creation of meaningless baselines, if possible. For example, drawing a vertical baseline at 'Canada' on a scatter chart has no meaning. Collection of notes to draw on the chart The datasource defines the contents of the note. It is required since there is no point in having a note without text of some sort. If the value of the note is data driven, it can come from another query. If the refQuery of this element is empty or not present, the query for the chart is assumed. If multiple rows are returned for a data driven note, the value of the first row will be used rather than returning an error. Defines the contents of the note. This is similar to the baseline label and the marker label. This element represents the borders on a note. If this element is not present, no border will be drawn on the note. Collection of markers for a point chart Defines a marker for a point chart. Defines the position of a marker in a point chart. Common definition of markers to draw on the chart. The datasource for the marker label defines that text that maybe associated with. It is optional since text is not required. Data references will be added to the lowest level of both edges in the QRD. This controls where the marker will be drawn on the chart. Common definition for a chart legend. If this element is not present in the chart no legend will be rendered. The associated style and conditional style will affect each row in the legend. Report Drills defined here applies to the items in the legend contents, i.e., each row of the legend. Controls where the legend will appear. Positions the chart by setting an enumeration value. Positions the legend by setting the pixel position of the top left corner of the legend. This position is in chart co-ordinates. Represents the legend title. If this element does not exist, no legend title will be generated. If it exists, and its contents are empty, a default one will be generated. Data references will be added to the overall level of both edges in the QRD. This is used to separate multiple levels in the legend. For example, if the legend must show country, city and qty / margin, the default separator could be used to show Canada-Ottawa-Qty. If the chartContents is defined, this separator is not used since they author is explicitly saying what they want and would include a text item for the separator if so desired. Title to display on the chart Sub title to diplay in the chart Defines a color gradient Defines a color Defines a background pattern. Defines a palette for the chart. It contains an ordered list of gradients and / or colors. One edge of the chart. Defines a footer that is rendered as part of the chart. In the end it is simply a piece of stylized text. Defines the body of the chart itself. The style of the body can be set independently of the chart itself. Bar definition for the progressive Chart. The child chartContents node applies to the labels of each bar. The presence of this element means that gridlines should be drawn for the appropriate axis. Measure that will run horizontally on the graph. The style is only for formatting display values. Measure that will run vertically on the graph. The style is only to allow data formatting of display values. Each row defines a single point that will appear in each cluster. Each row defines a cluster of points. Represents the title drawn for the axis. If this element is not present, no title will be drawn, if it is present but empty (no dataSource) a default title is drawn. Data references will be added to the overall level of both edges in the QRD. Contains a sequence of conditional colors. If the condition is true, that color or gradient is used for the relevant piece of chart (bar, point, etc...) Conditional define a color for a piece of chart. Canada (or Fred) is red. Defines the contents for this item. It could contain multiple pieces of text that can be styled individually. For example, in the legend, it will be possible to show 'Canada $357,98' by including two chartTextItems. If this element is not present, then no labels or legend items will be rendered. If the contents of it are empty, then the default will be generated. Defines one piece of text to display. For a chart, this will typically be a legend item, legend title, axis label or axis title. Common axis for all items in the combination chart. Collection of nodes for this part of the graph. Measure that defines the radius of each point. Represents the bars of a combination chart. The connecting lines element will only be applied if the valueType of the bar is 'stacked'. Represents the lines of a combination chart. Marker that is drawn for the highest value in this line. Its position is the highest numeric value in the series and the corresponding ordinal value. Marker that is drawn for the lowest value in the line. Its position is the lowest numerical value for the line and the corresponding oridnal value. Marker that is drawn for the first non-null value in the line. Its position is the first ordinal value and the numeric value that corresponds to that ordinal. Marker that is drawn for he last non-null value in the line. It's position is the last ordinal value and the numeric value that corresponds to that ordinal. Represents the areas of a combination chart. Primary Y Axis Secondary Y Axis The position is a numeric value on a numeric axis. The position is given by the member returned by the datasource. If this is a static value, such as Canada, it should be matched by string comparison. The offset is relative to that member. Negative values mean to the left and position values mean to the right. This is a percentage value. 50 means half way to the member to the immediate right. Represents the X Axis of the chart. If this element is not present, no axis line, gridlines, axis labels or axis title will be drawn. Represents the Y Axis of the chart. If this element is not present, no axis line, gridlines, axis labels or axis title will be drawn. Represents the radial axis of the polar chart. If this element is not present no axis line, grid lines, axis label or axis title will be drawn. Label that will be shown with the rendered baseline. Three D Baselines can only be positioned numerically on the Z Axis. This is the label that may be displayed with the marker. Collection of point chart related baselines Defines a baseline for a point chart. Baselines can only be positioned on a point chart by specifying two numeric values. The style and conditional style specified on the baseline is applied to its label (if defined). Container element for the position of a pointChartBaseline. Position along the X or Radial axis of a point chart. Position along the y or angular axis of a point chart. This element identifies the default measure to be used for a chart. If the measures of the chart cannot be determined by what is being rendered on the edges, then the default measure will be rendered. The style is appropriate only for data formating of values. This element identifies the actual measure for a bullet chart. The presence of this element indicates that connecting lines will be drawn between the bars. Co0ntrols the colors used in the chart based on a numeric range. The percentValues attributes indicates whether the pallete values are percentages or absolute values. If percentages, it represents a percent of the span of all the measure values. This is an ordered list of palette entires. Determining which one to use for a point or region depends on the current measure value and the attribute paletteValue. If the measure value is lower then the first enty, that palette is used. If the value is between the first and second value, the second entry is used and so forth. Note that the value on the last entry is not used if set. Defines an entry in the palette. This defines a set of drill throughs for each feature in this layer. This will allow the author to define a different drill through target report for each state, for example. Defines a drill through for one feature. This element represents minor gridlines. The attribute numberOfMinorGridlines controls how many are drawn between each major gridline. Zero means no minor gridlines, two means two between each gridline. If this element is not present, no minor gridlines will be drawn. This represents one regression line in a chart. The regression line can be drawn for the data of all series, one regression line can be drawn for each series or one regression line can be drawn for a specific series. The drawForSeries attribute controls this. All means one line for all series, each means one line for each series and speicfic means that it will be drawn for the series identified by the string attribute specificSeries. Defines how the regression line is position on the chart. Uses a common log regression. Uses a natural log regression. Uses linear regression. Uses exponential regression. Fits a polynomial curve to the data. The exponent attribute indicates the highest exponent of the fit equation. For example, if set to 3, the equation used would be y=Ax^3 + Bx^2 + Cx + D Label that will be will be shown in the legend for the regression line. Defines the things that are rendered in the chart. This could include any combination, in any order, of bars, lines, or areas. The presence of this element indicates that an axis line should be rendered. Defines a continuous chart palette. The color used from the palette is determined by a linear interpolation between the colors in the palette based on a measure value. Defines an entry in the palette. If the measure value is equal to the value of paletteEntryValue, this color will be used. Note that this is an ordered list and the value of the attribute paletteEntryValue must increase. Defines the label for this item. Percentage along the axis. 50% will be the middle of the axis. Definition of a measure used within a chart. Generic type that represents a title on a chart. Complex type to define special chart values. Mean of the data, adjusted by the number of standard deviations (+ or -) Mininum or maximum of the data. Percentile of the data Allows selection of an appropriate axis type. The style element is primarily for data formating. This defines an empty complex type. Type that represents an ordinal or discrete axis. Controls how labels are rendered Specifying this element allows the server to control how the labels are rendered. Specifying this element allows the author more control over the labels. The position is given by the member returned by the datasource. If this is a static value, such as Canada, it should be matched by string comparison. The offset is relative to that member. Negative values mean to the left and position values mean to the right. This is a percentage value. 50 means half way to the member to the immediate right. One based index of the member. Common set of chart attributes. Indicates whether the values are stacked, absolute or stacked 100% Common Attributes for baselines Common Attributes for a measure axis Visual affects for controlling the 2.5D look of some charts. Indicates whether or not to use spider effects. For polar type charts, indicates whether the arcs are cut or not. Common set of attributes for data points. Common definition of a line style Common definition of a line style Defines the set of enumerations for a viewing angle. Attributes common to line graphs. Attributes common to line graphs. Used in combination charts Which axis does this thing point to. Attribute to show data values Attribute to show data values Attributes to control the truncation of categoyr items. Attribute to indicate that display values should be shown as percentages. Attribute to indicate that display values are absolute values and not the cumulative values. Attribute for point charts that has two extra enumeration values in it. Attribute for point charts that has two extra enumeration values in it. Attributes for point charts that. Attributes for point charts that. Attributes to define borders on pie slices, bars, etc... Properties common to all map layers. Attribute to control the display of values Attributes to show location and presence of display values. Attributes related to data driven map layers. Indicates whether or not features that do not have corresponding data are rendered. Ensures that the full range of data is included in the legend. If set to false, only the values from the palette will be shown. Attribute that is a shared definition of a line style. Shows the measure values/labels for the points in the charts. Shows the point (legend) values/labels for the points in the charts. Shows the point cluster (category) values/labels for the points in the charts. Shows the measure values/labels for the points in the charts. Shows the point (legend) values/labels for the points in the charts. Shows the point cluster (category) values/labels for the points in the charts. Attributes common to baselines. Attribute to control whether or not labels are rotated with the chart. This may help make labels easier to read on rotated charts. - ===================================== Chart Types ================================================== Pie Chart. Repeating pies will not be directly supported. Instead use the matrix chart to have pies repeat. The exploded value is a percentage. Excel allows percentages up to 400. How do we handle the leader lines on this chart for any chart values? Still have not addressed the positiong of chart values. Data labels shown in a pie chart. These labels only have preset locations. Individual pies can be exploded. An exploded pie slice. The exploded value is a percentage. The slice to explode is either identified by report expression or index. This value overrides the global pie explosion value that is set on the chart. Use a report expression to determine which slice to explode. Defines the legend. STYLE: The legend will support font, color, background color, background image, generated background and padding. Used to style the chart body or plot area. In CGS lingo, this is the chart. STYLE: Only the following styles are allowed on the chartBody: background color, background image, generated background. Indicates whether tooltips should be rendered and what type of values to dipslay Combination Chart. Common axis for all items in the combination chart. Spacing attributes go here. Normally rendered as the top left axis. Normally rendered as the top right axis. Normally rendered as the top left axis. Normally rendered as the top right axis. Defines the legend. STYLE: The legend will support font, color, background color, background image, generated background and padding. Used to style the chart body or plot area. In CGS lingo, this is the chart. STYLE: Only the following styles are allowed on the chartBody: background color, background image, generated background. Tooltips are defined for the entire chart. Gauge Chart. Repeating gauges will not be directly supported. Instead use the matrix chart to have gauges repeat. Again I feel like we are exposing implementation and this should be cleaned up. Angles on the gauge chart are measures from the horizontal (3 o'clock) with positive angles going in the counter clockwise direction. Center point for all the needles. No idea how to specify the height of the pivot, or more correctly, what the value means. They seem to be percentages. Styling of the border of the dial. A gauge can have multiple axes visible on its face. Defines a single axis on the face of the gauge. It is unlikely that the engine will have such generic support, likely the tickMark and label elements will have to be replaced with something specific to this chart (yuck). Each row resulting in the chart nodes will be a needle. So, it chart nodes represents countries, this needle definition will be replicated for each country. Major gridlines on a gauge chart axis. Major gridlines on a gauge chart axis. Defines the legend. STYLE: The legend will support font, color, background color, background image, generated background and padding. Used to style the chart body or plot area. In CGS lingo, this is the chart. STYLE: Only the following styles are allowed on the chartBody: background color, background image, generated background. Instead of sectors, we have just a face color. Scatter Chart. Element to control display of scatter chart properties. Defines the legend. STYLE: The legend will support font, color, background color, background image, generated background and padding. Used to style the chart body or plot area. In CGS lingo, this is the chart. STYLE: Only the following styles are allowed on the chartBody: background color, background image, generated background. Bubble Chart from. Element to control display of bubble chart properties. Defines the measure to be used to size the data points. Defines the legend. STYLE: The legend will support font, color, background color, background image, generated background and padding. Used to style the chart body or plot area. In CGS lingo, this is the chart. STYLE: Only the following styles are allowed on the chartBody: background color, background image, generated background. Element which controls how to size the bubbles in a bubble chart. Bubbles are sized from zero to max. Bubbles are sized between the min and max values on the elment. Progressive Chart. The progressive chart does not support series. As such the legend is not particularly useful, but it can still show colors for positive, negative and total bars, for example. Category axis for the progressive chart. Slightly different than the combination chart. Presence of this element indicates that the total bar should be rendered. The text items represent the label for the bar. Defines the legend. STYLE: The legend will support font, color, background color, background image, generated background and padding. Used to style the chart body or plot area. In CGS lingo, this is the chart. STYLE: Only the following styles are allowed on the chartBody: background color, background image, generated background. Pareto chart. Bars of a pareto chart. The chart nodes will become series here. The bars are plotted against the left axis. Line in the pareto chart, it represents a cumulation of values. The line is plotted against the right axis. There will only ever be a single line, there a complete palette is not required. Represents the cumulation line in the pareto chart. If this element is not present the cumulation line is not drawn. Data labels for the cumulation line. Defines the legend. STYLE: The legend will support font, color, background color, background image, generated background and padding. Used to style the chart body or plot area. In CGS lingo, this is the chart. STYLE: Only the following styles are allowed on the chartBody: background color, background image, generated background. Bullet Chart Definition Bullet or actual value for the bullet chart. Target or expected value. Indicator for the bullet. This can be either a bar or a point. Target shown in the bullet chart. Used to style the chart body or plot area. In CGS lingo, this is the chart. STYLE: Only the following styles are allowed on the chartBody: background color, background image, generated background. Enables tool tips. ===================================== Simple Types ================================================= Definition for a transparency attribute Definition for a line style attribute Shapes for bars Controls where tickmarks are drawn ===================================== Attribute Groups =============================================== Indicates whether the series values will be used after filtering, before filtering or if all the values shared between this chart and the chart that is sharing a series with it. Display only the "series" categories in the filtered chart Display all possible "series" categories in the unfiltered chart Display all possible "series" categories in the unfiltered chart and any additional entries from a shared series. Common attributes for lines in v2 charts Common attributes for markers in v2 charts. Define a list of shapes for markers and data points. Depth is an arbitary value to define a 2.5 D look. 0 means no depth, 100 means a nice looking depth. There is no upper limit. Depth is an arbitary value to define a 2.5 D look. 0 means no depth, 100 means a nice looking depth. There is no upper limit. Attribute to control the bevel of different elements Attributes to be used if color by value measure is missing Borders on chart elements ===================================== Complex Types ============================================== This is a string of chart text items that can be individually styled. This is a string of chart text items that can be individually styled. Represents any text that is generated by the charting engine. The position is given by the member returned by the datasource. If this is a static value, such as Canada, it should be matched by string comparison. The offset is relative to that member. Negative values mean to the left and position values mean to the right. This is a percentage value. 50 means half way to the member to the immediate right. Common definition for anythying that uses a numerical axis. These will be either numeric or string labels depending on the context. If this element is not defined, labels will not be rendered for this axis. Labels will be drawn at every scale interval. TODO: Deal with label orientation and fitting. This is the generated or automatic title of an axis. TODO: This is incomplete. Missing label position control. The number of minor intervals controls how many minor gridlines or tick marks are rendered. This allows you to have either minor gridlines, minor tick marks or both. Axis title. This can either be specified or automatically generated by the server. If this element is not present no axis line will be rendered. Generic numerical axis definition for the combination chart. This is an incomplete definition. Also, it can be extended to include the stock / candle stick. Bars of a bar or column chart, depending on the chart orientation. If the bar thickness is not specified a suitable server default will be used. Values display in the chart for each data point. This defintion is not complete since it is missing placement and alignment control. Lines of a line chart. Can include data points or data markers. This does not have the showLine property. Use the v2_points element for points chart. If dataPoints are enabled here, their style will be defined by the line palette. If special data points are also defined, they will be drawn on top of the regular data points. Data points will be shown on the line if defined for the palette. Values display in the chart for each data point. This defintion is not complete since it is missing placement and alignment control. Put a marker at the high, low, open and / or close data value. If regular data points are also defined, these will be drawn on top. Marker that is drawn for he last non-null value in the line. It's position is the last ordinal value and the numeric value that corresponds to that ordinal. Marker that is drawn for the highest value in this line. Its position is the highest numeric value in the series and the corresponding ordinal value. Marker that is drawn for the lowest value in the line. Its position is the lowest numerical value for the line and the corresponding oridnal value. Marker that is drawn for the first non-null value in the line. Its position is the first ordinal value and the numeric value that corresponds to that ordinal. Area chart. When applying gradients or textures to an area, the bounding rectangle is used for calculation and placement, then the area itself is used as a mask (see Excel). Values display in the chart for each data point. This defintion is not complete since it is missing placement and alignment control. Baselines that are drawn against this numerical axis. Baselines are rendered in order, therefore the last baseline in the list will be rendered on top. Complex type to define special chart values. Mean of the data, adjusted by the number of standard deviations (+ or -) Mininum or maximum of the data. Percentile of the data Type for a generic chart measure. This includes a label definition in the event that the server needs to use the label for the measure (titles, ect...). Type for a bullet chart measure. No conditionalStyleRefs. This includes a label definition in the event that the server needs to use the label for the measure (titles, ect...). Same as the Chart Measure Type2 except for the addition of an attribute Common definition for a scatter chart axis These will be either numeric or string labels depending on the context. If this element is not defined, labels will not be rendered for this axis. Labels will be drawn at every scale interval. TODO: Deal with label orientation and fitting. This is the generated or automatic title of an axis. Baselines that are drawn against this numerical axis. Baselines are rendered in order, therefore the last baseline in the list will be rendered on top. Fill Effects supported by the server. Shared between palettes and conditional palettes. ===================================== Global Elements ============================================== Represents text styling within the chart. This element identifies the default measure to be used for a chart. If the measures of the chart cannot be determined by what is being rendered on the edges, then the default measure will be rendered. The style is appropriate only for data formating of values. These will be either numeric or string labels depending on the context. If this element is not defined, labels will not be rendered for this axis. TODO: Deal with label orientation and fitting. This is a title axis. TODO: There should be attributes to control the orientation of the axis title and how it is rendered. Common axis for all items in the combination chart. This represents minor gridlines. If not present, no minor gridlines will be rendred. The number of gridlines means how many will appear per scale interval (or major gridline) Major gridlines. If this element is not present, no major gridlines will be rendered. A major gridline will be drawn at every scale interval. Alternating background colors. First color to draw in the sequence Second color to draw in the sequence If this element is not present , no axis line will be rendered. Color used in alternating background colors. When these elements are placed in a sequence the first background color element will be applied to the first (lowest) gridline interval. Oridinal Axis Definition. The gap between ordinals works like Excel. It controls how much space (percent of bar width) that appears between clusters or ordinal values. Series overlap works like Excel and controls how much the series overlap (if present). It is expressed in percentage of bar thickness. Values display in the chart for each data point. This author can define the contents of the data labels or automatic can be used. For automatic, the server will determine the best choice. Typically this will include the value of the data point formatted appropriately and may also include the category and / or series name. Notes on the size from notes apply here as well. Baselines that are drawn against this numerical axis. Baselines are rendered in order, therefore the last baseline in the list will be rendered on top. Numerical Baseline drawn against this axis. Style defines the color, transparency and possible gradient for the baseline. Collection of markers to draw on a chart with an ordinal axis. Single marker to draw on the chart. The z-order of the markers is determined by their order in this list. If no pointFill is defined, the marker is hollow (empty/transparent). The marker can be filled by an image, gradient or color and includes transparency. The position of the marker corresponds to the center of the marker. Collection of markers to draw on a scatter or bubble chart. Single marker to draw on the chart. The z-order of the markers is determined by their order in this list. If no pointFill is defined, the marker is hollow (empty/transparent). The marker can be filled by an image, gradient or color and includes transparency. The position of the marker corresponds to the center of the marker. Where the marker will be positioned on the y axis. Where the marker will be positioned on the x axis. Position along an ordinal axis Defines the legend. The legend has an optional width and height. If not specified, the server will determine what makes sense based on an algorithm. If either is specified, the server will attempt to fit everything in it. STYLE: Padding, font, generated background, color, background color Position of the legend. This can be from a preset or from a specific setting. Position the legend with a preset value. This is a title axis. TODO: There should be attributes to control the orientation of the axis title and how it is rendered. Text to display in the legend when all the legend entries cannot fit. Others... or More... seems appropriate but the author can put wahtever they want. Notes displayed in a chart. Notes could follow the same rendering as the tooltips. Note displayed in a chart. The width of the note must be specified. However, height is optional. If not specified, the height of the note will be determined by fitting all the wrapped text. The note will grow up or down depending on its anchor type. To display images in a note use eithe the background image style or the generated background style. Used to style the chart body or plot area. Index of the ordinal. One based index of the member. Defines the text for the element. It can either be automatic or specified by the author. In either case style is inherited from the parent. Server generated automatic text. Display the trend line equation and / or the R-squared value in a note. If the note is displayed in the legend, it will be displaye with the line style. If it is displayed in the chart, it will be displayed near tht line. Defines how the equation note is positioned. If shown in the chart, it can be positioned and styled just as a note can. Element would support the full styling of a note. If shown in the legend, the equations are shown just below the entry for the label of the trend line (if shown). This element would only support style that applies to text. subtype Container for chart text items. Individual text items. STYLE: The chart text item only supports font and color. Numeric axis Numeric axis Chart Drop Shadow End point along the ordinal axis. End must be after start. First numeric position region of the colored region. Left and top are confused when chart is rotated. Start must be less than end. Last numeric position. Left and top are coifusing when the chart is rotated. End must be more than start. Starting point along hte ordinal axis. Start must be before end. If shown in the legend, the equations are shown just below the entry for the label of the trend line (if shown). If shown in the chart, it can be positioned and styled just as a note can. Generic authored label for charts. STYLE: Labels support font and color Position along the numeric axis. Lines that are calculated based on statistics. If this is used in anything other than a scatter chart, it will use the ordinal index or Date as its indepdentant variable. Definition of a trend line. A line can have a gradient style. Type of the trend line. Linear Regression Line Display the trend line equation and / or the R-squared value in a note. If the note is displayed in the legend, it will be displaye with the line style. If it is displayed in the chart, it will be displayed near tht line. Exponential Regression Line Polynomial Regression Line Common Log Regression Line Natural Log Regression Line Power Regression Line Not really a regression line, but kept here anyway. Shows the moving average. Periods is really just the number of ordinals. Label to show with the trendline. Connecting Lines definition. Maximum items (categories or slices) to allow before the remianing items are grouped togehter into a new item (category or slice). The style of this new category will follow the current palette definition. If specified, indicates the maximum number of items that will be displayed before gropuing occurs. If specified, indicates the threshold at which values are grouped. Any value below this threshold is grouped into the other category. Any value below this threshold percentage is grouped into the other category. This is a percentage of the total data in the data set. Generic chart measure. Its meaning is generally derived from its parent element. Generic constrained positions. List of string values to match in a conditional palette. String value to match in a conditional palette. In the future, if required, a calculated range element can be added where the values of the min, max and scaleInterval can be calculated from a report or query expression. The range for the axis will be calculated by the server based on the data. The range for the axis is specified by the author. If any of the optional attributes are not provided, they will be filled in by the server. For example, the author can specify the min and have the server determine an appropriate max and interval. Color and position. Solid color with transparency. Linear gradient without transparency because the engine cannot support it. X Axis. Y Axis. Category definition. Just a chartNodes element. Series definition. Just a chartNodes element. Defines how to render a one or two dimension matrix of this chart. What about nesting and unioning on these edges? Decide on convention and stick with it. How many levels of nesting from the series will be used as matrix rows. Controls how the matrix labels for the rows will be rendered. How many levels of nesting from the category will be used as matrix columns. Controls how the matrix labels for the rows will be rendered. Indicates what the positions are anchored to. If the anchor is a report expression it will generally result in a category with is a point, bar or similar riser. The position will be relative to the top or end of this riser and its center on the opposite axis. Positions are relative to the chart. Commonly called vertical baselines for vertical charts, these baselines are positioned by an ordinal value. Baselines are rendered in order, therefore the last one in the list will be on top. Baseline positioned by an ordinal value. Title for a chart. STYLE: Titles support font, background color, background image generated background and color. Sub title for a chart. Footer for the chart. Markers cannot be achored to the chart so we have a special definition here that removes that option from the constrainedposition. A marker can be positioned relative to the chart body or to a value identified by the report expression. This is a collection of rectangles drawn in the chart body to highlight special regions. They are drawn behind the risers. For z-order considerations, regions are drawn in order, so the last region will be drawn on top of the others. This is a collection of rectangles drawn in the chart body to highlight special regions. They are drawn behind the risers. For z-order considerations, regions are drawn in order, so the last region will be drawn on top of the others. A region has a fill defined by style, a start numeric and ordinal positions as well as end numeric and ordinal positions. If both pattern and style (backgfround color, generated background) are defined, the pattern is drawn on top of the item. The width and height are ignored if the calculated position is used. Generic authored label. A region has a fill defined by style, a start numeric and ordinal positions as well as end numeric and ordinal positions. If both pattern and style (backgfround color, generated background) are defined, the pattern is drawn on top of the item. The width and height are ignored if the calculated position is used. Generic authored label. Top position of the colored region. Bottom position of the colored region. Left position of the colorred region. right position ofthe colored region. Server generated label. Horizontal position. Offset from left. Offset from the center. Offset from the right. Vertical position. Offset from the top. Offset from the middle. Offset from the bottom. Represents that area inside the plot, between the axes. This allows for putting a background there. Positions are relative to be chart body. ============================== Palette Stuff ==================================== Palette definition for bars, pies and areas Palette definition for lines Collection of line palette entires. Palette definition for points, scatter and bubbles Collection of point palette entries. Full color by value definition Controls the fill on the progressive bars. Defines how bars for positive values are filled. Choice between authored label and automatic label. Defines how bars for negative values are filled. Choice between authored label and automatic label. Defines how the first bar is filled. Choice between authored label and automatic label. Defines how the total bar, if present, is filled. Choice between authored label and automatic label. Definition of a fill effect as indicated by current CGS support. Radial rectangle gradient without transparency because the engine cannot support it. Radial rectangle gradient without transparency because the engine cannot support it. If this is a percentage, it is a percentage of the greater of the height or the width of the bounding rectange. If this is a percentage, it is a percentage of the greater of the height or the width of the bounding rectange. Image Defines an image. The image can be placed within the generated background through different means. Determines how the image is positioned. Place the by specifying an X and Y location. Explicit position is measured from the top left corner of the rectangle. Stretch the image to fit. Preset image locations Pattern without transparency. Palette that uses linear interpolation to determine the color and other attributes for risers in charts. The conditional data item refers to the numerical value used to determine the location in the list of entries. Typically this will refer to the query of the chart, but may often not refer to a data item actually displayed in the chart. For example, the chart could be showing bars of revenue where the bars are colored by Gross Margin. The boundaryValueType attribute tells you if the boundary values are percentages of range from min to max of all values or if they are absolute values that will match the data. Since borders and material effects cannot be linearly interpolated, they are included here. Conditionally change the bar color or style. If no matching condiition is found, the next palette entry is used. This element is modeled from named conditional styles. The showInLegend attribute indicates whether or not a legend entry should be generated for each condition. A report expression is used to choose the pie palette entry. Container for list of advanced conditions in the pie conditional palette. Individual report condition case. If the child condition is true, use the child piepalette entry. A numeric range is used to choose a bar area palette entry. Container for the list of range conditional styles in the bar / area conditional palette. Individual range case. These cases must be ordered according to the value attribute. Any elements not satisfied by the range use this palette entry. A condition based on string values, much like a case statement. List of string cases. These can be explicit names or can be string matching criteria. List of strings. The selectedValues attribute is only used by the authoring tool. Rules to match names. Conditionally change the point color or style. If no matching condiition is found, the next palette entry is used. This element is modeled from named conditional styles. PP is short for Point Palette. The showInLegend attribute indicates whether or not a legend entry should be generated for each condition. A report expression is used to choose the point palette entry. Container for list of advanced conditions in the point conditional palette. Individual report condition case. If the child condition is true, use the child point palette entry. A numeric range is used to choose a point palette entry. Container for the list of range conditional styles in the point conditional palette. Individual range case. These cases must be ordered according to the value attribute. Any elements not satisfied by the range use this palette entry. A condition based on string values, much like a case statement. List of string cases. These can be explicit names or can be string matching criteria. List of strings. The selectedValues attribute is only used by the authoring tool. Rules to match names. Conditionally change the line and / or point color or style. If no matching condiition is found, the next palette entry is used. This element is modeled from named conditional styles. LP is short for Line Palette. The showInLegend attribute indicates whether or not a legend entry should be generated for each condition. A report expression is used to choose the line and / or point palette entry. Container for list of advanced conditions in the line and / or point conditional palette. Individual report condition case. If the child condition is true, use the child point palette entry. A numeric range is used to choose a point palette entry. Container for the list of range conditional styles in the point conditional palette. Individual range case. These cases must be ordered according to the value attribute. Any elements not satisfied by the range use this palette entry. A condition based on string values, much like a case statement. List of string cases. These can be explicit names or can be string matching criteria. List of strings. The selectedValues attribute is only used by the authoring tool. rn_internal_4.0" Rules to match names. Single line palette entry. The fill will be used for both the line and markers (if defined). Fill for the line. This is a limited set of v2_fillEffects Single palette entry for point type charts Single entry in the palette Label to be shown in the legend for a conditional palette entries Collection of solid palette entires. The entry has both color and transparency. This means that both color and transparency must be interpolated. Mesure used during the determination of color by value. Styling of chart node members must be done by applying style to the appropriate containing element. Typically this will either be an ordinalAxis or the legend. The child style element is only used for data formating of display values. Position along the axis. Represents the palette used for coloring the guage axis. Similar to guagePalette from PGSDK. Colors to display behind the axis range (numbers). Palette that controls the look of the dialog portion of a gauge. You can do a tachometer effect, green, yellow and red. Describes a list of discrete palette entries. Defines a single discrete palette entrie. An externally defined visualization. The type attribute indicates the type of the chart e.g. vis.ibm.com.bubblechart Data items that are on the rows edge of the query generated. The order of the items is the nesting order on the edge. An edge definining category values. Nested levels in the category edge Represents a level of unioned values in the query. The fields are mapped to certain sets of values in this level. Maps data item to viz field. idField must reference a viz field defined in the edge or a value field if the data item is numeric Data items that make up the set of values for the categorical field. The data items both sets and measures are unioned together to form a set of values. subtype Defines a label for the element to be used as the field label. When not specified the label will be determined from the default labels for the associated data items. The min/max range of the category field generated will the one of - all: full set of values - filtered: set of values that is visible for the user for the viz (in a non AR report, this is the same as all) Levels on this edge that are not visually used in the viz but can be used to filter the data interactively or for setting of variables. By default, put at lower levels so that they do not interfere with sorting. Only used in Active Reports. Values that are used in the viz. The data items will be unioned on to the columns edge of the query generated. The category(rows) edge of the query will have a higher solve order than the values(columns) edge. Represents a value in the viz. Can be one of measure, member or tuple. Maps data item to a value field in viz. subtype Represents a value in the viz that is not visually used in the viz but is available to filter the data interactively. Only used in Active Reports. The default measure for the query generated for the viz. This allows queries that do not have measures for the vizValues to resolve to a value. id for the data set definition in the RAVE spec subtype Indicates the type of the chart e.g. vis.ibm.com.bubblechart Used to specify the type of rendering (eg svg or canvas) for renderers that support a choice When chart data is changed it will automatically suggest the most appropriate chart type. Palette ID from the reporting palettes.json system file. Palette ID from the collection of palettes stored in content manager. The min/max range of the value field generated will the one of - full set of values generated for all details in a master/detail - set of values generate for an individual detail in a master/detail (if there is not master, then master and detail are the same) - set of values that is visible for the user for the viz (in a non AR report, this is the same as detail Ensure that the min/max range generated for this field will always contain 0 Defines a label to be used for the field item label if there are no vizCategoryDataItems. When not specified the label will either be empty, or if there is a single vizValue, show its label. Data formatting for the vizValues associated with this category data item. subtype