Импорт справочников и координат TMRefsImport — различия между версиями

Материал из TaxiMaster
Перейти к: навигация, поиск
м
(Изменен блок "импорт автомобилей+водителей")
Строка 130: Строка 130:
  
  
=== Импорт автомобилей+водителей ===
+
== Особенности импорта справочников==
  
На вкладке «Автомобили+Водители» при импорте автомобилей можно задать группу экипажей для импортируемых автомобилей. Есть два варианта: либо для всех импортируемых автомобилей задается одна группа экипажей, либо для каждой записи задается свое значение в колонке "'''Группа экипажей'''". Также для типов импорта: «Водители» и «Автомобили+Водители» тоже можно указывать для каждой записи свое значение группы экипажей.
+
=== Импорт автомобилей, водителей и экипажей ===
  
 +
При импорте на вкладке «Автомобили + Водители» доступны три варианта:
  
Для типов импорта «Автомобили» и «Автомобили+Водители в таблице для импорта можно указать значение параметра «'''Пассажирских мест'''», которое будет сохраняться в соответствующее поле карточки автомобиля.
+
* '''«Автомобили»''' — создаются только автомобили в справочнике автомобилей.
  
 +
* '''«Водители»''' — создаются водители и экипажи в справочниках водителей и экипажей. В выпадающем списке «Автомобиль» необходимо указать автомобиль, который будет назначен основным для всех создаваемых водителей и экипажей.
  
При импорте водителей, их телефоны автоматически получают признак «Использовать для отзвона».
+
* '''«Автомобили + Водители»''' — создаются автомобили, водители и экипажи в соответствующих справочниках.  
  
 +
 +
'''Дополнительно: '''
 +
 +
* Поле «Позывной» является обязательным при любом типе импорта. Для полей «Позывной» предусмотрена дополнительная возможность настройки. При нажатии правой кнопкой мыши на заголовок столбца, помимо выбора колонки из исходной таблицы, доступен пункт «Автогенерация». При его выборе позывные будут сгенерированы автоматически.
 +
 +
: Также доступна настройка «Уникальные позывные». Если флажок установлен, при импорте выполняется проверка на уникальность: система выдаст ошибку, если позывные повторяются внутри импортируемой таблицы или совпадают с уже существующими в справочнике.
 +
 +
 +
* В столбце «Телефоны» можно указать несколько номеров через запятую или точку с запятой — все они будут импортированы. Первый номер в списке будет считаться основным.
 +
: Все импортированные телефоны автоматически получают признак «Использовать для отзвона».
 +
 +
 +
* При импорте типов «Водители» и «Автомобили + Водители» поле «Группа экипажей» является обязательным. Группу экипажей можно задать одним из двух способов:
 +
** Указать общее значение в соответствующем поле — оно будет применено ко всем загружаемым объектам.
 +
** Указать группу для каждого объекта в соответствующем столбце таблицы импорта. Если в строке значение не указано, будет использована общая группа.
 +
 +
: При импорте типа «Автомобили + Водители» указанная группа экипажей будет присвоена только создаваемым экипажам. Автомобили будут загружены в справочник «Автомобили» без привязки к группе экипажей.
 +
 +
 +
[[Файл:TMRefsImport Автомобили и водители.png|центр]]
  
 
=== Импорт клиентов ===
 
=== Импорт клиентов ===

Версия 12:18, 20 февраля 2026

Панель управления ТМ - Утилиты - Импорт справочников.png
Интересная информация
Информация актуальна для Такси-Мастер 3.16


TMRefsImportутилита, позволяющая импортировать в справочники Такси-Мастер данные, представленные в текстовом виде.


Данная утилита находится в папке Utilities, которая расположена в папке с программой Такси-Мастер. Стандартный путь «C:\Program Files (x86)\Taxi-Master\Utilities\TMRefsImport.exe»


Все возникающие ошибки в работе утилиты импорта записываются в файл «Logs\TMRefsImport\TMRefsImport.log».


Справочники, поддерживающих импорт данных:


Работа с утилитой импорта данных

Подключение к базе данных

  1. В открывшемся окне «Подключение к базе данных» укажите путь к базе данных, в которую будут импортированы данные. При необходимости установите флажок «Сохранить настройки», чтобы сохранить введенный путь.
  2. Нажмите кнопку «Подключиться».


TMRefsImport Путь к БД.png


После подключения откроется окно, состоящее из двух частей:

  • в верхней части отображаются загруженные данные;
  • в нижней части выполняется сопоставление столбцов загруженных данных со столбцами таблицы базы данных.


TMRefsImport-импорт справочников.png


Загрузка данных

Импортируемые данные должны быть представлены в виде таблицы.


Загрузить импортируемые данные можно двумя способами:

  • скопировать данные из текстового файла или Excel и вставить их с помощью кнопки «Загрузить из буфера обмена».


  • загрузить данные непосредственно из файла Excel с помощью кнопки «Загрузить из файла». При импорте данных файл Excel должен быть закрыт. Поддерживаются форматы: xls, xlsx, ods, csv:
    • Если импорт выполняется из файлов xls, xlsx или ods и в файле содержится несколько листов, будет открыто дополнительное окно выбора листа, из которого будут импортированы данные.
    • При импорте из файла csv будет открыто окно настройки параметров импорта. В нём можно указать:
      • разделители полей для и для текста. По умолчанию для разделения полей используются точка с запятой: «;», для текста — кавычка: «"».
      • кодировку файла — ANSI или UTF8


После загрузки данные отобразятся в таблице в верхней части окна. Столбцы будут обозначены числами — 1, 2 и т. д..


TMRefsImport-импорт улиц-пример.png


Сопоставление столбцов

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


Для этого в таблице импорта нажмите правой кнопкой мыши на заголовке нужного столбца и в контекстном меню выберите столбец из загруженной исходной таблицы.


TMRefsImport-импорт улиц-пример2.png


Проверка данных

Если в данных для импорта заданы некорректные значения, соответствующие ячейки будут подсвечены красным цветом. При наведении курсора на такую ячейку отобразится всплывающая подсказка с описанием ошибки.

Например, в случае импорта улиц, красным будут подсвечиваться пустые ячейки.


Чтобы проверить данные на наличие ошибок, которые могут помешать импорту, нажмите кнопку «Перейти к ошибке». При каждом нажатии курсор будет перемещаться по очереди между всеми ячейками с некорректными данными.


Значения в таблице для непосредственного импорта можно исправить вручную: для перехода в режим редактирования дважды щелкните по ячейке мышью или выделите нужную строку и нажмите клавишу F2.

Для удаления строки используйте сочетание клавиш Ctrl+Delete.


TMRefsImport пример информации об ошибке.png


Если ошибки в таблице отсутствуют, отобразится сообщение «Ошибки не обнаружены».


TMRefsImport-импорт улиц-пример перейти к ошибке.png


Импорт данных

После настройки соответствия столбцов и проверки данных нажмите кнопку «Импорт». Данные будут добавлены в базу данных.


TMRefsImport-импорт улиц-пример-успешно.png


Особенности импорта справочников

Импорт автомобилей, водителей и экипажей

При импорте на вкладке «Автомобили + Водители» доступны три варианта:

  • «Автомобили» — создаются только автомобили в справочнике автомобилей.
  • «Водители» — создаются водители и экипажи в справочниках водителей и экипажей. В выпадающем списке «Автомобиль» необходимо указать автомобиль, который будет назначен основным для всех создаваемых водителей и экипажей.
  • «Автомобили + Водители» — создаются автомобили, водители и экипажи в соответствующих справочниках.


Дополнительно:

  • Поле «Позывной» является обязательным при любом типе импорта. Для полей «Позывной» предусмотрена дополнительная возможность настройки. При нажатии правой кнопкой мыши на заголовок столбца, помимо выбора колонки из исходной таблицы, доступен пункт «Автогенерация». При его выборе позывные будут сгенерированы автоматически.
Также доступна настройка «Уникальные позывные». Если флажок установлен, при импорте выполняется проверка на уникальность: система выдаст ошибку, если позывные повторяются внутри импортируемой таблицы или совпадают с уже существующими в справочнике.


  • В столбце «Телефоны» можно указать несколько номеров через запятую или точку с запятой — все они будут импортированы. Первый номер в списке будет считаться основным.
Все импортированные телефоны автоматически получают признак «Использовать для отзвона».


  • При импорте типов «Водители» и «Автомобили + Водители» поле «Группа экипажей» является обязательным. Группу экипажей можно задать одним из двух способов:
    • Указать общее значение в соответствующем поле — оно будет применено ко всем загружаемым объектам.
    • Указать группу для каждого объекта в соответствующем столбце таблицы импорта. Если в строке значение не указано, будет использована общая группа.
При импорте типа «Автомобили + Водители» указанная группа экипажей будет присвоена только создаваемым экипажам. Автомобили будут загружены в справочник «Автомобили» без привязки к группе экипажей.


TMRefsImport Автомобили и водители.png

Импорт клиентов

На вкладке «Клиенты» в таблице для импорта есть колонки «Группа экипажей по умолчанию» и «Доступные группы экипажей» (список названий групп, разделенных запятыми или точкой с запятой). Если при импорте клиентов окажется, что группа экипажей по умолчанию отсутствует в списке доступных групп экипажей, то она будет автоматически добавлена в список доступных групп.


Для импортируемых клиентов можно задавать вышестоящее подразделение. Есть два варианта: либо для всех импортируемых клиентов задается одно вышестоящее подразделение, либо для каждой записи определяется свое значение.


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


При импорте клиентов будет происходить проверка на дубликаты номеров телефонов. Если в базе данных уже есть неудаленный клиент с таким же номером телефона, то ячейка телефона будет подсвечиваться красным, и импорт данных будет невозможен.


Импорт районов и проездов между районами

Импорт данных в эти справочники имеет свои особенности, поэтому ниже рассмотрим последовательность действий более подробно.


Импорт районов и проездов между районами (справочники «Районы» и «Проезды между районами») связаны.


Интересная информация
При импорте проездов между районами в справочнике «Районы» уже должны быть заданы районы, и их имена должны точно соответствовать именам районов, между которыми заданы стоимости проезда.


Импорт районов

Откройте таблицу стоимости проезда между зонами в Excel. В нашем примере она будет выглядеть так:


Исходная матрица стоимости зон (Excel).png


Здесь имеется четыре зоны: А, Б, В и Г. Необходимо импортировать их в «Районы», для этого необходимо выделить все уникальные зоны, а также их типы. Для этого:

  1. Установите курсор на ячейку «A2».
  2. Нажмите Shift+End. Включится режим перехода в конец (об этом будет написано в статусной строке Excel).
  3. Нажмите Shift+. Выделится диапазон от «A2» до последней ячейки в столбце «A», таким образом выберутся все зоны.
  4. Если выделились не все зоны, а только видимые на странице, нажмите Shift+ еще раз.
  5. Нажмите Ctrl+C. Выделенный диапазон будет скопирован в буфер обмена.


Далее следует выполнить следующие действия:

  1. Открыть утилиту импорта данных.
  2. Открыть вкладку «Районы».
  3. Нажать кнопку «Загрузить из буфера обмена».
  4. В поле «Категория» выбрать нужное (город/загород).
  5. Нажать правой кнопкой мыши на «Название» и выбрать колонку.
  6. Нажать кнопку «Импорт».


TMRefsImport-импорт районов.png


Необходимо дождаться завершения импорта данных. После этого можно перейти к следующему шагу. При успешном импорте будет специальное сообщение:


TMRefsImport-Успешный импорт.png


При необходимости, Вы можете по аналогии импортировать и другие данные:

  • Код;
  • Цена посадки;
  • Цена остановки;
  • Цена высадки.


Импорт проездов между районами

Импортируем таблицу проездов между районами.


Проезды между районами (Excel).png


Для этого нужно выполнить следующие действия:

  1. В утилите импорта данных перейти на вкладку Проезды между районами.
  2. Нажать «Загрузить из файла» и выбрать нужный файл.
  3. Выбрать «Формат данных» «Матрица».
  4. Обязательно указать в какую группу добавить данные проезды между районами.
  5. Нажать «Импорт», чтобы импортировать данные. Импорт данных может занять какое-то время. Обязательно дождитесь завершения операции. При успешном завершении операции будет выведено уведомление об этом.


TMRefsImport-проезды между районами.png


Если районы отсутствуют

Если районы, проезды между которыми были вставлены в утилиту, отсутствуют в базе данных, то они будут выделены красным.


Это значит, что названия во внесенных данных не соответствуют названиям в справочнике «Районы», соответственно, что-то было сделано неверно.


В таком случае нужно добавить недостающие районы в справочник «Районы».


TMRefsImport-проезды между несуществующими районами.png


Утилиты Такси-Мастер
Утилиты для работы с базой данных

Утилита администрирования базы данныхУтилита резервного копированияУтилита импорта данных в справочникиCommonAPITest

История изменений

Чтобы посмотреть историю изменений - нажмите на кнопку «Развернуть» →


Версия Месяц Внесенное изменение
Такси-Мастер 3.16 Декабрь 2025 Добавлена возможность выполнять импорт координат для зон контроля проезда и зон действия местных тарифов.