Подключённые отчёты Wialon
Отдельный от «Сущностей» механизм на странице интеграции Wialon (см. Плагины и интеграции) — вместо регулярной синхронизации объектов, вы один раз настраиваете уже готовый отчёт из Wialon и превращаете его результат в записи CRM.
Шаблон отчёта, интервал, группа транспорта, кнопка загрузки
Шаг 1 — выбор отчёта и периода
- Шаблон отчёта — из уже настроенных в самом Wialon (Отчёты → шаблоны), с указанием ресурса.
- Интервал — «Последняя неделя», «Последний месяц» или «Произвольно» (свои даты «С»/«По»).
- Строить по — «Транспорт» (конкретная единица) или «Группа транспорта» (весь список объектов группы).
Большие группы и длинные периоды
Отчёт выполняется на стороне Wialon в реальном времени, и для большой группы транспорта за длинный период построение может занимать до нескольких минут — интерфейс предупреждает об этом под кнопкой загрузки, не закрывайте окно, пока идёт загрузка.
Шаг 2 — загрузка и предпросмотр
Кнопка «⬇ Загрузить данные» запускает отчёт и показывает результат: одну или несколько таблиц с их колонками и примером первых строк — это только предпросмотр, ничего в CRM ещё не сохраняется. Рядом с названием таблицы может появиться бейдж «с группировкой» — см. следующий раздел.
Строки: обычные таблицы и таблицы с группировкой
Многие отчёты Wialon строятся с группировкой — например, «по госномеру» или «по дате»: в результате в одной таблице оказываются вперемешку строки-итоги по группе и вложенные строки детализации, которые в сумме дают этот итог (типичный пример — отчёт «Пробег», где после каждого автомобиля идёт строка с его суммарным пробегом, а под ней — отдельные строки по каждой поездке).
Если система обнаружила такую группировку, у таблицы в предпросмотре появляется бейдж «с группировкой» и предупреждение под ним, а после выбора целевой таблицы CRM — дополнительный селектор «Строки» с тремя вариантами:
| Вариант | Что импортируется | Когда использовать |
|---|---|---|
| Все строки | И строки-итоги, и строки детализации подряд, как их вернул Wialon | Если целевая таблица CRM должна содержать и то, и другое как отдельные записи, либо для отчётов без группировки (тогда селектор просто не показывается) |
| Только итоги по группе | Только строки-итоги (например, одна строка на автомобиль с суммарным пробегом) | Когда в CRM нужна одна запись на объект/группу — например, справочник транспорта с накопленным пробегом за период |
| Только детализация | Только вложенные строки без итоговых | Когда в CRM нужны отдельные события — например, каждая отдельная поездка или каждая отдельная заправка |
Зачем это нужно
До появления этого выбора обе разновидности строк попадали в CRM единым потоком неразличимо — при построении отчётов или суммировании по импортированной таблице итоговые строки задваивали значения строк детализации (сумма получалась примерно вдвое больше реальной). Если у вашего отчёта есть группировка, обязательно выберите нужный вариант, а не оставляйте «Все строки», если только вам не нужны буквально обе разновидности как есть.
Шаг 3 — сопоставление с CRM
Целевая таблица, ключевое поле, маппинг колонок, режим обновления
Для каждой полученной таблицы отчёта указывается:
- целевая таблица CRM, в которую будут попадать строки;
- строки — какие именно строки импортировать, см. выше (только для таблиц с группировкой);
- ключевое поле — по нему строки отчёта сопоставляются с уже существующими записями (нужно только в режиме «Обновлять строки»);
- маппинг колонок — какая колонка отчёта в какое поле CRM записывается; для колонок, ссылающихся на другую таблицу (например, «Транспорт»), можно включить резолвинг по значению — CRM сама найдёт нужную связанную запись по человекочитаемому названию, выбрав поле для сопоставления в соседнем селекторе «сопоставлять по…»;
- режим: «Обновлять строки» — сопоставлять по ключевому полю и обновлять существующие записи (для новых строк — создавать), или «Перезаписать строки» — удалять всё, что было создано этой связкой отчёт+таблица ранее, и вставлять результат заново с нуля.
Сохранение и повторный запуск
После сохранения конфигурация отчёта появляется в списке подключённых отчётов таблицы с датой и результатом последнего запуска. Кнопка «Загрузить сейчас» повторяет импорт вручную в любой момент — тем же способом (обновление/перезапись), что был настроен изначально.
Настройка и запуск отчётов требуют права «Настройки» (manageSettings).