# Як використати макроси рядків?

**Макроси** запускають процес або дію для одного рядка або для виділених рядків. Базові налаштування — на вкладці **UI-налаштування** редактора (**Макроси**); розширені ключі — через **JSON** → **front_json (розширений)**.

## Коли знадобиться

- Оператору потрібна кнопка «Відправити в процес» біля запису.
- Масова дія для виділених рядків (наприклад, запуск workflow для кількох заявок).
- Інтеграція таблиці з ботом без ручного відкриття конструктора.

## Що важливо знати

- **Кнопка в рядку** — **macrosSingle**; одна дія на запис.
- **Кнопка для виділених** — **macrosMultiple**; з’являється після виділення рядків (**{count} вибрано**).
- **Запустити макрос…** — пункт у меню виділення в таблиці записів.
- **Bot ID** — ідентифікатор бота для макросу.

## Перед початком

- [x] Відкритий **Редактор моделі Custom Data**.
- [x] Процес або action jail для макросу вже існує.
- [x] У операторів є права на запуск макросів (якщо налаштовано ролями).

## Покрокова інструкція

1. Відкрийте таблицю → **Редагувати** → вкладка **UI-налаштування**.
2. Розгорніть секцію **Макроси**.
3. Налаштуйте **Кнопка в рядку** — макрос для одного запису.
4. Налаштуйте **Кнопка для виділених** — макрос для множинного виділення.
5. Вкажіть **Bot ID**, якщо потрібно для вашої конфігурації.
6. Для розширених параметрів відкрийте **JSON** → **front_json (розширений)** — додаткові ключі збережуться.
7. **Зберегти** редактора.
8. У таблиці записів:
   - Для одного рядка — кнопка макросу в рядку або меню дій.
   - Для кількох — виділіть рядки → **Запустити макрос…**.

## Що відбувається після

У таблиці з’являються кнопки макросів. Натискання передає контекст запису (id, поля) у налаштований процес або action.

## Як переконатися, що все вдалось

- Кнопка видна в рядку або в панелі виділення.
- Макрос виконується без помилок у тестовому записі.
- Для виділення спрацьовує **Кнопка для виділених**.

## Пов'язані матеріали

- [Редагувати таблицю](./edit-model.md)
- [Масове редагування записів](./bulk-edit-records.md)
- [Використати вкладку процесу на таблиці](./use-scenario-tab-on-model.md)