Fonction SAP BAPI_TIMEQUOTA_GETDETAILEDLIST - BAPI: Determines Quota Data for a Personnel Number

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
DEDUCTBEGIN BAPIHRQUOTA-DEDUCTBEGIN D 8 X Deduction from
DEDUCTEND BAPIHRQUOTA-DEDUCTEND D 8 X Deduction to
EMPLOYEENUMBER BAPIHRITBASE-EMPLOYEENUM N 8 Personnel number
KEYDATEFORDEDUCTION BAPIHRQUOTAHELP-KEYDATE_DE D 8 X Key date for deduction
KEYDATEFORENTITLE BAPIHRQUOTAHELP-KEYDATE_EN D 8 X Key date for entitlement
QUOTASELECTIONMOD BAPIHRQUOTAHELP-TYPEOFQU C 1 '1' X Selection Switch for Quotas
VALIDITYBEGIN BAPIHRQUOTA-FROM_DATE D 8 '18000101' X Valid from
VALIDITYEND BAPIHRQUOTA-TO_DATE D 8 '99991231' X Valid to
WAYOFCALCULATION BAPIHRQUOTAHELP-QUOTAMOD C 1 'D' X Quota Determination Type

Paramètre Reférence Long. Facultatif Description
ABSENCEQUOTARETURNTABLE BAPIHRQUOTA 182 X Return Table for Absence Quotas
ABSENCEQUOTATRANSFERPOOL BAPIHRTRANSFER 8 X
ABSENCEQUOTATYPESELECTION BAPIHRSELQTYPE 7 X Absence Quota Type Selection
CUMULATEDVALUES BAPIHRQUOTACV 116 X Return Table for Cumulated Values
PRESENCEQUOTARETURNTABLE BAPIHRQUOTA 182 X Return Table for Attendance Quotas
PRESENCEQUOTATYPESELECTION BAPIHRSELQTYPE 7 X Attendance Quota Types for Selection
RETURN BAPIRETURN1 470 X Return Table for General Information

Functionality
This method determines the information for personnel time quotas for apersonnel number.
Personnel time quotas can be selected using the following parameters:

  • Attendance quota or absence quota, or both

  • Quota type

  • Validity period (interval)

  • Deduction period (interval)

    • Notes
    The key date to which the information is determined is controlled byboth the KEYDATEFORENTITLE (Key date for entitlement) andKEYDATEFORDEDUCTION (Key date for deduction) parameters.
    Determining the quota status of the selected quota takes place based onthe following elements:

    • For each entitlement key date of the entitlement calculated

    • The quota used and the compensation is calculated up to a key date for
      • deduction
      • The expected requested deduction and compensation are calculated up to
        • the key date for deduction
        The result is displayed in its appropriate time unit. Quota informationcan be returned record by record using parameterABSENCEQUOTARETURNTABLE or PRESENCEQUOTARETURNTABLE. Cumulated quotainformation can be returned by the parameter CUMULATEDVALUES.
        Both key dates are compared with the PDC calculation dates to determinethe data to be accessed. The following options are available:
        • Read from Cluster B2

        • Read directly from the infotype record

        • Access to the data of a simulated time evaluation run

          • The data to be used for calculation is determined using the parameterWAYOFCALCULATION.

          Description
          Start date of the deduction period for the quota records.
          All of the records that match the time period from DEDUCTBEGIN toDEDUCTEND are selected.

          Description
          End date of deduction period for the quota records.
          All records that match the time period DEDUCTBEGIN to DEDUCTEND areselected.

          Description
          For more information on personnel numbers, see the corresponding dataelement documentation on the personnel numbers.

          Description
          For more information on key dates for deduction, see the correspondingdata element documentation on the key date fordeduction.

          Description
          For information on the meaning of the key date for entitlement, see thedata element documentation: Entitlement key date

          Description
          For more information on the selection switch for quotas, see thecorresponding data element documentation on theSelection Switch for Quotas

          Value range
          "1" for absence quotas
          "2" for attendance quotas
          "3" for absence and attendance quotas

          Default
          "1" for absence quotas

          Description
          Start date of the selectin period for the quota records.
          All records are selected that occur within the time periodVALIDITYBEGIN bis VALIDITYEND.

          Description

          End date for the selection period of the quota records.
          All records that occur within the time period VALIDITYBEGIN toVALIDITYEND are selected.

          Description
          By comparing the key dates with the last successfully evaluated day oftime evaluation (Recalculation for PDC = BDERR), you can enter variouscriteria to find the data available for determining quota information.
          To do so, use the WAYOFCALCULATION parameter.

          Value range

          • Value = A

            • If the key dates are < BDERR, data is read from Cluster B2 up to thekey date.
            If the key dates are > BDERR, Cluster B2 is read up to BDERR.
            • Value = B

              • If the key dates are < BDERR, data is read from Cluster B2 up to thekey date.
              If the key dates are > BDERR, data is read from the infotype (IT).
              • Value = C

                • If the key dates are < BDERR, data is read from Cluster B2 up to thekey date.
                If the key dates are > BDERR, data is simulated.
                • Value = D

                  • Data is read from the infotype for each case.
                  • Value = E

                    • If the key dates are < BDERR, data is read from the infotype up to thekey date.
                    If the key dates are > BDERR, data is simulated.

                    Notes
                    If the data is to be simulated, then the time evaluation reportRPTIME00 starts. You can specify a variant for RPTIME00 with thefeature LLREP

                    Default
                    If the parameter is not specified, then the information from theinfotype used for determination of quota information is calledWAYOFCALCULATION, or "D."

                    Description
                    The information on the selected absence quotas is available for eachindividual record in this table:
                    INCLUDE BAPI_KEYFIELD
                    LOGICALSYSTEM
                    QUOTANUMBER
                    INCLUDE BAPI_DATAELEMENT

                    Description
                    All of the absence quotas entered in this table are included.

                    Range in contrast to online transactions and abap reports, theseSIGN and OPTION must becompleted with valid values for each table entry. There are no"default" entries. Invalid table entries are removed from theselection, but are not replaced by "default" entries. As a result, yourdesired selection might be incomplete or limited.

                    Example
                    You want to include all quotas with the quota type 01 to 03.

                    • SIGN = I

                    • OPTION = BT

                    • LOW = 01

                    • HIGH = 03

                      • Description
                      Information on quota accrued is displayed in this table, which maycontain a maximum of four (4) entries:

                      • Accrual of absence quotas in hours

                      • Accrual of absence quotas in days

                      • Accrual of attendance quotas in hours

                      • Accrual of attendance quotas in days

                        • INCLUDE BAPI_DATAELEMENT

                        Description
                        In this table, information is displayed separately for the selectedattendance quotas.
                        Note:
                        If an attendance type is deducted in time evaluation, such as those intable T556P, field DEDUC), and this attendance type is assigned to anemployee with an entitlement = 0, then this is interpreted in TimeManagement as an unlimited entitlement.
                        To indicate this status, you must enter the maximum values(99999.99999) in the ENTITLE, REST and REST_FREE fields.
                        INCLUDE BAPI_DATAELEMENT

                        Description
                        All of the attendance quota types entered in this table are included.

                        Value range
                        In contrast to online transactions and ABAP reports, theseSIGN and OPTION must be
                        completed with valid values for each table entry.
                        There are no "default" entries. Invalid table entries are removed fromthe selection, but are not replaced by "default" entries. As a result,your desired selection might be incomplete or limited.
                        Description
                        Type,,ID,,Number,,Message
                        E ,,72,,036 ,,Infotype &1 does not exist
                        ,, ,, ,,in table T582A
                        E ,,P2,,556 ,,Infotype &1 cannot be read
                        ,, ,, ,,because authorization is limited
                        E ,,P2,,772 ,,Incorrect parameter
                        I ,,P2,,774 ,,Key date for leave taken is changed
                        ,, ,, ,,to &1
                        I ,,P2,,775 ,,Errors during simulation for infotype &1
                        I ,,P2,,776 ,,During simulation, data exists
                        ,, ,, ,,for infotype &1
                        I ,,P2,,777 ,,Key date for entitlement was changed
                        ,, ,, ,,to &1
                        I ,,P2,,778 ,,Transfer pool can only be
                        ,, ,, ,,determined under certain conditions