| name | released-abap-classes |
| description | SAP released ABAP APIs — C1/C2/C3/sAPIsC0 release contracts, released class hierarchies (cl_abap*, cl_system*, xco*, cl_bali*), API contract verification, ABAP Cloud compatibility checking, SAP API release lifecycle. Use when checking if a SAP class is released for customer use, selecting APIs for ABAP Cloud development, or verifying release contracts. |
| trigger | {"keywords":["released","abap","classes","apis","release-contracts","c1","c2","cloud","compatibility","sap-classes"],"intent":"Use when checking SAP class release contracts (C0-C4), verifying ABAP Cloud API compatibility, or selecting released APIs for development."} |
SAP Released ABAP APIs
SAP API release contracts and compatible ABAP APIs for cloud development.
Release Contracts
| Contract | Meaning | Stability |
|---|
| C1 | Released for customer use | Stable — SAP guarantees compatibility |
| C2 | Released with restrictions | Stable but usage-limited |
| C3 | Released for system-internal use | May change |
| [sAPIsC0] | Cloud Platform released | Stable for ABAP Cloud |
Key Released Class Hierarchies
CL_ABAP_* — Core ABAP Runtime
" Character/string utilities
cl_abap_char_utilities=>newline
cl_abap_char_utilities=>horizontal_tab
" Math operations
cl_abap_math=>round( iv_number = 3.14159 iv_decimals = 2 ) " → 3.14
" UUID generation
DATA(lv_uuid) = cl_system_uuid=>create_uuid_c32_static( ).
" Random integers
DATA(lv_random) = cl_abap_random_int=>create( seed = cl_abap_random=>seed( )
min = 1 max = 100 )->get_next( ).
XCO — eXtensible Component Objects
" CDS metadata access
DATA(lo_cds) = xco_cp_cds=>object_for( 'Z_I_PRODUCT' ).
DATA(lv_exists) = lo_cds->exists( ).
" Package metadata
DATA(lo_package) = xco_cp_abap_repository=>object->devc->for( '$ZFOO' ).
DATA(lt_objects) = lo_package->list_objects( )->get( ).
" DDIC table library
DATA(lo_table) = xco_cp_ddl=>field( 'MARA' )->field( 'MATNR' ).
DATA(lv_type) = lo_table->content( )->get_data_type( ).
CL_HTTP_CLIENT / CL_WEB_HTTP_CLIENT
" Released HTTP client (C1 contract)
DATA(lo_client) = cl_web_http_client_manager=>create_by_http_destination(
i_destination = cl_http_destination_provider=>create_by_cloud_destination(
i_name = 'MY_S4_SYSTEM' ) ).
DATA(lo_request) = lo_client->get_http_request( ).
DATA(lo_response) = lo_client->execute( i_method = if_web_http_client=>get ).
DATA(lv_body) = lo_response->get_text( ).
/UI2/CL_JSON
" Released JSON serialization (C1)
DATA(lv_json) = /ui2/cl_json=>serialize( data = ls_data ).
/ui2/cl_json=>deserialize( EXPORTING json = lv_json CHANGING data = ls_data ).
CL_BCS_MAIL_MESSAGE (Mail)
" Released mail client (C1)
DATA(lo_mail) = cl_bcs_mail_message=>create_instance( ).
lo_mail->set_sender( 'noreply@company.com' ).
lo_mail->add_recipient( 'user@company.com' ).
lo_mail->set_subject( 'Report Ready' ).
lo_mail->set_body( 'Your report is attached.' ).
lo_mail->send( ).
CL_BALI_LOG (Application Log — new)
" New BAL API (C1 in ABAP Cloud)
DATA(lo_log) = cl_bali_log=>create( ).
lo_log->add_item( item = cl_bali_message_item=>create(
severity = if_bali_constants=>c_severity_error
id = 'ZROUTER' number = '001' variable_1 = 'Failed' ) ).
lo_log->save( ).
Checking API Release Status
" Programmatic check
cl_abap_objectdescr=>get_object_type_info(
EXPORTING p_name = 'CL_WEB_HTTP_CLIENT'
IMPORTING p_release_contract = DATA(lv_contract) ).
" lv_contract = 'C1' (released) or 'C3' (not released for customer)
Not Released (Avoid in ABAP Cloud)
| Class | Alternative |
|---|
| CL_GUI_FRONTEND_SERVICES | Not available in cloud |
| CL_ABAP_BROWSER | Not cloud-compatible |
| CL_SALV_TABLE | Use CDS + Fiori |
| Function modules (custom) | Released RFC scenarios only |
| Direct DB access | CDS views only |
Gotchas
- C1 does not mean "no changes" — SAP may deprecate C1 APIs with 12-month notice
- XCO library is the future direction for DDIC/programmatic metadata
- cl_http_client is NOT released — use cl_web_http_client instead
- /ui2/cl_json is released but not in all C1 contract documents
