Fonction SAP BAPI_FIXEDASSET_GETLIST - Information on Selected Assets

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
COMPANYCODE BAPI1022_1-COMP_CODE C 4 Company Code
DEPRECIATIONAREA BAPI1022_DEP_AREAS-AREA N 2 X Depreciation Area for which Information is Requested
EVALUATIONDATE BAPI1022_5-EVAL_DATE D 8 X Report Date (Default = Today's Date)
MAXENTRIES BAPI1022_MISC-MAXENTRIES I 4 X Maximum Number of Assets to be Returned
REQUESTEDTABLESX BAPI1022_REQUESTEDTABLESX u 15 X Specification of Data to be Returned

Paramètre Reférence Type Long. Description
RETURN BAPIRET2 u 548 Information about Errors which Occurred

Paramètre Reférence Long. Facultatif Description
ALLOCATIONS BAPI1022_FEGLG004_PID 59 X Allocations
DEPRECIATIONAREAS BAPI1022_DEP_AREAS_PID 169 X Depreciation Areas
DEPRECIATIONAREAVALS BAPI1022_VALUES 126 X Selected Values
EXTENSIONOUT BAPIPAREX 990 X User Fields in Asset Master Record
GENERALDATA BAPI1022_FEGLG001_PID 239 X General Data
INSURANCE BAPI1022_FEGLG008_PID 156 X Insurance
INVENTORY BAPI1022_FEGLG011_PID 40 X Inventory
INVESTACCTASSIGNMNT BAPI1022_FEGLG010_PID 60 X Account Assignment for Investment
INVESTMENT_SUPPORT BAPI1022_INV_SUPPORT_PID 19 X Investment Support Measures
LEASING BAPI1022_FEGLG005_PID 190 X Leasing
NETWORTHVALUATION BAPI1022_FEGLG006_PID 45 X Net Worth Valuation
ORIGIN BAPI1022_FEGLG009_PID 164 X Origin
POSTINGINFORMATION BAPI1022_FEGLG002_PID 69 X Posting Information
REALESTATE BAPI1022_FEGLG007_PID 155 X Real Estate and Similar Rights
SELECTIONCRITERIA BAPI1022_SELECTIONCRITERIA 153 X Selection Criteria
TIMEDEPENDENTDATA BAPI1022_FEGLG003_PID 389 X Time-Dependent Data

Functionality
Using this method, you can compile a quantity of asset master data. Youcan influence the volume of data that is returned by entering selectioncriteria, as well as by selecting the relevant information on the assetmaster records.
From the time-dependent data of an asset (such as cost center), themethod returns the data that is valid on the report date. You can entera report date as a parameter when you call the method. If you do notenter a report date, the method uses today's date as the report date.

Notes

  • In order for the method to return asset data, you must have display
    • authorization for the object A_S_ANLKL ("normal" assets) and/orA_S_ANLGR (group assets).
    • Messages are returned in the RETURN parameter. See the parameter
      • documentation for that parameter to see the return values and theirmeanings.

      Description
      This parameter returns information on errors that might occur duringselection of assets.

      Value range
      If the parameter is blank (initial), then the selection was successful.
      TYPE,,ID,,NUMBER,,Meaning,,
      S,,BAPI1022,,009,,REQUESTEDTABLESX not set,,
      S,,BAPI1022,,010,,Nothing was selected,,
      S,,BAPI1022,,011,,Number of hits was limited,,
      E,,BAPI1022,,012,,Selection field not allowed,,
      Additional error messages from Asset Accounting are also possible.

      Description
      You have to use this parameter to transfer the company code to whichthe assets to be returned belong. The company code is a required entry.
      Only the assets of one company code can be returned per method call.

      Default
      None

      Description
      Specifies for which depreciation area the depreciation terms or valuesshould be returned.
      If you do not enter a depreciation area, and you nonetheless requestdepreciation terms or values using the REQUESTEDTABLESX parameter, thenthe system returns the depreciation terms or values from alldepreciation areas of the selected asset.

      Description
      The data returned in the table parameter TIMEDEPENDENTDATA can bedefined as time-dependent in the asset master record.
      The system returns the data that is valid on the EVALUATIONDATE that istransferred.
      If time-dependent data is not requested (theREQUESTEDTABLESX-TIMEDEPENDENTDATA field is blank or 0 when the methodis called), then the EVALUATIONDATE parameter has no significance.

      Default
      Today's date

      Description
      Using this parameter, you can limit the number of hits, in order toensure that the returned tables do not become too large if theselection was not limited enough.
      If the number of hits is limited by the MAXENTRIES parameter, a messagestating that is issued in the RETURN parameter.

      Default
      The number of hits is not limited.

      Description
      This parameter specifies which data the method returns.
      The following applies to the individual fields of the parameter:

      • If ' ' is transferred, the export parameter (table parameter) of the
        • same name is not filled.
        • If 'X' is transferred, the export parameter (table parameter) of the
          • same name is filled, if assets were selected.
          'X' must be transferred in at least one of the fields of theREQUESTEDTABLESX parameter.

          Description
          In this table parameter, the system returns data assigned to the"Allocations" group box of the selected assets.

          Description
          The depeciation terms of the DEPRECIATIONAREA depreciation area of theselected assets are returned in this table parameter.
          If the DEPRECIATIONAREA parameter is not set when the method is called,the depreciation terms of all depreciation areas are returned.

          Description
          The selected values of the DEPRECIATIONAREA depreciation area of theselected assets are returned in this table parameter.
          If the DEPRECIATIONAREA parameter is not set when the method is called,the values of all depreciation areas are returned.
          It is not possible to choose the values returned per asset and perdepreciation area.

          Description
          In this table parameter, the system returns the user fields in theasset master record that are defined for the selected assets.
          You can define user fields using customer enhancement
          AIST0002. Creating user fields is a preconditionfor the system returning user fields in this table parameter.
          If you have not created user fields in the asset master record usingthis customer enhancement, the system does not return any user fieldsin this table parameter.

          Description
          In this table parameter, the system returns the data assigned to the"General data" group box of the selected assets.

          Description
          In this table parameter, the system returns the data assigned to the"Insurance" group box of the selected assets.

          Description
          In this table parameter, the system returns the data assigned to the"Inventory" group box of the selected assets.

          Description
          In this table parameter, the system returns the data assigned to the"Investment account assignments" group box of the selected assets.

          Description
          In this table parameter, the system returns the data assigned to the"Leasing" group box of the selected assets.

          Description
          In this table parameter, the system returns the data assigned to the"Net worth tax" group box of the selected assets.

          Description
          In this table parameter, the system returns the data assigned to the"Origins" group box of the selected assets.

          Description
          In this table parameter, the system returns the data assigned to the"Posting information" group box of the selected assets.

          Description
          In this table parameter, the system returns the data assigned to the"Real estate" group box of the selected assets.

          Description
          By means of this table, you can designate selection criteria forlimiting the selection of asset master data. Basically you can selectusing each field in the asset master. Specifically, this means you canlimit the selection according to each field of the following parametersof the BAPI interface:

          • Allocations

          • GeneralData

          • Inventory

          • InvestAcctAssignmnt

          • Leasing

          • NetWorthValuation

          • Origin

          • PostingInformation

          • RealEstate

          • TimeDependentData

            • The parameters listed above also serve as return structures for theasset master data. However, the limiting and return processes areindependent of each other. In other words, you can select by certainfields in the 'GeneralData' structure, but have the system return onlydata from the 'Leasing' structure.
            For example, you can complete the fields of the parameter as follows:
            Parameter = 'generaldata'
            field = 'assetclass'
            sign = 'I'
            option = 'EQ'
            low = '00004000'
            The system lists all data for assets in class 4000. Remember that thenumber fields have to be completed using leading zeroes. The data whichthe BAPI should return is determined by your entering an 'X' in thecorresponding parameter in the 'RequestedTablesX' structure. If youenter an 'X' in the 'RequestedTablesX-GeneralData' field, the BAPIsupplies the 'GeneralData' table with data. On the other hand, if youdo not enter an 'X' in the 'RequestedTablesX-GeneralData' field, the'GeneralData' table remains empty.

            Description
            In this table parameter, the system returns the data assigned to the"Time-dependent data" group box of the selected assets that is valid onthe day of the EVALUATIONDATE.
            If the EVALUATIONDATE parameter is not set, the system then returns thetime-dependent data that is valid on the day of the method call.
            It is not possible to get more than one set of time-dependent data foran asset in one method call.