Creating Customizations
Before and After events are provided for every method of the business component, and each event header describes the business method and its parameters. To customize the event, you uncomment the event you want to implement and add code into the internal procedure.
The Customization folder in the application root contains two sub-folders:
• Definition
This folder contains an include file for each business component.
• Template
This folder contains the .p program file for each business component. This program contains the Before and After event code for the component.
Note: You must include the Template folder in the PROPATH of each progress session used for compiling the customized component code. This ensures that the system can detect code version mis-matches during an application upgrade.
Writing Customizations
Use the following steps for every component that you want to customize.
1 Copy the file in the template folder to a local source code folder.
You must always code in a locally stored copy of the template file, and not in the original file. You can store this copy anywhere on your local drive, but you must ensure that you copy only those template files that you are modifying. Ensure that the local folder you use is contained in the PROPATH for compilation.
You also copy the include file from the definition folder to the local folder. This file is needed for compilation, and must not be modified.
2 Use a Progress 4GL editor to uncomment the events in the template file to be customized, and to add related code.
Compiling Customizations
Compile all program files in your local source code folder into a folder named customcode.
This customcode folder is placed in a folder that is part of the PROPATH of the appserver running the business logic.
Once the folder is included in the PROPATH, the application automatically runs the customization when the appserver is restarted or all agents are trimmed.