Ansicht
Dokumentation

ABENEXCEPTION_TEXTS_GUIDL - EXCEPTION TEXTS GUIDL

Addresses (Business Address Services)   Vendor Master (General Section)  
This documentation is copyright by SAP AG.

Exception Texts

Each global exception class has a predefined exception text that has the same name as the exception class. This text can be edited and further exception texts can be defined. The exception texts of an exception class can be created either by referencing messages in the table T100 or by referencing texts in Online Text Repository (OTR).

For each exception text, Class Builder creates a static constant in the exception class with the same name as the exception text. When the exception is raised, this can be passed to the parameter TEXTID of the instance constructor to determine the exception text. If the parameter is not passed, the predefined exception text with the same name as the exception class is used.

From a technical perspective, the parameter TEXTID of the instance constructor can also be used to pass messages or texts from OTR as exception texts.

Using Messages as Exception Texts

Messages should be used as exception texts for exception classes in applications. OTR texts should be restricted to system classes. Only the associated texts can be used when an exception is raised.

The following guideline describes how to choose the text category:

• Messages should be used as exception texts in all exception classes in application programming.

• OTR texts should only be used in system classes, namely exception classes for system exceptions. OTR offers various benefits when compared with messages, such as no restriction to 73 characters and unlimited placeholders, but lacks full tool support. More specifically, ABAP Development Tools (ADT) do not support OTR texts.

From a technical perspective, it is possible to pass a data object to the input parameter TEXTID of the instance constructor when an exception is raised. This data object specifies either a message or an OTR text, depending on the text category. This approach is, however, absolutely not advisable. If the parameter TEXTID is used, an exception can only be raised with the texts specific to it. Only the associated constants of the exception class can be passed to the input parameter TEXTID of the instance constructor.

Notes

• In cases where a class-based exception is used to wrap a classic exception and MESSAGE ... RAISING is used to associate this classic exception with a message text (or after a message is caught using error_message), the class-based exception can use the same message text regardless of whether the program in question is a system program or application program. The system interface IF_T100_DYN_MSG and the addition MESSAGE of the statement RAISE EXCEPTION and of the addition THROW in a conditional exception are used for these cases.

• Classic exceptions are not associated with exception texts. If classic exceptions are required for reasons of downward compatibility, the statement MESSAGE ... RAISING gives the option of emulating exception texts here. Using MESSAGE ...RAISING in cases in which non-class-based exceptions must still be used is preferable to using the statement RAISE, because it offers the option of providing additional text information with an exception.

The following source code passes a UUID for an OTR text to the input parameter TEXTID of the instance constructor when an exception is raised. According to the rule above, however, only exception texts from the exception class can be passed, with each exception class containing the corresponding constants.

...
DATA otr_id TYPE sotr_conc.
otr_id = '9753EBD0102AD0418D902B8D972083C4'.
RAISE EXCEPTION TYPE cx_system_exception
   EXPORTING
      textid = otr_id.
...

The following source code passes the constant for the associated OTR text to the input parameter TEXTID of the instance constructor when an exception is raised, as specified by the rule above.

...
RAISE EXCEPTION TYPE cx_system_exception
   EXPORTING
      textid = cx_system_exception=>cx_system_exception.
...

Vendor Master (General Section)   General Material Data  
This documentation is copyright by SAP AG.

Length: 5638 Date: 20240419 Time: 121102     sap01-206 ( 96 ms )