Сторож журнала регистрации: ошибки, неудачные входы и упавшие обмены сами приходят в мессенджер
База данных - Журнал регистрации
Файлы
ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.
Подписка PRO — скачивайте любые файлы со скидкой до 85% из Базы знаний
Оформите подписку на компанию для решения рабочих задач
Оформить подписку и скачать решение со скидкойВы можете заказать платную доработку или адаптацию этой разработки под вашу конфигурацию на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.
Обмен лежит шесть часов, а узнают об этом от бухгалтера, хотя ошибка всё это время была в журнале регистрации. Обработка ставит регламентное задание: раз в 5 минут (можно 10, 15, 30 или 60) оно читает новые события журнала и присылает в Telegram короткое сообщение, что упало, где, у какого пользователя и сколько раз.
Что присылает
- неудачные входы в базу;
- упавшие регламентные и фоновые задания;
- ошибки обмена данными;
- остальные ошибки уровня "Ошибка".
Сорок одинаковых ошибок приходят одним сообщением со счётчиком повторов, за один запуск уходит не больше 10 сообщений. Старые события при включении не присылаются, только новые.
Как настроить
- Администрирование - Печатные формы, отчеты и обработки - Дополнительные отчеты и обработки - Добавить из файла. Разрешите работу без безопасного режима.
- В карточке обработки на вкладке "Команды" выделите "Настройка сторожа журнала регистрации" и нажмите "Выполнить" (или задайте "Размещение", и команда появится в выбранном разделе). Введите токен бота и ID чата, нажмите "Сохранить".
- Нажмите "Отправить тестовое сообщение": в чат придёт проверка.
- В разделе "Регламентное задание" нажмите "Включить". Расписание видно в карточке обработки, форму можно закрыть.
Требования
- Платформа 8.3.17 и новее.
- Конфигурация на Библиотеке стандартных подсистем (БСП) 2.4.6 и новее с подсистемой "Дополнительные отчеты и обработки", например Управление торговлей 11.5 или Управление торговлей для Казахстана 3.4.
- Права администратора для настройки и доступ сервера 1С к api.telegram.org, напрямую или через прокси.
Ограничения
- Один чат на базу, имя базы стоит в каждом сообщении.
- В файловой базе задание работает, только пока кто-то работает в базе.
- Разделённые базы (режим сервиса) не поддерживаются.
- Только управляемые формы.
Вопросы и ответы
Настройка за пять минут
Как создать бота и получить токен?
- В Telegram откройте @BotFather и отправьте команду /newbot.
- Придумайте имя бота и его адрес, адрес заканчивается на bot.
- Скопируйте токен вида
123456789:AAE...в поле "Токен бота" и нажмите "Сохранить".
Токен хранится в безопасном хранилище базы. В форму обратно он не выводится, в поле видна подсказка "Токен сохранён".
Как узнать ID чата?
- Личный чат: напишите боту любое сообщение, откройте в браузере
https://api.telegram.org/bot<токен>/getUpdatesи найдите"chat":{"id":...}. - Группа: добавьте бота в группу и напишите в ней сообщение. ID группы начинается с
-100. - Канал: сделайте бота администратором канала. ID тоже начинается с
-100.
Бот не пишет первым. Пока он не получил от вас сообщение или не добавлен в группу, Telegram отвечает "chat not found".
Как это работает
Какая нагрузка на базу?
Читаются только новые ошибки и неудачные входы: обычный запуск занимает доли секунды, во время "шторма" ошибок (тысячи в минуту) до минуты. После долгого простоя журнал дочитывается за несколько запусков.
Что уходит наружу?
- Уходит: имя базы, время, вид события, объект метаданных, имя пользователя, первые 300 знаков текста ошибки, число повторов.
- Не уходит никогда: данные документов, компьютер, IP-адрес, номер сеанса и транзакции.
В базе сторож меняет только своё: настройки, расписание и публикацию своей карточки, свои предупреждения в журнале.
Если что-то не так
Включил, а ничего не приходит. Это значит, что ошибок нет?
Не обязательно. Посмотрите раздел "Регламентное задание" на форме: там время последнего запуска, сколько прочитано и последний сбой.
- "Ещё не запускалось": первый запуск только запоминает текущий момент, старые события не шлёт.
- "Задание давно не запускалось": проверьте блокировку регламентных заданий в кластере 1С и не считает ли программа базу копией. В копии базы задания, работающие с интернетом, не выполняются.
Почему не приходят неудачные входы?
Неудачный вход платформа пишет уровнем "Информация". Если журнал регистрации пишет только ошибки, входов в нём нет, и сторож об этом предупреждает. Включите уровень "Информация": Администрирование - Обслуживание - Журнал регистрации - Настройка.
Telegram с сервера недоступен. Что делать?
- Сообщения отправляет сервер 1С, поэтому доступ к api.telegram.org нужен серверу.
- Если в базе настроен прокси (Администрирование - Интернет-поддержка и сервисы - Параметры прокси-сервера), сторож пойдёт через него.
- Запасной канал: копия на почту в группе "Дополнительно", через системную учетную запись электронной почты.
Пока связи нет, сообщения ждут в очереди до 50 штук и уходят при первом удачном запуске.
Это работает в файловой базе?
Регламентные задания файловой базы выполняются, только пока в базе кто-то работает (открыт клиент или веб-публикация). Ночью сторож не запускается, а утром дочитает журнал за ночь и пришлёт накопленное.
Выключение и удаление
Как выключить и как удалить?
- Выключить: в разделе "Регламентное задание" нажмите "Выключить". Задание снимется, настройки останутся.
- Удалить: пометьте обработку на удаление в списке дополнительных обработок. При ближайшем запуске сторож сам снимет своё задание и сотрёт токен и настройки из базы.
Проверено на следующих конфигурациях и релизах:
- Управление торговлей, редакция 11, релизы 11.5.22.67
Вступайте в нашу телеграмм-группу Инфостарт