Functionality
With this BAPI a role of a business partner defined in the parameterBUSINESSPARTNER is deleted.
The existence of the business partner in the role to be deleted ischecked.
The role to be deleted is either transferred explicitly in parameterBUSINESSPARTNERROLE or derived from the role category in the parameterBUSINESSPARTNERROLECATEGORY. When a role category is entered, the roleestablished through the standard assignment is deleted if the parameterALL_BUSINESSPARTNERROLES is not set. Otherwise, all the roles assignedto the role category are deleted. If the business partner does not existin one of the roles then an error is issued and the deletion does nottake place.
If both a role category and a role is transferred, a check is carriedout to see if there is an assignment between the category and role. Inthis case the role that is explicitly transferred is deleted.
A value can be transferred in the parameter DIFFERENTIATIONTYPEVALUE tofurther differentiate the role to be deleted. This is allowed only fordifferentiation type-dependent roles. (Whether or not a role can bedifferentiated depends on the value of the differentiation type assignedto the role category. Differentiation types not equal to 0 that areassigned to the role category may be used for entering a differentiationtype value.)
The parameter IV_X_ALL_DFVAL can be set in order to delete all instancesof a role with regard to its existence with different differentiationtype values. In this case you are not allowed to transfer an explicitdifferentiation type value in IV_DIFFTYPEVALUE.
Any errors that may occur are logged and issued in the table RETURN.

Example
When a role is deleted then a check is carried out to determine whetherthis deletion is allowed from the point of view of the application(s)that use this role, by means of processing the event RLDEL. Ifthe result of the check is negative then the business partner rolecannot be deleted.

Description
Indicator that controls whether all the roles assigned to a rolecategory are deleted when the role category is transferred.
You may set the parameter only if you enter a role category.
Default
If the parameter is not transferred, only the role that is defined viathe standard assignment of the transferred role category, is deleted.

Description
Indicator that controls whether all roles, regardless of theircharacteristics with regard to the differentiation type value, should bedeleted.

Default
If the indicator is not set, only the role that has a differentiationtype value to be transferred explicitly in the parameterDIFFERENTIATIONTYPEVALUE, is deleted, provided the role isdifferentiation type-dependent.

Description
Key that identifies a business partner uniquely for each client in thesystem.

Description
Role to be deleted.
Only roles that can be updated may be deleted. Whether or not a role canbe updated is controlled via the assignment of a role category.
If both a role category and a role are transferred, the role must beassigned to this role category.
You are not allowed to transfer a role together with a role category,and to set the indicator for updating all roles assigned to a rolecategory.

Value range
The role is defined in table TB003.

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

Value range
Role categories are defined in table TB003A.

Description
Differentiation type value of the role to be deleted.
You may transfer a differentiation type value only in the case of rolesto whose role category a differentiation type not equal to 0 (generaldata) is assigned.
The differentiation type allows you to define the role concept even moreprecisely.

Description
This table contains the confirmations from the method call.