Sapass

 Simplify SAP R/3 development with Excel VBA/VB RFC  
Home> Bapi>Appraisal



Index

Appraisal

Appraisal


Definition


Institutionalized process for rating objects in a planned, structured,
and standardized way. Objects are rated using criteria that evaluate the past, present, and future.


Purpose


Appraisals are used to rate objects on the basis of predefined
criteria. Appraisals are held by persons who have been commissioned to do so.


There are several phases in the appraisal process - each identified by a specific predefined status:


  • In preparation

  • In process

  • Completed

  • Approved or Rejected (if applicable)

  • The results of appraisals can be processed further, and can be used to
    update an object's qualifications profile, or to influence Compensation Management.


    Structure


    An appraisal model is identified on the basis of the following fields:


  • Plan version

  • ID of appraisal

  • The following information is defined for an appraisal:


  • Appraiser(s) and appraisee(s)

  • Name of appraisal

  • Period to be appraised and creation period

  • Anonymity of appraisers

  • Results of appraisal elements

  • Notes

  • Integration


    An appraisal model must exist before you can create an appraisal.



    11-Dec-2005


    Methods

    Available Methods


    • Change : Change appraisals [ BAPI_APPRAISAL_CHANGE ]
    • Create : Create appraisals [ BAPI_APPRAISAL_CREATE ]
    • Delete : Delete appraisals [ BAPI_APPRAISAL_DELETE ]
    • GetDetail : Read appraisal [ BAPI_APPRAISAL_GETDETAIL ]
    • GetList : Display appraisals [ BAPI_APPRAISAL_GETLIST ]
    • StatusChange : Change appraisal status [ BAPI_APPRAISAL_STATUS_CHANGE ]

    11-Dec-2005


    Change

    Change


    You can use this method to edit appraisals of the types Individual appraisal and Anonymous individual appraisal whose status is In preparation or In process.

    Example

    You can edit preparatory information (such as the period to be
    appraised and the objects to be appraised) in appraisals whose status is In preparation.

    You can rate appraisal elements, or change existing ratings, in appraisals whose status is In process.

    Notes

    Related Methods
    The methods that can be used for the business object Appraisal include:


  • Change Appraisal Status
  • Read Appraisals
  • Delete Appraisals
  • Create Appraisals
  • Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.


    Further Information

    For more information on appraisals, refer to the R/3 Library (HumanResources -> Personnel Management -> Personnel Development -> Appraisal Systems -> Appraisal Creation).


    11-Dec-2005


    Create

    Create


    You can use this method to create appraisals using an appraisal model. Atpresent, you can only use appraisal models of the appraisal types Individual appraisal and Anonymous individual appraisal.

    The status of the appraisals you create is In preparation.


    Notes

    Related Methods
    The methods that can be used for the business object Appraisal include:

  • Change Appraisal Status
  • Read Appraisals
  • Delete Appraisals
  • Create Appraisals

  • Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.

    Further Information

    For more information on appraisals, refer to the R/3 Library (HumanResources -> Personnel Management -> Personnel Development -> Appraisal Systems -> Appraisal Creation).



    11-Dec-2005


    Delete

    Delete


    You use this method to delete selected appraisals. The method returns the names of the appraisals that were deleted.

    Notes

    Authorizations
    In order to delete appraisals, you require authorization for the transaction APPDELETE
    .

    Customizing Dependencies
    The control parameters of the AppraisalSystem determine whether completed appraisals (and also approved/rejected appraisals) may be deleted.

    Related Methods
    You can use the method Display Appraisals
    to display detailed information on selected appraisals.

    Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.

    Further Information

    For more information on appraisals, refer to the R/3 Library (Human
    resources -> Personnel Management -> Personnel Development -> Appraisal Systems).


    11-Dec-2005


    GetDetail

    GetDetail


    This method reads detailed information on a specific appraisal and all its appraisal elements.

    Example

    You could use this method to display appraisal results.

    Notes

    Related Methods
    Methods available for the business object Appraisal include:


  • Change Appraisals
  • Delete Appraisals
  • Change Appraisal Status
  • You can use the method Delete Appraisals to delete selected appraisals.

    Messages are returned in the parameter return. The parameter
    documentation shows the return codes and their meanings.

    Further Information

    For more information on analyzing appraisals, refer to the R/3 Library (HR -> Personnel Management -> Personnel Development -> Appraisal Systems -> Appraisals).


    11-Dec-2005


    GetList

    GetList


    This method reads all existing appraisals for the plan version andother import parameters specified. The method outputs detailed information (validity period, status) for each appraisal read.

    Notes

    Authorizations
    You require authorization for displaying appraisals.


    Related Methods
    You can use the method Delete Appraisals to delete selected appraisals.

    Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.


    Further Information

    For more information on appraisals, refer to the R/3 Library (HumanResources -> Personnel Management -> Personnel Development -> Appraisal Systems).


    11-Dec-2005


    StatusChange

    StatusChange


    This method changes the status of an appraisal.

    The following status transitions are possible:

    From status        ->  To status
    1 In preparation   ->  2 In process
    2 In process       ->  3 Completed

    3 Completed        ->  2 In process
                       ->  4 Approved
                       ->  5 Rejected
    5 Rejected         ->  2 In process

    Example

    You would use this method if, for example, you want to complete an appraisal once you have rated the appraisee.


    Notes

    Authorizations
    In order to change the status of appraisals, you require authorization for the transactionAPPTAKEBACK.

    Customizing Dependencies
    The control parameters of the Appraisal
    System determine whether the status of Completed (and Rejected) appraisals can be changed back to In process.

    Related Methods
    The methods that can be used for the business object Appraisal include:


  • Read Appraisals
  • Change Appraisals
  • Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.

    Further Information

    For more information on appraisals, refer to the R/3 Library (Human
    Resources -> Personnel Management -> Personnel Development -> Appraisal Systems -> Appraisal Creation
    ).


    11-Dec-2005