SAP Function BAPI_FUNCLOC_CREATE - PM BAPI: Create Functional Location

Parameter Reference Type Length Default Optional Text
AUTOMATIC_INSTALL BAPIFLAG-BAPIFLAG C 1 X Automatic Installation According to Structure Indicator
DATA_GENERAL BAPI_ITOB u 815 PM: BAPI Structure for ITOBAPI_CREATE + READ Fields
DATA_SPECIFIC BAPI_ITOB_FL_ONLY u 72 PM: BAPI Structure for ITOBAPI_CREATE_FL_ONLY + READ Fields
EXTERNAL_NUMBER BAPI_ITOB_PARMS-FUNCLOC C 40 Functional Location Label
LABELING_SYSTEM BAPI_ITOB_PARMS-LABEL_SYST C 1 X Labeling System for Functional Locations

Parameter Reference Type Length Text
DATA_GENERAL_EXP BAPI_ITOB u 815 PM: BAPI Structure for ITOBAPI_CREATE + READ Fields
DATA_SPECIFIC_EXP BAPI_ITOB_FL_ONLY u 72 PM: BAPI Structure for ITOBAPI_CREATE_FL_ONLY + READ Fields
FUNCTLOCATION BAPI_ITOB_PARMS-FUNCLOC_INT C 30 Functional Location Key
RETURN BAPIRET2 u 548 Return Parameter

Functionality
This BAPI enables you to create an individualfunctional location.
Individual functions:

  • Functional location category check.

  • Structure indicator check.

  • Locking of labeling with simultaneous warning

  • (ENQUEUE).
    • Database check if the labeling is already being used.

    • Creation of the functional location in general status management.

    • INCLUDE 'ITOB_BAPI_HINTS' OBJECT DOKU ID TX LANGUAGE EN
      INCLUDE 'ITOB_BAPI_DATA_GENERAL_EXP' OBJECT DOKU ID TX LANGUAGE EN
      INCLUDE 'ITOB_BAPI_DATA_SPECIFIC_EXP' OBJECT DOKU ID TX LANGUAGE EN

      Description
      Internal key that uniquely identifies thefunctional location.
      INCLUDE BAPI_DATAELEMENT
      INCLUDE 'BAPI_RETURN' OBJECT DOKU ID TX LANGUAGE EN

      Description
      If this indicator is set, the BAPI automatically attempts to install thenew functional location being created in the existing structure.
      The structure indicator is used to determine the superior functionallocation. The latter must exist in the database. If an entire hierarchyof functional locations is to be created with the BAPI, the individualfunctional locations must be updated with COMMIT WORK AND WAIT beforethe next hierarchy level can be created.
      If the new functional location is installed directly in a superiorfunctional location, all the inheritance-relevant fields are inheritedfrom the superior functional location. Fields that are filled directlyby the BAPI call are filled with the transferred data, not inheritedfrom the superior functional location. In this case, even dependentfields are not inherited.
      Example
      If the maintenance plant is transferred to the BAPI, it is not inheritedfrom the superior functional location. This means that the dependentfields, such as business area and room, are not inherited.
      Even if the value transferred to the BAPI is the same as the field valuein the superior functional location, the field is not inherited from thesuperior functional location.
      Therefore, if you want to create a functional location and immediatelyinstall it, it is often better not to fill any further fields. Then theBAPI for changing the functional location must be called, in order tofill the fields. After this, the functional location can be updated.This ensures that the fields are inherited or set manually as required.This procedure best reflects the behavior of transaction IL01.
      If this indicator is not set, no superior functional location can betransferred to the BAPI.

      Value range
      Allowed values are ' ' and 'X'.

      Default
      The field is not filled.
      INCLUDE 'ITOB_BAPI_DATA_GENERAL' OBJECT DOKU ID TX LANGUAGE EN
      INCLUDE 'ITOB_BAPI_DATA_SPECIFIC' OBJECT DOKU ID TX LANGUAGE EN

      Description
      External label of the functional location tobe created.
      INCLUDE BAPI_DATAELEMENT

      Description
      Different labeling systems enable you to definealternative labelings for a functional location
      .
      If you do not specify a labeling system, the system uses the 'primarylabeling system' defined in Customizing for functional locations perdefault.
      This parameter is only used if alternative labeling has been activated.
      INCLUDE BAPI_DATAELEMENT

619145Technical object: Conversion of create BAPIs to SAVE APIs
489696Technical object: Authorization checks in new 4.6C BAPIs