Диагностика
Модуль устроен так, чтобы ответ на вопрос «почему не обменялось» находился в интерфейсе, а не в логах на сервере. Для этого есть четыре места.
Дашборд
Сводная картина модуля и гайд «с чего начать»:
- состояние настроек по обоим видам документов, трём типам контрагента и четырём справочникам — что готово к обмену, а что осталось донастроить;
- карточка агента очереди: активен, неактивен или не установлен, время последнего и следующего запуска, кнопки установить и реактивировать;
- карточка событий модуля: все ли обработчики CRM зарегистрированы и включены;
- счётчики очереди: сколько задач ждёт, сколько выполнено, сколько с ошибкой.
С дашборда удобно начинать разбор любой проблемы: если что-то не обменивается совсем, причина почти всегда видна здесь.
Журнал действий
Журнал хранит значимые события обмена: что обменивалось, чем закончилось и почему сущность была пропущена. Это главное место, когда задача в очереди отработала успешно, а данных во второй системе нет.
Здесь же пишутся предупреждения по полям: какое поле не записалось и по какой причине — не удалось подогнать значение под тип, поле обязательное, пустое значение не принимается.
Очередь обмена
Страница очереди показывает каждую задачу: направление, сущность, состояние, число попыток, полный текст ошибки и журнал попыток. Задачу можно выполнить принудительно или удалить, агент — вызвать вручную. Подробно — в разделе Очередь обмена.
Логи
Технические подробности запросов и ответов — для разбора сложных случаев и обращений в техподдержку. В логах видно, что именно уходило в API МойСклад и что оно ответило.
Служебные страницы
- Таблицы модуля — состояние собственных таблиц модуля в базе и их переустановка.
- События модуля — список зарегистрированных обработчиков CRM с переключателями (нужны для диагностики; в обычной работе их не трогают).
С чего начинать разбор
- Задача вообще создалась? Если нет — смотрите события модуля (для выгрузки) или вебхуки (для загрузки).
- Задача выполняется? Если задачи копятся — проверьте агент очереди на дашборде.
- Задача «Выполнена», а результата нет? Смотрите журнал действий: сработала проверка готовности или фильтр.
- Задача с ошибкой? Текст ошибки виден в карточке задачи; технические детали — в логах.