Appboard/2.5/tutorials/getting started tutorial - Revision history

imported>Jason.nicholls: /* Data Sources */

2014-09-23T08:14:18Z

Data Sources

← Older revision		Revision as of 08:14, 23 September 2014
Line 57:		Line 57:
	## Click the ''Add Data Source'' button.		## Click the ''Add Data Source'' button.
	# The Data Source Wizard will now display the ''Connect'' step, complete the following fields:		# The Data Source Wizard will now display the ''Connect'' step, complete the following fields:
	## ''Directory'': click the magnifying glass and select ~~'''TODO'''~~		## ''Directory'': click the magnifying glass and select <tt>examples/getting_started</tt>
	## ''Header Meta Delimiter'': Asterisk		## ''Header Meta Delimiter'': Asterisk
	## Click the ''Next'' button.		## Click the ''Next'' button.

imported>Jason.nicholls: /* Next Steps */

2014-09-22T12:30:50Z

Next Steps

← Older revision		Revision as of 12:30, 22 September 2014
Line 277:		Line 277:
	== Next Steps ==		== Next Steps ==

	This tutorial is limited on purpose to just cover the basics, however AppBoard provides a lot more capability and we haven't ~~quiet~~ exploited the underlying data as much as we could have. We certainly recommend playing around with the components already added as part of the tutorial and here are some additional suggestions:		This tutorial is limited on purpose to just cover the basics, however AppBoard provides a lot more capability and we haven't quite exploited the underlying data as much as we could have. We certainly recommend playing around with the components already added as part of the tutorial and here are some additional suggestions:

	* Create a filter on the Sales Regions widget to filter the map by region.		* Create a filter on the Sales Regions widget to filter the map by region.

imported>Jason.nicholls: /* More Widgets */

2014-09-22T12:30:37Z

More Widgets

← Older revision		Revision as of 12:30, 22 September 2014
Line 265:		Line 265:
	## On the ''Visualization'' step:		## On the ''Visualization'' step:
	##* use the ''Add Column'' button to add the following columns: <tt>County</tt>, <tt>LastYearSales</tt>, <tt>SalesToDate</tt>, and <tt>SalesTarget</tt>.		##* use the ''Add Column'' button to add the following columns: <tt>County</tt>, <tt>LastYearSales</tt>, <tt>SalesToDate</tt>, and <tt>SalesTarget</tt>.
	##* clicking on the ''Renderer'' column it is possible to edit the column heading and spacing, or use alternative renderers.		##* note that by clicking in the ''Renderer'' column it is possible to edit the column heading and spacing, or use alternative renderers.
	##* click ''Next''		##* click ''Next''
	## Click ''Finish'' on the ''Options'' step to save the widget.		## Click ''Finish'' on the ''Options'' step to save the widget.

imported>Jason.nicholls: /* Actions */

2014-09-22T12:29:38Z

Actions

← Older revision		Revision as of 12:29, 22 September 2014
Line 238:		Line 238:
	#* ''User Context Label Field'': enable and set to <tt>State</tt>		#* ''User Context Label Field'': enable and set to <tt>State</tt>
	# Click the ''Close'' button.		# Click the ''Close'' button.
	# Now you should be able to click on a point on the map and it will drill down to board with the context title <tt>State Summary: ''state_clicked''</tt>. For now this board is empty.		# Now you should be able to click on a point on the map and it will drill down to the <tt>State Summary</tt> board with the context title <tt>State Summary: ''<state_clicked>''</tt>. For now this board is empty.
	# To go back to the top-level board, click on the <tt>State Sales</tt> link in the breadcrumb trail under the stack tabs.		# To go back to the top-level board, click on the <tt>State Sales</tt> link in the breadcrumb trail under the stack tabs.

imported>Jason.nicholls: /* Exercise Summary */

2014-09-22T12:28:04Z

Exercise Summary

← Older revision		Revision as of 12:28, 22 September 2014
Line 208:		Line 208:

	* Create widget actions		* Create widget actions
	* Filter Data Collections via action.		* Filter Data Collections via action
	* Create a child-board		* Create a child-board
	* Add a widget onto the child-board		* Add a widget onto the child-board

imported>Jason.nicholls: /* Exercise Summary */

2014-09-22T12:27:50Z

Exercise Summary

← Older revision		Revision as of 12:27, 22 September 2014
Line 208:		Line 208:

	* Create widget actions		* Create widget actions
	* ~~Filtering~~ Data Collections via action.		* Filter Data Collections via action.
	* Create a child-board		* Create a child-board
	* Add a widget onto the child-board		* Add a widget onto the child-board

imported>Jason.nicholls: /* Widgets */

2014-09-22T12:27:23Z

Widgets

← Older revision		Revision as of 12:27, 22 September 2014
Line 163:		Line 163:
	##* click the ''Next'' button		##* click the ''Next'' button
	## No need to do anything on the ''Presentation'' or ''Options'' steps, just click ''Next'' and then ''Finish'' to save the widget.		## No need to do anything on the ''Presentation'' or ''Options'' steps, just click ''Next'' and then ''Finish'' to save the widget.
	# A bar chart widget should now be visible taking up half the space. Re-edit the widget and on the ''Presentation'' step add a ''X-Axis ~~Label~~'' of <tt>Total Sales ($)</tt>.		# A bar chart widget should now be visible taking up half the space. Re-edit the widget by clicking on the <tt>>></tt> icon in the widget title bar and then the wrench icon. On the ''Presentation'' step add a ''X-Axis Title'' of <tt>Total Sales ($)</tt>.

	~~And repeat~~ the same process again for the pie chart:		Repeat the same process again for the pie chart:

	# Click the ''Add Widget'' button.		# Click the ''Add Widget'' button.
Line 174:		Line 174:
	##* click the ''Next'' button		##* click the ''Next'' button
	## On the ''Visualization'' Step:		## On the ''Visualization'' Step:
	##* ''Name Field'': <tt>~~StateRegion~~</tt>		##* ''Name Field'': <tt>SalesRegion</tt>
	##* ''Value Field'': <tt>sum TotalSales</tt>		##* ''Value Field'': <tt>sum TotalSales</tt>
	##* ''Color Selection'': pick colors and patterns to suit your preference.		##* ''Color Selection'': pick colors and patterns to suit your preference.

imported>Jason.nicholls: /* Widgets */

2014-09-22T12:25:55Z

Widgets

← Older revision		Revision as of 12:25, 22 September 2014
Line 147:		Line 147:
	##* ''Colored Shape Filter'': select the new <tt>StateSalesTarget</tt> filter in the drop-down selection.		##* ''Colored Shape Filter'': select the new <tt>StateSalesTarget</tt> filter in the drop-down selection.
	##* Click the ''Next'' button		##* Click the ''Next'' button
	## No need to do anything on the ''Overlays'' or ''Options'' steps, just click ''Next'' and then ''Finish'' to save the widget.		## No need to do anything on the ''Links'', ''Overlays'' or ''Options'' steps, just click ''Next'', ''Next'', and then ''Finish'' to save the widget.
	# A map widget should now be visible in the builder. Since this is the only widget on the dashboard so far it will use up all the available space. There should be a mix of red and blue dots if everything is working correctly.		# A map widget should now be visible in the builder. Since this is the only widget on the dashboard so far it will use up all the available space. There should be a mix of red and blue dots if everything is working correctly.

imported>Jason.nicholls: /* Widgets */

2014-09-22T12:25:12Z

Widgets

← Older revision		Revision as of 12:25, 22 September 2014
Line 122:		Line 122:
	AppBoard ''Widgets'' are visualization elements placed and arranged on boards. AppBoard includes a large variety of widgets and includes an API for creating custom widgets. Typically you are working with widgets in the ''Builder'' mode directly on boards. However widgets can also be managed from the ''Widgets'' builder mode.		AppBoard ''Widgets'' are visualization elements placed and arranged on boards. AppBoard includes a large variety of widgets and includes an API for creating custom widgets. Typically you are working with widgets in the ''Builder'' mode directly on boards. However widgets can also be managed from the ''Widgets'' builder mode.

	Let's create ~~a number of~~ widgets to form our initial sales dashboard:		Let's create several widgets to form our initial sales dashboard:

	* A map showing all states with indicators of whether they're on target with sales.		* A map showing all states with indicators of whether they're on target with sales.

imported>Jason.nicholls: /* Stacks & Boards */

2014-09-22T12:24:57Z

Stacks & Boards

← Older revision		Revision as of 12:24, 22 September 2014
Line 106:		Line 106:
	''Stacks'' represent a collection of dashboards and always have at least one top-level dashboard. Stacks also form the top level navigation in AppBoard with stacks presented as tabs along the top of the interface. Provisioning is used to determine what stacks a user may see or access. The administrator has access to all stacks and can control which stacks are visible in the Builder.		''Stacks'' represent a collection of dashboards and always have at least one top-level dashboard. Stacks also form the top level navigation in AppBoard with stacks presented as tabs along the top of the interface. Provisioning is used to determine what stacks a user may see or access. The administrator has access to all stacks and can control which stacks are visible in the Builder.

	''Boards'' are dashboards in AppBoard which ~~consists~~ of a number of visualizations (widgets) and how those widgets are laid out.		''Boards'' are dashboards in AppBoard which consist of a number of visualizations (widgets) and how those widgets are laid out.

	Create a new stack for the State Sales dashboard:		Create a new stack for the State Sales dashboard: