Appboard/old/getting started tutorial - Revision history

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

2014-07-17T06:51:46Z

Next Steps

← Older revision		Revision as of 06:51, 17 July 2014
Line 238:		Line 238:
	==Next Steps==		==Next Steps==

	To create users in the system, and assign the USA States sample stack to those users, continue to the [[~~Provisioning_Quick_Start~~\|Provisioning Quick Start Tutorial]] page.		To create users in the system, and assign the USA States sample stack to those users, continue to the [[enportal/old/provisioning_quick_start\|Provisioning Quick Start Tutorial]] page.

imported>Jason.nicholls: /* Installation */

2014-07-16T16:32:31Z

Installation

← Older revision		Revision as of 16:32, 16 July 2014
Line 13:		Line 13:
	==Installation==		==Installation==

	The AppBoard system requires that a turnkey server is installed on an AppBoard server by a system administrator. This guide assumes that the installation has been completed and you are able to access the AppBoard builder in a web browser. For help with Installing AppBoard, see [[~~Installation~~\|Installation]].		The AppBoard system requires that a turnkey server is installed on an AppBoard server by a system administrator. This guide assumes that the installation has been completed and you are able to access the AppBoard builder in a web browser. For help with Installing AppBoard, see [[appboard/old/installation\|Installation]].


	The requirements for running the AppBoard Builder are:		The requirements for running the AppBoard Builder are:
	# A supported web browser running a supported version of Flash player. To check the supported versions, see [[~~System_Requirements~~\|System Requirements]]		# A supported web browser running a supported version of Flash player. To check the supported versions, see [[appboard/old/installation/system_requirements\|System Requirements]]
	# Connectivity to the AppBoard data server		# Connectivity to the AppBoard data server


	==Accessing the Builder==		==Accessing the Builder==

imported>Jason.nicholls at 16:28, 16 July 2014

2014-07-16T16:28:11Z

← Older revision		Revision as of 16:28, 16 July 2014
Line 1:		Line 1:
			{{DISPLAYTITLE:Getting Started Tutorial}}
			[[Category:AppBoard old]]
	==Audience==		==Audience==

imported>Jason.nicholls: moved Getting Started to appboard/old/getting started tutorial

2014-07-16T16:27:28Z

moved Getting Started to appboard/old/getting started tutorial

← Older revision	Revision as of 16:27, 16 July 2014
(No difference)

imported>Jason.nicholls at 15:52, 27 August 2013

2013-08-27T15:52:11Z

imported>Cmace: copied from internal

2013-01-16T14:37:42Z

copied from internal

imported>Cmace: changed ilog to vector

2012-05-22T15:39:07Z

changed ilog to vector

← Older revision		Revision as of 15:39, 22 May 2012
Line 136:		Line 136:
	# '''In the “Name” box, enter “Northern_States_Map”'''		# '''In the “Name” box, enter “Northern_States_Map”'''
	# '''For “Board”, select “USA_States_Stack”'''		# '''For “Board”, select “USA_States_Stack”'''
	# '''Select the Widget type “Maps” and select ~~“ILOG~~ Map”'''		# '''Select the Widget type “Maps” and select “Vector Map”'''
	# '''Click “Add Widget”'''		# '''Click “Add Widget”'''
	# '''Perform the following on the “Data” panel to configure the Widget:'''		# '''Perform the following on the “Data” panel to configure the Widget:'''

imported>Mike.berman: updates for AppBoard 2.2

2012-03-16T21:04:20Z

updates for AppBoard 2.2

Show changes

imported>Cmace: /* Accessing the Builder */

2012-03-01T20:03:34Z

Accessing the Builder

← Older revision		Revision as of 20:03, 1 March 2012
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~~ a URL such as http://appboardhost:8080/enportal/visualizer/Appboard_Builder.html. 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/visualizer/Appboard_Builder.html. If you are prompted to log in, use the following default administrator credentials:

	Username: administrator		Username: administrator
Line 33:		Line 33:

	'''Action: In your browser, navigate to the AppBoard home URL and log in to AppBoard.'''		'''Action: In your browser, navigate to the AppBoard home URL and log in to AppBoard.'''


	==Exercise Summary==		==Exercise Summary==

imported>Cmace: edited installation link - different than internalwiki

2012-03-01T20:01:03Z

edited installation link - different than internalwiki

← Older revision		Revision as of 20:01, 1 March 2012
Line 11:		Line 11:
	==Installation==		==Installation==

	The AppBoard system requires that a turnkey server is installed on an AppBoard server by a system administrator. This guide assumes that the installation has been completed and you are able to access the AppBoard builder in a web browser. For help with Installing AppBoard, see [[~~AppBoard_Installation~~\|Installation]].		The AppBoard system requires that a turnkey server is installed on an AppBoard server by a system administrator. This guide assumes that the installation has been completed and you are able to access the AppBoard builder in a web browser. For help with Installing AppBoard, see [[Installation\|Installation]].

← Older revision		Revision as of 15:52, 27 August 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/visualizer/Appboard_Builder.html. 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/visualizer/Appboard_Builder.html. If you are prompted to log in, use the following default administrator credentials:

	Username: administrator		Username: administrator
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 92:		Line 92:
	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 115:		Line 115:
	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 131:		Line 131:
	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. You will then configure an action to filter the display when one of the pins is clicked, to only show states with a total population that is greater than 2,000,000 residents.		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. You will then configure an action to filter the display when one of the pins is clicked, to only show states with a total population that is greater than 2,000,000 residents.

	[[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'''
	# '''Click the “Add” button to create a new Widget'''		# '''Click the “Add” button to create a new Widget'''
Line 186:		Line 186:


	[[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 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 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.'''

← Older revision		Revision as of 14:37, 16 January 2013
Line 88:		Line 88:
	==Data Collections==		==Data Collections==

	A "Data Collection" is a group of data sources that are available for the Widgets in the system to use. Data Collections ~~allow~~ you to configure filtered data sets from the raw data in a Data Source. For example, you can create server-side or client-side filters that restrict the data that will go into your Widgets.		A "Data Collection" is a group of data sources that are available for the Widgets in the system to use. Every time a Data Source is created, a Data Collection is made using all of the data from the data source. Creating your own Data Collections allows you to configure filtered data sets from the raw data in a Data Source. For example, you can create server-side or client-side filters that restrict the data that will go into your Widgets.

	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.
Line 145:		Line 145:
	#* '''For “Longitude Field”, select “Longitude”'''		#* '''For “Longitude Field”, select “Longitude”'''
	#* '''Observe that some data points are now displayed in the preview panel'''		#* '''Observe that some data points are now displayed in the preview panel'''
	#* '''~~Zoom in on~~ the ~~map~~ and ~~drag as needed so it shows~~ the ~~United States~~'''		#* '''You may change the default pin shape and color here. You may also add filters that determine the pin appearances.'''
	#* '''~~You may change the colors of the map background, foreground, borders, pins, and other components here as you see fit~~.'''		#* '''Click “Next”. The “Trouble Bubble” screen will be displayed'''
	#* '''Click “Next”. The “Options” screen will be displayed'''		#* '''Click “Next”. The “Options” screen will be displayed'''
	#* '''Click “Next”. The “Actions” screen will be displayed'''		#* '''Click “Next”. The “Actions” screen will be displayed'''
Line 158:		Line 158:
	#* '''Add a second Rule in the same manner, setting “Latitude” “>” “40”'''		#* '''Add a second Rule in the same manner, setting “Latitude” “>” “40”'''
	#* '''Click Finish'''		#* '''Click Finish'''
	# '''On the main panel, click “Builder” to display the “USA_States_Stack” stack. Observe the Widget displaying the Northern states~~. Zoom as desired~~.'''		# '''On the main panel, click “Builder” to display the “USA_States_Stack” stack. Observe the Widget displaying the Northern states.'''
	# '''Click on a pin in the map to activate the event which will filter the map to only display capitals for northern states with a Population > 2,000,000'''		# '''Click on a pin in the map to activate the event which will filter the map to only display capitals for northern states with a Population > 2,000,000'''
	# '''Click the Edit button to additionally edit the widget colors and other presentation elements'''		# '''Click the Edit button to additionally edit the widget colors and other presentation elements'''
Line 178:		Line 178:
	#* '''Under “Data Field”, select “State”'''		#* '''Under “Data Field”, select “State”'''
	#* '''For the "Renderer" and "Customize" columns, use the default values (no changes needed)'''		#* '''For the "Renderer" and "Customize" columns, use the default values (no changes needed)'''
	#* '''Repeat steps B-C, until all of the fields are added and shown in the Preview panel below'''		#* '''Repeat steps 7.2-7.4, until all of the fields are added and shown in the Preview panel below'''
	#* '''Click Next, Next, and Finish to exit the Widget configuration panels'''		#* '''Click Next, 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'''
Line 202:		Line 202:
	# '''Click Data Sources and create a new Data Source called “sample.USA_Counties” from the CSV file stateCounties.csv, with Primary Key = “CountyID”.'''		# '''Click Data Sources and create a new Data Source called “sample.USA_Counties” from the CSV file stateCounties.csv, with Primary Key = “CountyID”.'''
	# '''Under "File Path", enter "${application.home}/data/pkg/appboard/test/stateCounties.csv".'''		# '''Under "File Path", enter "${application.home}/data/pkg/appboard/test/stateCounties.csv".'''
	~~# '''Create a Data Collection called “sample.CountyData” with Data Source = “sample.USA_Counties.stateCounties”'''~~
	# '''Click Builder to display USA_States_Stack, containing a map and table Widget'''		# '''Click Builder to display USA_States_Stack, containing a map and table Widget'''
	# '''On the Northern_States_Map Widget, click the Actions (lightning bolt) icon to open the Actions editor in the Widget Wizard'''		# '''On the Northern_States_Map Widget, click the Actions (lightning bolt) icon to open the Actions editor in the Widget Wizard'''
Line 214:		Line 213:
	#* '''Check the box next to “Context Data Type” and select “sample.USA_States.StateCapitals”'''		#* '''Check the box next to “Context Data Type” and select “sample.USA_States.StateCapitals”'''
	#* '''For “Context Label Field”, select “StateLabel”'''		#* '''For “Context Label Field”, select “StateLabel”'''
	#* '''Click “Add Board” to exit the Add Board dialog'''		#* '''Click “Add Board” to exit the Add Board dialog. Make sure the County Table Board is now selected in the Action.'''
	#* '''Click the “Add Event Action” button and select "Apply a Filter to a Data Collection" from the drop-down list'''		#* '''Click the “Add Event 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”'''
	#* '''For “Filter data collection”, select “sample.~~CountyData”~~'''		#* '''For “Filter data collection”, select “sample.USA_Counties.stateCounties”'''
	#* '''Click the “Add Rule” button and select “Widget Interaction Comparison”'''		#* '''Click the “Add Rule” button and select “Widget Interaction Comparison”'''
	#* '''Select the following for the Widget interaction properties:'''		#* '''Select the following for the Widget interaction properties:'''
Line 224:		Line 223:
	# '''Click “Finish” to exit the Actions editor in the Widget Wizard'''		# '''Click “Finish” to exit the Actions editor in the Widget Wizard'''
	# '''Click Widgets and create a new Widget called “County Data Table” on the Board “County Table” and select the "Basic Table" option under the "Lists & Tables" tab'''		# '''Click Widgets and create a new Widget called “County Data Table” on the Board “County Table” and select the "Basic Table" option under the "Lists & Tables" tab'''
	# '''Configure the Widget to display one or more fields from the Data Collection “sample.~~CountyData”~~'''		# '''Configure the Widget to display one or more fields from the Data Collection “sample.USA_Counties.stateCounties”'''
	# '''Click Next, Next, and Finish to exit the Widget configuration panels'''		# '''Click Next, Next, and Finish to exit the Widget configuration panels'''
	# '''Click Builder to again display USA_States_Stack, containing the map and table Widget'''		# '''Click Builder to again display USA_States_Stack, containing the map and table Widget'''