Fonction SAP BAPI_ADMGMTCOA_GETLIST - IS-M/AM: BAPI Select Contract

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
DISTR_CHAN BAPIBUSISM012_HEAD-DISTR_CHAN C 2 Distribution Channel
DIVISION BAPIBUSISM012_HEAD-DIVISION C 2 Division
SALESORG BAPIBUSISM012_HEAD-SALESORG C 4 Sales Organization
SERVICE_PERFORMANCE_DATE BAPIBUSISM008_BDS_TMP_KEY-SERVICE_PERFORMANCE_DATE D 8 IS-M: Date services were created for settlement purposes

Paramètre Reférence Long. Facultatif Description
COA_LIST BAPIBUSISM012_SELECT 10 IS-M/AM: Selection Result for Contract Determination
EXTENSION_IN BAPIPAREX 990 X Reference Structure for BAPI ExtensionIn/ExtensionOut Parameters
PARTNER BAPIBUSISM008_PARTNER_SEL 30 X IS-M: Business Partner Key
PARTN_ROLE BAPIBUSISM008_PARTN_ROLE_SEL 2 X IS-M: Select by Business Partner Roles
RETURN BAPIRET2 548 Return Parameters
SELECTION BAPIF4D 255 X Where Clause for Selection

Functionality
This method is used to select all contract items for a business partnerin a sales area that are valid on the SERVICE_PERFORMANCE_DATEand whose inclusive requirements may match additional restrictions in the
SELECTION parameter.
A list of pairs (contract number,item number
) is returned in the COA_LIST parameter. TheAdMgmtCOA.GetDetail method is usedto read detailed data for the contracts selected.

Notes
Authorizations
The system checks authorization to display contracts in the sales area(J_CONTRACT authorization object) and displays anerror message if this authorization is missing.
User-defined selection criteria
Use the Selection or ExtensionIn parameter and theISM_AM_CONTRACT_BAPI BAdI to process your own selection criteriain this BAPI.
Performance
INCLUDE ISMAM_BAPIGETLIST_PERFORMANC

Example
Simple contract determination that ignores booking unit hierarchies canbe implemented by calling this method with the following parameters:
SALESORG [Sales organization]
DISTR_CHAN [Distribution channel]
DIVISION [Division]
SERVICE_PERFORMANCE_DATE [Service date]
PARTNER[1] [Advertiser]
PARTN_ROLE[1] "Contract holder (AI)"
SELECTION[1] ' ABRECHK <> ''2'''
SELECTION[2] 'AND AVMPOS_AR1 = ''01'''
SELECTION[3] 'AND BELEINH1 = ''[Booking unit]'''

Notes
Restrictions found in SELECTION can apply to the contract(ABRECHK in the example) and the requirement elements (AVMPOS_AR1 andBELEINH1 in the example).

Further information
Additional information on the contract is available in the SAP Libraryunder SAP Media -> Advertising Management -> Contract.
STYLE *

Description
The system only selects contracts in this distribution channel.

Description
The system only selects contracts in this division.

Description
The system only selects contracts in this sales organization.

Description
The system only selects contracts whose validity period covers thisdate.

Description
This parameter contains the key for contract items selected using theselection criteria transferred.

Description
This parameter is used to transfer customer-specific enhancements tothe BAPI. Entries should be made in this parameter by the customer. Ifno customer fields are required for selection, the ExtensionInparameter should be transferred with an inital value.
The BAPI_GETLIST_ADD_SELECTS method in the ISM_AM_COA_BAPI BAdI is usedto evaluate additional selection criteria.

Further information
Additional information is available in the Customer Enhancement Conceptfor BAPIs unit in the BAPI programming guidelines.

Description
This parameter contains the business partners for which contracts areto be selected.
INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX

Value range
If this parameter is transferred with an initial value, the systemselects contracts to which any business partner is assigned in theroles defined in the PartnRole parameter.

Notes
SAP BP
INCLUDE ISM_BAPI_BPEXT OBJECT DOKU ID TX
Business partner number Business partner number in external system
ADVERTISER ADVERTISER_EXTERNAL

Description
This parameter contains the business partner roles to be performed bythe business partner in the contracts selected.
INCLUDE BAPI_DATAELEMENT

Value range
If this parameter is transferred with an initial value, the systemselects contracts for business partners in the partner parameterregardless of the roles that they perform.
INCLUDE ISM_BAPI_RETURN

Description
This parameter is used to transfer additional selection criteria forselection using the JHV_RJHABS10 view in the form of an ABAP WHEREclause.

Example
This parameter contains three lines in the example call of this BAPIfor contract determination shown below:
SELECTION[1] ' ABRECHK <> ''2'''
SELECTION[2] 'AND AVMPOS_AR1 = ''01'''
SELECTION[3] 'AND BELEINH1 = ''[booking unit]'''