Ansicht
Dokumentation

FS_API_BP1012_ADD - Business Partner: Create Ratings

Functionality

This module processes data records for the database table BP1012. The table contains the rating for each business partner.

The key fields for table BP1012 are:

• CLIENT

• PARTNER

An ADD function module adds data records to a database table.

The data records belonging to the import table IT_ are used for processing the data records in the ADD module. At the same time, the contents of several fields in each data record are checked against check values. The result of processing the data for the ADD module is placed in temporary storage in several function group tables until the next COMMIT or until the end of the program.

If errors occur when processing the individual data records for the input table of the ADD module, an error message is written in table ET_RETURN for each incorrect data record. ET_RETURN can therefore contains a series of error messages for 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.

  Further information

  
  
  
  
  

  Parameters

  ET_RETURN
  IS_GENERAL
  IT_BP1012
  IV_PARTNER
  IV_PARTNER_GUID
  IV_TESTRUN
  

  Exceptions

  Function Group

  FS_API_RATING
  
  RFUMSV00 - Advance Return for Tax on Sales/Purchases   Fill RESBD Structure from EBP Component Structure  
  This documentation is copyright by SAP AG.
  
  Length: 4106 Date: 20240523 Time: 085104     sap01-206 ( 85 ms )