Functionality
With this BAPI a role is created for a business partner stated in theparameter BUSINESSPARTNER .
Only roles with assigned role category are created (updated).
The role to be created 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 created if the parameterALL_BUSINESSPARTNERROLES is not set. Otherwise, all the roles assignedto the role category are created.
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 iscreated.
A value can be transferred in parameter DIFFERENTIATIONTYPEVALUE tofurther differentiate a role. This is allowed only for differentiationtype-dependent roles. (Whether or not a role can be differentiateddepends on the value of the differentiation type assigned to the rolecategory. Differentiation types not equal to 0 that are assigned tothe role category may be used for entering a differentiation typevalue.)
The validity of the role can be entered in the parametersVALIDFROMDATE and VALIDUNTILDATE.
If you want to create all the roles assigned to a role category, thenall the roles also receive the differentiation type value that may havebeen transferred, and the validity that was specified.
Any errors that may occur are logged and issued in the table RETURN.

Notes
Roles to be created 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 becreated is defined, then the role is not created.
On the other hand, if the creation of a role leads to a change to thevalidity (delimitation) or to the deletion of a previously assignedrole, 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 role to be createdcannot be assigned to the business partner.

Description
Indicator that controls whether all the roles assigned to a rolecategory are created when the category is transferred.
You may set the parameter only if you also enter a rolecategory.

Value range

Default
If the parameter is not transferred, the only role that is created isthe one that is defined by means of the standard assignment of thetransferred role category.

Description
Key that identifies a business partner unambiguously in the systemfor each client.

Description
Role to be created.
Only roles that can be updated may be created. 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 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 created.
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
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
This table contains the confirmations from the method call.