Applies to Objects

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 at an IDO level. Most commonly, this is when an action is taken that involves that IDO, but it can also be used to process incoming BODs.

To use this option, specify either of these:

  • The name of the IDO associated with the event to be triggered

    Normally, this field contains a single IDO reference, but in certain cases, you might need to refer to more than one IDO. In such cases, you can list multiple IDOs, separating them with commas. In this case, the event handler executes when any one condition is met.

    For the procedure to determine what IDO you need, see Determining the IDO for an Event Handler.

  • A BOD verb and BOD noun into a single value and enter that value in this field.

    The format for this is BODverb.BODnoun

    You can use wildcards (*) as part of the specification. For example:

    • Sync.PulseNotification
    • Ack.*
    • *.SalesOrder

EXAMPLE:

Suppose you were concerned about a certain General Ledger account and wanted to know whenever any amounts were posted to it. You could add an event handler for the IdoOnItemInsert event, and enter in this field Journals,Ledgers. (These would both be IDOs that use the Acct property.)

The associated event actions would then be set up to first check when the event fires whether the value of the Acct property matches that of the account you want to monitor. If the value matches, the next event actions would be to send a notification to yourself with details of the transaction.

The key to using multiple IDOs is to ensure that you refer only to properties that are shared (that is, named identically) by all the IDOs, and/or to protect non-shared property references by tests against the IDO( ) or PROPERTYAVAILABLE( ) keywords, to avoid referring to a property that is not relevant to the object that triggered the running instance of the event.

Notes

If this field and the Applies to Initiators 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 form and the Event Handler Diagram form, this field is read-only and shows the initiators associated with the selected event handler.

On the Event Handler Revisions form, this field is read-only and shows the IDO objects or inbound BOD listed for the handler at the time the revision was created.