Когда выгрузка в Домиленд завершается ошибкой, обычно непонятно, какой объект её вызвал: дом, лицевой счёт, счётчик или услуга. Мы сделали расширение для 1С:Рарус ЖКХ «Монитор обмена с Домилендом». Оно записывает каждый сеанс, пакет и объект обмена и показывает, что не выгрузилось, почему и что исправить.
Ошибка есть, а объекта не видно
Обработка «Модуль обмена с Домилендом» выгружает здания, клиентов, лицевые счета, тарифы, счётчики, начисления и квитанции. Её журнал хранит итог по дому, а ответ сервера с ошибкой приходится разбирать вручную. Ещё сложнее, если сервер отклонил весь пакет из-за одного объекта.
Что записывает журнал
- Сеанс — один запуск обмена: вид, ручной или регламентный, пользователь, время, число пакетов, объектов и ошибок.
- Пакет — один HTTP-запрос: дом, время, размер запроса и ответа, код ответа, текст ошибки и ответ сервера.
- Объект — дом, ЛС, помещение, клиент, счётчик или услуга со своим статусом: «Выгружен», «Ошибка», «Пакет отклонён», «Нет связи», «Повтор» или «Не отправлен».
Ошибку из ответа сервера монитор привязывает к объекту по ГУИД, коду услуги или номеру элемента в отправленных данных. По словам ошибки он подбирает подсказку: телефон, ИНН, адрес, площадь, дубль, тип услуги, размер пакета.
Разделы монитора
Монитор обмена с Домилендом — Обзор — Отчёт по обмену — Сеансы и пакеты — Поиск объекта и ГУИД — Регламентные задания
- Обзор — ошибки за сегодня, неисправленные объекты, объём и последний запуск каждого вида обмена.
- Отчёт по обмену — отборы по периоду, дому, ЛС, виду обмена и тексту. Объект открывается щелчком, «История» показывает все его выгрузки.
- Сеансы и пакеты — сколько пакетов было в запуске, самый большой пакет в МБ, время, ответ сервера.
- Поиск объекта и ГУИД — ГУИД в базе и идентификатор, который уходит в Домиленд. Для ЛС также показываются помещение, здание и клиент.
- Регламентные задания — расписание, последний запуск и его ошибка.
Старые журналы обработки можно загрузить в монитор: повторная загрузка не создаёт дублей.
Что важно знать
В обработку обмена только добавлены вызовы журнала, исходные строки не изменены. Если расширение отключить, обмен идёт как раньше.
- Типовая конфигурация не изменяется.
- Формат ошибок Домиленда не документирован полностью. Сообщения без идентификаторов сохраняются как «Сообщение сервера» на уровне пакета.
- Журнал растёт с каждым обменом. При необходимости мы настраиваем очистку старых записей.
- Перед работой в рабочей базе мы проверяем монитор на копии.
Частые вопросы
Видно ли, почему объект не ушёл в Домиленд?
Да. Объекты, которые обработка отсеяла до отправки, получают статус «Не отправлен» с причиной.
Пишется ли журнал при регламентном обмене?
Да. Сеанс отмечается как регламентный, а в разделе заданий видно расписание и последний запуск.
Нужны ли пользователю особые права?
Для просмотра монитора выдаётся роль «Монитор обмена с Домилендом». Журнал пишется и от имени пользователя без этой роли.
Обмен с Домилендом выдаёт ошибки?
Подключим монитор, разберём ошибки по объектам и наладим регулярную выгрузку.
- найдём объекты с ошибками и исправим данные;
- настроим регламентные задания обмена;
- возьмём базу на сопровождение.