Skip to content

Commit d9aba2e

Browse files
committed
Adding more details
1 parent a33cd86 commit d9aba2e

File tree

1 file changed

+39
-38
lines changed

1 file changed

+39
-38
lines changed

powerapps-docs/developer/model-driven-apps/understand-charts-underlying-data-chart-representation.md

Lines changed: 39 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Charts display data visually by mapping textual values on two axes: horizontal (
4343

4444
The data description XML string defines the data that is displayed on the chart. The contents of the XML string are validated against the visualization data description schema. For more information about the schema, see [Visualization Data Description Schema](visualization-data-description-schema.md).
4545

46-
You can specify the data description XML string while you are creating a chart using the `SavedQueryVisualization.DataDescription` or the `UserQueryVisualization.DataDescription` attribute for the organization-owned or user-owned chart respectively.
46+
You can specify the data description XML string while you are creating a chart using the `SavedQueryVisualization.DataDescription` or `UserQueryVisualization.DataDescription` attribute for the organization-owned or user-owned chart respectively.
4747

4848
The data description XML string contains the following two elements: `<FetchCollection>` and `<CategoryCollection>`.
4949

@@ -147,14 +147,14 @@ Gets or sets the X-axis type of the series.
147147
|LabelStyle Enabled|Gets or sets a flag that indicates whether the label is enabled.|
148148
|LabelStyle ForeColor|Gets or sets the color of the label.|
149149
|LabelStyle Format|Gets or sets the formatting string for the label text. More information: [Supported numeric format for charts](#supported-numeric-format-for-charts-in-unified-interface)|
150-
|LineColor|Gets or sets the line color of an axis.|
151-
|IsReversed|Gets or sets a flag which indicates whether the axis is reversed.|
150+
|LineColor|Gets or sets the line color of an axis. More information: [Supported color format](#supported-color-format-in-unified-interface)|
151+
|IsReversed|Gets or sets a flag which indicates whether the axis is reversed.<br/> If set to true, it has two effects for x-axis:<br/> - x-axis labels are flipped in the reversed order (from right-to-left)<br/>- It also bring the y-axis to the opposite side, to accommodate above right-to-left x-axis label.|
152152
|MajorGrid Enabled|Gets or sets a flag that determines whether major or minor grid lines are enabled.|
153-
|MajorGrid LineColor|Gets or sets the line color of a grid.|
153+
|MajorGrid LineColor|Gets or sets the line color of a grid. More information: [Supported color format](#supported-color-format-in-unified-interface)|
154154
|MajorTickMark Enabled|Need description|
155155
|MajorTickMark LineColor|Need description|
156156
|Title|Gets or sets the title of the axis.|
157-
|TitleForeColor|Gets or sets the text color of an axis title.|
157+
|TitleForeColor|Gets or sets the text color of an axis title. More information: [Supported color format](#supported-color-format-in-unified-interface)|
158158

159159
**Example**
160160

@@ -174,21 +174,21 @@ Gets or sets the Y-axis type of the series.
174174

175175
|Property Name| Description|
176176
|-------------|------------|
177-
|AxisY2|Gets or sets an Axis object that represents the secondary Y-axis.|
177+
|AxisY2|Gets or sets an Axis object that represents the secondary Y-axis.<br/> - Second Yaxis only applies to multiple series chart. <br/> - If you create multiple series chart with the chart editor, by default, the `YAxisType=Secondary` property will be added to the 2nd series of your chart, and a `AxisY2` node is added to the XML.<br/> - If you want another series to be measured by second Y axis, you can move the `YAxisType=Secondary` to that series node. <br/> - If you don't want a second Y axis, you can delete the `YAxisType=Secondary`.<br/> - If a Y Axis (either primary or secondary) measures more than 1 series, title will not be added to that Y Axis, because Y Axis title doesn't know which series to display.|
178178
|Enabled|Gets or sets a value that indicates whether an axis is enabled.|
179179
|Interval|Gets or sets the interval of an axis.|
180180
|LabelStyle Enabled|Gets or sets a flag that indicates whether the label is enabled.|
181181
|LabelStyle ForeColor|Gets or sets the color of the label.|
182182
|LabelStyle Format|Gets or sets the formatting string for the label text. More information: [Supported numeric format for charts](#supported-numeric-format-for-charts-in-unified-interface)|
183-
|LineColor|Gets or sets the line color of an axis.|
183+
|LineColor|Gets or sets the line color of an axis. More information: [Supported color format](#supported-color-format-in-unified-interface)|
184184
|MajorGrid Enabled|Gets or sets a flag that determines whether major or minor grid lines are enabled.|
185-
|MajorGrid LineColor|Gets or sets the line color of a grid.|
185+
|MajorGrid LineColor|Gets or sets the line color of a grid. More information: [Supported color format](#supported-color-format-in-unified-interface)|
186186
|MajorTickMark Enabled|Need description|
187187
|MajorTickMark LineColor|Need description|
188188
|Maximum|Gets or sets the maximum value of an axis.|
189189
|Minimum|Gets or sets the minimum value of an axis.|
190190
|Title|Gets or sets the title of the axis.|
191-
|TitleForeColor|Gets or sets the text color of an axis title.|
191+
|TitleForeColor|Gets or sets the text color of an axis title. More information: [Supported color format](#supported-color-format-in-unified-interface)|
192192

193193
**Example**
194194

@@ -213,7 +213,7 @@ The root class for the charts.
213213

214214
|Property Name|Description|
215215
|-------------|------------|
216-
|PaletteCustomColor|Gets or sets an array of custom palette colors. It follows the priority as shown below: <br/> - Renders the color defined in the `Series` node. <br/> - If the color pallet is specified, chart picks the color from the color pallet. <br/> - If none is specified, it picks up the default color pallet.|
216+
|PaletteCustomColor|Gets or sets an array of custom palette colors. It follows the priority as shown below: <br/> - Renders the color defined in the `Series` node. <br/> - If the color pallet is specified, chart picks the color from the color pallet. <br/> - If none is specified, it picks up the default color pallet. More information: [Supported color format](#supported-color-format-in-unified-interface)|
217217

218218
**Example**
219219

@@ -230,15 +230,15 @@ Represents a chart area on the chart image.
230230
|Property Name| Description|
231231
|-------------|------------|
232232
|Area3DStyle Enable3D|Gets or sets a value that indicates whether the flag toggles the 3D on and off for a chart area.|
233-
|BackColor|Allow users to set the plot background to either a solid or a gradient color.|
234-
|BackSecondaryColor|Allow users to set the plot background to either a solid or a gradient color.|
233+
|BackColor|Allow users to set the plot background to either a solid or a gradient color. More information: [Supported color format](#supported-color-format-in-unified-interface)|
234+
|BackSecondaryColor|Allow users to set the plot background to either a solid or a gradient color. More information: [Supported color format](#supported-color-format-in-unified-interface)|
235235
|BackGradientStyle|Allow users to set the plot background to either a solid or a gradient color.|
236236

237237
**Example**
238238

239239
```xml
240240
<ChartArea BackColor="orange" BackSecondaryColor="purple" BackGradientStyle="LeftRight" >
241-
<Area3DStyle Enable3D="true" />
241+
<Area3DStyle Enable3D="true" />
242242
</ChartArea>
243243
```
244244

@@ -256,7 +256,7 @@ Represents the legend for the chart image.
256256

257257
```xml
258258
<Legends>
259-
<Legend Enabled="True"/>
259+
<Legend Enabled="True"/>
260260
</Legends>
261261
```
262262

@@ -268,26 +268,26 @@ Stores data points and series attributes.
268268

269269
|Property Name| Description|
270270
|-------------|------------|
271-
|BorderColor|Gets or sets the border color of the data point.|
271+
|BorderColor|Gets or sets the border color of the data point. More information: [Supported color format](#supported-color-format-in-unified-interface)|
272272
|BorderWidth|Gets or sets the border width of the data point.|
273-
|ChartType| An enumeration value that indicates the chart type that is used to represent the series. The default value is Column. It supports the following chart types: <br/> - Column <br/> - StackedColumn <br/> - StackedColumn100 <br/> - Bar <br/> - StackedBar <br/> - StackedBar100 <br/> - Area <br/> - StackedArea <br/> - StackedArea100 <br/> - Line <br/> - Pie <br/> - Funnel <br/> - Tag <br/> - Doughnut <br/> - Point|
274-
|Color|Gets or sets the color of the data point. For funnel and pie charts, the color property defined in the series node is ignored, but picks the chart color from color palette.|
273+
|ChartType| An enumeration value that indicates the chart type that is used to represent the series. The default value is Column. It supports the following chart types: <br/> - Column <br/> - StackedColumn <br/> - StackedColumn100 <br/> - Bar <br/> - StackedBar <br/> - StackedBar100 <br/> - Area <br/> - StackedArea <br/> - StackedArea100 <br/> - Line <br/> - Pie <br/> - Funnel <br/> - Tag <br/> - Doughnut <br/> - Point|
274+
|Color|Gets or sets the color of the data point. For funnel and pie charts, the color property defined in the series node is ignored, but picks the chart color from color palette. More information: [Supported color format](#supported-color-format-in-unified-interface)|
275275
|IsValueShownAsLabel|Gets or sets a flag that indicates whether to show the value of the data point on the label.|
276276
|CustomProperties|Allows users to set `FunnelNeckHeight` and `FunnelNeckWidth` to customize funnel chart's shape. FunnelNeckHeight & FunnelNeckWidth represents the percentage. This parameter is only supported for funnel chart types.|
277277
|IsVisibleInLegend|Gets or sets a flag that indicates whether the item is shown in the legend.|
278-
|LabelForeColor|Gets or sets the text color of the label.|
278+
|LabelForeColor|Gets or sets the text color of the label. More information: [Supported color format](#supported-color-format-in-unified-interface)|
279279
|LabelFormat|Gets or sets the format of the data point label. More information: [Supported numeric format for charts](#supported-numeric-format-for-charts-in-unified-interface)|
280-
|LegendText|Gets or sets the text of the item in the legend. For funnel and pie charts, the legend displays each individual data point's value in a series. Instead of displaying the series name as a whole.|
281-
|YAxisType|Gets or sets the Y-axis type of a series. Only second Y-axis is supported, not second X-axis.|
280+
|LegendText|Gets or sets the text of the item in the legend. For funnel and pie charts, the legend displays each data point's value in a series. Instead of displaying the series name as a whole.|
281+
|YAxisType|Gets or sets the Y-axis type of a series. Only the second Y-axis is supported, not second X-axis.|
282282

283283
**Example**
284284

285285
```xml
286286
<Series>
287-
<Series ChartType="Column" Color="91, 151, 213" LegendText="Est Revenue" IsVisibleInLegend="True" BorderColor="red" BorderWidth="1" IsValueShownAsLabel="True" LabelFormat="$#,0,.##K" LabelForeColor="59, 59, 59">
288-
</Series>
289-
<Series ChartType="Column" Color="237, 125, 49" LegendText="Actual Revenue" IsVisibleInLegend="True" BorderColor="red" BorderWidth="1" IsValueShownAsLabel="True" LabelFormat="$#,0,.##K" LabelForeColor="59, 59, 59" YAxisType="Secondary">
290-
</Series>
287+
<Series ChartType="Column" Color="91, 151, 213" LegendText="Est Revenue" IsVisibleInLegend="True" BorderColor="red" BorderWidth="1" IsValueShownAsLabel="True" LabelFormat="$#,0,.##K" LabelForeColor="59, 59, 59">
288+
</Series>
289+
<Series ChartType="Column" Color="237, 125, 49" LegendText="Actual Revenue" IsVisibleInLegend="True" BorderColor="red" BorderWidth="1" IsValueShownAsLabel="True" LabelFormat="$#,0,.##K" LabelForeColor="59, 59, 59" YAxisType="Secondary">
290+
</Series>
291291
</Series>
292292
```
293293

@@ -304,27 +304,28 @@ Unified Interface supports the following color formats in chart presentation xml
304304

305305
|Formatting values|Description|
306306
|------------|----------------|
307-
|`#,0` | No scaling, No decimals, leading zero|
307+
|`#,0` | No scaling, No decimals, leading zero|
308308
|`#,0,.##K`|Thousands, up to 2 decimals, leading zero|
309309
|`#,0,,.##M`|Millions, up to 2 decimals, leading zero|
310310
|`#,0,,,.##B` |Billions, up to 2 decimals, leading zero|
311311
|`C`|Currency with default decimals|
312312
|`C0`| Currency with no decimals|
313313
|`C2`|Currency with 2 decimals|
314314
|`F0`|Fixed point|
315-
|`#,0;(#,0);' '`| No scaling, no decimals, leading zero, negative value shown in braces, suppress zeros|
316-
|#,0,.##K;(#,0,.##K);' ' | Thousands, up to 2 decimals, leading zero negative value shown in braces, suppress zeros|
317-
|#,0,,.##M;(#,0,,.##M);' ' | Millions,  up to 2 decimals, leading zero negative value shown in braces, suppress zeros|
318-
|#,0,,,.##B;(#,0,,,.##B);' ' | Billions, up to 2 decimals, leading zero negative value shown in braces, suppress zeros|
319-
|%|Percent sign (%) in a format string causes a number to be multiplied by 100 before it is formatted|
315+
|`#,0;(#,0);' '`| No scaling, no decimals, leading zero, negative value shown in braces, suppress zeros|
316+
|`#,0,.##K;(#,0,.##K);' '` | Thousands, up to 2 decimals, leading zero negative value shown in braces, suppress zeros|
317+
|`#,0,,.##M;(#,0,,.##M);' '`| Millions, up to 2 decimals, leading zero negative value shown in braces, suppress zeros|
318+
|`#,0,,,.##B;(#,0,,,.##B);' '` | Billions, up to 2 decimals, leading zero negative value shown in braces, suppress zeros|
319+
|`%`|Percent sign (%) in a format string causes a number to be multiplied by 100 before it is formatted|
320320
|||
321321

322322
### See also
323-
[Visualizations (Charts)](view-data-with-visualizations-charts.md)
324-
[Actions on Visualizations (Charts)](actions-visualizations-charts.md)
325-
[Create a Chart](create-visualization-chart.md)
326-
[Use FetchXML to construct a query](../common-data-service/use-fetchxml-construct-query.md)
327-
[FetchXML schema](../common-data-service/fetchxml-schema.md)
328-
[Visualization Data Description Schema](visualization-data-description-schema.md)
329-
[Sample Charts](sample-charts.md)
330-
[Chart Class (Microsoft Chart Controls)](https://msdn.microsoft.com/library/system.web.ui.datavisualization.charting.chart.aspx)
323+
324+
[Visualizations (Charts)](view-data-with-visualizations-charts.md)
325+
[Actions on Visualizations (Charts)](actions-visualizations-charts.md)
326+
[Create a Chart](create-visualization-chart.md)
327+
[Use FetchXML to construct a query](../common-data-service/use-fetchxml-construct-query.md)
328+
[FetchXML schema](../common-data-service/fetchxml-schema.md)
329+
[Visualization Data Description Schema](visualization-data-description-schema.md)
330+
[Sample Charts](sample-charts.md)
331+
[Chart Class (Microsoft Chart Controls)](https://msdn.microsoft.com/library/system.web.ui.datavisualization.charting.chart.aspx)

0 commit comments

Comments
 (0)