Bind an event to a page

Variant event mappings You must have a variant page to perform a variant event mapping. The Variant event mappings that are available depend on the variant page. If the variant page has a list, you add event handlers for things like Row clicked, Nav item, and so on. When the variant has a Viewport, you may have different event handlers to set up.

1. Select Add event mappings. For example, you can add a new event handler for Row clicked.
2. Select an event handler from the list of available Inherited event handlers or local event handlers like the UXR App Shell Data Source.

3. To add the event handler to your variant, select Add.

   Image omitted: variant-event-mappings.png
   Variant event handler options.</p>

4. These event mappings are in the variant record that are found in the sys_ux_screen table.

5. The source events for these event mappings are any dispatched events that are defined for your page.
6. The available handlers for these event mappings are canvas-level events, the UXR App Shell Data Source, and operations from inherited data resources.
7. These event mappings are used as relays so that events that are dispatched from components on your page are relayed up to the user session handlers.
8. These mappings are automatically created on a page save when you have mapped a component's dispatched event to another event. For example, when you map a Button clicked event to the Link to destination event, the event creates a dispatched relay event and a variant event mapping after you save the page.

1. Select Dispatched events.
2. Select
   Image omitted: add-icon.png
   +Add icon..</li>
3. In the Add an event screen, do the following actions:
4. Type a label for your event.
5. Select a target parent event handler.
6. To add the event handler to your dispatched events, select Add.

1. The new event handler that you created appears in Dispatched events. The following example shows how to add a Link to destination event handler.

• These events are in the [sys_ux_event] table. The page definition record contains references to the [sys_ux_event] record.

• These events serve as source events for variant event mappings.

• To create new dispatched events for your page, select

  Image omitted: add-icon.png
  +Add icon.. Configure the event label to auto-populate the event name and payload fields for your new <code>sys_ux_event</code>.</p>

• These events are often used to create relay event mappings. You can select a Target parent event handler to model the payload fields after the selected event. You can also manually create payload fields for your dispatched event.