Business Add-Ins

Business Add-Ins (BAdI) are used to enhance products in an upgrade-safe way without modifying the original source.

Process start engine

With the enhancement spot /PCH/BPF_PROCESS_START the start of processes can be enhanced.
The method FILTER_VALID_PROCESSES allows additional checks of the available processes in the current context and allows to filter even more.

The method PREPARE_START_PROCESS allows you to provide container data and also objects (and data) for the object list as well as the possibility to define dynamic process adaption before the process is actually started. The adjustments can be done based on the process which shall be stared, the start type and the corresponding main object (if any).

For adjusting container data another enhancement is available (see below). The enhancement of customer specific container data can be achieved with both methods. Because the process start engine is very close to the UI and will be integrated in UIs it is recommended to use this BAdI when a UI is required for gathering data for the fulfilling of the container data.

The dynamic process adaption offers the possibility to define dynamic aspects of the Process (like deadlines, priorities, active gates...) and allows to define a different process behaviour when the process is started. When defining the dynamic process adoption during start, only basic consistency checks and no authority checks are applied. The developer is responsible for ensuring that the dynamic adjusted process remains in a valid state and that a possible (customer specific) user interaction does appropriate checks according to their business needs. The defined dynamic adoption is reflected in the corresponding dynamic adoption tasks and can be adjusted as well (if defined accordingly).

The definition of dynamic aspects of the parts is done via acquiring an interface for the corresponding process element via its external ID from the process definition. The returned interface has methods for getting and setting dynamic adjustable data according the corresponding object type.

The following settings can be adjusted during process start:

Process

• Priority

• Deadlines (relative and fix)

Part process

• Priority

• Deadlines (relative and fix)

• Threshold (only for parallel processes)

Activity

• Activation

• Priority

• Deadlines (relative and fix)

Gateway:

• Active gate (only in exclusive gateways)

Gate

• Activation (only in parallel gateways)

Enhancing Container Data

Defining custom persistent Container Data

If customer specific persistent containers and items are defined, values can be filled when new processes are created. To do so, the default ProNovia Business Object BAdI must be implemented (Please refer to the ProNovia Object Services Integration & Enhancement Manual). Because this BAdI is generic the implementation should also define a filter for just the Object Type "BPF_PROCESS". The default BAdI provides several generic methods. To add more specific enhancements the implementation class must implement the process specific interface /PCH/IF_BPF_BADI_BO_RPROCESS.

This interface provides an additional method called SET_CONTAINER_VALUES where item values can be added and modified.

Defining custom transient (non-persistent) Container Data

The value(s) of customer specific transient container items can be defined during runtime using the BAdI /PCH/BPF_CONT_PROVIDER_PRC. Consult the corresponding in system documentation for further details and explanation.