Ansicht
Dokumentation

_CACS_CACS_OAOBJSEL - BAdI: Object and Target Object Selection in Worklist

ROGBILLS - Synchronize billing plans   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
This documentation is copyright by SAP AG.

This Business Add-In (BAdI) is used in Incentive and Commission Management (ICM). This BAdI is intended for object and target object selection while creating, managing, and processing worklists for object assignment using the Framework for Object Assignment. The implementations of BAdI definition CACS_OAWL_OBJSEL are called from the application plug that connects the Framework for Object Assignment to the application.

The BAdI interface IF_EX_CACS_OAWL_OBJSEL has the following three methods:

• SELOBJSWID
  Gets detailed information on objects with their ID. This method is executed when an existing worklist is displayed or changed. The task of the connected application is to get the related object attributes for the specified object keys.

• SELOBJSWPAR
  Selects objects based on predefined selection parameters. This method is executed when the selection of objects or target objects for an assignment set is to be made. Here, the connected application selects and returns objects based on the selection parameters.

• SELOBJSWPARID
  Searches object list on basis of selection parameters. This method is executed when an object search of the worklist is executed in the user interface for managing worklists using the search function under the "Search" tab. This method is also used when you use the option 'With Configured Search Interface' in the search help for worklists. The task of the method is to select those objects from the list of all objects and target objects of the worklist that have the characteristics specified in the selection parameters.

Implementations for each of the above methods must observe the convention of returning data of an object or target object in the format fixed in the Dictionary structure CACS_S_OAOBJAFFIX. The key include CACS_S_OAOBJIDENT serves to identify the object or target object. The data section that complements the object data along with the prefix can have any number of fields. However, the data typing must match the definition of parameter ET_SELRESULT in the interface of the function module that is called in the application plug for the corresponding method.

Implementations of the BAdI definition CACS_OAWL_OBJSEL are called after filtering. The filter is defined in Dictionary structure CACS_S_OAOBJSELBADIFLTR. The following filter criteria are available:

• Assignment type

• Selection structure

• Field selection for object and target object selection

The implementations of CACS_OAWL_OBJSEL_ELT1 and CACS_OAWL_OBJSEL_ELT2 for entitlement and liability transfer are contained in the standard delivery of BAdI definition CACS_OAWL_OBJSEL. The implementations are active as standard and serve to select remuneration lines or commission contracts for entitlement and liability transfer worklists.

The implementation of CACS_OAWL_OBJSEL_ELT1 includes logic for selecting, reselecting (for display), and searching for remuneration lines. The implementation of CACS_OAWL_OBJSEL_ELT2 includes logic for selecting, reselecting (for display), and searching for commission contracts.

The BAdI implementations are called from the following methods in the application plug CACS41_FOA_ELTPLUG:

• Selects objects or target objects according to predefined parameters (method called: SELOBJSWPAR)

• Gets detailed information on a list of objects or target objects (method called: SELOBJSWID)

• Object or target object search in worklist (method called: SELOBJSWPARID)

Since the BAdI definition is filter-dependent, the filter values of existing BAdI implementations must be enhanced when you configure a new assignment type, define a new selection structure, or create a new field selection. If the logic of existing BAdI implementations does not take account of the new assignment type or selection by the new selection structure or field selection, you must create a new BAdI implementation.

See also:

Methods

• Gets detailed information on objects with their ID (SELOBJSWID)

• Selects objects according to predefined selection parameters (SELOBJSWPAR)

• Searches object list on basis of selection parameters (SELOBJSWPARID)

Interface

• BAdI interface IF_EX_CACS_OAWL_OBJSEL

ABAP Short Reference   PERFORM Short Reference  
This documentation is copyright by SAP AG.

Length: 5262 Date: 20240523 Time: 183237     sap01-206 ( 102 ms )