Appboard/2.4/builder/configure alternate widget - Revision history

imported>David.moore at 23:21, 24 December 2013

2013-12-24T23:21:46Z

← Older revision		Revision as of 23:21, 24 December 2013
Line 22:		Line 22:

	# Log in to the AppBoard Builder as an administrator.		# Log in to the AppBoard Builder as an administrator.
	# In the <b>Builder Modes</b> panel, click <b>Widgets</b>. The <b>Widgets ~~Administration~~</b> panel is displayed.		# In the <b>Builder Modes</b> panel, click <b>Widgets</b>. The <b>Widgets</b> panel is displayed.
	# Select a Widget and click <b>Edit</b>. The <b>Widget Wizard</b> is displayed.		# Select a Widget and click <b>Edit</b>. The <b>Widget Wizard</b> is displayed.
	# Click the <b>Configure</b> button under <b>Alternate Widget</b>. The alternate widget configuration screen is displayed, with a preview pane on the right and configuration settings panel on the left.		# Click the <b>Configure</b> button under <b>Alternate Widget</b>. The alternate widget configuration screen is displayed, with a preview pane on the right and configuration settings panel on the left.

imported>Jason.nicholls at 09:28, 14 December 2013

2013-12-14T09:28:38Z

← Older revision		Revision as of 09:28, 14 December 2013
Line 1:		Line 1:
	{{DISPLAYTITLE:Configure Alternate Widget}}		{{DISPLAYTITLE:Configure Alternate Widget}}
			[[Category:AppBoard 2.4]]
	The AppBoard developer should not be expected to build multiple copies of each component (e.g. one for desktop, one for iOS, one for Android, and so on). So one of the core goals of AppBoard is to support the same suite of components across all devices.		The AppBoard developer should not be expected to build multiple copies of each component (e.g. one for desktop, one for iOS, one for Android, and so on). So one of the core goals of AppBoard is to support the same suite of components across all devices.

imported>Mike.berman at 02:40, 24 September 2013

2013-09-24T02:40:38Z

← Older revision		Revision as of 02:40, 24 September 2013
Line 12:		Line 12:


	{{Note\|A green check box on the <b>Data</b> tab in the Edit Widget Wizard ~~indicated~~ that the alternate Widget settings have been configured for the current Widget. Once an alternate Widget is configured, there is no way to "un-configure" the alternate Widget}}		{{Note\|A green check box on the <b>Data</b> tab in the "Edit Widget" Wizard indicates that the alternate Widget settings have been configured for the current Widget. Once an alternate Widget is configured, there is no way to "un-configure" the alternate Widget}}


Line 23:		Line 23:
	# In the <b>Builder Modes</b> panel, click <b>Widgets</b>. The <b>Widgets Administration</b> panel is displayed.		# In the <b>Builder Modes</b> panel, click <b>Widgets</b>. The <b>Widgets Administration</b> panel is displayed.
	# Select a Widget and click <b>Edit</b>. The <b>Widget Wizard</b> is displayed.		# Select a Widget and click <b>Edit</b>. The <b>Widget Wizard</b> is displayed.
	# Click <b>~~Next~~</b> ~~to go to the options screen.~~		# Click the <b>Configure</b> button under <b>Alternate Widget</b>. The alternate widget configuration screen is displayed, with a preview pane on the right and configuration settings panel on the left.
	~~# Click~~ <b>~~Configure~~ Alternate Widget</b>. The alternate widget configuration screen is displayed, with a preview pane on the ~~left~~ and configuration settings panel on the ~~right~~.
	# Select the appropriate items for the following fields:		# Select the appropriate items for the following fields:
	~~#* <b>Data Collection</b> - Displays the name of the Data Collection used by this Widget for informational purposes. This item cannot be edited.~~
	#* <b>Layout</b> - Select how the Widget should flow on the mobile device:		#* <b>Layout</b> - Select how the Widget should flow on the mobile device:
			#** Flow - Information is displayed in multiple vertical columns in the Widget.
	#** Vertical - Information runs from top to bottom in the Widget. This is the default option.		#** Vertical - Information runs from top to bottom in the Widget. This is the default option.
	#** Horizontal - Information runs from left to right in the Widget.		#** Horizontal - Information runs from left to right in the Widget.
Line 35:		Line 34:
	#** Right - Label(s) will be displayed to the right of their associated icon.		#** Right - Label(s) will be displayed to the right of their associated icon.
	#* <b>Label Field</b> - Select the field whose value will be displayed as the label in each cell.		#* <b>Label Field</b> - Select the field whose value will be displayed as the label in each cell.
	~~#** Font Size - Select the size of text to use for the Label Field.~~
	~~#** Font Color - Select the color of text to use for the Label Field.~~
	#* <b>Second Label Field</b> - Check the box to select an optional second field whose value will be displayed as a second label in each cell.		#* <b>Second Label Field</b> - Check the box to select an optional second field whose value will be displayed as a second label in each cell.
	#** Font Size - Select the ~~size~~ of ~~text to use for the Second Label Field.~~		#* <b>Default Shape</b> - Select the shape of the icon to display in each cell (unless overridden by a Colored Shape Filter).
	~~#** Font Color - Select~~ the ~~color of text~~ to ~~use for the Second Label Field~~.
	#* <b>Icon Size</b> - Select the size of the icon to display in each cell.		#* <b>Icon Size</b> - Select the size of the icon to display in each cell.
	#* <b>Default Color</b> - Select the color of the icon to display in each cell (unless overridden by a Colored Shape Filter).		#* <b>Default Color</b> - Select the color of the icon to display in each cell (unless overridden by a Colored Shape Filter).
	~~#* <b>Default Shape</b> - Select the shape of the icon to display in each cell (unless overridden by a Colored Shape Filter).~~		#* <b>Colored Shape Filter</b> - [optional] Create rules to apply for controlling the color and shape of the icons for individual items. See [[appboard/2.4/builder/colored_shape_filter\|Colored Shape Filter]] for more information.
	#* <b>Colored Shape Filter</b> - [optional] Create rules to apply for controlling the color and shape of the icons for individual items. See [[~~Colored_Shape_Filter~~\|Colored Shape Filter]] for more information.
	# Confirm that the preview pane displays the appropriate presentation for the alternate widget.		# Confirm that the preview pane displays the appropriate presentation for the alternate widget.
	# Click <b>Finish</b> to save the changes.		# Click <b>Finish</b> to save the changes.

imported>Mike.berman at 02:26, 24 September 2013

2013-09-24T02:26:52Z

← Older revision		Revision as of 02:26, 24 September 2013
Line 15:		Line 15:


	[[Image:~~Configure_Alternative_Widget~~.png\|thumb\|center\|700px\|Configuring an Alternate Widget for Mobile]]		[[Image:Configure_Alternate_Widget.png\|thumb\|center\|700px\|Configuring an Alternate Widget for Mobile]]

imported>Mike.berman at 19:24, 4 August 2013

2013-08-04T19:24:28Z

← Older revision		Revision as of 19:24, 4 August 2013
Line 52:		Line 52:


	For more information on configuring AppBoard for mobile devices, see [[~~AppBoard_Mobile~~\|Appboard Mobile]].		For more information on configuring AppBoard for mobile devices, see [[appboard/2.4/mobile\|Appboard Mobile]].

imported>Mike.berman at 19:16, 4 August 2013

2013-08-04T19:16:44Z

← Older revision		Revision as of 19:16, 4 August 2013
Line 12:		Line 12:


	{{Note\|Once an alternate Widget is configured, there is no way to "un-configure" the alternate Widget}}		{{Note\|A green check box on the <b>Data</b> tab in the Edit Widget Wizard indicated that the alternate Widget settings have been configured for the current Widget. Once an alternate Widget is configured, there is no way to "un-configure" the alternate Widget}}

imported>Mike.berman at 19:11, 4 August 2013

2013-08-04T19:11:22Z

← Older revision		Revision as of 19:11, 4 August 2013
Line 10:		Line 10:

	Although this Option is used primarily for presentation on mobile devices, it can also be used to configure an alternative display to be presented on the desktop.		Although this Option is used primarily for presentation on mobile devices, it can also be used to configure an alternative display to be presented on the desktop.


			{{Note\|Once an alternate Widget is configured, there is no way to "un-configure" the alternate Widget}}

imported>Mike.berman: created page

2013-08-04T18:54:18Z

created page

New page

{{DISPLAYTITLE:Configure Alternate Widget}}
The AppBoard developer should not be expected to build multiple copies of each component (e.g. one for desktop, one for iOS, one for Android, and so on). So one of the core goals of AppBoard is to support the same suite of components across all devices.

However, certain types of Widgets provide displays that are too complex for consumption on a mobile device. In fact, if the user accesses certain standard AppBoard Widgets on a mobile device the device will display the message: "This widget is not supported on this device. Please contact your administrator to configure an alternative compatible widget". To address the specialized requirements of the mobile platform, many AppBoard Widgets provide a special configuration option called "Configure Alternate Widget".

For example, the standard Basic Table Widget is not supported in AppBoard Mobile. To present data from a Basic Table Widget on a mobile device, you can select a single column of the table and display that as a single-column list in AppBoard Mobile.

Although this Option is used primarily for presentation on mobile devices, it can also be used to configure an alternative display to be presented on the desktop.

[[Image:Configure_Alternative_Widget.png|thumb|center|700px|Configuring an Alternate Widget for Mobile]]

Perform the following steps to configure alternate display settings for a Widget:

# Log in to the AppBoard Builder as an administrator.
# In the Builder Modes panel, click Widgets. The Widgets Administration panel is displayed.
# Select a Widget and click Edit. The Widget Wizard is displayed.
# Click Next to go to the options screen.
# Click Configure Alternate Widget. The alternate widget configuration screen is displayed, with a preview pane on the left and configuration settings panel on the right.
# Select the appropriate items for the following fields:
#* Data Collection - Displays the name of the Data Collection used by this Widget for informational purposes. This item cannot be edited.
#* Layout - Select how the Widget should flow on the mobile device:
#** Vertical - Information runs from top to bottom in the Widget. This is the default option.
#** Horizontal - Information runs from left to right in the Widget.
#** Coverflow - Information is selected by visually flipping through animated snapshots.
#* Label Orientation - Select where to display the label(s) with regard to the icon in each cell.
#** Bottom - Label(s) will be displayed below their associated icon.
#** Right - Label(s) will be displayed to the right of their associated icon.
#* Label Field - Select the field whose value will be displayed as the label in each cell.
#** Font Size - Select the size of text to use for the Label Field.
#** Font Color - Select the color of text to use for the Label Field.
#* Second Label Field - Check the box to select an optional second field whose value will be displayed as a second label in each cell.
#** Font Size - Select the size of text to use for the Second Label Field.
#** Font Color - Select the color of text to use for the Second Label Field.
#* Icon Size - Select the size of the icon to display in each cell.
#* Default Color - Select the color of the icon to display in each cell (unless overridden by a Colored Shape Filter).
#* Default Shape - Select the shape of the icon to display in each cell (unless overridden by a Colored Shape Filter).
#* Colored Shape Filter - [optional] Create rules to apply for controlling the color and shape of the icons for individual items. See [[Colored_Shape_Filter|Colored Shape Filter]] for more information.
# Confirm that the preview pane displays the appropriate presentation for the alternate widget.
# Click Finish to save the changes.
# Load the Widget on the mobile device and confirm that it is displayed properly.

{{Tip|When naming Widgets, you should consider that the same name will be used across the various delivery platforms. For example, you may have a Widget called "Available Services Table" which displays a table of services on the desktop but only shows the status of a single service on the mobile device (using the "Configure Alternate Widget" approach). In this case, a more generic name such as "Available Services" may be preferable.}}

For more information on configuring AppBoard for mobile devices, see [[AppBoard_Mobile|Appboard Mobile]].