Introduction
This article describes how to configure a Web GUI map to launch another Web GUI map in a portlet page.
In Web GUI 7.4.0/8.1, a map can be configured to launch (or change the context) of an Event Viewer or AEL portlet with the "Update Event List (using wires)" launch action. This action can also be used to configure custom wires between maps such that clicking an element in one map may launch a portlet page containing another map. This article describes how to do this.
(Note: This article was updated on 23 September 2015 to include deployment details for transformation files on DASH in Web GUI 8.1)
Step 1: Configure the map click-action
This step configures a map element so that when it is clicked it fires a NodeClickedOn event that is picked up by any wires on the portlet page
- Navigate to the Administration->Event Management Tools->Map Creation task and edit the map from which the launch will be performed
- Select the map element whose click-action should launch a map and edit its properties.
- Select the Associations tab and choose the option: Update Event List (using wires)
- Repeat steps 1 to 3 for each map element that should launch a map portlet
- Apply the changes and save the map
- Repeat steps 1 to 5 for each map that should launch other maps
Step 2: Deploy Transformation
This step deploys a transformation to intercept the NodeClickedOn event from the map and route it to the correct destination. Transformations manipulate the event generated by a source target before it is delivered to the target portlet . This is required because a Map is not capable of receiving a NodeClickedOn event directly, so a "framework" event must be used to launch the portlet containing target map.
- Create the transformation descriptor in a file named ibm-portal-transformation.xml
<?xml version="1.0" encoding="UTF-8"?>
<transformation:ibm-portal-transformation
xmlns:p="http://www.ibm.com/tivoli/tip/schemas/2.1/ibm-portal-base.xsd"
xmlns:transformation="http://www.ibm.com/tivoli/tip/schemas/2.1/ibm-portal-transformation.xsd"
xmlns:base="http://www.ibm.com/tivoli/tip/schemas/2.1/ibm-portal-base.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.ibm.com/tivoli/tip/schemas/2.1/ibm-portal-transformation.xsd ibm-portal-transformation.xsd http://www.ibm.com/tivoli/tip/schemas/2.1/ibm-portal-base.xsd ibm-portal-base.xsd ">
<transformation:transformation
uniqueName="com.ibm.tivoli.ncw.transforms.map">
<transformation:description
uniqueName="com.ibm.tivoli.ncw.map.MapTransform.description">
<base:nls-ref
key="MapTransform.description"
locationName="classes/com/ibm/tivoli/ncw/map/nl/MapTransform" />
</transformation:description>
<transformation:title
uniqueName="com.ibm.tivoli.ncw.map.MapTransform.title">
<base:nls-ref
key="MapTransform.title"
locationName="classes/com/ibm/tivoli/ncw/map/nl/MapTransform" />
</transformation:title>
<!-- This is the name of the function in the transformation.js that will be called when the event is occurred. -->
<transformation:function-name>launchMap</transformation:function-name>
</trans |