Fonction SAP BAPI_EXPENDITUREPROGTREE_CREAT - Create Program Sub-Tree

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
APPROVALYEAR_IN BAPIPROGPOSID-APPROVALYEAR N 4 Approval Year of Program
LANGUAGE BAPIPROGAUX-LANGU C 1 X Logon Language in SAP Format
LANGUAGE_ISO BAPIPROGAUX-LANGU_ISO C 2 X Logon Language in ISO Format
PARENT BAPIPROGAUX-PARENT C 24 ' ' X Position ID of Parent
PREDECESSOR BAPIPROGAUX-PREDECESSOR C 24 ' ' X Position ID of Predecessor
PROGRAM_IN BAPIPROGPOSID-PROGRAM C 8 Program name
TEST_RUN BAPIPROGAUX-TEST_RUN C 1 ' ' X Test run

Paramètre Reférence Type Long. Description
APPROVALYEAR BAPIPROGPOSID-APPROVALYEAR N 4
POSITION BAPIPROGPOSID-POSITION C 24
PROGRAM BAPIPROGPOSID-PROGRAM C 8

Paramètre Reférence Long. Facultatif Description
PROGTREE BAPIPROGSTRUC 363 Detail Specif. on Program Positions
RETURN BAPIRET2 548 X Return Messages

Function
Using this method, you can create a program sub-tree in the programentered. The program definition has to exist already in the system inwhich the sub-tree is being created. You can either create a separateprogram tree, or add a sub-tree to an existing program tree.
Set the TEST_RUNindicator to have the system check if creating the sub-tree is possiblewithout errors. You receive a list showing any errors. In this way, youavoid the situation in which multiple errors cause the creation of thesub-tree to be interruped each time. The sub-tree is not created whenthis indicator is set.

Notes
You specify the program by entering these parameters:

  • PROGRAM

  • APPROVALYEAR

    • You control the position, to which the sub-tree should be assigned,using the PARENT andPREDECESSOR fields.
    The program positions are transferred in thePROGTREE internaltable. Along with the master data, this table has to supply thehierarchy of the sub-tree.
    INCLUDE IM_TREEHIER OBJECT DOKU ID TX
    INCLUDE IM_APPROVALYEAR OBJECT DOKU ID TX
    INCLUDE IM_LANGUAGE OBJECT DOKU ID TX
    INCLUDE IM_LANGUAGE_ISO OBJECT DOKU ID TX

    Meaning
    Position ID of the position, directly below which you want to assignthe sub-tree. This position thereby becomes the parent position of thepoint of entry position of the sub-tree.
    Making an entry in this field is optional.

    Preassignment
    If neither the PARENT field nor thePREDECESSOR fieldis set, the system creates a separate program tree using the point ofentry position as the top position.
    If the PREDECESSORfield is set, but the PARENT field is not, the system automaticallydetermines the position ID of the parent position.
    For more clarification of the terms "parent" position and "predecessor"position, refer to the example.

    Meaning
    Position ID of the position that is to be located directly in front ofthe point of entry position of the sub-tree being created, and whichwill be in both the same hierarchy level and below the same parentposition as the point of entry position.
    This entry is optional.

    Preassignment
    If the PREDECESSOR field is not set, and a value is transferred for theparent position (PARENTfield), then the point of entry position of the sub-tree becomes thefirst position in the hierarchy level directly below the parentposition.
    For more clarification of the terms "parent" position and "predecessor"position, refer to the example.

    Description
    INCLUDE IM_PROGRAM OBJECT DOKU ID TX
    INCLUDE IM_TEST_RUN OBJECT DOKU ID TX
    INCLUDE IM_PROGTREE OBJECT DOKU ID TX

    Meaning
    Overview of the most important return messages (TYPE.ID.NUMBER):
    INCLUDE IM_AP003 OBJECT DOKU ID TX
    INCLUDE IM_AP006 OBJECT DOKU ID TX
    INCLUDE IM_AP015 OBJECT DOKU ID TX
    INCLUDE IM_AP017 OBJECT DOKU ID TX(PROGTREE-RESPONSIBLE field)
    INCLUDE IM_AP036 OBJECT DOKU ID TX(PROGTREE-CO_AREA field)
    INCLUDE IM_AP040 OBJECT DOKU ID TX(PROGRAM, PROGTREE-CO_AREA fields)
    INCLUDE IM_AP043 OBJECT DOKU ID TX(PROGTREE-PLANT field)
    INCLUDE IM_AP045 OBJECT DOKU ID TX(PROGTREE-PLANT, PROGTREE-COMPANY_CODE fields)
    INCLUDE IM_AP046 OBJECT DOKU ID TX(PROGTREE-COMPANY_CODE field)
    INCLUDE IM_AP047 OBJECT DOKU ID TX(PROGTREE-COMPANY field)
    INCLUDE IM_AP051 OBJECT DOKU ID TX(PROGTREE-BUSINESS_AREA field)
    INCLUDE IM_AP053 OBJECT DOKU ID TX(PROGRAM, PROGTREE-CO_AREA fields)
    INCLUDE IM_AP054 OBJECT DOKU ID TX(PROGTREE-PLANT, PROGTREE-PLANT_SECTION fields)
    INCLUDE IM_AP059 OBJECT DOKU ID TX(PROGTREE-VALID_FROM_FY, PROGTREE-VALID_TO_FY fields)
    INCLUDE IM_AP060 OBJECT DOKU ID TX(APPROVALYEAR, PROGTREE-VALID_FROM_FY, PROGTREE-VALID_TO_FY fields)
    INCLUDE IM_AP106 OBJECT DOKU ID TX(PROGTREE-FUNCT_LOCATION field)
    INCLUDE IM_AP107 OBJECT DOKU ID TX(PROGTREE-FUNCT_LOCATION, PROGTREE-COMPANY_CODE fields)
    INCLUDE IM_AP109 OBJECT DOKU ID TX(PROGTREE-FUNCT_LOCATION, PROGTREE-COST_CENTER fields)
    INCLUDE IM_AP110 OBJECT DOKU ID TX(PROGTREE-FUNCT_LOCATION, PROGTREE-PLANT_SECTION fields)
    INCLUDE IM_AP111 OBJECT DOKU ID TX(PROGTREE-FUNCT_LOCATION, PROGTREE-PLANT fields)
    INCLUDE IM_AP112 OBJECT DOKU ID TX(PROGTREE-COMPANY_CODE, PROGTREE-COMPANY fields)
    INCLUDE IM_AP120 OBJECT DOKU ID TX
    INCLUDE IM_APBAPI002 OBJECT DOKU ID TX(PARENT or PREDECESSOR field)
    INCLUDE IM_APBAPI009 OBJECT DOKU ID TX
    INCLUDE IM_APBAPI017 OBJECT DOKU ID TX(PROGTREE-COUNTRY field)
    INCLUDE IM_APBAPI018 OBJECT DOKU ID TX(PROGTREE-USER04_UNIT or PROGTREE-USER05_UNIT field)
    INCLUDE IM_APBAPI019 OBJECT DOKU ID TX(PROGTREE-USER06_CURR or PROGTREE-USER07_CURR field)
    INCLUDE IM_APBAPI020 OBJECT DOKU ID TX(PROGTREE-USER04_UNIT_ISO or PROGTREE-USER05_UNIT_ISO field)
    INCLUDE IM_APBAPI028 OBJECT DOKU ID TX(PARENT and PREDECESSOR fields)
    INCLUDE IM_APBAPI029 OBJECT DOKU ID TX(PROGTREE-CO_AREA field)
    INCLUDE IM_APBAPI050 OBJECT DOKU ID TX(PROGTREE-USER08_DATE or PROGTREE-USER09_DATE field)
    INCLUDE IM_APBAPI051 OBJECT DOKU ID TX(PROGTREE-USER06_VALUE and PROGTREE-USER06_CURR/PROGTREE-USER06_CURR_ISO or PROGTREE-USER07_VALUE andPROGTREE-USER07_CURR/PROGTREE-USER07_CURR_ISO fields)
    INCLUDE IM_B1880 OBJECT DOKU ID TX(PROGTREE-COUNTRY_ISO field)
    INCLUDE IM_B1882 OBJECT DOKU ID TX(PROGTREE-USER06_CURR_ISO or PROGTREE-USER07_CURR_ISO field)
    INCLUDE IM_B1886 OBJECT DOKU ID TX(LANGUAGE_ISO field)
    INCLUDE IM_IL100 OBJECT DOKU ID TX(PROGTREE-FUNCT_LOCATION field)
    INCLUDE IM_KI101 OBJECT DOKU ID TX(PROGTREE-CO_AREA field)
    INCLUDE IM_KI200 OBJECT DOKU ID TX(PROGTREE-COMPANY_CODE, PROGTREE-CO_AREA fields)
    INCLUDE IM_KI203 OBJECT DOKU ID TX(PROGTREE-COMPANY_CODE, PROGTREE-CO_AREA fields)
    INCLUDE IM_KI222 OBJECT DOKU ID TX(PROGTREE-COST_CENTER, PROGTREE-CO_AREA, APPROVALYEAR fields)
    INCLUDE IM_KI265 OBJECT DOKU ID TX(PROGTREE-COST_CENTER, PROGTREE-CO_AREA fields)
    INCLUDE IM_KM089 OBJECT DOKU ID TX(PROGTREE-PROFIT_CENTER, PROGTREE-CO_AREA fields)
    INCLUDE IM_KM183 OBJECT DOKU ID TX(PROGTREE-PROFIT_CENTER, PROGTREE-COMPANY_CODE fields)
    INCLUDE IM_KM700 OBJECT DOKU ID TX(PROGTREE-PROFIT_CENTER, PROGTREE-CO_AREA, APPROVALYEAR fields)
    INCLUDE IM_KM701 OBJECT DOKU ID TX(PROGTREE-PROFIT_CENTER, PROGTREE-CO_AREA fields)
    INCLUDE IM_S040 OBJECT DOKU ID TX(PROGTREE-USER06_VALUE or. PROGTREE-USER07_VALUE field)
    INCLUDE IM_S041 OBJECT DOKU ID TX(PROGTREE-USER06_VALUE or PROGTREE-USER07_VALUE field)
    INCLUDE IM_S042 OBJECT DOKU ID TX(PROGTREE-USER06_VALUE or PROGTREE-USER07_VALUE field)
    INCLUDE IM_TL080 OBJECT DOKU ID TX(LANGUAGE field)