Appboard/old/widgets/pie chart: Difference between revisions

imported>Cmace
(created to remove appboard_builder)
 
imported>Cmace
(copied from internalwiki)
Line 1: Line 1:
== Adding a Pie Chart Widget ==
An Area Chart Widget is a graphical Widget that displays a circular image, divided into segments representing proportions in the underlying data.


Click "Add Widget" in the tool palette on the left.  If "Add Widget" is disabled, refer to the "Adding a Stack" section. 
# Enter a name for the Widget
# Select Pie Chart Widget
# Select the Board you'd like the Pie Chart Widget to appear on.
# Select "OK".


[[Image:PieChartExample.png|thumb|center|500px|Pie Chart Example]]


== Configuring Pie Chart ==


# Select a Data Collection that contains the information you'd like to use for this pie chart.
== How To Create a Pie Chart Widget ==
#:* Click the "Data Collection" pulldown, then select from the list of available Data Collections.
For instructions on creating a Widget, see the general instructions in [[Widgets#Adding_Widgets|Adding Widgets]].  The <b>Pie</b> Widget type is located under the <b>Charts</b> category on the Widget selection screen.
#:* If you do not see any Data Collections, refer to [[Data_Collections|Add/Edit/Remove a Data Collection]].
 
#:* Selecting a Data Collection will populate the other options in the Data Section.
 
# Select name and value fields from the Data Collection that this pie chart would visualize. "Name Field" usually is the field that has a unique value that identify a grouping concept. "Value Field" usually is the field indicate that quantity in a particular group.
== How To Configure a Pie Chart Widget ==
#:* Click "Name Field" pulldown, and then select an item from the list.  
Follow the instructions above to create the basic "Area Chart" Widget, and then perform the following steps to configure a Pie Chart Widget:
#:* Click "Value Field" pulldown, and then select an item from the list.  
 
# Click "Label Type" pulldown, and then select an item from the list.
 
#:* An example would be callout. The label for a pie slice would be shown in the callout style.
=== Select a Data Collection ===
# Click "Show Legend" option to indicate whether a legend area is shown or not.
Select a '''Data Collection''' that contains the information you would like to use for this Widget.  
# In "Color Selection" area, use color chooser to set the color of each pie slice.
* Click the "Data Collection" pulldown, then select from the list of available Data Collections.
* If you're using the sample CSV data, select "Sample.Data.ChartData2".
* If there are no Data Collections available in the pulldown, then click here for instructions on how to bring in some [[Sample_Chart_Data|Sample Chart Data]], or refer to [[Data_Collections|Add/Edit/Remove a Data Collection]].
 
 
=== Name Field ===
Specifies the field of the Data Collection to use as the name for the wedge. This is the value that will be used for the Legend and DataTips.  
* Click "Name Field" pulldown, and then select an item from the list.
If you are using ''Sample.Data.ChartData2'', then select "Task" for the Name Field.
 
 
=== Value Field ===
Specifies the field of the Data Collection that determines the data for each wedge of the pie chart.
* Click the "Value Field" pulldown, and then select an item from the list.
If you are using ''Sample.Data.ChartData2'', then Select "Feb", as the Value Field.
 
=== Color Selection ===
Use the color chooser to set the color of each pie slice.
 
 
=== Labels ===
Click the "Label" pulldown, and then select an item from the list.
 
* '''None''': Does not draw labels. This is the default value.
* '''Callout''': Draws labels in two vertical stacks on either side of the PieChart control. Shrinks the PieChart if necessary to make room for the labels. Draws key lines from each label to the associated wedge. Shrinks labels as necessary to fit the space provided.
* '''Inside''': Draws labels inside the chart. Shrinks labels to ensure that they do not overlap each other. Any label that must be drawn too small is hidden from view.
* '''InsideWithCallout''': Draws labels inside the pie, but if labels are shrunk below a legible size, Flex converts them to callout labels.
* '''Outside''': Draws labels around the boundary of the PieChart control.
 
[[Image:pieChart_Labels.png|Sample Pie Chart Labels]]
 
 
=== Legend ===
Click the "Show Legend" option to indicate whether a legend is shown or not.
 
[[Image:pieChart_Legend.png|Sample Pie Chart Labels]]
 
 
=== Inner Radius ===
Click the "Inner Radius" option to take a circle out of the middle of the pie chart, expand or minimize using the bar provided.
 
[[Image:pieChart.png|Sample Pie Chart]]
 
 
=== Additional Configuration Steps ===
* Provide additional configuration, if needed, on the <b>Options</b> tab.  For details on the available Options, see [[Options|Options]].
 
 
* Enter the following information on the <b>Actions</b> tab:
** Click <b>Add Event Action</b> to configure one or more [[Actions|Actions]] to be invoked when a user clicks on the Pie Chart Widget.  The action will apply to the current data record being displayed.
 
 
== Sample Data ==
 
Instructions for bringing sample chart data into AppBoard can be found here: [[Sample_Chart_Data|Sample Chart Data]]

Revision as of 14:28, 8 May 2012

An Area Chart Widget is a graphical Widget that displays a circular image, divided into segments representing proportions in the underlying data.


Pie Chart Example


How To Create a Pie Chart Widget

For instructions on creating a Widget, see the general instructions in Adding Widgets. The Pie Widget type is located under the Charts category on the Widget selection screen.


How To Configure a Pie Chart Widget

Follow the instructions above to create the basic "Area Chart" Widget, and then perform the following steps to configure a Pie Chart Widget:


Select a Data Collection

Select a Data Collection that contains the information you would like to use for this Widget.

  • Click the "Data Collection" pulldown, then select from the list of available Data Collections.
  • If you're using the sample CSV data, select "Sample.Data.ChartData2".
  • If there are no Data Collections available in the pulldown, then click here for instructions on how to bring in some Sample Chart Data, or refer to Add/Edit/Remove a Data Collection.


Name Field

Specifies the field of the Data Collection to use as the name for the wedge. This is the value that will be used for the Legend and DataTips.

  • Click "Name Field" pulldown, and then select an item from the list.
If you are using Sample.Data.ChartData2, then select "Task" for the Name Field.


Value Field

Specifies the field of the Data Collection that determines the data for each wedge of the pie chart.

  • Click the "Value Field" pulldown, and then select an item from the list.
If you are using Sample.Data.ChartData2, then Select "Feb", as the Value Field.

Color Selection

Use the color chooser to set the color of each pie slice.


Labels

Click the "Label" pulldown, and then select an item from the list.

  • None: Does not draw labels. This is the default value.
  • Callout: Draws labels in two vertical stacks on either side of the PieChart control. Shrinks the PieChart if necessary to make room for the labels. Draws key lines from each label to the associated wedge. Shrinks labels as necessary to fit the space provided.
  • Inside: Draws labels inside the chart. Shrinks labels to ensure that they do not overlap each other. Any label that must be drawn too small is hidden from view.
  • InsideWithCallout: Draws labels inside the pie, but if labels are shrunk below a legible size, Flex converts them to callout labels.
  • Outside: Draws labels around the boundary of the PieChart control.

Sample Pie Chart Labels


Legend

Click the "Show Legend" option to indicate whether a legend is shown or not.

Sample Pie Chart Labels


Inner Radius

Click the "Inner Radius" option to take a circle out of the middle of the pie chart, expand or minimize using the bar provided.

Sample Pie Chart


Additional Configuration Steps

  • Provide additional configuration, if needed, on the Options tab. For details on the available Options, see Options.


  • Enter the following information on the Actions tab:
    • Click Add Event Action to configure one or more Actions to be invoked when a user clicks on the Pie Chart Widget. The action will apply to the current data record being displayed.


Sample Data

Instructions for bringing sample chart data into AppBoard can be found here: Sample Chart Data

Retrieved from "http://ab.edge-technologies.com/docs/index.php?title=Appboard/old/widgets/pie_chart&oldid=1135"