imported>Jason.nicholls: moved Launch enPortal Channel to appboard/old/launch enportal channel

2014-07-17T18:20:59Z

moved Launch enPortal Channel to appboard/old/launch enportal channel

← Older revision	Revision as of 18:20, 17 July 2014
(No difference)

imported>Jason.nicholls at 18:20, 17 July 2014

2014-07-17T18:20:38Z

← Older revision		Revision as of 18:20, 17 July 2014
Line 1:		Line 1:
			{{DISPLAYTITLE:Launch enPortal Channell}}
			[[Category:AppBoard old]]
	In this section, we will provide a tutorial example for launching a contextual, generic enPortal channel from an AppBoard widget. Below are steps that show how to implement this cross communication between the enPortal channel and AppBoard widget.		In this section, we will provide a tutorial example for launching a contextual, generic enPortal channel from an AppBoard widget. Below are steps that show how to implement this cross communication between the enPortal channel and AppBoard widget.

imported>Jason.nicholls: /* Basic Table Widget */

2014-07-16T17:05:58Z

Basic Table Widget

← Older revision		Revision as of 17:05, 16 July 2014
Line 61:		Line 61:


	Then create a Table Widget called "State Table", which uses the data collection derived from the "sample.USA_States" data source. If you need assistance with creating the Data Source, Data Collection, or Table Widget, see the [[~~Getting_Started~~\|Getting Started ~~tutorial~~]]. Make sure this new Table Widget is placed on the "Map Interaction" Stack.		Then create a Table Widget called "State Table", which uses the data collection derived from the "sample.USA_States" data source. If you need assistance with creating the Data Source, Data Collection, or Table Widget, see the [[appboard/old/getting_started_tutorial\|Getting Started Tutorial]]. Make sure this new Table Widget is placed on the "Map Interaction" Stack.


	===Web Page Widget===		===Web Page Widget===

imported>Cmace: copied from internalwiki

2012-03-08T20:03:06Z

copied from internalwiki

New page

In this section, we will provide a tutorial example for launching a contextual, generic enPortal channel from an AppBoard widget. Below are steps that show how to implement this cross communication between the enPortal channel and AppBoard widget.

In this example, we will use the state capital data included with AppBoard, and a Google Map (<tt>http://maps.google.com</tt>) to illustrate the steps to accomplish this.

__TOC__

==Identify the relationship and interaction between components==

First we must define what the source and target components will be for the widget/channel interaction.

For example, we would like to launch a proximity area about a US State capital when a user clicks on an entry of US State capital data. In this case, it can be implemented as a click action on a row of a Table Widget to launch a URL in a Web Page Widget.

==Create the target component==

Perform the following steps to create an enPortal channel that accepts the necessary input parameters:

# Log in to enPortal as an administrator.
# Select the Integrations tab. The Integrations Explorer panel is displayed.
# Right-click on the Directory folder and select New Channel.
# For the Channel Name, enter <tt>Google Map</tt>.
# For the Channel Type, select "Web/Generic URL".
# For the Type of Web/Generic Channel, select "Proxy".
# Click Next.
# Set Access Control to "AllowAll".
# For the URL, enter <tt>http://maps.google.com/maps</tt>.
# Click Save
# Select the Parameters tab and create the following parameters:
## Variable q with Receivable flag set to "Yes".
## Variable pw with Value set to <tt>2</tt>. This is a control flag to show the Google Map in a print mode.
# Click Save

[[Image:CreateAGoogleMapChannel.jpg|thumb|center|700px|Create a Google Map Channel in enPortal]]

{{Note|It is required to set the query variable to "Receivable" to allow new values to be passed by the AppBoard Widget into the enPortal channel.}}

==Test the target component==

Test the newly created channel by launching it independently in a browser. If it is working, then we will wrap this URL in a Web Widget and be placed in a board.

Assuming the hostname is "localhost" and the system is running on port 8080, the above Google Map channel can be accessed through enPortal as <tt>http://localhost:8080/enportal/servlet/pd/vdir/Google%20Map</tt>. Test this URL also with an input location, such as <tt>http://localhost:8080/enportal/servlet/pd/vdir/Google%20Map?q=39.161944,%20-75.526667</tt>. Verify that the locations with the indicated coordinates as displayed in the browser. If so, you can proceed to launch the URL from an AppBoard Widget.

==Create the Source Components==

===Stack===

Use AppBoard Builder to create a new Stack called "Map Interaction".

===Basic Table Widget===

Use the AppBoard Builder to create a data source named "sample.USA_States". The data for this will be the state capitals data file in <tt>{APPBOARD_HOME}/server/webapps/enportal/WEB-INF/data/pkg/appboard/test/stateCapitals.csv</tt>.

Then create a Table Widget called "State Table", which uses the data collection derived from the "sample.USA_States" data source. If you need assistance with creating the Data Source, Data Collection, or Table Widget, see the [[Getting_Started|Getting Started tutorial]]. Make sure this new Table Widget is placed on the "Map Interaction" Stack.

===Web Page Widget===

Use AppBoard Builder to create a Web Page Widget named "GMap" with its URL set to <tt>${application.home}/data/pkg/appboard/test/stateCapitals.csv</tt>. This Widget will not display anything initially, but will be used in conjunction with an Action placed on the Table Widget that will launch this Widget with associated parameters for it to display. Make sure this new Web Page Widget is placed on the "Map Interaction" Stack.

Adjust the layout of the two Widgets, as desired.

==Configure the Launch Action==

Using the Widget Wizard on the Table Widget, click Add Event Action to create a "Lauch URL" action. For the Target, choose the target component "GMap". In the URL field, enter <pre>/enportal/servlet/pd/vdir/Google%20Map?q=${Latitude}, ${Longitude} (${Capital} with population ${Population})</pre>

Note: It is not necessary to specify the portal's header (protocol, host, port) in the URL.

[[Image:ConfigureALaunchURLAction.jpg|thumb|center|700px|Configure A Launch URL Action in Table Widget]]

==Test the Result==

Click a row in the Table Widget. The Launch URL Action will pass the selected parameters into the Google Map channel and display the targeted coordinates in the map, along with the population in the Address field within the header of the map.

Below is a screen shot of the result:
[[Image:InteractionBetweenTableWidgetAndWebWidget.jpg|thumb|center|700px|Interaction between Table Widget and Web Widget]]

Appboard/old/launch enportal channel - Revision history

imported>Jason.nicholls: moved Launch enPortal Channel to appboard/old/launch enportal channel

imported>Jason.nicholls at 18:20, 17 July 2014

imported>Jason.nicholls: /* Basic Table Widget */

imported>Cmace: copied from internalwiki