Programming GetStatus() BAPIs (SAP Library - BAPI Programming Guide Reference (CA-BFA))

Programming GetStatus() BAPIs

Use

With the BAPI GetStatus() you can retrieve information about the status of a particular object instance.
The BAPI GetStatus() is an instance method.

Features

Import Parameters

You should keep the following points in mind when defining the import parameters:

The import parameters in the function module of the GetStatus() BAPI must contain the key fields of the corresponding business object type. The names of these parameters must be identical to the names of the object keys in the BOR and must have the same data elements.

Note

For the associated method definition in the BOR, the key fields must not also be specified as parameters. For this reason, the BOR/BAPI Wizard does not include the function module parameters for the key fields in the method definition, when it creates a BAPI.

If customers are to be enabled to enhance the import parameters of the BAPI without modifications being necessary, you must create the parameter ExtensionIn.
For information about extension parameters and recommendations on how the customer enhancement concept should be implemented in a GetStatus() BAPI, see Customer Enhancements and Modification to BAPIs.

Export Parameters

You should keep the following points in mind when defining the export parameters:

The export parameters of the BAPI contain information about the status of an object instance.

If customers are to be allowed to extend the export parameters of the BAPI without modifications being necessary, you must create the parameter ExtensionOut.
For information about extension parameters and recommendations on how the customer enhancement concept should be implemented in a GetStatus() BAPI, see Customer Enhancements and Modification to BAPIs. .

To report messages from the method call back to the calling program, you should create the export parameter Return . It is of particular importance when errors occur that messages describing the errors in detail are returned. You should, therefore, use all of the fields of the structure BAPIRET2. You should, in particular, fill the fields Parameter, Row and Field.
For more information about this parameter, see Return Parameters (Error Handling).

See also:

Example of a GetStatus() BAPI