Импорт маршрутов
Импорт маршрутов — это функция для массовой загрузки и обновления маршрутов на проектах, где используются несколько Активностей
Загрузка выполняется только из Excel-файла, сформированного по шаблону системы
Импорт маршрутов доступен только пользователям группы «Ключевой пользователь»
Заполнение файла выполняется строго по шаблону. Изменять названия колонок, удалять их или добавлять новые не допускается
Скачивание шаблона
Шаблон для импорта доступен в разделе Маршруты → Импорт маршрутов.
Для выгрузки нажмите кнопку с тремя точками и выберите пункт «Экспорт в Excel».
Пример скачивания шаблона из системы
В выгружаемом шаблоне отображаются данные уже созданных маршрутов в системе. При необходимости список можно предварительно отфильтровать по нужным полям и экспортировать только релевантные записи для последующего заполнения и загрузки.
Правила заполнения файла
Обязательность полей и формат значений
Дата — обязательное поле, формат YYYY-MM-DD
Позиция — обязательное поле. Указывается ID, значение берется из справочника Орг. Структура → Управление позициями
Активность — обязательное поле. Указывается ID, значение берется из справочника Анкеты → Активности
Клиент — необязательное поле. Указывается ID, значение берется из справочников Справочники → Торговые точки/ЛПУ/Врачи
Место работы — если заполнено, поле Клиент обязательно. Указывается ID, заполняется только если Клиент = Врач. Значение берется из справочника Справочники → ЛПУ, место работы должно быть связано с врачом
Время начала — формат HH:mm:ss
Время окончания — формат HH:mm:ss
Удален — допустимые значения: 0, 1 или поле не заполнено
Для строк с заполненным полем Клиент и значением Удален = 0 (или незаполненным Удален) поля Время начала и Время окончания обязательны. Для строк с Удален = 1 поля времени могут быть не заполнены.
Логические проверки при загрузке
Импорт выполняется только для строк с датой не раньше текущей даты, при этом для строк с Удален = 1 удаление допускается только для дат позже текущей (на текущую дату удаление не выполняется)
Значение поля Время начала не может быть больше значения поля Время окончания
В группе Дата + Позиция + Активность для строк, где поле Удален не заполнено или равно 0, должно быть хотя бы одно заполненное значение поля Время начала
В группе Дата + Позиция + Активность для строк, где поле Удален не заполнено или равно 0, должно быть хотя бы одно заполненное значение поля Время окончания
В рамках одной группы Дата + Позиция + Активность интервалы времени клиентов не должны пересекаться внутри загружаемого файла
В рамках одной группы Дата + Позиция + Активность интервалы времени клиентов не должны пересекаться с уже существующими записями в системе
Если конец одного интервала равен началу другого, это не считается пересечением
Нельзя одновременно удалять активность и добавлять/сохранять клиентов в одной и той же группе Дата + Позиция + Активность
В файле не допускаются дубли строк по ключу Дата + Позиция + Активность + Клиент + Место работы
Для указанной в строке даты в системе должен существовать цикл
Правила обработки записей
Вставка записей выполняется, если в системе отсутствует запись по ключу Дата + Позиция + Активность + Клиент + Место работы
Обновление записей выполняется, если запись по ключу Дата + Позиция + Активность + Клиент + Место работы уже существует
При обновлении записей изменяются значения полей Время начала и Время окончания
Удаление записей активности выполняется для строк с Удален = 1 и незаполненным полем Клиент
Удаление записей клиента выполняется для строк с Удален = 1 и заполненным полем Клиент
При удалении записей клиента удаление выполняется по связке Клиент + Место работы
Если Место работы не заполнено, удаляется запись клиента без места работы
Если Место работы заполнено, удаляется только запись клиента с указанным местом работы
После обработки записей выполняется пересчет времени активности на основании клиентских интервалов
Если при обработке файла не пройдена хотя бы одна проверка, файл отклоняется полностью, загрузка не выполняется, пользователю выводится сообщение с причиной отклонения.
Скачивание справочников для заполнения шаблона
Для корректного заполнения полей шаблона можно предварительно выгрузить соответствующие справочники из системы и использовать их как источник ID.
Общий порядок:
Перейдите в нужный раздел справочника (в зависимости от поля, которое заполняете)
Нажмите кнопку с тремя точками
Выберите пункт Экспорт в Excel или CSV
Используйте колонку с ID из выгруженного файла при заполнении шаблона импорта маршрутов
Пример:
Для заполнения поля Активность откройте справочник Анкеты → Активности
Выгрузите справочник через меню экспорта
Возьмите значения ID из выгруженного файла и укажите их в шаблоне импорта
Загрузка готового файла с маршрутами в систему
После заполнения шаблона выполните загрузку файла в разделе Маршруты → Импорт маршрутов.
Нажмите кнопку «Импорт»
В открывшемся окне выберите подготовленный файл на устройстве
Нажмите «Сохранить» для запуска обработки
Если загружаемый файл не соответствует шаблону, система выводит ошибку «Невалидный файл»
В этом случае необходимо проверить структуру файла и убедиться, что названия колонок соответствуют шаблону, после чего повторить загрузку
Если структура файла корректна, но не пройдены проверки заполнения/логики, система выводит предупреждение с причиной отклонения
Импорт при этом не выполняется, файл отклоняется полностью
После исправления ошибок файл необходимо загрузить повторно
Если импорт выполнен успешно, система выводит сообщение: «Маршрут успешно загружен в систему»
