Functionality
With this BAPI the validity of a role is changed for abusiness partner stated in the parameter BUSINESSPARTNER .
The role to be changed is either transferred explicitly in parameterBUSINESSPARTNERROLE or derived from the role category in parameterBUSINESSPARTNERROLECATEGORY. If a role category is entered, the roleestablished through the standard assignment is changed if the parameterALL_BUSINESSPARTNERROLES is not set. Otherwise, all the roles assignedto the role category are changed.
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. If this is the case, the explicitly transferred role ischanged.
A role for a business partner is identified unambiguously by means ofits ID and a differentiation type value (in the case of differentiationtype-dependent roles). It is therefore necessary to explicitly entera differentiation type value in the parameter DIFFERENTIATIONTYPEVALUEin order to change a role with a certain differentiation type value.
The date to be changed (validity start and validity end) is selectedby means of the checkbox VALIDFROMDATE_X and VALIDUNTILDATE_X.
You can enter the validity of the role in the parametersVALIDFROMDATE and VALIDUNTILDATE. If you want to changethe validity start or the validty end according to how the checkboxesVALIDFROMDATE_X or VALIDUNTILDATE_X have been set, and if the parametersdo not contain a date, then the values for the validity are thecurrent date or the 31.12.9999.
If you want to changeall the roles assigned to a role category, then all the roles alsoreceive the specified validity.
Any errors that may occur are logged and issued in the table RETURN.

Notes
Roles to be changed are checked, with regard to their assignment to arole exclusion group, against roles that are already assigned to thebusiness partner and to the same role exclusion group. If the result ofthis check is negative and no transition from or to the role to bechanged is defined, then the role is not changed.
On the other hand, if the change to the validity of a roleleads to a change to thevalidity (delimitation) or to the deletion of a role that is alsoassigned to the exclusion group and to the business partner,then a check is carried out to determine whether this change ordeletion is allowed from the point of view of the application(s) thatuse this role, by means of processing the eventRLDEL.If the result of the check is negative then the validity of the rolethat was entered cannot be changed.

Description
Indicator that controls whether or not all the roles assigned to acategory are changed when a role category is transferred.
You can set this parameter only if you enter a role category.

Default
If this parameter is not transferred, only the role defined using thestandard assignment of the transferred role category is created.

Description
Key that identifies a business partner unambiguouslyin the system for each client.

Description
Role to be changed.
Only roles that can be updated may be changed. Whether or not a role canbe updated is controled 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 is selected in table TB003, ischanged.

Value range
Role categories are defined in table TB003A.

Description
Differentiation type value of the role to be changed.
You may transfer a differentiation type value only in the case ofroles to whose role category a differentiation type not equalto 0 (general data) is assigned.
The differentiation type allows you to define the role concept evenmore precisely.

Description
Date from which the role is valid from a business point of view.

Value range

Default
If no validity start is transferred, the current date is taken forthe start.

Description
For information on the change toolbar, see the relevant data elementdocumentation.

Description
Date to which the role is valid from a business point of view.

Value range

Default
If no validity end is transferred, the date 31.12.9999 is taken forthe end.

Description
For information on the change toolbar, see the relevant data elementdocumentation.

Description
This table contains the confirmations from the method call.