Fonction SAP BAPI_FAMILY_CREATESUCCESSOR - Create subsequent family record

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ACADEMICTITLE BAPIP0021-TITEL C 15 X Title
ARISTOCRATICTITLE BAPIP0021-FNMZU C 15 X Other title
DATEOFBIRTH BAPIP0021-FGBDT D 8 X Date of birth
EMPLOYEENUMBER BAPIP0021-PERNR N 8 Personnel number
FIRSTNAME BAPIP0021-FAVOR C 40 X First name
FULLNAME BAPIP0021-FCNAM C 80 X Full employee name
GENDER BAPIP0021-FASEX C 1 X Gender key
INITIALS BAPIP0021-FINIT C 10 X Employee's Initials
LANDOFBIRTH BAPIP0021-FGBLD C 3 X Country of Birth
LASTNAME BAPIP0021-FANAM C 40 X Last name
MAIDENNAME BAPIP0021-FGBNA C 40 X Name at Birth
MEMBERID BAPIP0021-OBJPS C 2 X Object identification
MEMBERTYPE BAPIP0021-FAMSA C 4 X Type of family record
NATIONALITY BAPIP0021-FANAT C 3 X Nationality
NATIONALITY2 BAPIP0021-FANA2 C 3 X Second nationality
NATIONALITY3 BAPIP0021-FANA3 C 3 X Third nationality
NOCOMMIT BAPI_STAND-NO_COMMIT C 1 X COMMIT control at BAPI interface
PLACEOFBIRTH BAPIP0021-FGBOT C 40 X Birthplace
SECONDNAME BAPIP0021-FNAC2 C 40 X Second name
SECONDSURNAMEPREFIX BAPIP0021-FVRS2 C 15 X Name Prefix
STATEOFBIRTH BAPIP0021-FGDEP C 3 X State
SURNAMEPREFIX BAPIP0021-FVRSW C 15 X Name Prefix
VALIDITYBEGIN BAPIP0021-BEGDA D 8 Valid from date
VALIDITYEND BAPIP0021-ENDDA D 8 Valid To Date

Paramètre Reférence Type Long. Description
EMPLOYEENUMBER BAPIP0021-PERNR N 8 Personnel number
LOCKINDICATOR BAPIP0021-SPRPS C 1 Lock indicator for HR master record
OBJECTID BAPIP0021-OBJPS C 2 Object identification
RECORDNUMBER BAPIP0021-SEQNR N 3 Number of Infotype Record
RETURN BAPIRETURN1 u 470 Structure for return code
SUBTYPE BAPIP0021-SUBTY C 4 Subtype
VALIDITYBEGIN BAPIP0021-BEGDA D 8 Valid from date
VALIDITYEND BAPIP0021-ENDDA D 8 Valid To Date

Functionality
You can use this method to create a subsequent Family/RelatedPerson record (0021).
Example:
An employee's husband has just received his Ph.D. A Family/Related Person record (0021) already exists for the period from01/01/1990 to 12/31/1999.
You can use the CREATESUCCESSOR method to create a subsequentFamily/Related Person record. The subsequent record contains thedata of the previous record, only the husband's new title still has tobe entered in the Title field.
The previous record is delimited on the start date of the subsequentrecord.

Notes
Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.
The key fields used by the method are described in the parameterdocumentation.
You can use this method only if you have called the ENQUEUE method ofthe business object EMPLOYEE beforehand. For more information onthe ENQUEUE method, read the documentation on the function moduleBAPI_EMPLOYEE_ENQUEUE.

Description
For information on the personnel number, read the relevant data elementdocumentation: Personnel number.

Description
For information on the lock indicator for the HR master record, readthe relevant data element documentation: Lock indicatorfor HR master record.

Description
For information on the object identification, read the relevant dataelement documentation: Object identification.

Description
For information on the number of an infotype record with the same key,read the relevant data element documentation: Number ofinfotype record with same key.

Description
Method return code

Value range
In case of an error, this structure contains the following information:

  • Message type (TYPE field)

  • Message code (CODE field)

  • Message text (MESSAGE field)

  • If the operation is successful, this structure contains the initialvalue.

    Description
    For information on the subtype, read the relevant data elementdocumentation: Subtype.

    Description
    For information on the academic title, read the relevant data elementdocumentation: Title.

    Description
    For information on the aristocratic title, read the relevant dataelement documentation: Title.

    Description
    For information on the birth date, read the relevant data elementdocumentation: Date of birth.

    Description
    For information on the personnel number, read the relevant data elementdocumentation: Personnel number.

    Description
    For information on the gender key, read the relevant data elementdocumentation: Gender key.

    Description
    You find information about the meaning of object identification in thecorresponding data element documentation: Objectidentification.

    Description
    For information on the type of family record, read the relevant dataelement documentation: Family member.

    Description
    For information on the nationality, read the relevant data elementdocumentation: Nationality.

    Description
    For information on the second nationality, read the relevant dataelement documentation: Second nationality.

    Description
    For information on the third nationality, read the relevant dataelement documentation: Third nationality.

    Description
    For information on COMMIT control, read the relevant data elementdocumentation: COMMIT control at BAPI interface.

    Description
    For information on the name affix, read the relevant data elementdocumentation: Name affix.

    Description
    For information on the state of birth, read the relevant data elementdocumentation: State.

    Description
    For information on the name affix, read the relevant data elementdocumentation: Name affix.