Developer Resource - Business Rule Customizations

Custom Events

Create Business Rule page showing an example of a custom event:

Custom Event

Custom business rule events can be defined in the following ways:

  1. Adding to the SEL_EVENT control on form 472 using UI Editor
  2. Creating a Configuration Item (config_itm)

Dovetail Agent will load custom events using both methods. The preferred method is to use a configuration item.

The configuration item should be created and imported by using a DAT file that is imported using DIET (ArchiveManager).

Configuraton Item Fields

Field Name Description
name Name of the event
value_type 1001. This tells Dovetail Agent that it's a custom event.
i_value Numeric identifier of the custom event. If your event is "USER1003", the i_value would be 1003
str_value Object type the event applies to, in uppercase, e.g. "CASE"
description Descriptiojn of the event

Example DAT file:

OBJECT TYPE="config_itm", NAME="Run Task Set Custom Event"
UNIQUE_FIELD = name
    FIELDS
        name ="Run Task Set";
        description="Dovetail - Run Task Set";
        value_type = 1001;
        i_value = 1005;
        str_value="CASE";
    END_FIELDS
END_OBJECT NAME="Run Task Set Custom Event"

Custom Event Creation Times

Create Business Rule page showing an example of a custom event creation time:

Custom Event Creation Times

Custom business rule event creation times can be defined by creating a custom rule property (prop_name). The prop name should be created and imported by using a DAT file that is imported using DIET (ArchiveManager).

Prop Name Fields

Field Name Description
obj_type Numeric identifier of the object type the event creation time applies to, e.g 0 for 'case'
prop_name Unique custom time ID. Must be in this format: @USERTIMEnnn where nnn is equal to or greater than 150
path_name Path from base object to the column name from which the value will be fetched for evaluation
val_type Numeric value of 609 meaning a date-time type
max_len 30
extra_info Text to be shown in the event list

Example DAT file:

OBJECT TYPE="prop_name", NAME=Next_Action_Due_Date
    UNIQUE_FIELD=obj_type, prop_name
    FIELDS
        obj_type=0;
        prop_name ="@USERTIME150";
        path_name="x_next_action_due_date";
        val_type=609;
        max_len=30;
        extra_info = "Next Action Due Date";
    END_FIELDS
END_OBJECT NAME=Next_Action_Due_Date

Additional Information

Additional information regarding Rulemanager, Business Rules, and Customizations can be found in the Rulemanager Companion Wiki