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

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

2014-07-17T15:40:16Z

Next Steps

← Older revision		Revision as of 15:40, 17 July 2014
Line 249:		Line 249:
	==Next Steps==		==Next Steps==

	To create users in the system, and assign the USA States sample stack to those users, ~~continue~~ to the [[~~appboard_provisioning_quick_start~~\|Provisioning ~~Quick Start Tutorial~~]] ~~page~~.		To create users in the system, and assign the USA States sample stack to those users, refer to the [[appboard/2.4/admin/provisioning\|Provisioning Overview]] documentation.

imported>David.moore: /* Widgets */

2013-12-24T22:37:28Z

Widgets

imported>David.moore: /* Stacks and Boards */

2013-12-24T22:32:49Z

Stacks and Boards

← Older revision		Revision as of 22:32, 24 December 2013
Line 111:		Line 111:
	# '''Click Close'''		# '''Click Close'''

	==Stacks ~~and~~ Boards==		==Stacks & Boards==

	A "Board" represents a dashboard of information. Each Board will consist of one or more Widgets. A Board typically displays a suite of information that is related in some meaningful way, and which will be appropriate to present as a visualization to an AppBoard end-user.		A "Board" represents a dashboard of information. Each Board will consist of one or more Widgets. A Board typically displays a suite of information that is related in some meaningful way, and which will be appropriate to present as a visualization to an AppBoard end-user.
Line 121:		Line 121:
	[[File:Stack.png]] '''Action: Perform the following steps to create a Stack:'''		[[File:Stack.png]] '''Action: Perform the following steps to create a Stack:'''

	# '''Click Stacks ~~and~~ Boards to display the Stacks ~~and~~ Boards ~~Administration~~ panel'''		# '''Click Stacks & Boards to display the Stacks & Boards panel'''
	# '''In the left panel, under “Quick Actions”, click the “Add Stack” item'''		# '''In the left panel, under “Quick Actions”, click the “Add Stack” item'''
	# '''Under "Title”, enter “USA_States_Stack”'''		# '''Under "Title”, enter “USA_States_Stack”'''
	# '''Click the "Add Stack" button'''		# '''Click the "Add Stack" button'''
	# '''Confirm that the Stack “USA_States_Stack” is now listed in the Stacks ~~and~~ Boards ~~Administration~~ panel'''		# '''Confirm that the Stack “USA_States_Stack” is now listed in the Stacks & Boards panel'''
	# '''In the left panel, click “Builder” to display the empty Stack'''		# '''In the left panel, click “Builder” to display the empty Stack'''


	==Widgets==		==Widgets==

imported>David.moore: /* Data Sources */

2013-12-24T22:28:58Z

Data Sources

← Older revision		Revision as of 22:28, 24 December 2013
Line 61:		Line 61:
	==Data Sources==		==Data Sources==

	The first step in creating a dashboard is defining a data source that will be used by the Widgets. The “Data Sources” Builder Mode displays the Data ~~Source Administration~~ panel, where you can add and edit data sources.		The first step in creating a dashboard is defining a data source that will be used by the Widgets. The “Data Sources” Builder Mode displays the Data Sources panel, where you can add and edit data sources.

	Data Sources define connections to data warehouses, such as databases, file systems, web services and system APIs. The basic purposes of a Data Source are to define a connection to the outside data, provide an AppBoard "namespace" for the data, and provide security measures such as filtering the incoming data.		Data Sources define connections to data warehouses, such as databases, file systems, web services and system APIs. The basic purposes of a Data Source are to define a connection to the outside data, provide an AppBoard "namespace" for the data, and provide security measures such as filtering the incoming data.
Line 67:		Line 67:
	In this section, you will create a mapping in AppBoard to a data source file. The file is a table of comma-separated-values (CSV) that lists the states in the United States of America and contains data such as population and map coordinates of the state capitals.		In this section, you will create a mapping in AppBoard to a data source file. The file is a table of comma-separated-values (CSV) that lists the states in the United States of America and contains data such as population and map coordinates of the state capitals.

	'''Action: Click Data Sources to display the Data ~~Source Administration~~ panel'''		'''Action: Click Data Sources to display the Data Sources panel'''


Line 84:		Line 84:
	# '''Click OK.		# '''Click OK.
	# '''Click Next. The “Associate” screen will be displayed'''		# '''Click Next. The “Associate” screen will be displayed'''
	# '''Click Finish. On the Data Sources page under the Data ~~Source Administration~~ panel, confirm that the Data Source “sample.USA_States” is now listed.'''		# '''Click Finish. On the Data Sources page under the Data Sources panel, confirm that the Data Source “sample.USA_States” is now listed.'''


	Associations are logical connections between two pieces of data; often referred to as "foreign-keys" in databases. For example, a collection of records about the individual states within the United States could be associated with a collection of records about the individual counties in each state. The county would have a "stateId" field would define the state in which the county resides. Therefore a one-to-many association can be created between a state and counties.		Associations are logical connections between two pieces of data; often referred to as "foreign-keys" in databases. For example, a collection of records about the individual states within the United States could be associated with a collection of records about the individual counties in each state. The county would have a "stateId" field would define the state in which the county resides. Therefore a one-to-many association can be created between a state and counties.


	==Data Collections==		==Data Collections==

imported>Jason.nicholls at 06:46, 14 December 2013

2013-12-14T06:46:18Z

← Older revision		Revision as of 06:46, 14 December 2013
Line 1:		Line 1:
	{{DISPLAYTITLE:Getting Started Tutorial}}		{{DISPLAYTITLE:Getting Started Tutorial}}
			[[Category:AppBoard 2.4]]
	==Audience==		==Audience==

imported>Jason.nicholls at 11:27, 30 September 2013

2013-09-30T11:27:25Z

← Older revision		Revision as of 11:27, 30 September 2013
Line 1:		Line 1:
			{{DISPLAYTITLE:Getting Started Tutorial}}
	==Audience==		==Audience==

imported>Jason.nicholls: /* Accessing the Builder */

2013-09-30T11:25:47Z

Accessing the Builder

← Older revision		Revision as of 11:25, 30 September 2013
Line 21:		Line 21:
	==Accessing the Builder==		==Accessing the Builder==

	[[File:~~builder~~.png]] In your browser, you can navigate to the home URL of your AppBoard system. This will be a URL such as http://appboardhost:8080/enportal/ab/home. If you are prompted to log in, use the following default administrator credentials:		[[File:Builder.png]] In your browser, you can navigate to the home URL of your AppBoard system. This will be a URL such as http://appboardhost:8080/enportal/ab/home. If you are prompted to log in, use the following default administrator credentials:

	Username: administrator		Username: administrator

imported>Jason.nicholls at 11:25, 30 September 2013

2013-09-30T11:25:29Z

imported>Mike.berman at 19:23, 29 August 2013

2013-08-29T19:23:07Z

← Older revision		Revision as of 19:23, 29 August 2013
Line 122:		Line 122:
	# '''Click Stacks and Boards to display the Stacks and Boards Administration panel'''		# '''Click Stacks and Boards to display the Stacks and Boards Administration panel'''
	# '''In the left panel, under “Quick Actions”, click the “Add Stack” item'''		# '''In the left panel, under “Quick Actions”, click the “Add Stack” item'''
	# '''~~For “Top-Level Board~~ Title”, enter “USA_States_Stack”'''		# '''Under "Title”, enter “USA_States_Stack”'''
	# '''Click the "Add Stack" button'''		# '''Click the "Add Stack" button'''
	# '''Confirm that the Stack “USA_States_Stack” is now listed in the Stacks and Boards Administration panel'''		# '''Confirm that the Stack “USA_States_Stack” is now listed in the Stacks and Boards Administration panel'''

imported>Mike.berman at 18:51, 29 August 2013

2013-08-29T18:51:00Z

← Older revision		Revision as of 18:51, 29 August 2013
Line 225:		Line 225:
	#* '''Click “Add Board” to exit the Add Board dialog		#* '''Click “Add Board” to exit the Add Board dialog
	#* '''Select the new board from the “Board” drop-down list		#* '''Select the new board from the “Board” drop-down list
	#* '''Check the box next ~~to“Use~~ Context Label Field”, select “StateLabel”'''		#* '''Check the box next to “Use Context Label Field”, select “StateLabel”'''
	#* '''Click the “Add Action” button and select "Apply a Filter to a Data Collection" from the drop-down list'''		#* '''Click the “Add Action” button and select "Apply a Filter to a Data Collection" from the drop-down list'''
	#* '''For “On selection of”, select "any" and “sample.USA_States.StateCapitals”'''		#* '''For “On selection of”, select "any" and “sample.USA_States.StateCapitals”'''

← Older revision		Revision as of 22:37, 24 December 2013
Line 135:		Line 135:

	[[File:Widget.png]] '''Action: Perform the following steps to create a Widget:'''		[[File:Widget.png]] '''Action: Perform the following steps to create a Widget:'''
	# '''Click Widgets to display the Widgets ~~Administration~~ panel'''		# '''Click Widgets to display the Widgets panel'''
	# '''At the top, For “Board”, select “USA_States_Stack”'''		# '''At the top, For “Board”, select “USA_States_Stack”'''
	# '''Click the “Add” button to create a new Widget'''		# '''Click the “Add” button to create a new Widget'''
Line 159:		Line 159:
	'''Action: Perform the following steps to create a second Widget:'''		'''Action: Perform the following steps to create a second Widget:'''

	# '''Click Widgets to display the Widgets ~~Administration~~ panel'''		# '''Click Widgets to display the Widgets panel'''
	# '''At the top, For “Board”, select “USA_States_Stack”'''		# '''At the top, For “Board”, select “USA_States_Stack”'''
	# '''Click the “Add” button to create a new Widget'''		# '''Click the “Add” button to create a new Widget'''
Line 172:		Line 172:
	#* '''Click Next, and Finish to exit the Widget configuration panels'''		#* '''Click Next, and Finish to exit the Widget configuration panels'''
	# '''Click Builder and observe that the Board now shows a map Widget and table Widget'''		# '''Click Builder and observe that the Board now shows a map Widget and table Widget'''


	==Actions==		==Actions==

← Older revision		Revision as of 11:25, 30 September 2013
Line 71:		Line 71:


	[[File:~~datasource~~.png]] '''Action: Perform the following steps to add a data source:'''		[[File:Datasource.png]] '''Action: Perform the following steps to add a data source:'''
	# '''Click the Add button'''		# '''Click the Add button'''
	# '''In the “Name” box, enter “sample.USA_States”'''		# '''In the “Name” box, enter “sample.USA_States”'''
Line 94:		Line 94:
	In this section, you will create a filtered data collection from your raw data source. The filter will select the states in the Northern part of the USA.		In this section, you will create a filtered data collection from your raw data source. The filter will select the states in the Northern part of the USA.

	[[File:~~datacollection~~.png]] '''Action: Perform the following steps to add a Data Collection:'''		[[File:Datacollection.png]] '''Action: Perform the following steps to add a Data Collection:'''

	# '''Click Data Collections to display the Data Collections panel'''		# '''Click Data Collections to display the Data Collections panel'''
Line 118:		Line 118:
	In this section, you will create a Stack (and a Top-Level Board) that will be used for displaying Widgets with information about the states in the USA.		In this section, you will create a Stack (and a Top-Level Board) that will be used for displaying Widgets with information about the states in the USA.

	[[File:~~stack~~.png]] '''Action: Perform the following steps to create a Stack:'''		[[File:Stack.png]] '''Action: Perform the following steps to create a Stack:'''

	# '''Click Stacks and Boards to display the Stacks and Boards Administration panel'''		# '''Click Stacks and Boards to display the Stacks and Boards Administration panel'''
Line 134:		Line 134:
	In this section, you will create a map Widget that displays a USA map. You will place pins on the map where the state capitals are located for the northern states only.		In this section, you will create a map Widget that displays a USA map. You will place pins on the map where the state capitals are located for the northern states only.

	[[File:~~widget~~.png]] '''Action: Perform the following steps to create a Widget:'''		[[File:Widget.png]] '''Action: Perform the following steps to create a Widget:'''
	# '''Click Widgets to display the Widgets Administration panel'''		# '''Click Widgets to display the Widgets Administration panel'''
	# '''At the top, For “Board”, select “USA_States_Stack”'''		# '''At the top, For “Board”, select “USA_States_Stack”'''
Line 199:		Line 199:


	[[File:~~board~~.png]] '''Action: Perform the following steps to modify the layout of a Board:'''		[[File:Board.png]] '''Action: Perform the following steps to modify the layout of a Board:'''
	# '''Grab the upper-left corner of the label bar of the lower Widget and drag the lower Widget above the upper Widget until you observe a change in color. Release the Widget and observe that the order of the Widgets has been swapped.'''		# '''Grab the upper-left corner of the label bar of the lower Widget and drag the lower Widget above the upper Widget until you observe a change in color. Release the Widget and observe that the order of the Widgets has been swapped.'''
	# '''Grab the label bar of the lower Widget and drag the lower Widget to the right of the upper Widget until you observe a change in color. Release the Widget and observe that the Widgets are now side by side.'''		# '''Grab the label bar of the lower Widget and drag the lower Widget to the right of the upper Widget until you observe a change in color. Release the Widget and observe that the Widgets are now side by side.'''