Fonction SAP BAPI_COSTACTPLN_CHECKKEYFIGURE - Stat. Key Figure Planning: Check

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
DELTA BAPI6031_CTRLDATA-DELTA C 1 SPACE X
HEADERINFO BAPIPLNHDR_SKF u 67 Header Data

Paramètre Reférence Long. Facultatif Description
COOBJECT BAPISKFOBJ 70 Object List
INDEXSTRUCTURE BAPIACISTRU 12 Assign Objects and Values
PERVALUE BAPISKFVAL 330 X Plan Values Per Period
RETURN BAPIRET2 548 Error messages
TOTVALUE BAPISKFTOT 98 X Plan Values Per Fiscal Year and Distribution Key

Functionality
This method checks that statistical key figures can be plannedcorrectly.

Example
On cost center 4210 you want to plan statistical key figures KF01 andKF02 with the corresponding values 13 and 204, and distribution keys 1and 2.
You can fill the table as follows:
INDEXSTRUCTURE:
OBJECT_INDEX | VALUE_INDEX
1 | 1
1 | 2
COOBJECT:
OBJECT_INDEX|COSTCENTER|ACTTYPE|CO_BUSPROC|ORDERID|WBS_ELEMENT
1 | 4210 | | | |
TOTVALUE:
VALUE_INDEX|STATKEYFIG|STAT_QTY|DIST_KEY_QUAN|STAT_QTY_MAX|DIST_KEY_QU..
1 | KF01 | 13 | 1 | | 1
2 | KF02 | 204 | 2 | | 2
The records are checked by the system.
Important: If you are planning for the complete fiscal year, you mustalways specify the distribution key for quantity and maximum quantityfor statistical key figures of category "Total value". This applieseven if you have not entered a value for the maximum quantity.

Description
The DELTA indicator specifies whether the function module should addthe transferred values to the existing values.

Value range
X - The value is added to the existing value.
- The value is not added to, but rather overwrites the old value.

Default

Description
The Header_Info structure contains the following fields:

  • CO_AREA - Controlling area

  • FISC_YEAR - Fiscal year

  • PERIOD_FROM - First period for which values are transferred

  • PERIOD_TO - Last period for which values are transferred

  • VERSION - Version in which the plan data is stored

  • DOC_HDR_TX - Document header; only saved with integrated planning.

    • Value range

    • PERIOD_FROM, PERIOD_TO - The following must be true:

      • 1 <= PERIOD_FROM <= PERIOD_TO <= Number of true posting periods

      Description

      • OBJECT_INDEX - Index that uniquely identifies the row and thereby the

        • object. The index must be greater than zero, and may
        not appear more than once in the table.
        If the index does not appear in the INDEXSTRUCTURE,
        the row is ignored.
        • COSTCENTER - Cost center on which the statistical

          • key figure is to be planned.
          • ACTTYPE - Activity type can only be filled

            • together with COSTCENTER.
            • CO_BUSPROC - Business process on which the

              • statistical key figure is to be planned.
              • ORDERID - Order on which the statistical key

                • figure is to be planned.
                • WBS_ELEMENT - WBS element on which the statistical

                  • key figure is to be planned.
                  Only one object may be filled, COSTCENTER, CO_BUSPROC, ORDERID orWBS_ELEMENT.

                  Description
                  The IDX_STRUCTURE table assignes the contents of the individual tablesto one another. In each row there must be an object that exists in theOBJECT_INDEX field. You can also choose to transfer a row with periodicvalues from the PER_VALUE table or with annual values from theTOT_VALUE table.
                  The VALUE_INDEX field refers to the values.

                  Value range
                  The OBJECT_INDEX field may only contain values contained in theOBJECT_INDEX field of the OBJECT table.
                  The VALUE_INDEX field may only contain values that are contained in theVALUE_INDEX field of either the PER_VALUE or TOT_VALUE transfer tables.

                  Description
                  Used to transfer the values that refer to the statistical key figures.These are:

                  • VALUE_INDEX : A unique key of the row linked to in the

                    • INDEXSTRUCTURE table. If the index does not
                    appear in the INDEXSTRUCTURE, the system
                    ignores the row.
                    • STATKEYFIG : Statistical key figure

                    • QUANTITY_PER01-16 : Quantities for periods 1-16

                    • QUANTITY_MAX_PER01-16: Maximum quantities for periods 1-16

                      • Description
                      Return table containing the error messages that have occurred.

                      Description
                      Used to transfer the values that refer to the statistical key figure.These are:

                      • VALUE_INDEX : A unique key of the row linked to in the

                        • INDEXSTRUCTURE table. If the index does not appear
                        in the INDEXSTRUCTURE, the system ignores the row.
                        • STATKEYFIG : Statistical key figure

                        • STAT_QTY : Quantity for all periods

                        • DIST_KEY_QUAN : Distribution key for STAT_QTY. Required entry field

                        • STAT_QTY_MAX : Maximum quantity for all periods

                        • DIST_KEY_QUAN_MAX: Dist. key for STAT_QTY_MAX. Required entry field

                          • Important: If you are using statistical key figures of category "Totalsvalue", you must always specify the distribution key for quantity andmaximum quantity. This applies even if you have not entered a value forthe maximum value.

811787SAPLKIPL: Message KG 501 since Release 4.7
532262SAPLKIPL: Planning data not updated
535745SAPLKIPL: KI501 and KP571 with synchronous update
525569SAPLKIPL: Currency types insufficiently checked
508658SAPLKIPL: Overflow of lock table in background
450442BAPI: Data is not updated