trigger preRequest
System trigger for handling any global pre-processing, such as verifying the environment or user permissions.
|
Declaration: |
|
|
Applies to: |
|
|
Activation: |
Activated before the preActivate trigger and the requested operation |
|
Default behavior: |
Executes done |
|
Behavior upon completion: |
If the trigger returns 0 or a positive value, the preActivate trigger is activated, followed by the requested operation. If the trigger returns a negative value or throws an exception, additional information is added to $procerrorcontext and the requested operation is not activated. |
Description
The preRequest trigger allows global pre-processing to be centralized in a single trigger. Generic ProcScript should be placed in this trigger, rather than duplicated in each component. The trigger is typically used to include environment verification, such as checking user rights or permissions, and to log file or audit file record keeping.
In web applications, this trigger is the first in a sequence of triggers fired by the USYSHTTP component in response to every web request made by the Web Request Dispatcher (WRD).
The SOAP Request Dispacher (SRD) and other types of call-in do not fire this trigger.
