# Event Registration

The Event Registration feature lets Portal Administrators and developers register custom portal and non-portal events that are sent to Analytics using the OpenUsage API. Event data is saved to the Analytics database, which can then be queried for reporting to a non-portal application. This feature's user interface includes the Event Registration and Create Event pages.

Use the Event Registration page to:

- Launch the Create Event page, which you use to create events and their parameters.
- Enable and disable the storage of data generated by individual events. Once event data is stored in the database, you can query the data for reporting in a portal or non-portal application.
- Create dimensions, which are discussed below.

Note: This topic only discusses the Event Registration user interface. To utilize the full capabilities of this feature, you must use the OpenUsage API.

This topic discusses:

Overview of Events, Event Parameters, and Dimensions
Managed Dimensions
Managed Events

Overview of Events, Event Parameters, and Dimensions

An event typically defines one user action that you would like to capture. Each event is composed of several event parameters, which define the various kinds of data that is generated by the event. By default, each event includes the TIMEID, OCCURRED, USERID, and VISITID event parameters (for more details on these parameters, see Delivered Parameters).

Event Registration also lets you create your own event parameters to capture data that is not defined by the delivered defaults. To capture data of type Date, Integer, or Float, simply create an event parameter for that data type. To capture data of type String, you must create a dimension to define this data. After you create the dimension, you must create a new event parameter of type String, and associate it to the dimension that you created.

Note: We recommend that you do not create too many dimensions, since they slow down the speed of data collection and reporting.

Event Registration also lets you use dimensions from your own application's tables. To do so, create a parameter of type Integer. Then, using your database schema, map the parameter to the ID column in your dimension table.

Managed Dimensions

This section lets you create custom dimensions to define data of type String.

To use a dimension, you must associate it to an event parameter on the Create Event page. You can associate a dimension to multiple event parameters and use that dimension in multiple events.

Setting | Description
Add | Create a new dimension.
Remove | Remove a dimension by selecting the check box next to the dimension name and clicking this button. Note: You cannot remove or change the name of a dimension after clicking Finish on the Event Registration page. To do so, contact the Support Center for assistance.
Name | Type the name of the dimension in this box. Names can be up to 20 characters in length and can only include letters, numbers, spaces, and underscores. The names that you create only define how dimensions appear on the Event Registration page. In the database, custom dimension tables use the following naming convention: ascdim_<dimension_name> (spaces in dimension names are replaced by underscores).
Unique? | Check this box if you want to store only unique values in this dimension's table.

Managed Events

This section lets you add, enable and disable events.

Setting | Description
Add | Launch the Create Event page, which lets you create an event.
Enable | Select the check box next to an event and click this button to begin saving an event's data. By default, the BEA AquaLogic Analytics Collector Service starts saving the event's data 30 minutes after you click Enable.
Disable | Select the check box next to an event and click this button to stop saving an event's data. You can edit events even when they are disabled. By default, the BEA AquaLogic Analytics Collector Service stops saving the event's data 30 minutes after you click Disable.

Related Topics:

- Runtime Settings
- Security Settings
- Event Registration
- Create Event

To display the page associated with this help topic:

1. Click Administration.
2. From the Select Utility drop-down list, click Analytics Administration.
3. Under Edit Object Settings on the left, click Event Registration.