Fonction SAP BAPI_CMS_AST_GETDETAIL_MULTI - Get Asset data

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
DATA_REQUESTED BAPICMS_STR_AST_REQD_DATA u 4 X Data that is required for an Asset fetch
PROCESSEXTENSION BAPI_CMS_STR_CENTRAL-PROCESSEXTENSION C 1 X Indicator

Paramètre Reférence Long. Facultatif Description
ASSETS BAPICMS_STR_AST_GET 546 X Asset data
ASSET_CALCULATED_VALUES BAPICMS_STR_AST_CALC_GET 172 X Consolidated calculations results asset
BUSINESS_PARTNERS BAPICMS_STR_AST_BP_GET 184 X Business partner data of an Asset
EXTENSIONIN BAPIPAREX 990 X Ref. structure for BAPI parameter ExtensionIn/ExtensionOut
EXTENSIONOUT BAPIPAREX 990 X Ref. structure for BAPI parameter ExtensionIn/ExtensionOut
INTERNAL_IDS BAPICMS_STR_AST_GUID 32 Asset Guid (Asset internal key)
MAIN_ASSET_CALCULATED_VALUES BAPICMS_STR_AST_MAS_CALC_GET 172 X Calculations results of main asset (header only)
RETURN BAPIRET2 548 X Return Parameter
SUBASSETS BAPICMS_STR_SAS_GET 489 X Sub-asset data
SUBASSET_CALCULATED_VALUES BAPICMS_STR_SAS_CALC_GET 204 X Calculations results of the subassets
SYSTEM_STATUS BAPICMS_STR_AST_SYS_STAT_GET 41 X Asset system status
USER_STATUS BAPICMS_STR_AST_USR_STAT_GET 41 X Asset user status

Functionality
Use this method to transfer the details for one or more assetsmaintained in Collateral Management. These include :

  • Basic details of assets including value and discounts

  • Business partners

  • Calculated values for the assets

  • Note : This method transfers all the basic data. To transferspecific details of the assets such as business partner details, userstatus, system status and the calculation details, you must check therelevant flags for the same.
    This method is mostly used by correspondence and other modules where atable of asset identifications are given and all the details arerequired to be transferred.
    The rights GUID must be passed as parameter to uniquely identify assetsin the system. Based on this key, the details of the assets are returnedfrom the records.

    Description
    This parameter controls the scope of the data to be read for the asset.All the basic details of the assets are transferred. To transferspecific details, you must check the flags for the relevant structures.
    For more information on the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

    Description
    Check this flag to transfer the details entered by the Customers in aBusiness Add-In of this method.
    You will find information on the meaning of the parameter in thedocumentation for the data element Execute Extension(s)(BAdI).

    Value range
    X = Yes: In general the planned customer extensions should be executed.

    Description
    The parameter controls the details of the asset that would be transferedbased on the scope defined in the import parameter.
    For more information on the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

    Description
    This parameter determines the calculated values for the whole asset(including the asset and the sub-assets) that are transferred. Thedetails include :

    • Lending value

    • Lending limits

    • Lending ranges

    • Note : These details are transfered only if you have checked theflag CMS_DTE_FETCH_CALC_RESULTS.

      Description
      The parameter controls the details of the asset that would be transferedbased on the scope defined in the import parameter.
      This parameter controls the business partner details that must betransferred for the assets.
      You need to transfer values for atleast the following fields :

      • Business partner identification

      • Business partner function

      • The business partner details would be transfered only if you havechecked the flag CMS_DTE_FLG_FETCH_BP_DATA.
        For more information on the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

        Description
        This parameter enables you to define additional filter criteriadetermine the scope of the details to be transfered. You can use thisparameter to transfer user-specific enhancments to a BAPI. The customerhas to complete the EXTENSION structure and the systemautomatically continues processing it. If you have not defined anyuser-specific fields, then you can transfer a blank EXTENSIONINstructure.
        The table extension provided is called BAPI_TE_FMBH.
        For more information on the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

        Default

        Further information
        You can find more information in the BAPI programming guide in thechapter for enhancements to BAPIs.

        Description
        This parameter enables you to define additional filter criteriadetermine the scope of the details. This parameter is an exportparameter. It is provided to allow additional detail values to bereturned by the BAPI.
        The table extension provided is called BAPI_TE_FMBH.
        For more information on the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

        Default
        You can find more information in the BAPI programming guide in thechapter for enhancements to BAPIs.

        Description
        This parameter implements the primary keys (GUIDs or internal technicalkeys) of the assets whose details must be transferred.

        Description
        This parameter contains the calculated values of assets (excluding thesub-asset values) that are transfered in the method. These details aretransfered only if you have checked the flagCMS_DTE_FETCH_CALC_RESULTS.

        Description
        This table contains the return messages (including the error messagesfor plausibility checks ) from the method call.

        Description
        The parameter controls the details of the sub-assets that would betransfered based on the scope defined in the import parameter.
        For more information on the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

        Description
        This parameter contains the calculated values of sub-assets which aretransfered in the method.These details are transfered only if you havechecked the flag CMS_DTE_FETCH_CALC_RESULTS.

        Description
        This parameter contains the following details on the internal status ofthe asset :

        • Asset GUID (internal technical key of the asset)

        • System status assigned to the asset

        • Name of the system status

        • The details on the system status are transfered only if you have checkedthe flag CMS_DTE_FLG_FETCH_SYS_STAT while maintaining the importparameters.

          Value range
          The following system statuses are possible for assets :

          • Created

          • Active

          • Inactive

          • Legally active

          • Calculation relevant

          • Note : Only the following combinations of system statuses areallowed:
            Created + Calculation relevant
            Active + Calculation relevant
            Inactive + Calculation relevant
            Legally active + Calculation relevant
            If you want to set the system status to Calculation relevant,then in the Implementation Guide (IMG) Customizing, you must explicityset the status to a combination of a system status with calculationrelevant.
            Note :Plausibility checks are defined to validate the input databefore a system status is set for an asset.

            Default
            By default, all new assets assume the system status Created.

            Description
            This parameter contains the following data on the user status of theasset:

            • Asset GUID (internal technical key) that identifies the asset for which
            • the user status is valid
              • User status

              • Name of the user status

              • The details of the user status are transfered only if you have checkedthe flag CMS_DTE_FLG_FETCH_USR_STAT when defining the scope in theimport parameters.