Functionality
You can use this method to select business partners in the SAPMedia component according to various criteria.
You can read details on the selected business partners using the methodISMBusinessPartner.GetDetail.
The system lists the numbers of all the selected business partners as aresult.

Notes
INCLUDE BAPIBUSISM007_SAP_GP_ACTIVE
Parameters
You specify the selection criteria by means of the import parametersand tables parameters, whose texts end with the suffix _SEL.
The selection parameters are always linked with a logical AND duringselection.

Authorizations
The method only returns the numbers of business partners for whom theuser has display authorization.
The following authorizations are checked:

• Authorization to display a business partner according to the business
partner role (authorization object B_BUPA_RLT
), if this is specified for selection

• Authorization to display a business partner according to the
authorization group (authorization object B_BUPA_GRP
), if this is specified for the business partner
If authorization to display a business partner is missing, this isindicated by an error message in the return parameter Return.
Customer Selection Criteria
If you want to process your own selection criteria in this BAPI, youmust use the parameter ExtensionIn.
Performance
INCLUDE ISMAM_BAPIGETLIST_PERFORMANC

Further information
INCLUDE ISM_BAPI_SEE_BP_DOCU

Description
Search for business partners using the address attributes
Country, Region, City andPostal code.
The following applies to each of these parameters:
INCLUDE ISMAM_BAPISELPARAM_INITIAL
INCLUDE ISMAM_BAPISELPARAM_FILLED

Value range
INCLUDE ISMAM_BAPISELPARAM_MASKIERT

Description
Select this indicator if you only want to select agencies. See also thedata element documentation.

Hinweis
INCLUDE ISMAM_BAPISELPARAM_SELECTIVE

Description
Search for business partners by business partner role
.
INCLUDE ISMAM_BAPISELPARAM_INITIAL
INCLUDE ISMAM_BAPISELPARAM_FILLED

Hinweis
INCLUDE ISMAM_BAPISELPARAM_SELECTIVE

Value range
See control table TBZ0 for possible specifications.

Description
Search for business partners using search fields
MC_NAME1 and MC_NAME2. In organizations, theseare the central fields NAME1 and NAME2, whereas in the case of persons,the system searches by first and last name.
You can also specify the business partner numberdirectly.
The following applies to each of these attributes:
INCLUDE ISMAM_BAPISELPARAM_INITIAL
INCLUDE ISMAM_BAPISELPARAM_FILLED

Value range
INCLUDE ISMAM_BAPISELPARAM_MASKIERT

Description
Search for business partners by the search termsSEARCHTERM1, SEARCHTERM2. Thefollowing applies to each of these attributes:
INCLUDE ISMAM_BAPISELPARAM_INITIAL
INCLUDE ISMAM_BAPISELPARAM_FILLED

Value range
INCLUDE ISMAM_BAPISELPARAM_MASKIERT

Beispiel
Search for 'ME+ER' if you want to find 'MEIER' or 'ME
Y
ER' (but not 'MEISTER').

Recommendation
In release 4.71, the fields SEARCHTERM1 andSEARCHTERM2 have been added to the parameterCENTRALDATA. Toavoid additional table accesses, you should use these parameters forselection.

Description
Search for customers using the attributes CLASSIFIC,INDUSTRY or IND_CODE. The followingapplies to each of these attributes:
INCLUDE ISMAM_BAPISELPARAM_INITIAL
INCLUDE ISMAM_BAPISELPARAM_FILLED

Hinweis
INCLUDE ISMAM_BAPISELPARAM_SELECTIVE

Efg_effect_database
INCLUDE ISMAM_BAPIGETLIST_NOINDEX

Description
Search for business partners by
Internet mail (SMTP) address.
INCLUDE ISMAM_BAPISELPARAM_INITIAL
INCLUDE ISMAM_BAPISELPARAM_FILLED

Value range
The e-mail address can have the following formats:
local@domain
Comment
local@domain (comment)

Description
Search for media customers in the sales area defined bySALESORG, DISTR_CHAN andDIVISION. You can also specify individual sales areakeys. The following applies to each of the keys:
INCLUDE ISMAM_BAPISELPARAM_INITIAL
INCLUDE ISMAM_BAPISELPARAM_FILLED

Hinweis
INCLUDE ISMAM_BAPISELPARAM_SELECTIVE

Description
Search for a business partner by their socialinsurance number.

Description
Search for business partners by telephone number for determiningcaller.
INCLUDE ISMAM_BAPISELPARAM_INITIAL
INCLUDE ISMAM_BAPISELPARAM_FILLED

Value range
Specify the telephone number with the area code but without the countrycode.
In addition to digits, the telephone number can contain any number ofthe following special characters:
'(', '/', '+', '-', '.', ')' and ' '

Description
Selection of business partners by their usage in a document.
You can use the attribute Usage type tocontrol which sort of document is meant. You must also specify the keyof the document you are interested in.

Value range
See the values of domain ISM_BP_USAGE_TYPE for possible specificationsfor the usage type.

Description
You can use this parameter to transfer your own data to the BAPI. Youcan use this data as part of method

BAPI_GETLIST_ADD_SELECTS of BAdI ISM_BP_BAPI
to further restrict the hitlist.

Further information
INCLUDE ISM_BAPI_SEE_BAPI_DOCU_EXT
INCLUDE BAPIBUSISM007_NUMBERS

Description
Search for business partners assigned one of the producthierarchy keys listed in the parameter.

Value range
INCLUDE ISMAM_BAPISELPARAM_MASKIERT

Beispiel
Use '0005' to search for customers that are assigned the producthierarchy node 'Electrical equipment'. This search does not findcustomers who are assigned dependent product hierarchy nodes (forexample, 'Water devices'). If you want to find all 'electricalequipment' including 'water devices', search with '00005*'.

Hinweis
INCLUDE ISMAM_BAPISELPARAM_SELECTIVE
INCLUDE ISM_BAPI_RETURN