Отчёты

Отчёты показывают бизнес-результат работы роботов: сколько платежей проведено и на какую сумму, сколько заявок обработано, сколько времени сэкономлено. Отчёты хранятся в отдельной базе данных отчётов; пароли, токены, аргументы заданий и данные элементов очередей туда не попадают.

Что есть в разделе «Отчёты» #

Права: смотреть и выгружать отчёты могут все участники области; править записи — операторы и выше; создавать отчёты и поля — разработчики и владелец; писать SQL — разработчики, владелец и аудитор (см. матрицу прав).

Создать отчёт #

1. «Отчёты» → «Создать отчёт» (или вкладка «Отчёты» процесса — тогда отчёт сразу связан с процессом).
2. «Ключ» — латиница, цифры и _, с буквы: payments. По ключу отчёт находят шаги робота; в базе отчётов это таблица r_payments. Ключ после создания не меняется.
3. «Название» (например, „Платежи“), «Описание», «Процесс» — для навигации и прав (записывать в отчёт могут и другие процессы области), «Хранить записи, дней» — пусто — бессрочно.
4. «Поля» → «Добавить поле» для каждой колонки (см. ниже).
5. При необходимости — «Ключ записи». Нажмите «Создать».

Поля #

У поля — «Ключ поля» (латиница, имя колонки и имя значения в шагах робота, например amount), «Подпись» (что видят люди, например „Сумма“) и «Тип»:

Флажки поля: «Обязательное», «Искать по полю» (индекс в базе — фильтр быстрый и на миллионах записей), «Скрыто». «Значение по умолчанию» записывается, если значение не передано.

Каждая запись сама получает системные колонки: когда записана и изменена, источник (робот, оператор или загрузка из файла), задание и его номер, процесс и версия, робот и ссылка элемента очереди, который задание обрабатывало.

Ключ записи #

Необязательный набор полей, по которым запись уникальна, — например, „Номер“ платежа. Запись с тем же ключом не создаёт дубль: робот в режиме upsert обновляет прежнюю запись, загрузка из Excel — по флажку «Обновлять записи с тем же ключом записи». В ключ входят до 5 видимых обязательных полей, кроме JSON.

Изменение живого отчёта #

Вкладка «Поля» отчёта: добавлять поля, менять подписи, проверки и описание можно в любой момент — старые записи нового поля остаются пустыми. Тип поля с данными меняется только безопасно: целое → дробное, расширение числа, любое → текст, текст ↔ список. Убрать поле — «Скрыто» (данные остаются, поле можно вернуть); «Удалить окончательно» доступно только для скрытого поля и требует ввести его ключ. Каждое изменение — новая версия определения на вкладке «История» и запись в аудите.

Записи #

Вкладка «Записи» — таблица отчёта:

• «Поиск по тексту и спискам», «Записано с» … «по», «Любой источник», «Фильтры по полям» — по типу поля: диапазон чисел и дат, список, текст „содержит“, «Не заполнено»;
• сортировка щелчком по заголовку, «Колонки» — какие колонки показывать;
• щелчок по записи — карточка: «Значения» и «Сведения» со ссылками на «Задание», «Робот», «Процесс и версия»;
• «Добавить запись», «Изменить», «Удалить запись» — правка оператором попадает в аудит „было → стало“;
• «Выгрузить XLSX» и «Выгрузить CSV» — текущая выборка с фильтрами: XLSX — до 1 048 575 строк, CSV — без ограничения.

Числа можно вводить с пробелами и запятой (3 400,50). Значение, которое не подходит к полю, не сохраняется — текст ошибки называет поле, что ожидалось и что получено (например, для „12,5 сом“ в поле „Сумма“ — „ожидалось число“).

Загрузка из Excel #

1. «Загрузить из Excel» на странице отчёта.
2. Файл XLSX или CSV (UTF-8, разделитель ; или ,), заголовки — в первой строке, до 20 МБ и 10 000 строк.
3. Сопоставьте колонки файла с полями отчёта (колонки с подписью или ключом поля сопоставляются сами); лишние — «Не загружать».
4. «Проверить» — сервер разберёт файл без записи и покажет ошибки по строкам.
5. «Загрузить» — записываются только верные строки, неверные перечислены.