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
For the procedure to determine what IDO you need, see Determining the IDO for an Event Handler.
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.
- 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. Examples:
- 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 shared (that is, named identically) by all the IDOs, and/or to protect nonshared 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 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 IDO objects or inbound BOD listed for the handler at the time the revision was created.