Configuring launch-out integrations for the Event Dashboard

You can configure the Event Dashboard to run a script that launches another product. The script is run when a user clicks a monitor box. For integrations with products that are in Jazz for Service Management, you can use the Dashboard Application Services Hub action framework to define events that can be launched by the script, or specify a URL that is opened in the browser. For products that are not in Jazz for Service Management, you can only use a URL.

To use the Dashboard Application Services Hub action framework, complete steps 1 and 2. Otherwise, skip these steps.

1. On the Web GUI server, define the broadcasting event in the JazzSM_WAS_Profile/installedApps/JazzSMNode01Cell/isc.ear/OMNIbusWebGUI.war/WEB-INF/ibm-portal-event.xml file.
   For example:

   <!--  Event Definition -->
   <events:event-definition>
         <events:name xmlns:x="http://ibm.com/namespace">
                x:eventname
         </events:name>
   </events:event-definition>

   Where eventname is the name of the broadcasting event and namespace is the name space shorthand for the Web GUI.

   Important: The combination of namespace and eventname must be unique.
2. In the ibm-portal-event.xml file of the integrating product, define a subscription to the event in the widget that you want to be launched from the Event Dashboard:
   1. Locate the section that defines the widget that you want to subscribe to the event.
   2. Define the subscription.
      For example:

      <!--  Portlet Subscriptions -->
      <events:widget-definition-ref widgetDefinitionRef="widgetdefinition">
              <events:supported-subscribed-event>
                     <events:name xmlns:x="http://ibm.com/namespace">x:eventname
                     </events:name>
              </events:supported-subscribed-event>
      </events:widget-definition-ref>

      Where:

      eventname

      Is the name of the event defined in step 1

      namespace

      Is the name space shorthand for the Web GUI

      widgetdefinition

      Is the widget definition of the page to which you want to launch from the Event Dashboard.

3. Edit the widget preferences for an Event Dashboard, or set the defaults for all users.
   In the Edit Event Dashboard Portlet Preferences window, from the Single Click list select Script. In the text field, write the required JavaScript. See Sample scripts for more information.
4. Click OK.

{$param.widgetNamespace}sendPortletEvent
({'name':'http//ibm.com/namespace#eventname',
'parameter':{parametervalue}'});

window.open("protocol://hostname:portnumber/contextroot/?querystring");