Як працює клінер
ABAP-клінер — це власний форматувальник і нормалізатор коду від Makion. Він детермінований і зберігає поведінку: він змінює лише пробіли, регістр, розриви рядків і безпечні модернізації токенів, і ніколи не змінює того, що робить код. Клінер відпрацьовує через SAP-інструмент під час виконання задачі, перш ніж агент запише чи активує об'єкт.
Налаштуйте його на вкладці Клінер ABAP, яка видима адміністратору проєкту. Усе, що ви тут задаєте, стосується лише цього проєкту.
Що клінер робить, а чого — ні#
Клінер переписує форму ABAP, ніколи його зміст. Він може заново відформатувати відступи операторів, нормалізувати регістр ключових слів, упорядкувати пробіли та порожні рядки, вирівняти колонки оголошень і застосувати безпечні модернізації (наприклад, перетворити MOVE src TO tgt. на tgt = src.). Кожне правило за задумом зберігає поведінку — повний каталог дивіться в Довіднику правил клінера.
Клінер ніколи не запускається на об'єктах CDS / DDLS / DDLX / SRVD. Переформатування зіпсувало б їхні анотації. Він застосовується лише до сорсу ABAP.
Увімкнення клінера#
Головний прапорець Чистити код перед активацією — це вимикач увімк./вимк. для всього клінера в цьому проєкті. За замовчуванням він ВИМКНЕНИЙ.
Коли він УВІМКНЕНИЙ, у композері Чату з'являється прапорець Клінер для цієї задачі для окремої задачі, тож ви можете вирішити запустити клінер для однієї задачі. Коли головний вимикач вимкнено, клінер ніколи не запускається, а цей прапорець прихований.
Елементи керування на вкладці#
| Елемент | Що він робить |
|---|---|
| Чистити код перед активацією | Головний прапорець. За замовчуванням ВИМКНЕНИЙ. Коли УВІМКНЕНИЙ, вмикає клінер для цього проєкту і відкриває Клінер для цієї задачі в композері Чату. |
| Реліз ABAP системи | Числове поле (напр., 757; діапазон 700–799). Керує правилами модернізації — деякі переписування потребують мінімального релізу ABAP і не спрацюють на нижчому цільовому релізі. |
| Правила | Каталог правил, згрупований за категоріями. Кожне правило має прапорець, назву, опис, приклад до → після і id правила. Вимкнені, доки головний вимикач не увімкнено. |
| Зберегти | Зберігає конфігурацію клінера для цього проєкту. |
Реліз ABAP системи#
Деякі модернізації існують лише починаючи з певного релізу ABAP — наприклад, конструкторні вирази на кшталт NEW потребують 7.40, а складені присвоєння на кшталт x += n потребують 7.54. Значення Реліз ABAP системи повідомляє клінеру, на який реліз ви орієнтуєтеся, тож він застосовує лише ті переписування, які ваша система здатна скомпілювати. Установіть його на реліз вашої системи.
Правила#
Каталог Правила згрупований за категоріями — Регістр, Оголошення, Розмітка, Пробіли, Вирівнювання, Коментарі, Порожні рядки, Модернізація і Читабельність. Кожне правило перемикається окремо і налаштовується через профіль проєкту. Без профілю застосовується вбудоване значення за замовчуванням кожного правила. Елементи керування правилами вимкнені, доки головний вимикач не увімкнено.
Повний список усіх 45 правил — що робить кожне з них, його значення за замовчуванням і його група — дивіться в Довіднику правил клінера.
Запуск для задачі#
- На вкладці Клінер ABAP увімкніть Чистити код перед активацією і виберіть потрібні правила.
- Установіть Реліз ABAP системи на реліз вашої системи.
- Натисніть Зберегти.
- У Чаті поставте галку Клінер для цієї задачі на задачі, яку хочете почистити. Клінер відпрацює перед тим, як агент запише чи активує об'єкт.
Оскільки клінер зберігає поведінку, його безпечно залишати ввімкненим — він упорядкує і модернізує код, який створює агент, не змінюючи того, що той робить. Налаштуйте окремі правила під стиль вашої команди.
Пов'язані сторінки#
- Довідник правил клінера — усі 45 правил, згруповані, зі значеннями за замовчуванням.
- Чат — де з'являється прапорець Клінер для цієї задачі.
- Специфікації — вхідні дані задачі, з якими працює агент.