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 post-processing 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 that 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 two 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. Click the Notify Now check box to broadcast the event and update any listening mobile applications. Click the Notify Across Page check box to notify listening mobile applications on current and other pages. Server-side - click this check box 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 pre-processing 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, the column can not have more than one event defined on it.

Click OK to add the event to your events list. The cell(s) with the event defined should turn blue, which indicates there is an event defined for that column.
Click Preview to preview the mobile application.