JSON (JavaScript Object Notation) es el formato estándar para REST-APIs e integraciones modernas. ABAP ofrece varias opciones para el procesamiento de JSON: /ui2/cl_json, bibliotecas XCO y transformación nativa ABAP.
Resumen de métodos
| Método | Disponibilidad | Recomendación |
|---|---|---|
/ui2/cl_json | Desde 7.40 | Simple, ampliamente usado |
| XCO (Cloud) | ABAP Cloud | Moderno, type-safe |
| Simple Transformation | Todas | Eficiente, más esfuerzo |
| sXML | Todas | Low-Level |
/ui2/cl_json – El clásico
1. Estructura a JSON (Serialización)
TYPES: BEGIN OF ty_customer, id TYPE i, name TYPE string, email TYPE string, active TYPE abap_bool, END OF ty_customer.
DATA: ls_customer TYPE ty_customer.
ls_customer = VALUE #( id = 1001 name = 'Max Mustermann' active = abap_true).
" Convertir estructura a JSONDATA(lv_json) = /ui2/cl_json=>serialize( data = ls_customer compress = abap_true " Sin valores nulos/campos vacíos pretty_name = /ui2/cl_json=>pretty_mode-camel_case).
WRITE: / lv_json." {"id":1001,"name":"Max Mustermann","email":"[email protected]","active":true}2. JSON a estructura (Deserialización)
DATA: lv_json TYPE string.DATA: ls_customer TYPE ty_customer.
" Convertir JSON a estructura/ui2/cl_json=>deserialize( EXPORTING json = lv_json pretty_name = /ui2/cl_json=>pretty_mode-camel_case CHANGING data = ls_customer).
WRITE: / 'ID:', ls_customer-id.WRITE: / 'Nombre:', ls_customer-name.WRITE: / 'E-Mail:', ls_customer-email.3. Tabla interna a JSON
DATA: lt_customers TYPE TABLE OF ty_customer.
lt_customers = VALUE #().
DATA(lv_json) = /ui2/cl_json=>serialize( data = lt_customers compress = abap_true pretty_name = /ui2/cl_json=>pretty_mode-camel_case).
WRITE: / lv_json." [{"id":1,"name":"Müller",...},{"id":2,...},{"id":3,...}]4. Array JSON a tabla
DATA: lv_json TYPE string.DATA: lt_customers TYPE TABLE OF ty_customer.
lv_json = '[{"id":1,"name":"A"},{"id":2,"name":"B"},{"id":3,"name":"C"}]'.
/ui2/cl_json=>deserialize( EXPORTING json = lv_json CHANGING data = lt_customers).
LOOP AT lt_customers INTO DATA(ls_cust). WRITE: / ls_cust-id, ls_cust-name.ENDLOOP.5. Opciones de Pretty-Name
DATA: ls_data TYPE ty_customer.
" Nombres ABAP originales (MAYÚSCULAS)DATA(lv_json1) = /ui2/cl_json=>serialize( data = ls_data pretty_name = /ui2/cl_json=>pretty_mode-none)." {"ID":1001,"NAME":"Max",...}
" camelCaseDATA(lv_json2) = /ui2/cl_json=>serialize( data = ls_data pretty_name = /ui2/cl_json=>pretty_mode-camel_case)." {"id":1001,"name":"Max",...}
" Minúsculas con guiones bajosDATA(lv_json3) = /ui2/cl_json=>serialize( data = ls_data pretty_name = /ui2/cl_json=>pretty_mode-low_case)." {"id":1001,"name":"Max",...}6. Estructuras anidadas
TYPES: BEGIN OF ty_address, street TYPE string, city TYPE string, zip TYPE string, END OF ty_address.
TYPES: BEGIN OF ty_person, name TYPE string, age TYPE i, address TYPE ty_address, END OF ty_person.
DATA: ls_person TYPE ty_person.
ls_person = VALUE #( name = 'Max' age = 30 address = VALUE #( street = 'Calle Principal 1' city = 'Berlin' zip = '10115' )).
DATA(lv_json) = /ui2/cl_json=>serialize( data = ls_person pretty_name = /ui2/cl_json=>pretty_mode-camel_case).
" {"name":"Max","age":30,"address":{"street":"Calle Principal 1","city":"Berlin","zip":"10115"}}7. Salida formateada (Pretty Print)
DATA(lv_json) = /ui2/cl_json=>serialize( data = ls_customer pretty_name = /ui2/cl_json=>pretty_mode-camel_case format_output = abap_true " Indentado/formateado).
" {" "id": 1001," "name": "Max Mustermann"," "email": "[email protected]"" }8. Parseo genérico (sin tipo)
DATA: lv_json TYPE string.DATA: lr_data TYPE REF TO data.FIELD-SYMBOLS: <data> TYPE any.
lv_json = '{"name":"Max","age":30,"items":[1,2,3]}'.
" Parsear genéricamente/ui2/cl_json=>deserialize( EXPORTING json = lv_json CHANGING data = lr_data).
" El resultado es una estructura dinámicaASSIGN lr_data->* TO <data>.9. Mapeo de nombres
TYPES: BEGIN OF ty_abap_struct, customer_id TYPE i, customer_name TYPE string, END OF ty_abap_struct.
DATA: ls_data TYPE ty_abap_struct.
" JSON con nombres de campo diferentesDATA: lv_json TYPE string VALUE '{"customerId":1,"customerName":"Test"}'.
" Mapeo de nombres vía PRETTY_NAME/ui2/cl_json=>deserialize( EXPORTING json = lv_json pretty_name = /ui2/cl_json=>pretty_mode-camel_case CHANGING data = ls_data).
WRITE: / ls_data-customer_id, ls_data-customer_name.XCO – ABAP Cloud
10. Serialización XCO JSON
" Solo disponible en ABAP Cloud / SteampunkDATA: ls_customer TYPE ty_customer.
" SerializarDATA(lv_json) = xco_cp_json=>data->from_abap( ls_customer )->apply( VALUE #( ( xco_cp_json=>transformation->camel_case ) ) )->to_string( ).
" Deserializarxco_cp_json=>data->from_string( lv_json )->apply( VALUE #( ( xco_cp_json=>transformation->underscore_case ) ) )->write_to( REF #( ls_customer ) ).Simple Transformation
11. JSON con Simple Transformation
" Crear Transformation Z_JSON_CUSTOMER (STRANS)
" <?sap.transform simple?>" <tt:transform xmlns:tt="http://www.sap.com/transformation-templates"" template="main">" <tt:root name="CUSTOMER"/>" <tt:template>" <object>" <str name="id"><tt:value ref="CUSTOMER.ID"/></str>" <str name="name"><tt:value ref="CUSTOMER.NAME"/></str>" </object>" </tt:template>" </tt:transform>
DATA: ls_customer TYPE ty_customer, lv_json TYPE string.
ls_customer = VALUE #( id = 1 name = 'Max' ).
" ABAP a JSONCALL TRANSFORMATION z_json_customer SOURCE customer = ls_customer RESULT XML lv_json OPTIONS data_refs = 'embedded'.
" JSON a ABAPCALL TRANSFORMATION z_json_customer SOURCE XML lv_json RESULT customer = ls_customer.Ejemplos prácticos
12. Llamada REST-API
DATA: lv_response TYPE string, ls_result TYPE ty_api_response.
" HTTP-RequestDATA(lo_client) = cl_web_http_client_manager=>create_by_http_destination( i_destination = cl_http_destination_provider=>create_by_url( 'https://api.example.com' )).
DATA(lo_request) = lo_client->get_http_request( ).lo_request->set_uri_path( '/api/customers/1' ).
DATA(lo_response) = lo_client->execute( if_web_http_client=>get ).lv_response = lo_response->get_text( ).
" Parsear respuesta JSON/ui2/cl_json=>deserialize( EXPORTING json = lv_response CHANGING data = ls_result).
lo_client->close( ).13. JSON POST-Request
TYPES: BEGIN OF ty_request, action TYPE string, payload TYPE string, END OF ty_request.
DATA: ls_request TYPE ty_request.
ls_request = VALUE #( action = 'create' payload = 'datos de prueba').
" Crear cuerpo de la peticiónDATA(lv_json_body) = /ui2/cl_json=>serialize( data = ls_request pretty_name = /ui2/cl_json=>pretty_mode-camel_case).
" HTTP POSTDATA(lo_client) = cl_web_http_client_manager=>create_by_http_destination( i_destination = cl_http_destination_provider=>create_by_url( 'https://api.example.com' )).
DATA(lo_request) = lo_client->get_http_request( ).lo_request->set_uri_path( '/api/process' ).lo_request->set_header_field( i_name = 'Content-Type' i_value = 'application/json' ).lo_request->set_text( lv_json_body ).
DATA(lo_response) = lo_client->execute( if_web_http_client=>post ).14. Manejo de errores
DATA: lv_json TYPE string VALUE '{"json inválido'.DATA: ls_data TYPE ty_customer.
TRY. /ui2/cl_json=>deserialize( EXPORTING json = lv_json CHANGING data = ls_data ). CATCH cx_sy_move_cast_error INTO DATA(lx_error). WRITE: / 'Error de parseo JSON:', lx_error->get_text( ).ENDTRY.15. Fecha/Hora en JSON
TYPES: BEGIN OF ty_event, name TYPE string, event_date TYPE d, event_time TYPE t, timestamp TYPE timestamp, END OF ty_event.
DATA: ls_event TYPE ty_event.
ls_event = VALUE #( name = 'Reunión' event_date = sy-datum event_time = sy-uzeit timestamp = utclong_current( )).
" Estándar: Fecha como YYYYMMDDDATA(lv_json) = /ui2/cl_json=>serialize( data = ls_event pretty_name = /ui2/cl_json=>pretty_mode-camel_case).
" Para formato ISO: Se necesita conversión propia16. Arrays de tipos primitivos
DATA: lt_ids TYPE TABLE OF i.
lt_ids = VALUE #( ( 1 ) ( 2 ) ( 3 ) ( 4 ) ( 5 ) ).
DATA(lv_json) = /ui2/cl_json=>serialize( data = lt_ids ).WRITE: / lv_json. " [1,2,3,4,5]
" De vueltaDATA: lt_parsed TYPE TABLE OF i./ui2/cl_json=>deserialize( EXPORTING json = lv_json CHANGING data = lt_parsed).17. Tratar valores null
TYPES: BEGIN OF ty_nullable, name TYPE string, value TYPE i, END OF ty_nullable.
DATA: ls_data TYPE ty_nullable.
ls_data = VALUE #( name = 'Test' ). " value queda inicial (0)
" Con compress = true: Omitir valores inicialesDATA(lv_compressed) = /ui2/cl_json=>serialize( data = ls_data compress = abap_true)." {"name":"Test"}
" Sin compress: Todos los camposDATA(lv_full) = /ui2/cl_json=>serialize( data = ls_data compress = abap_false)." {"name":"Test","value":0}18. Valores booleanos
TYPES: BEGIN OF ty_flags, enabled TYPE abap_bool, visible TYPE abap_bool, END OF ty_flags.
DATA: ls_flags TYPE ty_flags.
ls_flags = VALUE #( enabled = abap_true visible = abap_false).
DATA(lv_json) = /ui2/cl_json=>serialize( data = ls_flags pretty_name = /ui2/cl_json=>pretty_mode-camel_case).
WRITE: / lv_json. " {"enabled":true,"visible":false}Consejos para integración API
" 1. Definir tipos que coincidan con la APITYPES: BEGIN OF ty_api_error, code TYPE string, message TYPE string, END OF ty_api_error.
TYPES: BEGIN OF ty_api_response, success TYPE abap_bool, data TYPE ty_customer, error TYPE ty_api_error, END OF ty_api_response.
" 2. Procesar respuestaDATA(lv_status) = lo_response->get_status( )-code.DATA(lv_body) = lo_response->get_text( ).
DATA: ls_response TYPE ty_api_response./ui2/cl_json=>deserialize( EXPORTING json = lv_body CHANGING data = ls_response).
IF ls_response-success = abap_true. " Procesar éxitoELSE. " Tratar error WRITE: / 'Error:', ls_response-error-message.ENDIF.Notas importantes / Mejores prácticas
/ui2/cl_jsones el estándar para JSON en ABAP clásico.- pretty_name para conversión de nombres (camelCase, lowercase).
- compress = abap_true elimina campos vacíos/iniciales.
- Para ABAP Cloud: Usar bibliotecas XCO.
- Simple Transformations para máximo rendimiento.
- Nombres de campo ABAP con guiones bajos se convierten a camelCase.
- Probar estructuras JSON con herramientas online (jsonlint.com).
- Definir tipos ABAP adecuados para respuestas de API.
- Manejo de errores con TRY-CATCH para JSON inválido.
- Boolean:
abap_true/abap_falsese convierte atrue/false.