SAP Function BAPI_USER_CHANGE - Change User

Parameter Reference Type Length Default Optional Text
ADDCOMX BAPIADCOMX u 13 X Change Structure for Communication Data
ADDRESS BAPIADDR3 u 2031 X Address Data
ADDRESSX BAPIADDR3X u 96 X Select Change-Relevant Fields
ALIAS BAPIALIAS u 40 X User Name Alias
ALIASX BAPIALIASX u 1 X User alias change flag
BACK_DISTRIBUTION BAPIFLAG u 1 SPACE X Redistribution into the Central System (Central User Administration)
COMPANY BAPIUSCOMP u 42 X Company for Address
COMPANYX BAPIUSCOMX u 1 X Select Change-Relevant Fields
DEFAULTS BAPIDEFAUL u 70 X User Defaults
DEFAULTSX BAPIDEFAX u 12 X Select Change-Relevant Fields
EXTIDSX BAPIUSEXTIDX u 1 X Change Indicators for External IDs
GROUPSX BAPIGROUPX u 1 X User group change flag
LOGONDATA BAPILOGOND u 339 X Logon Data
LOGONDATAX BAPILOGONX u 13 X Select Change-Relevant Fields
PARAMETERX BAPIPARAMX u 3 X Select Change-Relevant Fields
PASSWORD BAPIPWD u 40 X Password
PASSWORDX BAPIPWDX u 1 X Select Change-Relevant Fields
PRODUCTIVE_PWD BAPIFLAG-BAPIFLAG C 1 SPACE X Single-Character Indicator
REF_USER BAPIREFUS u 12 X User name
REF_USERX BAPIREFUSX u 1 X Reference user change flag
SNC BAPISNCU u 256 X Secure Network Communication data
SNCX BAPISNCUX u 2 X Change Secure Network Communication Data
UCLASS BAPIUCLASS u 45 X License-Related User Classification
UCLASSX BAPIUCLASSX u 2 X Change Indicators for License-Related User Classification
USERNAME BAPIBNAME-BAPIBNAME C 12 User Name

Parameter Reference Length Optional Text
ADDCOMREM BAPICOMREM 60 X
ADDFAX BAPIADFAX 143 X
ADDPAG BAPIADPAG 136 X
ADDPRT BAPIADPRT 40 X
ADDRFC BAPIADRFC 69 X
ADDRML BAPIADRML 63 X
ADDSMTP BAPIADSMTP 300 X
ADDSSF BAPIADSSF 2391 X
ADDTEL BAPIADTEL 142 X
ADDTLX BAPIADTLX 72 X
ADDTTX BAPIADTTX 72 X
ADDURI BAPIADURI 2219 X
ADDX400 BAPIADX400 948 X
EXTIDHEAD BAPIUSEXTIDHEAD 36 X Header Data for External ID of a User
EXTIDPART BAPIUSEXTIDPART 234 X Part of a Long Field for the External ID of a User
GROUPS BAPIGROUPS 12 X Transfer Structure for a List of User Groups
PARAMETER BAPIPARAM 98 X Table with User Parameters
PARAMETER1 BAPIPARAM1 120 X Replaces parameter (length 18 -> 40)
RETURN BAPIRET2 548 Return Structure
UCLASSSYS BAPIUCLASSSYS 55 X System-Specific License-Related User Classification

Functionality
You can use this method to change the attributes of a user. Theexisting attributes are overwritten by the attributes transferred tothe interface, as long as the change flag is set. The field for thechange flag has the name of the field or the structure to be changed,,but is extended by an 'X'.

Example
You want to change a user's user group 'SAMPLE' from 'SUPER' to'TESTER'.
username = 'MUSTER'.
logondata-class = 'TESTER'.
logondatax-class = 'X'.
call function 'BAPI_USER_CHANGE'
exporting
username = username
LOGONDATA = logondata
LOGONDATAX = logondatax
tables
return = return .
INCLUDE ADDR_TABL_BAPIADDR3 OBJECT DOKU ID TX
INCLUDE SU_X OBJECT DOKU ID TX LANGUAGE DE

Description
Only relevant in child systems with central user maintenance.
Indicator that specifies whther the changed user data is to beredistributed into the central system if the field attributes for thechanged fields are set to "Redistribution".

Value range
' ' No (redistribution) and 'X' (redistribution)

Default
' ' No (redistribution)
INCLUDE SU_COMPANY OBJECT DOKU ID TX LANGUAGE EN
INCLUDE SU_X OBJECT DOKU ID TX LANGUAGE DE
INCLUDE SU_DEFAULTS OBJECT DOKU ID TX LANGUAGE EN
INCLUDE SU_X OBJECT DOKU ID TX LANGUAGE EN
You can either change all the parameters or none of them.
If you want to change all the parameters, set all three fields forPARAMETERX to "X".

Description
If EXTIDX-EXTID = 'X', the external user IDs are to be copied from thetable parameters EXTIDHEAD and EXTIDPART. If EXTIDX-EXTID = SPACE,parameters EXTIDHEAD and EXTIDPART are to be ignored.
INCLUDE SU_LOGONDATA OBJECT DOKU ID TX
INCLUDE SU_X OBJECT DOKU ID TX LANGUAGE DE
INCLUDE SU_X OBJECT DOKU ID TX LANGUAGE DE
Either all or no parameters can be changed.
Set all three fields of PARAMETERX to 'X' if you want to change allparameters.

Description
Password for the logon (plain text).
INCLUDE SU_X OBJECT DOKU ID TX LANGUAGE EN
INCLUDE SU_SNC OBJECT DOKU ID TX LANGUAGE DE
INCLUDE SU_X OBJECT DOKU ID TX

Description
User classification in accordance with the license agreement betweenthe customer and SAP.
The import parameter UCLASS should be used if the function is calledin a child system of a central user administration (CUA) or in asystem without a CUA connection. In a central system of a CUA, thetable parameter UCLASSSYS should be used.
LIC_TYPE is the user type (values from table TUTYPA or TUTYP).
SPEC_VERS is a possible special version (values from table TUZUS).
COUNTRY_SURCHARGE is a possible country surcharge (value range between-100% and +999%).
You can specify only a special version or a country surcharge, neverboth. Therefore, the following must apply: SPEC_VERS = '00' orCOUNTRY_SURCHARGE = 0.
SUBSTITUTE_FROM and SUBSTITUTE_UNTIL specify the time period duringwhich a user is a subsitute (user type "04").
SYSID, CLIENT, and BNAME_CHARGEABLE point to the chargeable users forthe user types Substitute ("04") or Multi-Client/Multi-system ("11") .

Description
The method 'Change' changes only the transferred fields, which areexplicitly identified as change-relevant. The structure UCLASSX existsfor the structure UCLASS and the table UCLASSSYS. Only if UCLASSX-UCLASSis set to 'X' are the user classifications used.
In addition, you must specify in the CUA central system during userclassification how the table is to process the system-specific userclassifications. The following values are permitted for the fieldUCLASSX-UCLASSSYS:

  • 'R' The system-specific user classifications are deleted, and
    • replaced with current values from the table.
    • 'S' Only the user classifications for the listed systems are
      • replaced. If the user classifications for a system are to be deleted,the user type must be initial.
      • Space The table is not used.

        • INCLUDE SU_USERNAME OBJECT DOKU ID TX

        Description
        BAPIUSEXTIDHEAD

        Description
        BAPIUSEXTIDPART
        INCLUDE SU_PARAMETER OBJECT DOKU ID TX LANGUAGE DE
        INCLUDE SU_RETURN OBJECT DOKU ID TX LANGUAGE EN

        Description
        User classification in accordance with the license agreement betweenthe customer and SAP.
        The table parameter UCLASSSYS should be used if the function is calledin the central system of a central user administration (CUA), and theusers in the various systems are to be changed. In a system without aCUA connection, or in a child system of a CUA, the import parameterUCLASS should be used.
        RCVSYSTEM is the name of the logical system to be used for the userclassification (values from table USZBVLNDRC).
        LIC_TYPE is the user type (values from table TUTYPA or TUTYP).
        SPEC_VERS is a possible special version (values from table TUZUS).
        COUNTRY_SURCHARGE is a possible country surcharge (value range between-100% and +999%).
        You can only ever specify a special version or a country surcharge,never both. The following must therefore apply: SPEC_VERS = '00' orCOUNTRY_SURCHARGE = 0.
        SUBSTITUTE_FROM and SUBSTITUTE_UNTIL specify the time period duringwhich a user is a substitute (only for user type '04').
        SYSID, CLIENT, and BNAME_CHARGEABLE point to the chargeable user for theuser types substitute ('04') or Multi-Client/Multi-System ('11').

1287410BAPI_USER_CHANGE: Set productive password
1602902Password Not Set to Productive on User Creation
1365739SUSR_RFC_USER_INTERFACE:Adjusting to password rule from 7.00
1393313License data is not provisioned in CUA system - New request
750390USR02: various problems with password attributes
787292Password-related problems