Fonction SAP BAPI_FAGL_PLANNING_POST - BAPI for Transferring Plan Data to New General Ledger Accounting

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
DELTA BAPIBUS1600_S_PARAM-DELTA C 1 SPACE X Produce Total of Existing and New Values
HEADERINFO BAPIBUS1600_PLAN_HEAD u 29 Header Data for Planning in New General Ledger Accounting
TESTRUN BAPIBUS1600_S_PARAM-TESTRUN C 1 SPACE X Switch to Simulation Mode for BAPIs That Write Data

Paramètre Reférence Long. Facultatif Description
EXTENSIONIN BAPIPAREX 990 X Container for Customer Exit Parameters
FIELDLIST BAPIBUS1600_S_FIELDLIST 30 X Field List for Additional Fields
PERVALUE BAPIBUS1600_S_POS_PERIOD 548 X Plan Data for New General Ledger Accounting, Item Data
RETURN BAPIRET2 548 Error Messages

Functionality
You can use this method to transfer plan data from an external datasource to new General Ledger Accounting. You can also use the method toperform mass uploads of plan data. Plan data is transferred for eachledger for a version, acompany code, a fiscal year, or for one or more periodsof a fiscal year. You can specify that additional criteria are applied.

Notes
Only amounts in the company code currency are transferred. If you useparallel local currencies for the company code in the correspondingledger, the method translates the amounts that were provided in thecompany code currency into the parallel local currencies.
You can use the Business Add-In AdditionalValidation of Plan Data to make customer-specific additional settingsfor this method.

Parameters
HEADERINFO
DELTA
TESTRUN
FIELDLIST
PERVALUE
EXTENSIONIN
RETURN

Customer Enhancements
The BAPI customer enhancement concept enables you to consider additionaldata that was not considered at the interface.
The parameter EXTENSIONIN serves as a data container that is used totransfer the additional values during the import.
In addition to the extension parameters at the interface, you can usethe Business Add-In (BAdI) AdditionalValidation of Plan Data to check the additional data that istransferred to the method as well as to perform further processing ofthat data.

Backflushes
Messages are returned in parameter RETURN. For more information, see theparameter documentation.

Description
If you set this indicator, the plan data to be transferred is added tothe existing plan data in the database. In this way, the plan data to betransferred is applied as delta data.

Value range

  • The indicator is not set (" ")

    • The data to be transferred is applied as target values. Applying thedelta update logic, the method transfers the differences between theexisting plan data and the target values to the database.
    • The indicator is set ("X")

      • The data to be transferred is applied as delta data. The method adds thedelta data to the existing plan data in the database.

      Default
      With the default setting, the indicator is not set, which meansthat the plan data to be transferred is applied as target values. Themethod reads the existing plan data using the criteria specified in thestructures HEADERINFOand FIELDLIST andcompares the data with the target values from structurePERVALUE.
      The method writes the differences between the existing plan data and theplan data to be transferred to the database.

      Description
      The parameter contains the header data to be transferred.
      The following fields must be filled:

      • COMP_CODE (company code for which the plan data is transferred)

      • LEDGER (ledger to which the plan data is transferred)

      • COMP_CODE (fiscal year for which the plan data is transferred)

      • PERIOD_FROM (first period of the fiscal year for which the plan data is
        • transferred)
        • PERIOD_TO (last period of the fiscal year for which the plan data is
          • transferred)
          • VERSION (plan version to which the plan data is transferred)

            • Description
            When this indicator is set, the system starts the plan data transfer asa test run.

            Value range

            • The indicator is set ("X")

              • The plan data is not transferred. The system runs checks andreports errors that would have occurred during an update run.
              • The indicator is not set (" ")

                • If no errors occur, the plan data is transferred.

                Default
                In the standard system, this indicator is not set.

                Description
                This parameter serves as a data container. In the parameter, additionaldata that was not considered at the interface can be transferred to themethod.
                The data is transferred to a table. The format of the individual datarecords of this table is determined by structure BAPIPAREX. Thisstructure contains data record fields (such as VALUEPART1 andVALUEPART2) as well as a field for the name of an internal structurecreated by the customer (STRUCTURE). Since the data is written to theavailable data record fields in consecutive blocks for each data record,an internal structure is required for interpret the data.
                If you have added customer fields to the tables in new General LedgerAccounting, you can use the structure BAPI Table Extensions to transferplan data with customer-specific account assignment information.
                For more detailed information about the different options for customerenhancements as well as about the internal structures that need to beused, see the document entitled Customer Enhancements andModification of BAPIs in the SAP Library under CA-BFA: FurtherDevelopments, Modifications ...
                As an example of an internal structure for totals table FAGLFLEXT
                , SAP delivers structure FAGLFLEX_BAPI_EXT.
                You can use the Business Add-In (BAdI)BADI_GL_PLANNING to assign thecustomer-specific account assignment information to the plan values. ThemethodFILL_CUST_DATA iscalled with the enhancement structure using parameter IT_EXTENSION tofill export parameter CT_INDEX_DATA. The data records from parameterCT_INDEX_DATA are assigned to the fixed data structurePERVALUE on the basisof the value in field POSNR and transferred to table TotalsTable.

                Description
                This parameter contains the fields from which you would like to transferdata in addition to the values from the standard fieldsLedger, Version,Company Code and Account. The method uses theparameter for the following processes:

                • Reading existing plan data and the corresponding account assignments
                  • from the database
                  • Determining the difference between the existing plan value and the
                    • target value from the Business Application Programming Interface (BAPI)
                    • Transferring the values determined to the database

                      • Example:
                      If you want to transfer plan data for which the profit center isrelevant in addition to the fields in theHEADERINFO parameter,you have to transfer the field PROFIT_CTR to the structure.
                      If you want to transfer plan data for which the customer field Z*(which you defined in theEXTENSIONINparameter) is relevant, you also have to transfer this field to thestructure.

                      Description
                      This parameter contains the plan values to be transferred. Besidesamount and quantity fields, the structure contains fields for accountnumber, controlling area, cost center, and profit center.

                      Value range
                      The plan values must always be transferred in the first local currencyof the company code. The system only considers amounts and quantitiesfor posting periods falling in the range PERIOD_FROM through PERIOD_TO.
                      If you use customer fields from theEXTENSIONINparameter, the POSNR field is used to assign a combination ofcustomer fields to the corresponding plan values (parameter PERVALUE).If the structure does not contain the field or if the field isnot filled correctly, no assignment can be made. In thiscase, no data is transferred.

                      Description
                      This table contains the confirmations from the method callup.
                      If errors occur during the plan data transfer, no data recordsare transferred.