Fonction SAP BAPI_STUDENT_CHANGE3 - Method: Change Student (From Release CM 4.64)

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
OBJECTID BAPISTUDENT_HEAD-OBJID N 8 Object ID of Student
PLANVERSION BAPISTUDENT_HEAD-PLVAR C 2 X Plan Version
STUDENTADDITIONALDATA BAPISTUDENT_ADDPERSONAL u 86 X Additional Personal Data of Student
STUDENTADDITIONALDATAX BAPISTUDENT_ADDPERSONALX u 11 X Additional Personal Data of Student (Change Structure)
STUDENTCAMPUS BAPISTUDENT_CAMPUS u 8 X Campus to Which Student is Assigned
STUDENTCAMPUSX BAPISTUDENT_CAMPUSX u 1 X Campus to Which Student is Assigned (Change Structure)
STUDENTCHALLENGEDATA BAPISTUDENT_CHALLENGE u 15 X Challenge Data of Student
STUDENTCHALLENGEDATAX BAPISTUDENT_CHALLENGEX u 4 X Challenge Data of Student (Change Structure)
STUDENTFEEDATA BAPISTUDENT_FEEDATA u 32 X Fee Calculation Data of Student
STUDENTFEEDATAX BAPISTUDENT_FEEDATAX u 8 X Fee Calculation Data of Student (Change Structure)
STUDENTORGUNIT BAPISTUDENT_ORGUNIT u 8 X Organizational Unit to Which Student is Assigned
STUDENTORGUNITX BAPISTUDENT_ORGUNITX u 1 X Organizational Unit to Which Student is Assigned (Change Structure)
STUDENTPERSONALDATA BAPISTUDENT_PERSONAL u 373 X Personal Data of Student
STUDENTPERSONALDATAX BAPISTUDENT_PERSONALX u 30 X Personal Data of Student (Change Structure)
STUDENTRESIDENCYDATA BAPISTUDENT_RESIDENCY u 36 X Residence Data of Student
STUDENTRESIDENCYDATAX BAPISTUDENT_RESIDENCYX u 7 X Residence Data of Student (Change Structure)
STUDENTSTATUSDATA BAPISTUDENT_STATUSDATA u 2 X Status Attributes of Student
STUDENTSTATUSDATAX BAPISTUDENT_STATUSDATAX u 1 X Status Attributes of Student (Change Structure)
STUDENTSTUDYDATA BAPISTUDENT_STUDYDATA u 48 X Study Data of Student
STUDENTSTUDYDATAX BAPISTUDENT_STUDYDATAX u 3 X Study Data of Student (Change Structure)
TESTRUN TESTRUN C 1 '' X Switch to Simulation Mode for Write BAPIs
UPDATEACCOUNTDATA PIQUPDATEACCOUNTDATA C 1 'X' X Data Element for Domain BOOLE: TRUE (="X") and FALSE (=" ")
VALIDITYBEGIN BAPISTUDENT_HEAD-BEGDA D 8 SY-DATUM X Validity Start Date of Changes
VALIDITYEND BAPISTUDENT_HEAD-ENDDA D 8 '99991231' X Validity End Date of Changes

Paramètre Reférence Long. Facultatif Description
EXTENSIONIN BAPIPAREX 990 X Container for Transfer of Customer Enhancements
EXTENSIONOUT BAPIPAREX 990 X Container for Transfer of Customer Enhancements
RETURN BAPIRET2 548 Return Messages

Functionality
This method is used to change student data.
INCLUDE PIQBAPI_CHANGECONCEPT OBJECT DOKU ID TX

Example
You want to change a student's last name:

  • To make this change, you must transfer the new last name to the
    • parameter STUDENTPERSONALDATA and to the field LAST_NAME.
    You must also select the field LAST_NAME in the change structureSTUDENTPERSONALDATAX by placing an X in it. The method makes thechange only if this field contains an X.

    Notes

    Authorization Checks
    The method checks the following authorizations for the object PLOG, the object type (OTYPE) ST (student), the status (ISTAT)1 (active), and the function code (PPFCODE) INSE(create):
    INCLUDE PIQBAPISTAUTHORITY OBJECT DOKU ID TX
    INCLUDE PIQBAPI_STDEATH

    Return Messages
    INCLUDE BAPI_RET

    Data Update
    INCLUDE PIQBAPI_UPDATETASK
    In a logical unit of work(LUW), you may not call write methods (CREATE or CHANGE) more thanonce per instance. This can lead to data inconsistencies if an HRinfotype of an instance is changed within a LUW as the BAPIs forstudent data do not have write and read buffers. For example, when youcall function module BAPI_STUDENT_CREATEFROMDATA3 orBAPI_STUDENT_CHANGE3, you must first terminate the current LUW beforeyou can call function module BAPI_STUDENT_CHANGE3 again for the sameinstance. This restriction applies only to data stored in HR infotypes.The student address and bank data are not affected by this restriction.

    Customer Enhancements
    INCLUDE PIQBAPI_EXTENSION

    Description
    INCLUDE BAPI_KEYFIELD

    Description
    INCLUDE BAPI_KEYFIELD

    Default

    Hints

    Mandatory Parameters
    To unlock a student, you must transfer the object ID (import parameterOBJECTID) of the student.

    Return Messages
    INCLUDE BAPI_RET

    Description
    The parameter STUDENTADDITIONALDATA contains additional personal dataof the student.
    INCLUDE BAPI_DATAELEMENT

    Description
    INCLUDE PIQBAPI_CHANGEPARAMETER

    Value range
    INCLUDE PIQBAPI_CHANGEPARAMETER_DEL

    Description
    With the parameter STUDENTCAMPUS, you can assign a campus to thestudent. This is necessary if your university has several campuses, andyou want to assign the student to a specific campus.
    INCLUDE BAPI_DATAELEMENT

    Description
    INCLUDE PIQBAPI_CHANGEPARAMETER

    Value range
    INCLUDE PIQBAPI_CHANGEPARAMETER_DEL

    Description
    The parameter STUDENTCHALLENGEDATA contains the challenge data of thestudent.
    INCLUDE BAPI_DATAELEMENT

    Description
    INCLUDE PIQBAPI_CHANGEPARAMETER

    Value range
    INCLUDE PIQBAPI_CHANGEPARAMETER_DEL

    Description
    The parameter STUDENTFEEDATA contains the fee calculation data of thestudent.
    INCLUDE BAPI_DATAELEMENT

    Description
    INCLUDE PIQBAPI_CHANGEPARAMETER

    Value range
    INCLUDE PIQBAPI_CHANGEPARAMETER_DEL

    Description
    With the parameter STUDENTORGUNIT, you can assign the student to anorganizational unit.
    When a student is registered for a program, the system automaticallyassigns the student to the organizational unit that offers thisprogram. If you want to redefine this organizational unit, you can usethis parameter.
    INCLUDE BAPI_DATAELEMENT

    Description
    INCLUDE PIQBAPI_CHANGEPARAMETER

    Value range
    INCLUDE PIQBAPI_CHANGEPARAMETER_DEL

    Description
    The personal data of the student is transferred in the parameterSTUDENTPERSONALDATA. Required entry fields are FIRST_NAME (first name),LAST_NAME (last name), and CORRESP_LANGUAGE (correspondence language).
    INCLUDE BAPI_DATAELEMENT

    Description
    INCLUDE PIQBAPI_CHANGEPARAMETER

    Value range
    INCLUDE PIQBAPI_CHANGEPARAMETER_DEL

    Description
    The parameter STUDENTRESIDENCYDATA contains the residence data of thestudent.
    INCLUDE BAPI_DATAELEMENT

    Description
    INCLUDE PIQBAPI_CHANGEPARAMETER

    Value range
    INCLUDE PIQBAPI_CHANGEPARAMETER_DEL

    Description
    The parameter STUDENTSTATUSDATA contains the status data of thestudent.
    INCLUDE BAPI_DATAELEMENT

    Description
    INCLUDE PIQBAPI_CHANGEPARAMETER

    Value range
    INCLUDE PIQBAPI_CHANGEPARAMETER_DEL

    Description
    The parameter STUDENTSTUDYDATA contains the individual study data ofthe student.
    INCLUDE BAPI_DATAELEMENT

    Description
    INCLUDE PIQBAPI_CHANGEPARAMETER

    Value range
    INCLUDE PIQBAPI_CHANGEPARAMETER_DEL

    Description
    INCLUDE PIQBAPIST_TESTRUN

    Description
    Trigger updating of account data

    Description
    With the parameter VALIDITYBEGIN, you can specify the validity startdate of the date change.

    Value range

    • The lowest date corresponds to the start date of the student object.

    • The highest date corresponds to the end date of the object validity.

      • Description
      With the parameter VALIDITYEND, you can specify the validity end dateof the change.

      Value range

      • The lowest date corresponds to the start date of the student object.

      • This highest date corresponds to the end date of the object validity.

        • Description
        The parameter EXTENSIONIN is a tabular import parameter.
        INCLUDE PIQBAPIST_EXTENSIONKEY
        INCLUDE BAPI_DATAELEMENT

        Value range
        INCLUDE PIQBAPIST_EXTENSION
        The name of the associated change structure ends with an X. Thestructure of the change parameter may only consist of BAPIUPDATE dataelements. The change structure must always appear in the extensionparameter continuation line after the data structure to be changed.

        Description
        The parameter EXTENSIONOUT is a tabular export parameter.
        INCLUDE BAPI_DATAELEMENT

        Value range
        INCLUDE PIQBAPIST_EXTENSION

        Description
        INCLUDE BAPI_TABLE
        INCLUDE BAPI_DATAELEMENT