Maintenance Objects - Algorithms
Use this page to maintain a maintenance object's algorithms. Open this page using Admin Menu, Maintenance Object and then navigate to the Algorithms tab.
Maintenance Object - Algorithms
Description of Page
The Algorithms grid contains algorithms that control important functions for instances of this maintenance object. You must define the following for each algorithm:
• Specify the System Event with which the algorithm is associated (see the table that follows for a description of all possible events).
• Specify the Sequence Number and Algorithm for each system event. You can set the Sequence Number to 10 unless you have a System Event that has multiple Algorithms. In this case, you need to tell the system the Sequence in which they should execute.
• If the algorithm is implemented as a script, a link to the Script is provided. Refer to Plug-in Scripts for more information.
• Owner indicates if this is owned by the base package or by your implementation (Customer Modification).
The following table describes each System Event.
System Event | Optional / Required | Description |
|---|---|---|
Determine BO | Optional | Algorithm of this type is used to determine the Business Object associated with an instance of the maintenance object. It is necessary to plug in such an algorithm on a Maintenance Object to enable the business object rules functionality. The system invokes a single algorithm of this type. If more than one algorithm is plugged-in the system invokes the one with the greatest sequence number. |
Information | Optional | We use the term "Maintenance Object Information" to describe the basic information that appears throughout the system to describe an instance of the maintenance object. The data that appears in this information description is constructed using this algorithm. The system invokes a single algorithm of this type. If more than one algorithm is plugged-in the system invokes the one with the greatest sequence number. |
Transition | Optional | The system calls algorithms of this type upon each successful state transition of a business object as well as when it is first created. These are typically used to record the transition on the maintenance object's log. Note that some base maintenance objects are already shipped with an automatic logging of state transitions. In this case you may use these algorithms to override the base logging functionality with your own. |
Transition Error | Optional | The system calls this type of algorithm when a state transition fails and the business object should be saved in its latest successful state. The algorithm is responsible for logging the transition error somewhere, typically on the maintenance object's log. For details see "Keeping An Entity In Its Last Successful State" in the Oracle Utilities Application Framework Administration Guide. Notice that in this case, the caller does NOT get an error back but rather the call ends successfully and the exception is recorded somewhere, as per the plug-in logic. The system invokes a single algorithm of this type. If more than one algorithm is plugged-in the system invokes the one with the greatest sequence number. |
Parent topic