Fonction SAP BAPI_FAMILY_REQUEST - Create locked 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
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 locked Family/Related Personrecord (0021).
It enables you to implement the "double verification principle" inconjunction with the APPROVE method. According to this principle, atleast two users must take part in writing an active record to thedatabase. One user creates a locked record using the REQUEST method.The other user unlocks or 'activates' this record using the APPROVEmethod.

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.
For more information on the APPROVE method, read the documentation onthe function module BAPI_FAMILY_APPROVE.

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
    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.