Ansicht
Dokumentation

FS_API_BP1013_GET - Read Differentiated Attributes

Functionality

This module processes data records for the database table BP1013. The table contains the differentiation type-dependent attributes for the business partner.

The key fields for table BP1013 are:

• MANDT

• PARTNER

• DFTVAL

• VALID_FROM

The GET module determines the complete dataset for a business partner in the database and in temporary storage, and transfers the processing result to the output table ET_.The module can also determine an individual data record, as opposed to the complete dataset. In order to do this, the key for the required data record must be entered in full in the import parameter.

GET modules output the located data records without checking them further. An error message appears in the table ET_RETURN only if no data record is found. This occurs irrespective of whether the module is searching for a single data record or for several data records.

The tables are preprocessed prior to actual processing taking place.

• A check is made to ensure the availability of the data for processing.

• An authorization check is carried out, if required.

• An exclusive lock is set.

If an error occurs in preprocessing, this is saved in the output table ET_RETURN and processing is terminated. In this case, a single error message is entered in the table ET_RETURN.

Notes

• The module only processes data for one business partner. The business partner is identified via the business partner import parameter (IV_PARTNER), or alternatively via the business partner GUID parameter (IV_PARTNER_GUID).

• If a partner number exists, the system checks its validity. If it is valid, the business partner is selected. If it is invalid, an error message appears in ET_RETURN and processing is discontinued.

• If no partner number exists, the system checks whether a valid partner GUID is available. Where this is the case, the partner GUID is used. Otherwise, an error message appears in RT_RETURN and processing is discontinued.

• The module usually processes several data records for the current business partner (see above). It will only process one data record, however, if the table key contains only the client and the partner number as key fields. (The partner number key field uniquely defines a data record in the current client data.)

• The authorization check is carried out if the parameter value IS_GENERAL-AUTHORITY does not have initial value.

• A CHANGE module creates a change document for selected fields in every data record if the parameter IS_GENERAL-CHANGE_DOCU does not have initial value. The fields are determined for each individual data record via the table IT__X.
  • If the parameter IS_GENERAL-TESTRUN does not have initial value, only a test run will be carried out. This will not change the data in the database.
  • The exclusive lock is a simple exclusive lock, not an exclusive but not cumulative lock. It prevents other users from accessing data for the business partner currently being processed until the next COMMIT. At the same time, the authorized user has multiple access to the same business partner.
  • Temporary storage contains all the data records that have been marked for transfer to the database table since the last COMMIT for ADD, CHANGE and REMOVE modules. The database contains all the data records, which have been saved up to the last COMMIT.
  • If all the key fields are not filled in the import parameters, but if one or more fields in addition to the partner number have been filled, the module will not output the data record. Likewise, if the key is incorrect, no data record can be output, and an error message appears.
  • The search for an individual data record differs from the standard search only if other key fields in addition to the key fields Client and Partner Number are present in the table in question. If these two fields are the only key fields, then only one data record is available for the current business partner anyway.

  Further information

  
  
  
  
  

  Parameters

  ET_BP1013
  ET_BP1013
  ET_RETURN
  ET_RETURN
  IS_GENERAL
  IV_DFTVAL
  IV_PARTNER
  IV_PARTNER_GUID
  IV_VALID_FROM
  

  Exceptions

  Function Group

  FS_API_DIFFERENTIATION
  
  RFUMSV00 - Advance Return for Tax on Sales/Purchases   General Data in Customer Master  
  This documentation is copyright by SAP AG.
  
  Length: 5233 Date: 20240523 Time: 094136     sap01-206 ( 107 ms )