Setting Up Events

The Aptify Framework provides a great deal of flexibility without requiring any programming. For instance, a user may define an event and then set up event handlers using only the Aptify Desktop client. (Note that some new events may require additional development to raise an event through code, which would require some programming. The event model in Aptify provides the ability for a developer to raise events explicitly via code.)

This topic covers the following sub-topics:

• Creating Event Definitions
• Creating Event Categories

Creating Event Definitions

The Event Definitions service stores the events that an organization can use to trigger a process flow. Aptify provides a set of events with the standard system; see About the Delivered Event Definitions for information on the set of delivered Event Definitions.

A sample Event Definitions record is shown in the figure below.

In addition, an organization can create new Event Definitions by following these steps:

1. Open a new record from the Event Definitions service.
2. Enter a Name for the event.
3. Enter an event category in the Category field. This field links to the Event Categories service (see Creating Event Categories).
4. Enter a Description for the event (required).
5. Specify a scope for the event from the Event Scope drop-down list.
   • Select Global if the event is generic and is applicable system wide. For example, the AfterSave event is generic since it is applicable to every record in the system.
   • Select Entity if the event is related to a specific entity. For example, the Order Shipped event definition is set to Entity since it is specific to the Orders entity.
   • Select Application is the event is related to a specific application. 
6. If this event is based on another event, enter that event in the Base Event field. This field links to another record in the Event Definitions service.
7. If you specified a Base Event, select a Firing Sequence from the drop-down list.
   • Post-Process: This is the default setting. It specifies that this event fires after its associated Base Event.
   • Pre-Process: This option specifies that this event fires before its associated Base Event. 
8. If you set Event Scope to Entity, enter the entity to which this event applies in the Entity field.
9. If you set Event Scope to Application, enter the application to which this event applies in the Application field.
10. If you specified a Base Event, click the Script tab and enter a script that defines the logic which will trigger this event.
    • The script should be in VB.NET script format; the system uses Aptify's Scripting functionality to execute your script. See Administering Scripts for more information.
      
      
11. Save and close the record.

Creating Event Categories

Event categories allow events to be grouped into logical business-specific categories.

1. Open a new record from the Event Categories service.
2. Enter a Name for the category.
3. If you are creating a sub-category, enter the parent category in the Parent field. This field links to another record in the Event Categories service.
4. Enter a Description for the category (optional).
5. Save and close the record.