Defining Broadcast Events

Not all mobile application types can have events defined; the mobile application must have tabular data, a grid, or table structured output. If you try to create an event and nothing seems to happen, try using a different mobile application type.

The following example guides you through the creation of a postprocessing event:

Right-click a mobile application and select Add Post Processing|Events.
You will select the grid section to use for the event from the table.

In the first wizard window, click Add to launch the Add Event wizard, which allows you to define, or edit an event.

You can define an event for a row, a column, or any subset of rows and columns. You can also use the row and column number to identify a specific cell to define an event. The following table describes the event properties.

Event properties

Property name	Description
Event Properties	Enter a name for this event and select a grid to which the event applies: Event Name is a logical name that must be unique and you must have separate names for distinct events. The name is automatically filled in for server-side when you select the mobile application for the server-side click-across event. Select the Grid to which the event is assigned from the drop-down list.
Records to Send Events	Select the rows and columns to which this event applies. Enter your rows and columns as numbers, for example 1, 2, 3 or 1-3 or "all" for all rows or columns. You can also enter something similar "2-" to indicate starting row/column 2 to the last row/column. Click the Multi-value check box if this event has more than one value and the columns to which they apply.
Event Type	Event Type can be: Client-side – click this check box if this is a client-side event. Select Notify Now to broadcast the event and update any listening mobile applications. Select Notify Across Page to notify listening mobile applications on current and other pages. Server-side – select this option if this is a server-side event. Click Search Mobile Application to locate the listening mobile application for this event. If you have selected a mobile application that does not have parameters, an alert displays. Click Search Template to locate the preprocessing template for this event, which is optional. The server-side mobile application must have CGI parameters to pass the event to. If there is more than one CGI parameter, you are presented with a dialog box asking for which event this represents. The event name is assigned the name of the selected CGI parameter. A couple of other things to keep in mind: In-place transform – select this option to perform an in-place transformation. This field affect PDA devices only.
Value Type	The differences between the types of data that can be sent in an event are: Cell Value (this cell) – sends the text you click on as the event data. Cell Value (other cell) – sends the text of the specified cell as the event data. Static – sends a constant value you specify in the text box to the right of the drop-down list as the event data. HREF (this cell) – if the text for which you are defining the event is a link, the underlying URL is sent as the event data. HREF (other cell) – sends the underlying URL of the specified cell as the event data.

Warning

Defining multiple events on the same data causes invalid HTML. In other words, a column cannot have more than one event defined on it.

Click OK to add the event to your events list. The cells for which the event is defined should turn blue, which indicates there is an event defined for that column.
Click Preview to preview the mobile application. See Preview the Mobile Application.

Related Task

Adding Listeners