Citypoint - контроль и аналитика автопарка

Skip to end of metadata
Go to start of metadata

Раздел предназначен для импорта данных в систему мониторинга СитиПоинт.

Важно!

Для активации услуги "Импорт данных" необходимо обратиться в обслуживающую организацию.

Перейти в раздел «Импорт данных» можно с помощью верхнего меню «Управление»  .

Раздел доступен для диспетчеров.

Раздел не доступен для агрегаторов.

Примечание. Имеется возможность изменения табличного вида, путем сортировки, перемещения и изменения ширины столбцов.

В таблице следующие столбцы:

  • Тип данных;
  • Дата загрузки;
  • Имя файла;
  • Статус загрузки.

Возможные статусы загруженных файлов:

  • Новый - отчет стоит в очереди на построение;
  • Завершено - объекты успешно импортированы;
  • Ошибка чтения файла - произошла ошибка при парсинге данных из файла.

Возможны действия:

  • Загрузить файл

Загрузка файла

Для загрузки файла необходимо нажать на кнопку  "Загрузить файл".

Доступны поля:

Тип данныхКлючевое поле
Импорт ТСVIN, Рег.номер
Контрольные зоныНазвание
Адреса и компанииНаименование компании, Номер компании
ЗаявкиНомер заявки
Импорт ТООбъект

Доступны действия:

  • Выберите файл

При нажатии на кнопку "Выберите файл" откроется окно выбора файла на ПК.

Возможно загрузить файлы со следующими расширениями:

  • .xlsx
  • .xlsm
  • .xlsb
  • .xls
  • .ods
  • .fods
  • .csv

Примечание. Допустимы пустые столбцы в файле. В файле должно быть не менее 4 столбцов и не менее 2 строк.

Файл конвертируется в формат Office Open XML и расширением .xlsx.

После выбора файла в окне «Загрузить файл»:

  • отображаются таблица, в таблице отображены первые три строки из файла;
  • появляется параметр «Первая строка с заголовками»;
  • выводится текст: «Показано первых строк: 3 Всего строк: х»;
  • над каждым столбцом отображается поле с выпадающим списком;
  • появляется кнопка «Импортировать файл»:

Для загрузки данных из файла, необходимо нажать на кнопку "Импортировать файл". После загрузки файла в систему, статус в столбце "Статус загрузки" будет "Новый".

После успешного завершения импортирования данных из файла в систему, статус в столбце "Статус загрузки" изменится на "Завершено".

Отчет о результатах импорта

Для записей в статусе «Завершено» доступен «Отчет о результатах импорта».

Отчет можно открыть кликом по одноименной иконке, в столбце «Статус загрузки».

В окне «Отчет о результатах импорта» по умолчанию отображаются строки, которые не были импортированы из-за ошибки.

В фильтре «Статус» можно выбрать:

  • Ошибка

  • Успешно импортировано

  • Все строки

Импорт адресов и компании

Пример файла:

Доступные значения в выпадающем списке для столбца:

  • Номер компании
  • Наименование компании
  • Номер Адреса
  • Адрес / Координаты
  • Название адреса
  • Контактное лицо
  • Телефон

Обязательные поля:

  • Номер компании
  • Наименование компании
  • Номер Адреса
  • Адрес / Координаты

Значения в полях:

  • «Номер компании» - номер компании, любые символы; указанный в файле номер не выводится в веб интерфейсе, в веб интерфейсе выводится внутренняя нумерация - автоинкримент.
  • «Наименование компании» - название компании, любые символы; выводится в интерфейсе, как название компании.
  • «Номер Адреса» - номер адреса в пределах компании, любые символы; указанный в файле номер не выводится в веб интерфейсе.
  • «Адрес / Координаты» - адрес, адрес может быть задан как символами, так и через координаты, выводится в веб интерфейсе в качестве названия адреса.
  • «Название адреса» - если пользователь хочет, чтобы в веб интерфейсе выводился не адрес, который был указан в поле «Адрес / Координаты», а произвольное значение (например: «Куст 1»), то необходимо заполнить поле «Название адреса», тогда геокодироваться адрес будет по значению в поле «Адрес / Координаты», но в веб интерфейсе название будет из поля «Название адреса».
  • «Контактное лицо» - название контакта, любые символы;
  • «Телефон» - телефон контактного лица, любые символы; символы, кроме: цифры, «(», «)», «-» - будут пропущены при парсинге (в веб интерфейсе невалидные символы не отобразяться).

Координаты необходимо вводить в формате:

  • yy.yy, xx.xx
  • yy.yy xx.xx
  • широта(Lat/ Latitude), долгота(Lon/ longitude)

Особенности:

  • При импорте адресов и компании создаются два объекта: адрес и компания.
  • При импорте адресов и компании возможно как создание адресов и компании, так и обновление - можно добавить адреса к уже существующей компании, для этого нужно указать в поле «Название компании» наименование этой компании (ключ = «Наименование компании») и в поле «Номер адреса» уникальный адрес в пределах этой компании (чтобы создался новый адрес , а не обновился уже существующий).
  • Чтобы адреса принадлежали одной компании, необходимо в поле «Наименование компании», если ключ «Наименование компании», или в поле «Номер компании», если ключ = «Номер компании» указать одно и то же значение для этих адресов.
  • Чтобы добавить несколько адресов в пределах одной компании, необходимо, чтобы в поле «Номер адреса» были разные значения для этих адресов.
  • Если один из адресов компании не прошел валидацию при импорте (ошибка импорта строки), то остальные адреса этой компании будут успешно импортированы.

Для успешного импорта необходимо:

  • Валидные значения в полях: «Номер компании», «Наименование компании», «Номер Адреса», «Адрес / Координаты»;
  • «Номер компании» должен быть уникальным в пределах данного владельца (данного аккаунта).
  • В поле «Адрес / Координаты» должен быть реальный адрес (адрес должен успешно геокодироваться) или координаты;

«Адрес / Координаты» и «Название адреса»:

  • Если заполнено поле «Адрес / Координаты», но не заполнено «Название адреса», то
    • адрес будет геокодирован по значению в поле «Адрес / Координаты» (получены координаты точки) и иметь название, равное результату геокодирования значения поля «Адрес / Координаты».
  • Если заполнено оба поля «Адрес / Координаты» и «Название адреса», то
    • адрес будет геокодирован по значению в поле «Адрес / Координаты» (получены координаты точки), но название адреса будет равно значению поля «Название адреса» (координаты могут не соответствовать названию).
  • Если в поле «Адрес / Координаты» в качестве адреса указаны координаты и не заполнено поле «Название адреса», то
    • адрес будет геокодирован по значению в поле «Адрес / Координаты» (получены координаты точки), в качестве названия адреса возьмется значение поля «Адрес / Координаты», то есть координаты.

Импорт заявок

Пример файла:

Доступные значения в выпадающем списке для столбца:

  • Номер заявки
  • Адрес
  • Компания
  • Дата и время прибытия
  • Дата и время отправления
  • Время стоянки
  • Задание
  • Тип ТС
  • Контактное лицо
  • Телефон
  • Комментарий
  • Груз
  • Объем груза 
  • Вес груза
  • Кол-во мест
  • Сборный груз
  • Негабаритный груз 
  • Стропальщики
  • Код грузополучателя 
  • Ширина - нет в импорте
  • Высота - нет в импорте, длина - нет в импорте

Обязательные поля:

  • Номер заявки
  • Адрес
  • Дата и время прибытия
  • Дата и время отправления
  • Задание

Значения полей:

  • «Номер заявки» - любое значение;
  • «Адрес» - значение, которое можно геокодировать;
  • «Компания» - любое значение;
  • «Дата и время прибытия» - формат: дд.мм.гггг чч:мм:сс;
  • «Дата и время отправления» - формат: дд.мм.гггг чч:мм:сс;
  • «Время стоянки» - положительные числа разделитель точка;
  • «Задание» - погрузка / выгрузка, Погрузка / Выгрузка, ПОГРУЗКА / ВЫГРУЗКА;
  • «Тип ТС» - тип из справочника, таблица LogisticsCarTypeAccountAssign (логистические типы ТС данного пользователя);
  • «Контактное лицо» - любое значение;
  • «Телефон» - цифры, допустимы символы: 'пробел', '-', '(', ')', все неразрешенные символы пропускаются при парсинге, строка импортируется.
  • «Комментарий» - любое значение;
  • «Груз» - любое значение;
  • «Объем груза» - любое значение (параметр удален);
  • «Вес груза» - любое значение;
  • «Кол-во мест» - любое значение;
  • «Сборный груз» - 1 / 0, true / false, yes / no, да / нет;
  • «Негабаритный груз» - 1 / 0, true / false, yes / no, да / нет;
  • «Стропальщики» - 1 / 0, true / false, yes / no, да / нет;
  • «Код грузополучателя» - любое значение;

Особенности:

  • При импорте заявок нет обновления данных, только создание.
  • Если в файле импорта есть несколько строк с одним значением в поле «Номер заявки» (у заявки несколько точек), и одна из точек не прошла валидацию при импорте (ошибка импорта строки), то остальные точки с тем же значением в поле «Номер заявки» импортированы не будут (если одна из точек заявки не импортирована, то заявка импортирована не будет).
  • При импорте, в полях «Задание», «Тип ТС», - учитывается локализация данных объектов, сравнивается значение полей в файле и перевод соответствующего ключа локализации.


Импорт контрольных зон

Пример файла:

Ограничения на входной файл:

  • Не должно быть пустыми: Наименование, Широта, Долгота, Радиус
  • Наименования зон не должны повторяться
  • Всегда убираем ведущие пробелы
  • Радиус в метрах от 5 до 10 000
  • Широта: от -90 до 90
  • Долгота: от -180 до +180
  • Скорость: от 5 до 250

Импорт Объектов (ТС)

Пример файла:

Доступные значения в выпадающем списке для столбцов:

Основная информация:

  • Рег. номер ТС
  • Модель
  • Инвентарный номер
  • VIN
  • Описание
  • Максимальная допустимая скорость в зимний период, км/ч
  • Максимальная допустимая скорость, км/ч
  • Минимальный порог изменения одометра, км
  • Порог нулевой скорости, км/ч


Свидетельство о регистрации:

  • Год выпуска
  • Кузов, №
  • Максимальная разрешенная масса, кг
  • Масса без нагрузки, к
  • Мощность двигателя
  • Объем двигателя
  • Серия и номер свидетельства о регистрации объекта
  • Собственник
  • Цвет по ПТС
  • Шасси, №
  • Экологический класс


Параметры:

  • Нормативный пробег между ТО
  • Периоде тех. обслуживания по времени, месяцы
  • Дата истечения срока действия доп. страховки (ОСАГО, КАСКО и т.п.)
  • Дата истечения срока действия основной страховки (ОСАГО)
  • Дата начала эксплуатации
  • Дата очередной калибровки тахографа
  • Количество дверей
  • Количество пассажирских мест
  • Лизинговая компания
  • Начало зимнего периода (дд-мм)
  • Окончание зимнего периода (дд-мм)
  • Промежуток времени, в течение которого объект считается на связи, с


Лимиты пробегов:

  • Лимит пробега: в выходной день
  • Лимит пробега: в год
  • Лимит пробега: в месяц
  • Лимит пробега: в неделю
  • Лимит пробега: в сутки
  • Лимит пробега: за все выходные дни в году
  • Лимит пробега: за все выходные дни в месяце

Обязательные поля:

  • Рег. номер

Особенности:

  • При импорте ТС происходит поиск значений в БД по выбранному ключу VIN или Рег.номер.
    • если значение не найдено, то создается новый Объект - транспортное средство
    • если удалось найти значение, то произойдет корректировка существующего транспортного средства
  • Процесс импорта логируется. Результат можно увидеть в системе Администрирования, в Истории действий пользователя.

Импорт ТО

Пример файла:

Доступные значения в выпадающем списке для столбцов:

  • Рег. номер ТС
  • VIN
  • Дата
  • Пробег
  • Напомнить за X дней
  • Напомнить за Y км


Обязательные поля:

  • Рег. номер или VIN
  • Пробег
  • Дата ТО

Особенности:

  • При импорте ТС происходит поиск значений в БД по выбранному ключу VIN или Рег.номер.
    • поиск ТС осуществляется или по Рег. номеру или по VIN номеру
    • если во входном файле присутствует как Рег.номер так и VIN номера, то поиск осуществляется по Рег.номеру.
  • Система определяет ТО как пройденное если для строки во входном файле отсутствуют данные: "Напомнить за X дней", "Напомнить за Y км".
    В противном случае ТО считается плановым.
  • Логика работы с пройденным ТО:
    • если есть похожее пройденное ТО (дата или пробег равны) - Обновляем пройденное ТО
    • если есть плановое ТО, а так есть пересечение ТО из файла и планового ТО. Закрываем плановое ТО (переводим в пройденное), создаем новое плановое ТО.
    • если ТО из файла является последним пройденным ТО для данной ТС (т.е. дата или пробег больше\равно пройденного в БД), при этом планового ТО нет. При необходимости корректируем пройденное ТО и обязательно Создаем плановое ТО, отталкиваясь от пройденного.
    • если ТО из файла является последним пройденным ТО для данной ТС и есть Плановое ТО. При необходимости корректируем пройденное ТО и Обновляем плановое ТО.


  • No labels