Fonction SAP BAPI_PERSDANL_CREATESUCCESSOR - Create Subsequent Personal Data Record

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ACADEMICGRADE BAPIP0002-TITEL C 15 X Title
ARISTROCRATICTITLE BAPIP0002-NAMZU C 15 X Other Title
BIRTHPLACE BAPIP0002-GBORT C 40 X Birthplace
COUNTRYOFBIRTH BAPIP0002-GBLND C 3 X Country of Birth
DATEOFBIRTH BAPIP0002-GBDAT D 8 X Date of Birth
EMPLOYEENUMBER BAPIP0002-PERNR N 8 Personnel Number
FIRSTNAME BAPIP0002-VORNA C 40 X First Name (by which one is generally known)
FORMOFADDRESS BAPIP0002-ANRED C 1 X Form of Address Key
FULLNAME BAPIP0002-CNAME C 80 X Full Name Employee
GENDER BAPIP0002-GESCH C 1 X Gender Key
IDNUMBER BAPIP0002-PERID C 20 X Personnel ID Number
INITIALS BAPIP0002-INITS C 10 X Employee's Initials
KNOWNAS BAPIP0002-RUFNM C 40 X Known As
LANGUAGE BAPIP0002-SPRSL C 1 X Language Key
LANGUAGE_ISO BAPIP0002-SPRSL_ISO C 2 X Language According to ISO 639
LASTNAME BAPIP0002-NACHN C 40 X Last Name
MARITALSTATUS BAPIP0002-FAMST C 1 X Marital Status Key
MARITALSTATUSSINCE BAPIP0002-FAMDT D 8 X Valid From Date of Current Marital Status
MIDDLENAME BAPIP0002-MIDNM C 40 X Middle Name
NAMEATBIRTH BAPIP0002-NAME2 C 40 X Name at Birth
NATIONALITY BAPIP0002-NATIO C 3 X Nationality
NOCOMMIT BAPI_STAND-NO_COMMIT C 1 X COMMIT Control at BAPI Interface
NUMBEROFCHILDREN BAPIP0002-ANZKD N 3 X Number of Children
RELIGION BAPIP0002-KONFE C 2 X Religious Denomination Key
SECONDACADGRADE BAPIP0002-TITL2 C 15 X Second Title
SECONDNAME BAPIP0002-NACH2 C 40 X Second Name
SECONDNAMEPREFIX BAPIP0002-VORS2 C 15 X Second Name Prefix
SECONDNATIONALITY BAPIP0002-NATI2 C 3 X Second Nationality
STATEOFBIRTH BAPIP0002-GBDEP C 3 X Federal State
SURNAMEPREFIX BAPIP0002-VORSW C 15 X Name Prefix
THIRDNATIONALITY BAPIP0002-NATI3 C 3 X Third Nationality
VALIDITYBEGIN BAPIP0002-BEGDA D 8 Valid From Date
VALIDITYEND BAPIP0002-ENDDA D 8 Valid To Date

Paramètre Reférence Type Long. Description
EMPLOYEENUMBER BAPIP0002-PERNR N 8 Personnel Number
LOCKINDICATOR BAPIP0002-SPRPS C 1 Lock Indicator for HR Master Record
OBJECTID BAPIP0002-OBJPS C 2 Object Identification
RECORDNUMBER BAPIP0002-SEQNR N 3 Number of Infotype Record
RETURN BAPIRETURN1 u 470 Structure for Return Parameter
SUBTYPE BAPIP0002-SUBTY C 4 Subtype
VALIDITYBEGIN BAPIP0002-BEGDA D 8 Valid From Date
VALIDITYEND BAPIP0002-ENDDA D 8 Valid To Date

Functionality
This method can be used to create a subsequent record for infotypePersonal Data (0002).
Example:
A single employee marries. In Infotyp Personal Data (0002) themarital status 'single' has been entered for the validity period01.01.1990 - 31.12.1999.
The method CREATESUCCESSOR can be used to create a subsequent recordwith the new marital status. This subsequent record contains the dataof the previous record, only the field Mar. Status must bereplaced by the new marital status 'Married'.
The previous record is delimited on the start data of the subsequentrecord.

Notes
Messages are returned in the RETURN paramter. This parameterdocumentation contains the return values and their meanings.
The key fields used by the method are described under the parameters.
This method can only be used if the ENQUEUE method is called first forthe business object EMPLOYEE. You will find further details onthe ENQUEUE method in the function module documentationBAPI_EMPLOYEE_ENQUEUE.

Description
You will find details on the meaning of Personnel Number in therelevant data element documentation: Personnel Number
.

Description
You will find details on the meaning of Lock Indicator for HR MasterRecord in the relevant data element documentation: LockIndicator for HR Master Record.

Description
You will find details on the meaning of Object Identification in therelevant data element documentation: Object Identification
.

Description
You will find details on the meaning of Number of Infotype Record withSame Key in the relevant data element documentation:Number of Infotype Record with Same Key.

Description
Return Code of Method

Value range
In case of error, the structure may contain the following information:

  • Message Type (field TYPE)

  • Message Code (field CODE)

  • Message Text (field MESSAGE)

    • If there are no errors, the field string is initial.

    Description
    You will find details on the meaning of Subtype in the relevant dataelement documentation: Subtype.

    Description
    You will find details on the meaning of Title in the relevant dataelement documentation: Title .

    Description
    You will find details on the meaning of Other Title in the relevantdata element documentation: Other Title .

    Description
    You will find details on the meaning of Date of Birth in the relevantdata element documentation: Date of Birth .

    Description
    You will find details on the meaning of Personnel Number in therelevant data element documentation: Personnel Number
    .

    Description
    You will find details on the meaning of
    Form of Address Key in the relevant data element documentation:Form of Address Key .

    Description
    You will find details on the meaning of Gender Key in the relevant dataelement documentation: Gender Key.

    Description
    You will find details on the meaning of Personal ID Number in therelevant data element documentation: Personal ID Number
    .

    Description
    You will find details on the meaning of Known As in the relevant dataelement documentation: Known As.

    Description
    You will find details on the meaning of Language Key in the relevantdata element documentation: Language Key.

    Description
    You will find details on the meaning of Nationality in the relevantdata element documentation: Nationality .

    Description
    You will find details on the meaning of COMMIT Control in the relevantdata element documentation: COMMIT Control at BAPIInterface.

    Description
    You will find details on the meaning of Religious Denomination Key inthe relevant data element documentation: ReligiousDenomination Key.

    Description
    You will find details on the meaning of Second Nationality in therelevant data element documentation: Second Nationality
    .

    Description
    You will find details on the meaning of State in the relevant dataelement documentation: State .

    Description
    You will find details on the meaning of Name Prefix in the relevantdata element documentation: Name Prefix.

    Description
    You will find details on the meaning of Third Nationality in therelevant data element documentation: Third Nationality.