Action Type

On the Event Actions form and Event Handlers form, select the type of action you want the application event handler to perform.

On the Event Handler Revisions form, this field is read-only and indicates the value set for this field on the Event Actions form.

This table lists and describes the basic application event action types available from this drop-down list:

Event action: What it does: See this entry:
Achieve Milestone Tells the application to change the visual state of the event when a specified condition has been met. Event Action Achieve Milestone
Attach Specifies a document (file) to be attached to a record. Event Action Attach
Audit Tells the application to add an entry to the audit log. Event Action Audit
Branch Allows the application to take different actions, depending on whether a specified condition has been met. If the condition evaluates to TRUE, the system takes one action. If the condition evaluates to FALSE, the system takes a different action. Event Action Branch
Call Database Method Tells the application to run a specified stored procedure, passing any parameters that the stored procedure requires and accepting any return values. Event Action Call Database Method
Call IDO Method Tells the system to invoke a specified IDO method, passing any parameters that the method requires and accepting any return values.
Note: A standard (.NET) IDO method that is invoked from a Call IDO Method action should be declared with a type of int and a return value of 0 for success or non-zero for failure.
Event Action Call IDO Method
Call Web Service Tells the application to invoke and run a specified web service, passing any parameters that the web service requires and accepting any return values. Event Action Call Web Service
Discover File Tells the application to watch for named files in specified locations and then take prescribed actions when these files are discovered. Files can be named using wildcards. You can specify a single folder or a folder and all of its subfolders.
Note: Use of this event action forces the handler to be asynchronous.
Event Action Discover File
Dispatch IDO Method Invokes the IDO method on a remote system. Event Action Dispatch IDO Method
Dispatch IDO Request Sends an IDO request to retrieve or update data, or perform some action on a system to which the user is not currently connected or logged on.

The result can be parsed using the Transform XML action type.

Event Action Dispatch IDO Request
Dispatch Load Collection Executes a LoadCollection request on a remote system. Event Action Dispatch Load Collection
Dispatch Load IDO Row Executes the underlying Load IDO Row request on a remote system. Event Action Dispatch Load IDO Row
Dispatch Update Collection Executes an UpdateCollection request on a remote system. Event Action Dispatch Update Collection
Execute IDO Request Executes an IDO request to retrieve or update data, or perform some action.

The result can be parsed using the Transform XML action type.

Event Action Execute IDO Request
Extract XML Collection Tells the applicaton to generate a collection of rows and properties from a specified XML string, and store it in a named result-set. This collection can be further adjusted through the Update Collection action type, its properties retrieved through expression functions, and converted back to XML. Event Action Extract XML Collection
Fail Tells the application that, when a specified condition has been met, an error has been encountered, and then discontinues the event handler execution with a status of Failure. Event Action Fail
Finish Tells the application that, when a specified condition has been met, the event handler is finished with a status of Success.

Optionally, sets a result message to display on the Event Status form when the event is finished running.

Event Action Finish
Generate Event Tells the application to generate an event when a specified condition has been met. Event Action Generate Event
Goto Tells the application to proceed to a particular action in the sequence. Event Action Goto
Load Collection Tells the application to retrieve data from a specified IDO collection and place it into a named result set. Event Action Load Collection
Load IDO Row Tells the application to retrieve a specified row of data from an IDO collection. Event Action Load IDO Row
Notify Sends an informational message to selected recipients. This message does not require a response from the recipients. Event Action Notify
Prompt Sends a message that prompts recipients to take some action and then awaits a response.

Can send an email to recipients for whom Send Email Prompts is specified in the Users form, if the system is set up for SMTP relaying of email. The recipient can click a link in the email to respond.

Can be set to count response votes according to a specified voting rule.

Can also be set so that, if no response or an insufficient response is received within a certain time limit, an alternate action is performed.
Note: Use of this event action forces the handler to be asynchronous.
Event Action Prompt
Run Background Task Places a specified task on the background task queue, to be run in its turn. Event Action Run Background Task
Send BOD Sends a Business Object Document (BOD) to the Replication Document Outbox. Event Action Send BOD
Send Email Tells the application to send an email to designated recipients when a specified condition has been met. Event Action Send Email
Set Attributes Sets the title of the event as it displays in the Event Status form, when the event is running or finished. Event Action Set Attributes
Set Values Tells the application to set event variables or parameters to given values or expressions when a specified condition has been met. Event Action Set Values
Sleep Tells the application to wait for a specified period of time (in seconds) before moving on.
Note: Use of this event action forces the handler to be asynchronous.
Event Action Sleep
Transform XML Tells the application to perform an XSL transformation on specified XML content and place the result in an event variable or parameter. Event Action Transform XML
Update Collection Has the application perform an INSERT, UPDATE, or DELETE operation on specified records in a designated IDO collection or named result set. Event Action Update Collection
Wait Tells the application to wait until a specified condition has been met.
Optionally, can be set to retest for the condition periodically and, if the condition has not been met within a certain time limit (in seconds), perform an alternate action.
Note: Use of this event action forces the handler to be asynchronous.
Event Action Wait