Applies to Initiators

On the Event Handlers form, use this field in cases where you want an event handler to execute only when the event is triggered under certain circumstances. Most commonly, this is when an action is taken on a particular form.

For example, you have two forms, for example, Customers and Vendors, that can both trigger the same event. You want this event handler to be executed only when the event is triggered in the Vendors form. In this case, you would use this field to set the handler to execute for Vendors only.

The syntax for this field is:

InitiatorType.InitiatorName

where:

  • InitiatorType is the type of initiator where the event is triggered.

    An initiator type is any process that initiates an IDO request, most commonly a form.

  • InitiatorName is the name or other identifier of the initiator.

For example, to define the initiator for the example already given, in this field you would enter Form.Vendors.

You can list multiple initiators, separating them with commas. In this case, the event handler executes whenever any one of the initiators is present.

Note:  If this field and the Applies to Objects field both contain values, then at least one condition in each field must be met for the event handler to execute.

On the Event Handler Sequence and Event Handler Diagram forms, this field is display-only and shows the initiators associated with the selected event handler.

On the Event Handler Revisions form, this field is display-only and shows the initiators listed for the handler at the time the revision was created.