SAP ABAP Data Element BAPIUPDATE (Updated information in related user data field)
Hierarchy
SAP_BASIS (Software Component) SAP Basis Component
   BC-MID-API (Application Component) BAPI Tools (for BAPIs see Note 813411)
     SBF_BAPI (Package) Business Framework BAPI, Central Modules, Tools
Basic Data
Data Element BAPIUPDATE
Short Description Updated information in related user data field  
Data Type
Category of Dictionary Type D   Domain
Type of Object Referenced     No Information
Domain / Name of Reference Type BAPIUPDATE    
Data Type CHAR   Character String 
Length 1    
Decimal Places 0    
Output Length 1    
Value Table      
Further Characteristics
Search Help: Name    
Search Help: Parameters    
Parameter ID   
Default Component name    
Change document    
No Input History    
Basic direction is set to LTR    
No BIDI Filtering    
Field Label
  Length  Field Label  
Short 10 Update 
Medium 18 Updated Info 
Long 34 Updated info. user data field 
Heading 20 Updated information 
Documentation

Definition

This flag is used to select fields containing modified values in the parameter. It is used in, for example, change methods.

The value 'X' means that the associated field contains an updated value. The value BLANK means that the field does not contain an updated value.

Conventions for Parameters with Updated Values (update parameter)

The parameter has exactly the same fields as the parameter with the user data. The name of the update parameter should consist of the user data parameter name with an additional 'X'

For example: User data parameter name: Equisales
Update parameter: EquisalesX

If the parameter is a table the update parameter must also be a table.

Example

The distribution channel (Distr_Chan) should be changed to the value 'US'.
Business Object: PieceOfEquipment
BAPI: Update
Parameter with updated data: EquiSales
Fields in EquiSales: SalesOrg
Distr_Chan = 'US'
Division
...
Parameter for modified data: EquiSales_x
Fields in EquiSalesX: SalesOrg
Distr_Chan = 'X'
Division
...
In the parameter EquiSales_x the field Distr_Chan has the value 'X', meaning that the field EquiSales-Distr_Chan contains modified values.

Further Notes

This procedure is necessary because otherwise fields containing updated values cannot be identified. Using an initial value is no solution because an initial value could also be valid new value. Also, in the ABAP programming language or on other development platforms, you cannot assign the value "zero" to a field in order to select fields and thus indicate that the remaining fields contain update values. For further information see the BAPI Programming Guidelines.

History
Last changed by/on SAP  20010130 
SAP Release Created in