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

Материал из TaxiMaster
Перейти к: навигация, поиск
(Ссылки)
(не показано 14 промежуточных версий этого же участника)
Строка 1: Строка 1:
{{info|Данная утилита находится в папке Utilities, которая расположена в папке с программой Такси-Мастер.
+
[[Файл:Панель управления ТМ - Утилиты - Импорт справочников.png|center]]
Стандартный путь {{путь|C:\Program Files\TMEnterprise\Utilities\TMRefsImport.exe}}}}
 
  
 
'''{{PAGENAME}}''' — [[Утилиты Такси-Мастер|утилита]], позволяющая импортировать в [[справочник]]и [[{{ТМ}}]] данные, представленные в текстовом виде.
 
'''{{PAGENAME}}''' — [[Утилиты Такси-Мастер|утилита]], позволяющая импортировать в [[справочник]]и [[{{ТМ}}]] данные, представленные в текстовом виде.
Столбцы должны быть разделены знаком {{code|Tab}}.
+
 
Вы можете скопировать данные из Excel и вставить их в утилиту.
+
Информация должна быть разделена по столбцам.  
На данный момент возможен импорт в несколько [[справочник]]ов.
+
Можно скопировать данные из Excel и вставить их в утилиту или импортировать прямо из файла. На данный момент возможен импорт в несколько [[справочник]]ов.
Вы можете узнать список поддерживаемых справочников из соответствующего раздела данной статьи, а также из набора вкладок в Вашей версии TMRefsImport.
+
 
 +
Узнать список поддерживаемых справочников можно из набора вкладок в TMRefsImport.
 +
 
 +
Данная утилита находится в папке Utilities, которая расположена в папке с программой Такси-Мастер.
 +
Стандартный путь {{путь|C:\Program Files (x86)\Taxi-Master\Utilities\TMRefsImport.exe}}
  
 
== Как работать с утилитой? ==
 
== Как работать с утилитой? ==
Перед началом работы потребуется указать [[путь к базе данных]], в которую впоследствии будет внесена информация.
+
Перед началом работы потребуется указать путь к базе данных, в которую впоследствии будет внесена информация.  
После этого открывается новое окно, разделенное на две части: в верхней — ввод данных; в нижней — сопоставление столбцов введенных данных столбцам таблицы [[База данных {{ТМ}}|базы данных]].
+
 
 +
Чтобы сохранить введенный путь к базе данных, можно установить флажок {{checkbox|Сохранить настройки}}.
 +
 
 +
Далее надо нажать кнопку {{button|Подключиться}}.
  
 
[[Файл:TMRefsImport_Путь к БД.png|center]]
 
[[Файл:TMRefsImport_Путь к БД.png|center]]
  
Укажите путь к базе данных, а затем нажмите кнопку {{button|Подключиться}}.
 
Чтобы сохранить путь к базе данных установите флажок {{checkbox|Сохранить настройки}}.
 
 
После этого откроется новое окно, которое состоит из двух частей: верхняя часть для ввода данных; нижняя — для сопоставления столбцов введенных данных столбцам таблицы базы данных.
 
После этого откроется новое окно, которое состоит из двух частей: верхняя часть для ввода данных; нижняя — для сопоставления столбцов введенных данных столбцам таблицы базы данных.
  
Строка 22: Строка 26:
 
Данные должны быть в виде значений, разделенных символом табуляции (клавиша {{code|Tab}}). Каждая строка текста — одна строка таблицы.
 
Данные должны быть в виде значений, разделенных символом табуляции (клавиша {{code|Tab}}). Каждая строка текста — одна строка таблицы.
  
Чтобы ввести в нее данные, скопируйте их из текстового файла или Excel и вставьте (кнопкой {{button|Вставить}} или комбинацией клавиш {{key|Ctrl}}+{{key|V}}).
+
Чтобы ввести в нее данные, скопируйте их из текстового файла или Excel и вставьте (кнопкой {{button|Загрузить из буфера обмена}} или комбинацией клавиш {{key|Ctrl}}+{{key|V}}) или загрузите прямо из файла.
 +
 
 +
{{info| Для импорта из файла поддерживаются следующие форматы: xls, xlsx, ods, csv. При импорте из xls, xlsx, ods может дополнительно всплывать окно для выбора листа, из которого надо импортировать данные, если в файле несколько листов. При импорте из csv будет всплывать окно для указания параметров импорта, там можно будет выбрать разделители для полей и для текста (по умолчанию ; и "), а также кодировку: ANSI или UTF8.}}
 +
 
 
Данные отобразятся в верхней таблице, а ее столбцы будут обозначены числами (1, 2 и т. д.).
 
Данные отобразятся в верхней таблице, а ее столбцы будут обозначены числами (1, 2 и т. д.).
  
Для примера возьмем список улиц, скопированный из листа Excel, где каждая новая строка в столбце — это отдельная улица.  
+
Для примера возьмем список улиц, вставленный из файла Excel, где каждая новая строка в столбце — это отдельная улица.  
  
 
[[Файл:TMRefsImport-импорт улиц-пример.png|center]]
 
[[Файл:TMRefsImport-импорт улиц-пример.png|center]]
Строка 38: Строка 45:
 
На данный момент утилита импорта справочников позволяет импортировать данные в следующие справочники:
 
На данный момент утилита импорта справочников позволяет импортировать данные в следующие справочники:
  
# [[Справочник «Улицы»]].
+
# [[Справочник «Улицы»|Справочник "Улицы"]].
# [[Справочник "Клиенты"|Справочник «Клиенты»]].
+
# [[Справочник "Клиенты"]].
# [[Справочник «Районы»]] — должен быть импортирован '''до''' импорта следующего справочника, наименования зон должны совпадать!
+
# [[Справочник «Районы»|Справочник "Районы"]] — должен быть импортирован '''до''' импорта следующего справочника, наименования зон должны совпадать!
# [[Справочник «Проезды между районами»]].
+
# [[Справочник «Проезды между районами»|Справочник "Проезды между районами"]].
# [[Справочник «Телефоны»]].
+
# [[Справочник «Телефоны»|Справочник "Телефоны"]].
 
# Статистика по телефонам.
 
# Статистика по телефонам.
# Статистика по дисконтным картам.
+
# [[Справочник "Дисконтные карты"]].
# Координаты города.
+
# Координаты города, района, стоянки.
 +
# [[Справочник "Автомобили"]].
 +
# [[Справочник "Водители"]].
 +
# [[Справочник "Экипажи"]] (Автомобили + Водители).
 +
# Заказы.
 +
# Пункты и стоянки.
  
 
== Импорт районов и проездов между районами ==
 
== Импорт районов и проездов между районами ==
Строка 52: Строка 64:
 
'''При импорте проездов между районами в справочнике «Районы» уже должны быть заданы районы, и их имена должны точно соответствовать именам районов, между которыми заданы стоимости проезда.'''
 
'''При импорте проездов между районами в справочнике «Районы» уже должны быть заданы районы, и их имена должны точно соответствовать именам районов, между которыми заданы стоимости проезда.'''
  
Импорт данных в эти справочники несколько отличается от импорта в другие справочники, поэтому ниже мы рассмотрим необходимую последовательность действий более подробно.
+
Импорт данных в эти справочники несколько отличается от импорта в другие справочники, поэтому ниже рассмотрим необходимую последовательность действий более подробно.
  
 
=== Импорт районов ===
 
=== Импорт районов ===
Откройте таблицу стоимости проезда между зонами в Excel.В нашем примере она будет выглядеть так:
+
Откройте таблицу стоимости проезда между зонами в Excel. В нашем примере она будет выглядеть так:
  
 
[[Файл:Исходная матрица стоимости зон (Excel).png|center]]
 
[[Файл:Исходная матрица стоимости зон (Excel).png|center]]
Строка 64: Строка 76:
 
# Нажмите {{key|Shift}}+{{key|End}}. Включится режим перехода в конец {{серым|(об этом будет написано в статусной строке Excel)}}.
 
# Нажмите {{key|Shift}}+{{key|End}}. Включится режим перехода в конец {{серым|(об этом будет написано в статусной строке Excel)}}.
 
# Нажмите {{key|Shift}}+{{key|↓}}. Выделится диапазон от {{code|A2}} до последней ячейки в столбце {{code|A}}, таким образом выберутся все зоны.
 
# Нажмите {{key|Shift}}+{{key|↓}}. Выделится диапазон от {{code|A2}} до последней ячейки в столбце {{code|A}}, таким образом выберутся все зоны.
# Если выделились не все зоны, а только видимые на странице, нажмите {{key|Shift}}+{{key|↓}} еще раз.
 
# Удерживая клавишу {{key|Ctrl}}, установите курсор в {{code|ячейку B2}}.
 
# Нажмите {{key|Shift}}+{{key|↓}}. Выделится диапазон от {{code|B2}} до последней ячейки в столбце {{code|B}}.
 
 
# Если выделились не все зоны, а только видимые на странице, нажмите {{key|Shift}}+{{key|↓}} еще раз.
 
# Если выделились не все зоны, а только видимые на странице, нажмите {{key|Shift}}+{{key|↓}} еще раз.
 
# Нажмите {{key|Ctrl}}+{{key|C}}. Выделенный диапазон будет скопирован в буфер обмена.
 
# Нажмите {{key|Ctrl}}+{{key|C}}. Выделенный диапазон будет скопирован в буфер обмена.
 
На изображении ниже видно, что все необходимые нам зоны были выделены.
 
 
[[Файл:Исходная матрица стоимости зон, выделены зоны (Excel).png|center]]
 
  
 
Далее следует выполнить следующие действия:
 
Далее следует выполнить следующие действия:
Строка 78: Строка 83:
 
# Открыть утилиту импорта данных.
 
# Открыть утилиту импорта данных.
 
# Открыть вкладку {{tab|Районы}}.
 
# Открыть вкладку {{tab|Районы}}.
# Нажать кнопку {{button|Вставить}}.
+
# Нажать кнопку {{button|Загрузить из буфера обмена}}.
 
# В поле {{field|Название}} ввести число {{code|1}}.
 
# В поле {{field|Название}} ввести число {{code|1}}.
# В поле {{field|Категория}} ввести число {{code|2}}.
+
# В поле {{field|Категория}} выбрать нужное (город/загород).
 
# Нажать кнопку {{button|Импорт}}.
 
# Нажать кнопку {{button|Импорт}}.
  
 
[[Файл:TMRefsImport-импорт районов.png|center]]
 
[[Файл:TMRefsImport-импорт районов.png|center]]
  
Необходимо дождаться завершения импорта данных. После этого можно перейти к следующему шагу. При успешном импорте Вы увидите специальное сообщение:
+
Необходимо дождаться завершения импорта данных. После этого можно перейти к следующему шагу. При успешном импорте будет специальное сообщение:
  
 
[[Файл:TMRefsImport-Успешный импорт.png|center]]
 
[[Файл:TMRefsImport-Успешный импорт.png|center]]
Строка 94: Строка 99:
 
* Цена остановки;
 
* Цена остановки;
 
* Цена высадки.
 
* Цена высадки.
 
=== Перевод таблицы проездов между районами в нужный формат ===
 
На данный момент в утилиту импорта не встроен механизм трансформации таблицы стоимости зон в список проездов между районами, поэтому Вам потребуется отправить файл, содержащий матрицу проездов, на {{Ящик ОТП}} с соответствующей пометкой. В ответ Вы получите файл Excel, в котором будет содержаться список проездов между районами.
 
  
 
=== Импорт проездов между районами ===
 
=== Импорт проездов между районами ===
После того, как вы получили результирующий список проездов между районами, откройте его в Excel:
+
Для того, чтобы импортировать матрицу проездов между районами, которая выглядит примерно так:
  
 
[[Файл:Проезды между районами (Excel).png|center]]
 
[[Файл:Проезды между районами (Excel).png|center]]
Строка 105: Строка 107:
 
Выполните следующие действия:
 
Выполните следующие действия:
  
# Нажмите {{key|Ctrl}}+{{key|A}}, чтобы выделить все данные.
+
# Откройте утилиту импорта данных.
# Нажмите {{key|Ctrl}}+{{key|C}}, чтобы скопировать все данные.
+
# Откройте вкладку {{button|Проезды между районами}}.
# Откройте утилиту импорта и повторите действия, необходимые для вставки данных (кнопка {{button|Вставить}}).
+
# Выберете '''Формат данных''' "Матрица".
# В полях {{field|Из района}}, {{field|В район}} и {{field|Стоимость}} расставьте номера соответствующих столбцов. В данном случае — {{code|1}}, {{code|2}} и {{code|3}} соответственно.
+
# Нажмите '''Загрузить из файла''' и выберете нужный файл.
 
# Обязательно укажите, в какую группу следует включить данные проезды между районами.
 
# Обязательно укажите, в какую группу следует включить данные проезды между районами.
  
[[Файл:|TMRefsImport-проезды между районами.png|center]]
+
[[Файл:TMRefsImport-проезды между районами.png|center]]
  
 
Нажмите {{button|Импорт}}, чтобы импортировать данные. Если таблица была большая, и, следовательно, список проездов получился большой, то импорт данных может занять продолжительное время. Обязательно дождитесь завершения операции.
 
Нажмите {{button|Импорт}}, чтобы импортировать данные. Если таблица была большая, и, следовательно, список проездов получился большой, то импорт данных может занять продолжительное время. Обязательно дождитесь завершения операции.
  
При успешном завершении операции Вы увидите уведомление:
+
При успешном завершении операции будет выведено уведомление об этом.
[[Файл:TMRefsImport-Успешный импорт2.png|center]]
 
  
При необходимости, Вы можете по аналогии импортировать и другие данные, а именно поле Примечание.
+
При необходимости, можно по аналогии импортировать и другие данные, а именно поле "Примечание".
  
 
==== Если районы отсутствуют ====
 
==== Если районы отсутствуют ====
 
 
Если районы, проезды между которыми были вставлены в утилиту, отсутствуют, они будут выделены красным:
 
Если районы, проезды между которыми были вставлены в утилиту, отсутствуют, они будут выделены красным:
  
 
[[Файл:TMRefsImport-проезды_между_несуществующими_районами.png|center]]
 
[[Файл:TMRefsImport-проезды_между_несуществующими_районами.png|center]]
  
Это значит, что названия во внесенных данных не соответствуют названиям в справочнике  [[Справочник «Районы»|справочнике «Районы»]], соответственно, что-то было сделано неверно. В данном случае следует очистить справочник «Районы» и [[#Импорт районов и проездов между районами|начать процесс импорта с самого начала.
+
Это значит, что названия во внесенных данных не соответствуют названиям в [[Справочник «Районы»|справочнике «Районы»]], соответственно, что-то было сделано неверно.  
]].
 
  
== Импорт справочников [[справочник "Клиенты"|"Клиенты"]] и [[Справочник «Телефоны»|"Телефоны"]] ==
+
В данном случае можно очистить справочник «Районы» и [[#Импорт районов и проездов между районами|начать процесс импорта с самого начала]].
  
Импорт в данные справочник производится немного иначе, чем в общем случае. Здесь для выбора колонки, из которой будет произведен импорт, следует выполнить следующие действия:
+
== Импорт клиентов, телефонов и заказов ==
 +
Импорт этих данных производится особым образом.  
  
# Кликнуть левой кнопкой мыши по заголовку колонки в нижней таблице
+
После загрузки данных из буфера обмена или файла, необходимо выбрать колонки с соответствующей информацией для импорта.
# Выбрать номер столбца верхней таблицы, который необходимо перенести в эту колонку.
+
 
# Указать группу, в которую будут включены импортируемые клиенты.
+
Чтобы выбрать колонку, из которой будет произведен импорт, следует выполнить следующие действия:
 +
 
 +
# Кликнуть левой кнопкой мыши по заголовку колонки в нижней таблице и выбрать номер столбца верхней таблицы, информацию из которого необходимо перенести в эту колонку.
 +
# Сделать так для всех необходимых столбцов.
 +
# Указать дополнительные параметры. Например, при импорте клиентов нужно выбрать группу клиентов, в которую будут включены импортируемые клиенты.
 
# Нажать кнопку {{button|Импорт}}.
 
# Нажать кнопку {{button|Импорт}}.
  
Строка 149: Строка 153:
  
 
{{info|Обратите внимание! Для импорта статистики по дисконтным картам обязательно нужно указать ИД типа карты!}}
 
{{info|Обратите внимание! Для импорта статистики по дисконтным картам обязательно нужно указать ИД типа карты!}}
 
== Ссылки ==
 
* [[Карты Ингит#Импорт улиц из карт Ингит с помощью TMSI|TMSI]] — утилита импорта улиц из [[Модуль Ингит|карты Ингит]].
 
* {{code/(}}http://taxidev.blogspot.com/search?q=TMRefsImport{{code/)}} — все статьи с упоминанием утилиты импорта справочников в [[Блог разработчиков|блоге разработчиков]].
 
  
 
{{утилиты}}
 
{{утилиты}}
Строка 158: Строка 158:
 
[[Категория:Утилиты]]
 
[[Категория:Утилиты]]
 
[[Категория:Импорт и экспорт]]
 
[[Категория:Импорт и экспорт]]
[[Категория:ТМ2]]
 

Версия 15:35, 18 марта 2022

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

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

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

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

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

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

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

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

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

TMRefsImport Путь к БД.png

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

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

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

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

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

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

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

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

Далее в поле «Поле наименования» укажем номер столбца, который необходимо импортировать. В нашем случае столбец только один, соответственно, его номер мы и укажем. Теперь нажмем кнопку «Импорт».

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

Готово!

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

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

  1. Справочник "Улицы".
  2. Справочник "Клиенты".
  3. Справочник "Районы" — должен быть импортирован до импорта следующего справочника, наименования зон должны совпадать!
  4. Справочник "Проезды между районами".
  5. Справочник "Телефоны".
  6. Статистика по телефонам.
  7. Справочник "Дисконтные карты".
  8. Координаты города, района, стоянки.
  9. Справочник "Автомобили".
  10. Справочник "Водители".
  11. Справочник "Экипажи" (Автомобили + Водители).
  12. Заказы.
  13. Пункты и стоянки.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

При успешном завершении операции будет выведено уведомление об этом.

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

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

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

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

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

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

Импорт клиентов, телефонов и заказов

Импорт этих данных производится особым образом.

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

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

  1. Кликнуть левой кнопкой мыши по заголовку колонки в нижней таблице и выбрать номер столбца верхней таблицы, информацию из которого необходимо перенести в эту колонку.
  2. Сделать так для всех необходимых столбцов.
  3. Указать дополнительные параметры. Например, при импорте клиентов нужно выбрать группу клиентов, в которую будут включены импортируемые клиенты.
  4. Нажать кнопку «Импорт».

Ниже показан пример импорта справочника "Клиенты".

TMRefsImport-импорт Клиентов.png

Импорт остальных справочников

Все остальные справочники импортируются по общему принципу: следует сопоставить номера столбцов из области 1, колонкам в области 2. Например, данные об общем количестве заказов находятся в колонке №4 в верхней таблице, следовательно в поле «Всего заказов» в нижней таблице нужно указать номер этой колонки.

TMRefsImport-Общий принцип импорта.png
Интересная информация
Обратите внимание! Для импорта статистики по дисконтным картам обязательно нужно указать ИД типа карты!
Утилиты Такси-Мастер
Утилиты для работы с базой данных

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