Ansicht
Dokumentation

FKK_SAMPLE_0490 - Event 0490: Document Assignment to Co-Liability Records

Addresses (Business Address Services)   ABAP Short Reference  
This documentation is copyright by SAP AG.

Functionality

The function module provides data to assign line items to existing collaborative liability (co-liability) records. When adding line items to a co-liability instance, after the line item validation (predefined checks and event 0493) has taken place, event 0490 is processed to determine the co-liability records to which the line items are to be added.

The data available comprises a list of all valid line items (IT_DFKKOP), a list of all existing co-liability records within the co-liability instance (IT_DOCUMENT), the type of co-liability (IV_COLIO_TYPE) and the key of the co-liability instance (IV_COLIO_GUID).

The event is processed once for all valid line items. To add a line item to a co-liability record, you have to add it to the export parameter ET_OP_DOCUMENT_LINK. The internal table stores the link between a line item and a co-liability record. You can also add a split criterion.

If a line item cannot be added to an existing co-liability record, it is also possible to assign the item to a new record. In this situation, you also need an entry in the parameter ET_OP_DOCUMENT_LINK,but a consecutive number has to be used instead of a real record key.

If no entry exists for a line item in the parameter ET_OP_DOCUMENT_LINK, the item is not added to an existing record or to a new record.

The only split criterion currently available is PERSL. In future other criteria may be added.

Parameter	Name	Type
Import	IV_COLIO_GUID	/BOBF/CONF_KEY
Import	IV_COLIO_TYPE	COL_OBJ_TYPE_KK
Import	IT_DFKKOP	DFKKOP_T
Import	IT_DOCUMENT	FKK_COL_T_DOC
Export	ET_OP_DOCUMENT_LINK	FKK_COL_T_DOC_LINK
Export	ET_MESSAGE	BAPIRET2_T
Export	EV_TRACE_GUID	SYSUUID_X

Example

In this example the correct record is determined according to the period key. This would be the split criteria. In co-liability OBJ 1 there are three different co-liability records. A different period key (PERSL) is assigned to each record:

Record 1: Key 1 - PERSL 2014

Record 2: Key 2 - PERSL 2015

Record 3: Key 3 - PERSL 2016

The line item L1 with OPBEL 123, OPUPW 0, OPUPK 1 and PERSL 2015 is added to OBJ 1. The event 0490 determines the record to which line item L1 is assigned.

In this case record 2 is the correct one. Therefore, a new line in parameter ET_OP_DOCUMENT_LINK is created with the following structure:

DB_OPBEL 123, DB_OPUPW 0, DB_OPUPK 1, DOC_KEY 2, SPLIT_CRIT 2015

Notes

If you create a function module to assign line items to co-liability records, you can add messages only and NOT exceptions. The messages can be transferred by adding them to the export parameter ET_MESSAGE. The export parameter EV_TRACE_GUID is only required if you are using BRFplus. If you do not use BRFplus but implement the function module, you must ignore this parameter.

Parameters

ET_MESSAGE
ET_OP_DOCUMENT_LINK
EV_TRACE_GUID
IT_DFKKOP
IT_DOCUMENT
IV_COLIO_GUID
IV_COLIO_TYPE

Exceptions

Function Group

FKK_COL_EVENTS

BAL Application Log Documentation   Addresses (Business Address Services)  
This documentation is copyright by SAP AG.

Length: 5791 Date: 20240523 Time: 060220     sap01-206 ( 77 ms )