Appboard/2.4/builder/widgets/actions/focus on widget - Revision history

imported>Cmace: action filtering based on data source, not data collection

2014-05-01T18:30:26Z

action filtering based on data source, not data collection

← Older revision		Revision as of 18:30, 1 May 2014
Line 23:		Line 23:
	### Click <b>Add Rule</b> to create one or more rules that indicate what data should trigger the Action, when selected.		### Click <b>Add Rule</b> to create one or more rules that indicate what data should trigger the Action, when selected.
	### Click <b>Close</b> to save the Filter settings.		### Click <b>Close</b> to save the Filter settings.
	## Select the Data ~~Collection~~ name. When the Widget is run, selection of data in this Data ~~Collection~~ will trigger the Action.		## Select the Data Source name. When the Widget is run, selection of data in this Data Source will trigger the Action.
	# Under <b>Widget on which to focus</b>, select the name of the Widget on which to focus when the Action is invoked.		# Under <b>Widget on which to focus</b>, select the name of the Widget on which to focus when the Action is invoked.

imported>Jason.nicholls at 08:53, 14 December 2013

2013-12-14T08:53:43Z

← Older revision		Revision as of 08:53, 14 December 2013
Line 1:		Line 1:
	{{DISPLAYTITLE:~~AppBoard Action -~~ Focus On Widget}}		{{DISPLAYTITLE:Focus On Widget}}
			[[Category:AppBoard 2.4]]
	There are some cases where clicking on a Widget will create a desired result on the desktop client, but not automatically achieve a different result that would be desired on the mobile device. For example, you may have a Widget that applies a filter when you click on an item. On the mobile device, you may want the filter to be applied and then to automatically switch to displaying another list where the filter would be meaningful. This can be achieved by using the "Focus on Widget" action.		There are some cases where clicking on a Widget will create a desired result on the desktop client, but not automatically achieve a different result that would be desired on the mobile device. For example, you may have a Widget that applies a filter when you click on an item. On the mobile device, you may want the filter to be applied and then to automatically switch to displaying another list where the filter would be meaningful. This can be achieved by using the "Focus on Widget" action.

imported>Mike.berman at 00:06, 5 September 2013

2013-09-05T00:06:48Z

← Older revision		Revision as of 00:06, 5 September 2013
Line 16:		Line 16:

	# Follow the instructions above to create the basic "Focus on Widget" Action.		# Follow the instructions above to create the basic "Focus on Widget" Action.
	# <b>Name</b>: Enter a name for this Action. For convenience, a default name is provided ~~that you may use~~. The Name is not used anywhere else in AppBoard, and only displayed on this configuration page.		# <b>Name</b>: Enter a name for this Action. For convenience, a default name is provided. The Name is not used anywhere else in AppBoard, and only displayed on this configuration page.
	# <b>On selection of</b>:		# <b>On selection of</b>:
	## Select "any" or "specific" for the type of data selection by the User that will trigger the Action. When selecting "specific", perform the following additional steps:		## Select "any" or "specific" for the type of data selection by the User that will trigger the Action. When selecting "specific", perform the following additional steps:

imported>Mike.berman at 20:56, 4 September 2013

2013-09-04T20:56:50Z

← Older revision		Revision as of 20:56, 4 September 2013
Line 22:		Line 22:
	### Click <b>Add Rule</b> to create one or more rules that indicate what data should trigger the Action, when selected.		### Click <b>Add Rule</b> to create one or more rules that indicate what data should trigger the Action, when selected.
	### Click <b>Close</b> to save the Filter settings.		### Click <b>Close</b> to save the Filter settings.
			## Select the Data Collection name. When the Widget is run, selection of data in this Data Collection will trigger the Action.
	# Under <b>Widget on which to focus</b>, select the name of the Widget on which to focus when the Action is invoked.		# Under <b>Widget on which to focus</b>, select the name of the Widget on which to focus when the Action is invoked.

imported>Mike.berman at 20:42, 4 September 2013

2013-09-04T20:42:50Z

← Older revision		Revision as of 20:42, 4 September 2013
Line 16:		Line 16:

	# Follow the instructions above to create the basic "Focus on Widget" Action.		# Follow the instructions above to create the basic "Focus on Widget" Action.
			# <b>Name</b>: Enter a name for this Action. For convenience, a default name is provided that you may use. The Name is not used anywhere else in AppBoard, and only displayed on this configuration page.
			# <b>On selection of</b>:
			## Select "any" or "specific" for the type of data selection by the User that will trigger the Action. When selecting "specific", perform the following additional steps:
			### Click the <b>Filter</b> button. The <b>Filter Editor</b> is displayed.
			### Click <b>Add Rule</b> to create one or more rules that indicate what data should trigger the Action, when selected.
			### Click <b>Close</b> to save the Filter settings.
	# Under <b>Widget on which to focus</b>, select the name of the Widget on which to focus when the Action is invoked.		# Under <b>Widget on which to focus</b>, select the name of the Widget on which to focus when the Action is invoked.

imported>Mike.berman: create page for AppBoard 2.4

2013-09-04T20:11:27Z

create page for AppBoard 2.4

New page

{{DISPLAYTITLE:AppBoard Action - Focus On Widget}}
There are some cases where clicking on a Widget will create a desired result on the desktop client, but not automatically achieve a different result that would be desired on the mobile device. For example, you may have a Widget that applies a filter when you click on an item. On the mobile device, you may want the filter to be applied and then to automatically switch to displaying another list where the filter would be meaningful. This can be achieved by using the "Focus on Widget" action.

The "Focus on Widget" action tells AppBoard to switch the application over to another specific Widget on the same Board. This technique can replicate the same behavior on the mobile device as experienced on the desktop.

== How To Create a Focus on Widget Action ==

For instructions on adding a Focus on Widget Action, see the general instructions in [[appboard/2.4/builder/widgets/actions#How_To_Create_an_Action_in_a_Widget|How To Create an Action in a Widget]].

== How To Configure a Focus on Widget Action ==

Perform the following steps to configure the "Focus on Widget" action for a Widget:

# Follow the instructions above to create the basic "Focus on Widget" Action.
# Under <b>Widget on which to focus</b>, select the name of the Widget on which to focus when the Action is invoked.

== Sample Use Case ==

Suppose you have a Board with two Widgets for a banking customer. The top Widget shows a world map. The bottom Widget shows a table that lists all the cities where the bank has branches in the selected country.

On the desktop client, when the user clicks in a country in the map, a filter is applied and the table below shows the list of cities in the selected country.

On the mobile client, instead of a world map, the Configure Alternative Widget is used to show a list of countries. When the user taps the name of a country, the same filter is applied as on the desktop. But the result of the filter is not apparent on the device. By creating a "Focus On Widget" Action, the mobile client can switch focus to the table Widget. Then when the user taps the name of a country, the filtered list of cities will be shown.