Functionality
This BAPI allows you to check whether a business partner exists in arole that is entered in the parameter BUSINESSPARTNERROLE.
Only the existence of update-relevant roles (i.e. roles with an assignedrole category) can be checked.
The role to be checked is either transferred explicitly in parameterBUSINESSPARTNERROLE or derived from the role category in parameterBUSINESSPARTNERROLECATEGORY. When a role category is entered, the roleestablished through the standard assignment is created if the parameterALL_BUSINESSPARTNERROLES is not set. Otherwise, all the roles assignedto the role category are created. The result of the check is postiveif the business partner exists in at least one of the roles.
If a role category and a role are both transferred, a check is carriedout to determine whether an assignment exists between the category andthe role. In this case the explicitly transferred role is checked.
The role(s) to be checked can be determined in more detail by enteringa differentiation type value in the parameter DIFFERENTIATIONTYPEVALUE,as well as by entering a date on which the role should be valid inVALIDDATE. If no date is entered in VALIDDATE, then a check is carriedout for existence on the current date. If this parameter is blank, thenthe assignment of the role is checked independently of its validity.
Any errors that may occur, and also the non-existence of a roleare logged and issued in the table RETURN.

Description
Indicator that controls whether all the roles assigned to a category arechecked when the role category is transferred.
You may set the parameter only if you enter a role category.
If at least one of the roles assigned to the transferred role categoryis also assigned to the business partner, then it is assumed to exist.

Default
If you do not transfer the parameter, only the existence of role that isdefined via the standard assignment of the transferred role category, ischecked.

Description
Key that defines a business partner unambiguously in the system for eachclient.

Description
Roles whose existence is checked.

Description
Category of a role. Any number of roles can be assigned to a rolecategory, whereby one assignement is defined as the standard assignment.
If only the role category is transferred, then this results in thecreation of the role whose assignment to the transferred role categoryin table TB003 is selected as standard.

Value range
Role categories are defined in table TB003A.

Description
Differentiation type value of the role to be checked.

Description
Date by which the business partner role to be checked is found. All BProles are checked that were or are valid on this day.

Value range
01.01.0001 to 31.12.9999

Default
If the parameter is not transferred, then all the BP roles of thebusiness partner valid on the current date are checked.
If the value SPACE is transferred, then all the BP roles assigned to thebusiness partner are checked, regardless of their validity.

Description
This table contains the confirmations from the method call.