Fonction SAP BAPI_BUPA_FS_CUSTFIELDS_CHANGE - Change Additional Data

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
BUSINESSPARTNER BAPI_BUS_PARTNER_FS-PARTNER_ID C 10 Business Partner Number
CHANGEDOCU BAPI_STR_BUPA_FS_CHANGE_DOCU u 1 X Generate Change Documents; obsolete
GENERALSETTINGS BAPI_STR_BUSISB990_GEN u 16 X General Settings
TESTRUN BAPI_FSBP_CENTRAL-TESTRUN C 1 X Activate Simulation Mode

Paramètre Reférence Long. Facultatif Description
CUSTFIELDSDATA BAPI_STR_BUPA_FS_CUSTFIELDS 42 Additional Data
CUSTFIELDSDATAX BAPI_STR_BUPA_FS_CUSTFIEL_X 3 Change Information
RETURN BAPIRET2 548 X Return Messages

Functionality
You can use this method to change additional data for the businesspartner.
Additional data is a customer-specific attribute that you can define asfields with unrestricted use (that can be specified inCustomizing), user-defined fields, and checkboxesaccording to your requirements. This is defined in Customizing andstored in the business partner.
In the standard version you can define up to 11 fields withunrestricted use, 8 user-defined fields, and 10 checkboxes
according to your individual needs.

Recommendation
We recommend that new customers use only the Easy Enhancement Workbench for enhancing the SAP Business Partnerfor Financial Services data model.
The advantage of the Easy Enhancement Workbench is that you canenhance both the data model and the accompanying services (link toarchiving, change document update, data exchange, and so on). It is theonly tool to be used for making enhancements that is to be supported inthe future.
You can find further information on the Easy Enhancement Workbench
in the SAP Library by choosing SAP NetWeaver->Application Platform (SAP Web Application Server)-> Cross-ApplicationServices-> Easy Enhancement Workbench.
If you use Bank Analyzer pay particular attention to the separatenotes on using additional data that are contained in the SAP Library
for the primary object Business Partner.

Notes
You can change only one record with additional data for each businesspartner.
A preprocessing run takes place before the data is changed:

  • A check is performed to determine whether the business partner is
  • available for processing.
    • A simple exclusive lock is activated.

    • This prevents other users from changing the business partner that iscurrently being processed until either the method TransactionCommit
      or TransactionRollback for the Business ObjectBapiService is executed. The authorized user can access the samebusiness partner repeatedly.
      The additional data is not written to the database until the methodTransactionCommit for the Business Object BapiService hasbeen called.

      Authorizations
      You can make settings for business partner authorization objects to bechecked in Customizing for the SAP Business Partner underBusiness Partner-> Basic Settings-> Authorization Management.

      Buffering
      This method works with buffering. Change and read methods for thisbusiness object category can be repeatedly used for this instance. Aftercalling the save method, read and write methods can access thebuffered instances and supply current attributes in the same Logical Unit of Work (LUW)
      .

      Dependencies
      You make the additional data settings in Customizing for the SAPBusiness Partner for Financial Services by choosing Settings forFinancial Services-> General Settings-> Enhancement Options-> AdditionalData, and then the IMG activities Set Categories for AdditionalData and Determine Values for Additional Data. For moreinformation about the settings for additional data, see thedocumentation for the related IMG activities.
      Messages are returned in the Return parameter. The parameterdocumentation shows the return codes and their meanings.
      If errors occur, the entire Logical Unit of Work (LUW) must be discarded. To do this, call themethod TransactionRollback for the Business ObjectBapiService.

      Further information
      You will find more information on additional data in the SAP Library
      for SAP Business Partner for Financial Services by choosing
      Functions-> SAP Business Partner Data-> Additional Data.

      Description
      This parameter is a required (mandatory) parameter.
      You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Number.

      Value range

      Description
      This parameter is obsolete and does not have a function.
      The system generates change documents automatically.

      Value range

      Description
      You can find information about the meaning of the parameter in thecorresponding documentation for the data element: DBField Contents Must Be Valid at This Date.

      Description
      You can find information about the meaning of the parameter in thedocumentation for the data element: Switch To SimulationMode for Write BAPIs.

      Value range
      'X' Method is called in simulation mode, that is to say, the data is notupdated.
      ' ' Method is not called in simulation mode, that is to say, the data isupdated.

      Default
      ' ' Method is not called in simulation mode.

      Description
      This parameter is a required (mandatory) parameter.
      It contains the additional data for a business partner.
      Additional data is a customer-specific attribute that you can define asfields with unrestricted use (that can be specified in Customizing),user-defined fields, and checkboxes according to your requirements. Thisis defined in Customizing and stored in the business partner.
      For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

      Description
      This parameter is a required (mandatory) parameter.
      You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
      You have to transfer values for all fields to be changed in theparameter CUSTFIELDSDATA.

      Value range
      'X' Change additional data
      ' ' Do not change additional data

      Description
      This table contains the return messages from the method call.