Function
You can use this method to change the budget or plan values on thepositions of a program sub-tree.

Notes
Using this method, the system transfers the value changes (= "deltas")for each position in table PROGTREEVALUES, not the new valuesresulting from the change.
INCLUDE IM_APPROVALYEAR OBJECT DOKU ID TX

Meaning
You can enter a text here that will be displayed along with the lineitems that result from plan or budgeting changes.
INCLUDE IM_POSITION OBJECT DOKU ID TX
INCLUDE IM_PROGRAM OBJECT DOKU ID TX

Meaning
Set this indicator, if you want each change to plan or budget valuesthat is transferred in a record of the PROGTREEVALUES table to also becarried out on all higher-level positions above thePROGTREEVALUES-POSITION position (rollup).
This guarentees that only plan or budget changes that are consistent inthemselves can be carried out.
INCLUDE IM_TEST_RUN OBJECT DOKU ID TX
INCLUDE IM_PROGTREEVALUES OBJECT DOKU ID TX

Meaning
INCLUDE BAPI_TABLE
Overview of the most important return messages (TYPE.ID.NUMBER):
E.APBAPI.002 : Unknown position in PROGTREEVALUES table(PROGTREEVALUES-POSITION field).
E.APBAPI.003 : Unknown budget category in PROGTREEVALUES table(PROGTREEVALUES-BUDGET_CATEGORY field).
E.APBAPI.004 : Unknown value type in PROGTREEVALUES table(PROGTREEVALUES-VALUE_TYPE field).
E.APBAPI.006 : No budget category entered in PROGTREEVALUEStable, although budget categories are used.(PROGTREEVALUES-BUDGET_CATEGORY field).
E.APBAPI.007 : Unknown approval period in PROGTREEVALUES table(PROGTREEVALUES-APPROVAL_PERIOD field).
E.APBAPI.008 : Unknown activity for budgeting in PROGTREEVALUEStable (PROGTREEVALUES-VALUE_TYPE field).
E.APBAPI.011 : Planning or budgeting not allowed according tosystem status or user status of program positionPROGTREEVALUES-POSITION.
E.APBAPI.012 : No authorization.
E.APBAPI.014 : A required entry field was not completed. Thename of the field is shown in the message.
E.APBAPI.027 : A position of the PROGTREEVALUES table(PROGTREEVALUES-POSITION field) does not belong to the sub-tree of thePROGRAM/APPROVALYEAR program that is specified by point of entryposition POSITION.
INCLUDE IM_AP005 OBJECT DOKU ID TX
INCLUDE IM_AP015 OBJECT DOKU ID TX
E.AP.169 : Unknown plan version in PROGTREEVALUES table(PROGTREEVALUES-VERSION field).
E.AP.170 : Plan version in PROGTREEVALUES table is locked(PROGTREEVALUES-VERSION field).
E.AP.179 : No plan versions are defined for program type ofPROGRAM/APPROVALYEAR program and approval year APPROVALYEAR.