TMRefsImport — различия между версиями

Текущая версия на 13:47, 29 ноября 2024

Информация актуальна для Такси-Мастер 3.15

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

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

Информация должна быть разделена по столбцам. Можно скопировать данные из Excel и вставить их в утилиту или импортировать прямо из файла. На данный момент возможен импорт в несколько справочников.

Узнать список поддерживаемых справочников можно из набора вкладок в TMRefsImport.

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

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

Как работать с утилитой?

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

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

Далее надо нажать кнопку «Подключиться».

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

Верхняя часть - отображение введенных данных.
Нижняя часть - сопоставление столбцов введенных данных со столбцами таблицы базы данных.

Данные должны быть представлены в виде таблицы значений. Столбцы разделяются символом табуляции (клавиша «Tab»), а строки - символом абзаца (клавиша «Enter»).

Чтобы ввести данные, скопируйте их из текстового файла или Excel и вставьте (кнопкой «Загрузить из буфера обмена» или комбинацией клавиш Ctrl+V) или загрузите прямо из файла.

Для импорта файл должен быть закрыт. Поддерживаются следующие форматы: xls, xlsx, ods, csv. При импорте из xls, xlsx, ods может дополнительно всплывать окно для выбора листа, из которого надо импортировать данные, если в файле несколько листов. При импорте из csv будет всплывать окно для указания параметров импорта, там можно будет выбрать разделители для полей и для текста (по умолчанию ; и "), а также кодировку: ANSI или UTF8.

Данные отобразятся в верхней таблице, а ее столбцы будут обозначены числами (1, 2 и т. д.).

Для примера возьмем список улиц, вставленный из файла Excel, где каждая новая строка в столбце — это отдельная улица.

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

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

Данные из выбранного столбца отобразятся в нижней части утилиты.

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

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

Теперь нужно нажать кнопку «Импорт». После этого данные будут добавлены в базу данных.

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

Какие справочники можно импортировать?

На данный момент утилита импорта справочников позволяет импортировать данные в следующие справочники:

Справочник "Улицы".
Справочник "Клиенты".
Справочник "Районы" — должен быть импортирован до импорта следующего справочника, наименования зон должны совпадать!
Справочник "Проезды между районами".
Статистика по телефонам.
Справочник "Дисконтные карты".
Координаты города, района, стоянки.
Справочник "Автомобили".
Справочник "Водители".
Справочник "Экипажи" (Автомобили + Водители).
Заказы.
Пункты и стоянки.

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

Справочники имеют общий принцип установления соответствия колонок из исходной таблицы данных, загруженных из файла или из буфера обмена, и таблицы для непосредственного импорта данных.

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

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

Импорт автомобилей+водителей

На вкладке "Автомобили+Водители" при импорте автомобилей можно задать группу экипажей для импортируемых автомобилей. Есть два варианта: либо для всех импортируемых автомобилей задается одна группа экипажей, либо для каждой записи задается свое значение в колонке "Группа экипажей". Также для типов импорта: "Водители" и "Автомобили+Водители" тоже можно указывать для каждой записи свое значение группы экипажей.

Для типов импорта "Автомобили" и "Автомобили+Водители" в таблице для импорта можно указать значение параметра "Пассажирских мест", которое будет сохраняться в соответствующее поле карточки автомобиля.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ Строка 1: / Строка 1: @@
-{{info|Данная утилита находится в папке Utilities, которая расположена в папке с программой Такси-Мастер.
+{{info|Информация актуальна для Такси-Мастер 3.15}}
-Стандартный путь {{путь|C:\Program Files\TMEnterprise\Utilities\TMRefsImport.exe}}}}
+[[Файл:Панель управления ТМ - Утилиты - Импорт справочников.png|center]]
 '''{{PAGENAME}}''' — [[Утилиты Такси-Мастер|утилита]], позволяющая импортировать в [[справочник]]и [[{{ТМ}}]] данные, представленные в текстовом виде.
-Столбцы должны быть разделены знаком {{code|Tab}}.
-Вы можете скопировать данные из Excel и вставить их в утилиту или импортировать прямо из файла.
+Информация должна быть разделена по столбцам.
-На данный момент возможен импорт в несколько [[справочник]]ов.
+Можно скопировать данные из Excel и вставить их в утилиту или импортировать прямо из файла. На данный момент возможен импорт в несколько [[справочник]]ов.
-Вы можете узнать список поддерживаемых справочников из соответствующего раздела данной статьи, а также из набора вкладок в Вашей версии TMRefsImport.
+Узнать список поддерживаемых справочников можно из набора вкладок в TMRefsImport.
+Данная утилита находится в папке Utilities, которая расположена в папке с программой Такси-Мастер.
+Стандартный путь {{путь|C:\Program Files (x86)\Taxi-Master\Utilities\TMRefsImport.exe}}
+Все возникающие ошибки в работе утилиты импорта записываются в файл {{путь|Logs\TMRefsImport\TMRefsImport.log}}.
 == Как работать с утилитой? ==
 Перед началом работы потребуется указать путь к базе данных, в которую впоследствии будет внесена информация.
-После этого открывается новое окно, разделенное на две части: в верхней — ввод данных; в нижней — сопоставление столбцов введенных данных столбцам таблицы базы данных.
+Чтобы сохранить введенный путь к базе данных, можно установить флажок {{checkbox|Сохранить настройки}}.
+Далее надо нажать кнопку {{button|Подключиться}}.
 [[Файл:TMRefsImport_Путь к БД.png|center]]
-Укажите путь к базе данных, а затем нажмите кнопку {{button|Подключиться}}.
+После этого откроется новое окно, которое состоит из двух частей:
-Чтобы сохранить путь к базе данных установите флажок {{checkbox|Сохранить настройки}}.
+* Верхняя часть - отображение введенных данных.
-После этого откроется новое окно, которое состоит из двух частей: верхняя часть для ввода данных; нижняя — для сопоставления столбцов введенных данных столбцам таблицы базы данных.
+* Нижняя часть - сопоставление столбцов введенных данных со столбцами таблицы базы данных.
 [[Файл:TMRefsImport-импорт справочников.png|center]]
-Данные должны быть в виде значений, разделенных символом табуляции (клавиша {{code|Tab}}). Каждая строка текста — одна строка таблицы.
+Данные должны быть представлены в виде таблицы значений. Столбцы разделяются символом табуляции (клавиша {{code|Tab}}), а строки - символом абзаца (клавиша {{поле|Enter}}).
-Чтобы ввести в нее данные, скопируйте их из текстового файла или Excel и вставьте (кнопкой {{button|Загрузить из буфера обмена}} или комбинацией клавиш {{key|Ctrl}}+{{key|V}}) или загрузите прямо из файла.
+Чтобы ввести данные, скопируйте их из текстового файла или Excel и вставьте (кнопкой {{поле|Загрузить из буфера обмена}} или комбинацией клавиш {{key|Ctrl}}+{{key|V}}) или загрузите прямо из файла.
-{{info| Для импорта из файла поддерживаются следующие форматы: xls, xlsx, ods, csv. При импорте из xls, xlsx, ods может дополнительно всплывать окно для выбора листа, из которого надо импортировать данные, если в файле несколько листов. При импорте из csv будет всплывать окно для указания параметров импорта, там можно будет выбрать разделители для полей и для текста (по умолчанию ; и "), а также кодировку: ANSI или UTF8.}}
+{{info| Для импорта файл должен быть закрыт. Поддерживаются следующие форматы: xls, xlsx, ods, csv. При импорте из xls, xlsx, ods может дополнительно всплывать окно для выбора листа, из которого надо импортировать данные, если в файле несколько листов. При импорте из csv будет всплывать окно для указания параметров импорта, там можно будет выбрать разделители для полей и для текста (по умолчанию ; и "), а также кодировку: ANSI или UTF8.}}
 Данные отобразятся в верхней таблице, а ее столбцы будут обозначены числами (1, 2 и т. д.).
@@ Строка 32: / Строка 41: @@
 [[Файл:TMRefsImport-импорт улиц-пример.png|center]]
-Далее в поле {{field|Поле наименования}} укажем номер столбца, который необходимо импортировать. В нашем случае столбец только один, соответственно, его номер мы и укажем. Теперь нажмем кнопку {{button|Импорт}}.
+Далее нужно настроить соответствие колонок из исходной таблицы данных, загруженных из файла или из буфера обмена, и таблицы для непосредственного импорта данных.
+Для этого нужно в таблице для непосредственного импорта данных нажать правой кнопкой мыши по шапке какого-либо столбца, и выбрать в контекстном меню колонку из таблицы исходных данных.
+[[Файл:TMRefsImport-импорт улиц-пример2.png|center]]
+Данные из выбранного столбца отобразятся в нижней части утилиты.
+Можно проверить на наличие ошибок, которые могут помешать импорту, нажав {{поле|Перейти к ошибке}}. При нажатии данной кнопки курсор в таблице будет перемещаться на следующую ячейку с некорректными данными. А если ошибок нет, то будет выводиться сообщение "Ошибки не обнаружены".
+[[Файл:TMRefsImport-импорт улиц-пример перейти к ошибке.png|center]]
+Теперь нужно нажать кнопку {{поле|Импорт}}. После этого данные будут добавлены в базу данных.
 [[Файл:TMRefsImport-импорт улиц-пример-успешно.png|center]]
-Готово!
 == Какие справочники можно импортировать? ==
 На данный момент утилита импорта справочников позволяет импортировать данные в следующие справочники:
-# [[Справочник «Улицы»]].
+# [[Справочник «Улицы»|Справочник "Улицы"]].
-# [[Справочник "Клиенты"|Справочник «Клиенты»]].
+# [[Справочник "Клиенты"]].
-# [[Справочник «Районы»]] — должен быть импортирован '''до''' импорта следующего справочника, наименования зон должны совпадать!
+# [[Справочник «Районы»|Справочник "Районы"]] — должен быть импортирован '''до''' импорта следующего справочника, наименования зон должны совпадать!
-# [[Справочник «Проезды между районами»]].
+# [[Справочник «Проезды между районами»|Справочник "Проезды между районами"]].
-# [[Справочник «Телефоны»]].
 # Статистика по телефонам.
-# Статистика по дисконтным картам.
+# [[Справочник "Дисконтные карты"]].
-# Координаты города.
+# Координаты города, района, стоянки.
+# [[Справочник "Автомобили"]].
+# [[Справочник "Водители"]].
+# [[Справочник "Экипажи"]] (Автомобили + Водители).
+# Заказы.
+# Пункты и стоянки.
+== Импорт справочников ==
+Справочники имеют общий принцип установления соответствия колонок из исходной таблицы данных, загруженных из файла или из буфера обмена, и таблицы для непосредственного импорта данных.
+Для этого нужно в таблице для непосредственного импорта данных нажать правой кнопкой мыши по шапке какого-либо столбца, и выбрать в контекстном меню колонку из таблицы исходных данных.
+[[Файл:TMRefsImport-импорт справочников общее.png|center]]
+=== Импорт автомобилей+водителей ===
+На вкладке "Автомобили+Водители" при импорте автомобилей можно задать группу экипажей для импортируемых автомобилей. Есть два варианта: либо для всех импортируемых автомобилей задается одна группа экипажей, либо для каждой записи задается свое значение в колонке "'''Группа экипажей'''". Также для типов импорта: "Водители" и "Автомобили+Водители" тоже можно указывать для каждой записи свое значение группы экипажей.
+Для типов импорта "Автомобили" и "Автомобили+Водители" в таблице для импорта можно указать значение параметра "'''Пассажирских мест'''", которое будет сохраняться в соответствующее поле карточки автомобиля.
+При импорте водителей, их телефоны автоматически получают признак "Использовать для отзвона".
+=== Импорт клиентов ===
+На вкладке "Клиенты" в таблице для импорта есть колонки "'''Группа экипажей по умолчанию'''" и "'''Доступные группы экипажей'''" (список названий групп, разделенных запятыми или точкой с запятой). Если при импорте клиентов окажется, что группа экипажей по умолчанию отсутствует в списке доступных групп экипажей, то она будет автоматически добавлена в список доступных групп.
-== Импорт районов и проездов между районами ==
+Для импортируемых клиентов можно задавать вышестоящее подразделение. Есть два варианта: либо для всех импортируемых клиентов задается одно вышестоящее подразделение, либо для каждой записи определяется свое значение.
-Импорт районов и проездов между районами (справочники [[Справочник «Районы»|«Районы»]] и [[Справочник «Проезды между районами»|«Проезды между районами»]]) связаны.
-'''При импорте проездов между районами в справочнике «Районы» уже должны быть заданы районы, и их имена должны точно соответствовать именам районов, между которыми заданы стоимости проезда.'''
+При импорте клиентов можно указать признак "'''Собственный счет'''", который будет определять наличие собственного счета для всех импортируемых клиентов.
-Импорт данных в эти справочники несколько отличается от импорта в другие справочники, поэтому ниже мы рассмотрим необходимую последовательность действий более подробно.
+При импорте клиентов будет происходить проверка на дубликаты номеров телефонов. Если в базе данных уже есть неудаленный клиент с таким же номером телефона, то ячейка телефона будет подсвечиваться красным, и импорт данных будет невозможен.
-=== Импорт районов ===
+=== Импорт районов и проездов между районами ===
-Откройте таблицу стоимости проезда между зонами в Excel.В нашем примере она будет выглядеть так:
+Импорт данных в эти справочники имеет свои особенности, поэтому ниже рассмотрим последовательность действий более подробно.
+Импорт районов и проездов между районами (справочники [[Справочник «Районы»|"Районы"]] и [[Справочник «Проезды между районами»|"Проезды между районами"]]) связаны.
+'''При импорте проездов между районами в справочнике "Районы" уже должны быть заданы районы, и их имена должны точно соответствовать именам районов, между которыми заданы стоимости проезда.'''
+==== Импорт районов ====
+Откройте таблицу стоимости проезда между зонами в Excel. В нашем примере она будет выглядеть так:
 [[Файл:Исходная матрица стоимости зон (Excel).png|center]]
-Здесь имеется четыре зоны: А, Б, В и Г. Необходимо импортировать их в [[справочник «Районы»]], для этого необходимо выделить все уникальные зоны, а также их типы. Для этого:
+Здесь имеется четыре зоны: А, Б, В и Г. Необходимо импортировать их в [[справочник «Районы»|"Районы"]], для этого необходимо выделить все уникальные зоны, а также их типы. Для этого:
 # Установите курсор на ячейку {{code|A2}}.
@@ Строка 75: / Строка 121: @@
 # Открыть вкладку {{tab|Районы}}.
 # Нажать кнопку {{button|Загрузить из буфера обмена}}.
-# В поле {{field|Название}} ввести число {{code|1}}.
+# В поле {{поле|Категория}} выбрать нужное (город/загород).
-# В поле {{field|Категория}} выбрать нужное (город/загород).
+# Нажать правой кнопкой мыши на {{поле|Название}} и выбрать колонку.
 # Нажать кнопку {{button|Импорт}}.
 [[Файл:TMRefsImport-импорт районов.png|center]]
-Необходимо дождаться завершения импорта данных. После этого можно перейти к следующему шагу. При успешном импорте Вы увидите специальное сообщение:
+Необходимо дождаться завершения импорта данных. После этого можно перейти к следующему шагу. При успешном импорте будет специальное сообщение:
 [[Файл:TMRefsImport-Успешный импорт.png|center]]
@@ Строка 91: / Строка 137: @@
 * Цена высадки.
-=== Импорт проездов между районами ===
+==== Импорт проездов между районами ====
-Для того, чтобы импортировать матрицу проездов между районами, которая выглядит примерно так:
+Импортируем таблицу проездов между районами.
 [[Файл:Проезды между районами (Excel).png|center]]
-Выполните следующие действия:
+Для этого нужно выполнить следующие действия:
+# В утилите импорта данных перейти на вкладку '''Проезды между районами'''.
-# Откройте утилиту импорта данных.
+# Нажать {{поле|Загрузить из файла}} и выбрать нужный файл.
-# Откройте вкладку {{button|Проезды между районами}}.
+# Выбрать {{поле|Формат данных}} "Матрица".
-# Выберете '''Формат данных''' "Матрица".
+# Обязательно указать в какую группу добавить данные проезды между районами.
-# Нажмите '''Загрузить из файла''' и выберете нужный файл.
+# Нажать {{поле|Импорт}}, чтобы импортировать данные. Импорт данных может занять какое-то время. Обязательно дождитесь завершения операции. При успешном завершении операции будет выведено уведомление об этом.
-# Обязательно укажите, в какую группу следует включить данные проезды между районами.
 [[Файл:TMRefsImport-проезды между районами.png|center]]
-Нажмите {{button|Импорт}}, чтобы импортировать данные. Если таблица была большая, и, следовательно, список проездов получился большой, то импорт данных может занять продолжительное время. Обязательно дождитесь завершения операции.
+===== Если районы отсутствуют =====
+Если районы, проезды между которыми были вставлены в утилиту, отсутствуют в базе данных, то они будут выделены красным.
-При успешном завершении операции Вы увидите уведомление:
-[[Файл:TMRefsImport-Успешный импорт2.png|center]]
-При необходимости, Вы можете по аналогии импортировать и другие данные, а именно поле Примечание.
+Это значит, что названия во внесенных данных не соответствуют названиям в [[Справочник «Районы»|справочнике "Районы"]], соответственно, что-то было сделано неверно.
-==== Если районы отсутствуют ====
+В таком случае нужно добавить недостающие районы в справочник "Районы".
-Если районы, проезды между которыми были вставлены в утилиту, отсутствуют, они будут выделены красным:
 [[Файл:TMRefsImport-проезды_между_несуществующими_районами.png|center]]
-Это значит, что названия во внесенных данных не соответствуют названиям в справочнике  [[Справочник «Районы»|справочнике «Районы»]], соответственно, что-то было сделано неверно. В данном случае следует очистить справочник «Районы» и [[#Импорт районов и проездов между районами|начать процесс импорта с самого начала.
-]].
-== Импорт справочников [[справочник "Клиенты"|"Клиенты"]] и [[Справочник «Телефоны»|"Телефоны"]] ==
-Импорт в данные справочник производится немного иначе, чем в общем случае. Здесь для выбора колонки, из которой будет произведен импорт, следует выполнить следующие действия:
-# Кликнуть левой кнопкой мыши по заголовку колонки в нижней таблице
-# Выбрать номер столбца верхней таблицы, который необходимо перенести в эту колонку.
-# Указать группу, в которую будут включены импортируемые клиенты.
-# Нажать кнопку {{button|Импорт}}.
-Ниже показан пример импорта справочника [[справочник "Клиенты"|"Клиенты"]].
-[[Файл:TMRefsImport-импорт Клиентов.png|center]]
-== Импорт остальных справочников ==
-Все остальные справочники импортируются по общему принципу: следует сопоставить номера столбцов из области '''1''', колонкам в области '''2'''. Например, данные об общем количестве заказов находятся в колонке №4 в верхней таблице, следовательно в поле {{field|Всего заказов}} в нижней таблице нужно указать номер этой колонки.
-[[Файл:TMRefsImport-Общий принцип импорта.png|center]]
-{{info|Обратите внимание! Для импорта статистики по дисконтным картам обязательно нужно указать ИД типа карты!}}
 {{утилиты}}
@@ Строка 148: / Строка 164: @@
 [[Категория:Утилиты]]
 [[Категория:Импорт и экспорт]]
-[[Категория:ТМ2]]