Vials System - Справка



Содержание

Установка, настройка и запуск системы

  • Скачивая и используя данную авторскую разработку - систему оптимально планирования и контроля доставок грузов Vials System (далее Система), вы соглашаетесь со следующими условиями: Лицензия
  • Запросите доступ и скачайте дистрибутив (файлы) по ссылке: Загрузка
  • Требования к компьютеру:
    • Система состоит из двух функциональных частей: "Рабочее место диспетчера" (РМД) и "Мобильное приложение исполнителя" (МПИ).
    • Тестирование РМД осуществлялось на ОС Windows 7. Система будет работать и на более старших версиях ОС Windows, но вам, возможно, понадобится установить .NET Framework 3.5 (используйте ссылку: https://dotnet.microsoft.com/download/dotnet-framework/net35-sp1).
    • Для РМД необходим веб-браузер. Тестировалась работа Системы для: Mozilla Firefox, Opera, Google Chrome, Internet Explorer, Microsoft Edge.
    • МПИ тестировалось на мобильном устройстве под управлением ОС Андроид. МПИ также работает в веб-браузере, и тестировалось для: Mozilla Firefox (рекомендуется).
    • На мобильном устройстве исполнителя должна быть установлена какая-либо "почтовая программа по умолчанию" (приложение для отправки сообщений электронной почты). Для целей тестирования МПИ на компьютере диспетчера, необходимо также установить установить "почтовую программу по умолчанию".
  • Что еще нужно загрузить, помимо дистрибутива Vials System:
  • Инсталлятор Internet Information Services (IIS) Express:
    • Версия 7.5: https://www.microsoft.com/ru-ru/download/details.aspx?id=1038
    • Примечание: IIS Express необходим для работы РМД. Это программное обеспечение просто устанавливается - после скачивания и запуска выполняемого файла, нужно только нажимайть кнопку "Далее...", а после установки запомнить / записать директорию, в которую установили.
  • Получить бесплатный API-ключ для Google Maps:
    • https://developers.google.com/maps/documentation/javascript/get-api-key (или "Как получить API-ключ для Google Maps")
    • Примечание 1: для тестирования решения на прилагаемых в дистрибутиве демо-данных ключ не обязателен (но вы будете получать затененные изображения карты). Также, в особом случае, можно запросить ключ у меня.
    • Примечание 2: в дистрибутиве решения, предлагаемом с 1 октября 2020г. демонстрационный API-ключ задан в настройках Системы (вам не надо скачивать ключ самостоятельно, но следует иметь в виду, что этот ключ будут использовать и другие пользователи, тестирующие решение, и квота запросов к Google Карты на текущий день может быть израсходована).
  • Если захотите обновить дорожные графы для территорий РФ (в дистрибутиве прилагаются демо-данные для города Вашингтон, США):
  • Распакуйте архив и разместите его, например, на диске "C:".
https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vsh2.png
  • При необходимости измените содержимое командного файла "start.bat". Внимательно проверьте первую строку, а именно, местоположение IIS Express - установили ли вы этот компонент в папку "Program Files" или в "Program Files (x86)".
https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vsh3.png

https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vsh4.png
  • При необходимости измените ярлык "Vials System.url".
https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vsh5.png

https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vsh6.png
  • Запустите командный файл "start.bat" (откроется окно терминала IIS Express), запустите веб-интерфейс системы посредством ярлыка "Vials System.url". После этого вы сможете использовать РМД.
https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vsh7.png

https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vsh8.png
  • В РМД задайте обязательные параметры настройки.
https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vsh9.png

https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vsh1.png
  • Примечания:
    • Для рассылки электронных маршрутных листов исполнителям можно использовать различные почтовые сервисы. Тестирование проводилось на Google Gmail и Mail.ru. При использовании первого сервиса, необходимо в аккаунте пользователя Google разрешить доступ сторонним приложениям (см. "Вход в аккаунт Google через небезопасные приложения" и скриншоты ниже). Для использования второго сервиса, дополнительные настройки не предполагаются (достаточно указать параметры, аналогичные представленным на скриншоте выше).

  • Приступайте к работе:
    • Проверьте функционирование системы при помощи тестовых задач "task (10).xml" (содержит 10 заказов доставки) и "task (240).xml" (содержит 240 заказов доставки).
    • Для реальных задач используйте шаблон "task_template.xlsx": редактируйте задачу в табличном редакторе Microsoft Excel, сохраняйте задачу в формате для загрузки - XML.

Аспекты использования системы

Производительность

  • Продолжительность расчета плана зависит от (помимо параметров вашего компьютерного  "железа"):
    • Если вы обновили дорожный граф, то при первом его использовании система проводит вспомогательную индексацию, на что уходит приличное время и требуются значительные вычислительные ресурсы.
https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vsh10.png
      • В дистрибутиве системы содержится уже проиндексированный граф (карта) Вашингтона (округ Колумбия).
      • В этой связи предпочтительно использовать граф нужного региона: не всей страны, а, например, штата или республики. Примечание: если все-таки работаете с большими дорожными графами, то старайтесь использовать "железо" помощнее и увеличьте значения параметров "Тайм-аут сценария" и "Максимальное ограничение памяти JAVA".
    • Если в вашей задаче встретились новые адреса точек доставки, то требуется время на их геокодирование.
    • Если ваша задача содержит уже "знакомые" системе адреса точек доставки, то выполняется только расчет плана, и это является наиболее быстрым сценарием использования.

Размерность задач

  • Вы можете менять параметры настройки (см. скриншот выше) "Макс. количество заказов" и "Макс. количество ТС (транспортных средств)" произвольным образом.
  • Также вы можете менять параметр "Лимит геокодинга". Этот параметр ограничивает суточное количество запросов к Google Карты для преобразования адресов точек доставки в геокоды (координаты - широту и долготу), необходимые для работы алгоритма оптимального планирования.
    • Используя бесплатный API-ключ, вы ограничены значением в 2500. Это означает для вас, что у вас есть возможность ежедневно обрабатывать 2500 новых (не зарегистрированных в базе данных системы) точек доставки. Другими словами, это означает возможность прироста вашей базы грузополучателей до 2500 в сутки.
    • Если вы используете платный API-ключ, то можно установить значение данного параметра свыше 2500. Однако будьте внимательны: каждый запрос для вас - это расход денежных средств, поэтому в административных целях желательно ограничить значение данного параметра разумными пределами.
  • Параметр "Лимит МР (матрицы расстояний)" в данной версии системы игнорируется (и может быть задан произвольно). Поскольку используется дорожный граф OpenStreetMap, который вы бесплатно скачиваете и используете локально на своем компьютере, никаких административных и экономических последствий не возникает, так как система не обращается с запросами на серверы внешних провайдеров для получения расстояний между точками маршрута.
    • Примечание на будущее: если перейдете на версию системы, в которой для этих целей будут использоваться внешние геоинформационные провайдеры (например, Google Карты, Bing Карты, Яндекс Карты и др.), то задайте разумное ограничение данного параметра.
      • Пример: если оцениваемое вами максимальное ежедневное количество точек доставки 50 (каждый день - до 50 "новых" + "старых" грузополучателей), то значение параметра следует установить на 2500 (для работы алгоритма оптимального планирования может понадобится до 50 x 50 запросов к внешнему провайдеру для получения новых отрезков пути).
      • При использовании бесплатного API-ключа Google Карты, вы ограничены 2500 запросами в сутки. Но повторю еще раз: данная версия системы работает только с графами OpenStreetMap, поэтому API-ключ для матрицы расстояний никакой не требуется.

Интерфейс пользователя (РМД): основные команды

  • Основные функции системы доступны через веб-интерфейс и несколько командных кнопок:
https://sites.google.com/site/erpacademies/rd/eals/ealsweb/vialshelp/vs_main_win.png

  • Доступ к кнопкам открывается (они становятся активными) по мере выполнения основного сценария применения системы:
    • Загрузка задачи в систему -> Диагностика задачи -> Расчет плана доставки -> Коррекция плана (привязка исполнителя к заказу) + Пересчет плана -> Сохранение в папку на компьютере результатов планирования или Рассылка электронных маршрутных листов исполнителям -> Контроль выполнения задачи -> Удаление данных (при необходимости).