Работа со справочником "Маршруты" (Новая)
Справочник «Маршруты» (SFA)
Раздел «Маршруты» находится в навигационной панели слева в разделе SFA.Что такое «Маршруты»?
Это справочник, в котором хранятся данные обо всех загруженных в систему маршрутах и их расписаниях (посещениях торговых точек по дням).
В общую таблицу справочника выводятся расписания маршрутов по дням. При этом для одного маршрута может отображаться несколько строк с расписаниями на разные дни. В таблице указывается ID маршрута, а ID расписания (отдельной строки на конкретную дату) в общем списке не выводится.
Доступ к данным в справочнике ограничен иерархией: вы видите только маршруты сотрудников, привязанных к дочерним звеньям вашей оргструктуры.
Столбцы таблицы и их настройка
По умолчанию в таблице отображаются следующие колонки (в указанном порядке):
ID маршрута — уникальный идентификатор загруженного маршрута (UUID). Может повторяться, так как маршрут имеет расписания на разные дни.
Название маршрута — название, указанное при импорте.
Код оргструктуры — код оргструктуры, для которой загружен маршрут.
Название оргструктуры — наименование оргструктуры (ранее колонка «Объект оргструктуры»).
Сотрудник — основной сотрудник, привязанный к оргструктуре.
Цикличность — повторение маршрута (0 — нет цикличности, 1 — каждая неделя, 2 — каждые 2 недели, 3 — каждый месяц).
День недели — день, для которого создано расписание (полное название: понедельник, вторник и т.д.).
Фиксированный порядок — чекбокс (true — с соблюдением порядка точек, false — свободное выполнение).
Начало действия — дата расписания.
Окончание действия — дата расписания.
Статус — Активный / Неактивный.
Кем изменено — email пользователя, загрузившего маршрут или вносившего изменения.
Дата создания — дата загрузки и создания расписания.
Дата изменения — дата внесения изменений в расписание.
Важно: Колонки «ID должности» и «Должность» из справочника убраны.
Столбцы, отмеченные иконкой лупы, поддерживают текстовый поиск по столбцу, и быструю фильтрацию данных по значениям:
В полях с датами можно выбрать временный период, и отфильтровать данные по нему:
В общей таблице можно применять больше двух фильтров одновременно. Для сброса одного из фильтров нажмите на крестик в соответствующей записи с применённым фильтром. Для сброса всех фильтров нажмите кнопку 
.
Настройка отображения столбцов:
Видимость столбцов можно настроить по клику на «шестерёнку» .png){kind=small}
.
Откроется модальное окно, где с помощью чекбоксов выбирается показ/скрытие нужного столбца. Чтобы сделать видимыми другие поля, активируйте чекбокс(-ы) напротив. Для сохранения изменений нажмите кнопку 
.
Для быстрого включения всех существующих в данном справочнике столбцов нажмите «Выбрать все». Нажмите на кнопку «По умолчанию», чтобы вернуть стандартные настройки отображения столбцов таблицы.
Для перемещения столбцов влево-вправо по таблице нужно в модальном окне зажать строку с нужным параметром, и перемещать его вверх или вниз по списку. Для сохранения изменений нажмите кнопку.Экспорт данных
Нажмите кнопку кнопку 
, чтобы выгрузить таблицу на компьютер.
ARK Space сформирует файл в формате .xlsx. При экспорте всегда выгружается полный набор колонок в порядке по умолчанию (настройки видимости и порядка колонок в интерфейсе не учитываются).
Чтобы скачать файл на компьютер:
- Дождитесь окончания выгрузки файла;
- Нажмите на
; - Найдите нужный файл в списке и нажмите на него.
Важно! Более 10 000 строк выгрузить не получится. Если есть необходимость выгрузить более - воспользуйтесь фильтрами.
Файл будет содержать две вкладки:
Расписание — табличный вид расписаний, попавших в выборку по фильтрам.
Маршруты — сетка календаря с полным набором точек для маршрутов, расписания которых попали в выборку.
Подробный вид маршрута
По клику на любую из строк таблицы открывается детальная страница объекта. Визуально экран разделяется на три блока: блок с общей информацией о маршруте, блок с точками маршрута и карта.
Общая информация
По клику на иконку 
открывается полный список полей:
В верхнем блоке отображаются поля:
- ID маршрута
- Название маршрута
- Код оргструктуры
- Название оргструктуры
- Сотрудник
- Цикличность
- День недели
- Фиксированный порядок (чекбокс да/нет)
- Начало действия
- Окончание действия
- Статус
- Дата создания
- Дата изменения
- Кем изменено
Поля с серой заливкой нельзя редактировать, они заполняются автоматически.
Точки маршрута
Экран разделен на две части:
Слева — список торговых точек (ТТ) плашками в порядке, заданном на маршруте. Для каждой ТТ указана следующая информация:
- Порядковый номер ТТ на маршруте (по умолчанию сортировка от меньшего к большему)
- Фактическое название ТТ
- Фактический адрес ТТ
- Код ТТ (доступно копирование по значку справа от кода)
- Статус
Поиск по списку ТТ — текстовый, работает только для поиска в списке.
Справа — карта (Яндекс), на которой отображены ТТ маршрута с указанием номера порядка посещения, соединенные линиями. Над картой выводится информация: Количество ТТ.
Важно: Информация по торговым точкам (название, адрес) забирается из актуальных мастер-данных по коду ТТ и обновляется соответственно.
Импорт маршрутов
Для загрузки маршрутов нажмите кнопку «Импорт» в правом верхнем углу справочника.
Откроется окно с двумя вариантами загрузки:
Импорт из файла — добавляет маршруты из файла импорта, прошедшие валидацию (включая проверку на пересечение дат расписаний между маршрутами в файле и в БД).
Импорт из файла с перезаписью маршрутов в БД — добавляет маршруты из файла импорта без прохождения валидации на пересечение дат расписаний с уже записанными маршрутами в БД. Пересекающиеся даты расписаний перезаписываются на новые (старые записи переходят в статус «Неактивный» для сохранения истории).
Скачайте пример загрузочного файла:
Поля в файле делятся на обязательные (без них не загрузится маршрут) и вспомогательные (не участвуют в загрузке, нужны только для подсказок при оформлении файла).
Поля файла:
| Поле | Описание | Обязательность |
| Название маршрута | Название маршрута | Обязательное |
| Код оргструктуры | Код оргструктуры | Обязательное |
| Название оргструктуры | Название оргструктуры | Необязательное |
| Сотрудник | Основной сотрудник, привязанный к оргструктуре | Необязательное |
| Цикличность | Повторение маршрута, выбор одного из вариантов: 0 — нет цикличности, 1 — каждая неделя, 2 — каждые 2 недели, 3 — каждый месяц (каждые 4 недели) | Обязательное |
| Начало действия | Дата начала маршрута | Обязательное |
| Окончание действия | Дата окончания маршрута | Обязательное |
| Фиксированный порядок | Фиксированный порядок выполнения маршрута в указанном порядке точек: true — с соблюдением порядка точек, false — свободное выполнение маршрута; незаполненное значение в файле учитывается как false | Необязательное |
| Код ТТ | Код торговой точки | Обязательное |
| Фактическое название ТТ | Фактическое наименование торговой точки | Необязательное |
| Адрес ТТ | Фактический адрес торговой точки | Необязательное |
| Порядок ТТ | Порядок торговой точки на маршруте | Обязательное |
| Плановое время визита | Плановое время выполнения визита в торговой точке, в минутах | Необязательное |
| День недели, выделенный в 7 колонок: пн, вт, ср, чт, пт, сб, вс | Дни недели по порядку | Обязательное хотя бы одно |
Правила заполнения:
Важно! Не меняйте формат ячеек с датами — формат должен быть как в исходном шаблоне, иначе файл не прогрузится.
Период действия: Не должен превышать 1 год (366 дней).
Дни недели: Можно указать несколько дней. Если указана цикличность — маршрут повторяется в эти дни с заданной периодичностью. Если цикличность не указана (0) — маршрут действует только в первые даты совпадения всех указанных дней недели в рамках периода действия.
Даты: Дата начала действия не обязана совпадать с первым днем недели из списка. Маршрут начнет действовать с первого совпадения дня недели и даты в рамках указанного периода.
Сохраните заполненный файл и загрузите его в выделенную область:
Красная точка
рядом с иконкой загрузки означает, что загружается или загрузился новый файл.
Файл может быть загружен успешно, если абсолютно все строки в файле заполнены корректно. Если же в файле есть хотя бы 1 ошибка, то отобразится статус загрузки «Ошибка». В этом случае никакие данные из файла не загружаются, необходимо исправить ошибки в файле и повторить загрузку. В уведомление вы увидите подсказки о том, какие проблемы возникли с загруженным файлом. Ниже в статье будет описание каждой из ошибок.
Если ошибок в файле не найдено - маршрут загрузится в систему. Он получит уникальный ID маршрута. Данные из файла будут скопированы в таблицу справочника маршрутов и в детальный вид маршрута вместе с привязанными торговыми точками в нижнем меню.
Исправление ошибок в файле
Если в файле есть ошибки, то по клику на иконку загрузки файлов вы увидите уведомление о проблемах. Кликните на название файла, чтобы скачать файл и увидеть, какие ошибки возникли в процессе загрузки.
Если файл скачать нельзя, значит вы попытались загрузить некорректный формат файла. Например, PDF вместо таблицы.
Excel-файл с ошибками отличается от обычного тем, что в нём красным подсвечены проблемные строки.
В правой части таблицы появилась новая колонка «Ошибка». Кликните на поле в колонке «Ошибка» у проблемной строки, чтобы увидеть, почему файл не загрузился.
Основные проверки:
Обязательные поля: Все обязательные поля должны быть заполнены. Ошибка: Поле [название поля] обязательно к заполнению.
Формат полей: Значения должны соответствовать формату. Ошибка: Неправильное значение для столбца [название столбца].
Код оргструктуры: Если не найден или неактивен. Ошибка: Код оргструктуры не существует или неактивен.
Даты: Дата начала или окончания меньше сегодняшней. Ошибка: Даты маршрутов должны быть больше сегодняшней.
Даты: Дата начала позже даты окончания. Ошибка: Дата начала не может быть позже даты окончания.
Период: Превышает 1 год. Ошибка: Максимальный период действия маршрута не должен быть больше 1 года.
Код ТТ: Не найден или неактивен. Ошибка: Код торговой точки не существует или неактивен.
Код ТТ: ТТ не привязана к территории оргструктуры. Ошибка: ТТ отсутствует в территории сотрудника.
Порядок ТТ: Повторение порядка в рамках одного маршрута. Ошибка: Порядок ТТ в маршруте не может повторяться.
Пересечение дат (для режима «Импорт из файла»):
Если пересечение есть внутри файла: Для сотрудника есть пересечение дат расписания между маршрутами в файле.
Если пересечение с системой: Для сотрудника есть пересечение дат расписания между маршрутами в файле и в системе.
В режиме «с перезаписью» эта проверка с БД не проводится.
Удаление (деактивация) маршрутов
Функционал выборочной деактивации через файл удален. Теперь удаление расписаний маршрутов производится вручную через интерфейс.
Отфильтруйте таблицу нужным образом.
Выберите чекбоксами нужные строки (расписания) или используйте чекбокс «Выбрать все».
Нажмите кнопку удаления в экшн-баре.