Guida SAP Clean ABAP

Guida SAP Clean ABAP: Scrivere Codice di Qualità nella Programmazione SAP

Clean ABAP rappresenta l’evoluzione della programmazione SAP ABAP verso standard di qualità professionale. Questa guida tecnica approfondisce metodologie, strumenti e best practice per sviluppatori ABAP junior e senior che vogliono modernizzare il proprio approccio al codice.

Cos’è Clean ABAP e Perché Nasce

Clean ABAP è un insieme di principi e linee guida per scrivere codice ABAP leggibile, manutenibile e testabile, basato sul celebre libro Clean Code di Robert C. Martin pubblicato nel 2008. Mentre Martin scriveva principalmente per linguaggi come Java, la comunità ABAP ha dovuto attendere fino al maggio 2019 per avere una guida specifica.

La storia di Clean ABAP inizia nel 2010, quando tre team Scrum del dipartimento SAP governance, risk e compliance, guidati da Florian Hoffmann e Klaus Häuptle, iniziarono a sviluppare SAP Fraud Management in ABAP. Nonostante gli obiettivi raggiunti, i team mostravano idee molto diverse su cosa fosse “buon codice ABAP”. Nel febbraio 2018, decisero di raccogliere le best practice in un repository interno, che divenne rapidamente un tesoro di conoscenze condivise.

Dopo sessioni informative con centinaia di partecipanti e discussioni intense all’interno di SAP, Klaus Häuptle e Florian Hoffmann decisero nel maggio 2019 di rendere Clean ABAP un progetto open-source, pubblicandolo su GitHub sotto licenza CC BY 3.0. Questo passaggio ha permesso a sviluppatori ABAP di tutto il mondo di contribuire e beneficiare di queste linee guida.

I Principi Fondamentali di Clean ABAP – Guida SAP Clean ABAP

Clean ABAP non è un insieme rigido di regole, ma una filosofia guidata da principi chiave che ogni programmatore SAP dovrebbe conoscere:

• KISS (Keep It Simple, Stupid): mantieni il codice semplice. Un metodo dovrebbe fare una cosa alla volta, e farla bene. La complessità è nemica della manutenibilità.
• DRY (Don’t Repeat Yourself): non ripetere il codice. Se ti trovi a scrivere lo stesso codice più volte, incapsulalo in un metodo riutilizzabile.
• YAGNI (You Aren’t Gonna Need It): non introdurre funzionalità aggiuntive finché non ne hai effettivamente bisogno. Il codice inutilizzato è codice da mantenere senza benefici.
• La leggibilità è il valore fondamentale: passiamo molto più tempo a leggere codice che a scriverlo. Un codice leggibile accelera il debug, facilita le modifiche e rende più semplice l’inserimento di nuovi sviluppatori nel team.

Clean ABAP Style Guide: La Guida di Riferimento

Il Clean ABAP Style Guide è il documento ufficiale disponibile su GitHub che raccoglie tutte le raccomandazioni per scrivere codice ABAP pulito. Copre aspetti fondamentali come:

Naming Conventions (Convenzioni di Denominazione)

I nomi devono essere descrittivi e pronunciabili. Evita la notazione ungherese e i prefissi come “lv_”, “lt_”, “gs_” che erano comuni in passato ma rendono il codice meno leggibile.

* Codice NON pulito
DATA: lv_cnt TYPE i,
      lt_itab TYPE TABLE OF mara,
      gs_str TYPE mara.

* Codice pulito
DATA: counter TYPE i,
      materials TYPE TABLE OF mara,
      material TYPE mara.

Metodi Brevi e Focalizzati

Un metodo dovrebbe fare una cosa sola e farla bene. Mantieni i metodi sotto le 20 righe quando possibile, con un massimo di 3-4 parametri.

* Metodo troppo lungo e complesso
METHOD process_order.
  SELECT * FROM vbak INTO TABLE @DATA(orders)
    WHERE vkorg = @company_code.
  LOOP AT orders INTO DATA(order).
    "50 righe di logica complessa...
  ENDLOOP.
ENDMETHOD.

* Metodi puliti e focalizzati
METHOD process_order.
  DATA(orders) = get_orders( company_code ).
  validate_orders( orders ).
  calculate_totals( orders ).
  save_orders( orders ).
ENDMETHOD.

Gestione delle Eccezioni

Usa eccezioni basate su classi invece di codici di ritorno. Le eccezioni rendono il flusso del codice più chiaro e separano la logica di business dalla gestione degli errori.

* Gestione pulita delle eccezioni
METHOD check_email_exists.
  TRY.
      SELECT SINGLE @abap_true FROM pa0105
        INTO @DATA(exists)
        WHERE pernr = @personnel_number
          AND subty = @mail_subtype
          AND begda <= @sy-datum
          AND endda >= @sy-datum.
      
      IF exists = abap_true.
        result = abap_true.
      ELSE.
        RAISE EXCEPTION TYPE zcx_email_not_found.
      ENDIF.
    CATCH zcx_email_not_found.
      "Gestione specifica dell'errore
  ENDTRY.
ENDMETHOD.

Code Pal for ABAP: Il Controllo Automatico della Qualità

Code Pal for ABAP è uno strumento open-source che integra controlli automatici per verificare l’aderenza alle linee guida Clean ABAP. È completamente integrato nel Code Inspector e nell’ABAP Test Cockpit (ATC), rendendo i controlli di qualità parte del corso SAP ABAP quotidiano.

Caratteristiche Principali di Code Pal

Code Pal offre oltre 50 controlli diversi che coprono:

• Naming conventions: verifica che i nomi siano descrittivi e seguano le convenzioni
• Complessità ciclomatica: segnala metodi troppo complessi
• Profondità di annidamento: avvisa quando ci sono troppi livelli di IF/LOOP annidati
• Utilizzo di costrutti obsoleti: identifica sintassi ABAP deprecata
• Numero di parametri: controlla che i metodi non abbiano troppi parametri

Dal 2023 è disponibile anche Code Pal for ABAP Cloud Edition, che può essere eseguito in SAP BTP ABAP Environment e supporta controlli remoti. Questa versione include anche la funzionalità di quick fixes, permettendo di correggere automaticamente molte violazioni con un semplice click.

Installazione e Utilizzo

Per installare Code Pal, è necessario utilizzare abapGit per scaricare il repository da GitHub. Una volta installato, si attiva tramite il Code Inspector (transazione SCI) e si crea una variante di controllo personalizzata che include i controlli Clean ABAP desiderati.

Code Pal Quick Fixes: Correzioni Automatiche – Guida SAP Clean ABAP

Una delle caratteristiche più potenti della Cloud Edition di Code Pal è il supporto per i quick fixes automatici. Quando Code Pal identifica una violazione delle linee guida Clean ABAP, molte di queste possono essere corrette automaticamente attraverso ABAP Development Tools (ADT) in Eclipse.

I quick fixes coprono situazioni comuni come:

• Conversione di CALL METHOD in chiamate funzionali moderne
• Rimozione di dichiarazioni concatenate (unchaining)
• Sostituzione di CHECK con IF nelle posizioni appropriate
• Conversione di costrutti obsoleti in sintassi moderna
• Correzione della posizione dei commenti

Utilizzando i quick fixes, è possibile velocizzare enormemente il processo di adattamento del codice legacy alle linee guida Clean ABAP, rendendo la transizione verso un codice ABAP di qualità molto più gestibile.

ABAP Cleaner: Pulizia del Codice con un Click – Guida SAP Clean ABAP

ABAP Cleaner è uno strumento rivoluzionario rilasciato come open-source nel 2023 che applica oltre 100 regole di pulizia al codice ABAP con una sola pressione di tasto (Ctrl+4). Sviluppato internamente in SAP per due anni come progetto InnerSource, è ora disponibile gratuitamente per tutta la comunità ABAP.

Cosa Fa ABAP Cleaner – Guida SAP Clean ABAP

ABAP Cleaner può pulire qualsiasi quantità di codice, da una singola istruzione a un intero documento di codice, in modalità automatica o interattiva. Le 100+ regole di pulizia includono:

• Standardizzazione di spazi e righe vuote
• Rielaborazione delle sezioni di dichiarazione
• Miglioramenti sintattici
• Modernizzazione dei comandi
• Correzione automatica di typo comuni

* Prima di ABAP Cleaner
DATA: lv_value TYPE i.
lv_value = 10.
IF lv_value LE 100.
  WRITE: / 'Valore OK'.
ENDIF.

* Dopo ABAP Cleaner
DATA value TYPE i.
value = 10.
IF value <= 100.
  WRITE: / 'Valore OK'.
ENDIF.

Implementare Clean ABAP: Strategia Pratica

L’adozione di Clean ABAP non deve essere un processo “tutto o niente”. SAP raccomanda un approccio graduale in quattro fasi:

1. Coinvolgi il team
2. Inizia con piccole aree non controverse
3. Applica la regola del Boy Scout (“lascia il campeggio più pulito di come l’hai trovato”)
4. Crea isole di codice pulito

Concentrati sul nuovo codice e migliora gradualmente quello esistente quando ci lavori per correzioni o nuove funzionalità.

Benefici Tangibili di Clean ABAP

• Riduzione dei tempi di manutenzione
• Onboarding accelerato
• Meno errori
• Maggiore produttività
• Preparazione per S/4 HANA e Cloud
• Riduzione dei findings ATC

Clean ABAP nel Contesto 2025: Clean Core e ABAP Cloud

Nel 2025, Clean ABAP si inserisce perfettamente nella strategia Clean Core di SAP.
ABAP Cloud impone molti principi Clean ABAP di default, rendendo chi adotta oggi questa filosofia già pronto per il futuro dell’ecosistema SAP.

Investire nella Formazione: La Chiave del Successo

L’adozione di Clean ABAP richiede formazione continua.

Per le Aziende:
Scopri i Corsi SAP ABAP per Aziende

Per i Privati:
Esplora i Video Corsi SAP per Privati

📧 Email: info@innovaformazione.net
📞 Tel: 3471012275 (Dario Carrassi)

(fonte) (fonte) (fonte) (fonte)

Per altri articoli tecnici sul mondo SAP, consigliamo di navigare sul nostro blog QUI.