TMDriverJava (Архив)

Материал из TaxiMaster
(перенаправлено с «TMDriverJava»)
Перейти к: навигация, поиск
Предупреждение!
Обратите внимание! Начиная с версии 0.4.5 от 19.02.2014 прекращается доработка функционала приложения.


Где скачать TMDriver?

Download.png
Последнюю версию Вы можете скачать по ссылке:
http://files.bitmaster.ru/TM/tmdriver/TMDriverJavaME_2_3_0.zip
Имеются страницы, на которые следует обратить внимание
Обратите внимание на следующую страницу документации: TMDriverWM
Предупреждение!
Внимание!

Работа приложения TMDriver тестировалась на телефонах Nokia. На телефонах нижнего ценового уровня Nokia 2630 и 3110 приложение TMDriver показало на тестах стопроцентную работоспособность.

Для работы TMDriver сотовый телефон должен иметь следующие компоненты:

  1. Виртуальная машина Java (J2ME).
  2. GPRS.

Однако, как показали тесты телефонов Samsung и Motorola, выполнения этих условий не всегда достаточно. Проверьте работоспособность TMDriver на своем сотовом телефоне перед эксплуатацией!

Главное меню TMDriver

Мобильное приложение TMDriver — это приложение для мобильных телефонов, базирующееся на технологии Java. Приложение TMDriver создавалось специально для водителей, чтобы дать им возможность работать с модулем «Связь с водителями», контактируя по внешнему интернет-соединению с сервером связи с водителями.

Архитектурная единица

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

Версия TMDriver

Приложение TMDriver имеет внутреннюю версию — номер выпуска копии. Версия необходима для того, чтобы установить соответствие между приложением TMDriver и сервером связи с водителями, к которому происходит подключение: если версия TMDriver не поддерживается сервером, то подключение не происходит, и выдается сообщение «Версия протокола не поддерживается сервером».

Возможности TMDriver

Приложение TMDriver позволяет водителям выполнять следующие действия:

  1. Выходить на линию и сниматься с линии в несколько нажатий кнопок телефона без участия оператора.
  2. Начинать и заканчивать смену также без участия оператора или диспетчера.
  3. Регистрироваться на стоянках и видеть свою позицию на этой стоянке, а также число машин и заказов на всех имеющихся стоянках.
  4. Всегда видеть актуальную информацию о наличии заказов и количестве машин на линии.
  5. Отправлять сообщения диспетчерам и водителям и принимать входящие сообщения от них.
  6. Видеть актуальный список предварительных заказов и брать их.
  7. Видеть информацию об активном заказе и брать его.
  8. Завершать заказ, указывая сумму, либо без ее указания.

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

Выбор телефона для работы с TMDriver

Выбор телефона для работы с TMDriver — достаточно простая на сегодняшний день задача. Дело в том, что очень многие современные телефоны отвечают всем требованиям, предоставляемым приложением TMDriver. Требований всего два:

  1. Наличие виртуальной машины Java.
  2. Наличие возможности интернет-соединения по каналу GPRS.

Оба пункта вы можете уточнить при покупке телефона, либо в руководстве к нему.

Смартфоны и коммуникаторы тоже могут работать с TMDriver, однако перед установкой приложения следует убедиться в том, что в устройстве имеется установленная виртуальная машина Java.

Интересная информация

Практика показывает, что лучший выбор — это Nokia или Sony Ericsson. На телефонах других производителей TMDriver может не работать так, как ожидается.


Установка TMDriver

Установить TMDriver на сотовый телефон можно двумя способами:

  1. Установкой через соединение с компьютером (data-кабель, Bluetooth, Wi-Fi — не имеет значения).
  2. Прямое скачивание.


Установка через соединение с компьютером, как правило, подразумевает копирование файлов «tmdriver.jar» и «tmdriver.jad» (второй часто может быть опущен). Большинство телефонов позволяют запускать приложения из любого места файловой системы, однако рекомендуется копировать файлы в специальную папку. На разных моделях она может называться по-разному, но чаще всего — «Приложения». На телефонах Nokia файлы можно копировать в папку «Принятые файлы» и запускать из нее — операционная система телефона позволяет это.

Прямое скачивание, как правило, производится через браузер телефона (любой, который установлен). Для этого необходимо ввести либо прямую ссылку на файл «tmdriver.jar», либо скачать его через «http://wap.taximaster.ru».

Если у вас возникли проблемы со скачиванием TMDriver или установкой его на телефон, обратитесь в отдел технической поддержки, написав письмо на support@bitmaster.ru. В теме письма не забудьте указать ИД клиента, в тексте письма — краткое описание проблемы.

Установка TMDriver происходит так же, как установка на телефон любого Java-приложения. Например, установка на телефоны Nokia происходит с помощью приложения, включенного в пакет Nokia PC Suite, поставляемого на компакт-дисках в одной упаковке с телефонами.

Скачать TMDriver можно либо с FTP-сервера, либо с WAP-портала Такси-Мастер, введя в поле «ИД» цифру «0» для получения последней версии приложения. Обратите внимание на то, что последняя версия TMDriver на WAP-портале не всегда соответствует публичной последней версии, поэтому рекомендуем скачивать TMDriver со специальной страницы (или обратиться в отдел технической поддержки) и загружать приложение на телефон через Bluetooth или кабель для передачи данных.

Настройка TMDriver

Рекомендуется почитать статью: ИД водителя и Пароль водителя
Пункт основных настроек TMDriver

Настройка TMDriver происходит в один шаг. Все, что нужно сделать, — настроить соединение с сервером связи с водителями и указать реквизиты водителя. Чтобы зайти в пункт настроек, вызовите главное меню любой функциональной кнопкой (левой, правой или средней). В меню найдите пункт «Настройки» и нажмите центральную функциональную кнопку (далее — «огонь»).

  1. В поле «Сервер» введите внешний IP-адрес компьютера, на котором работает сервер связи с водителями.
  2. В поле «Порт» введите номер порта, по которому происходит соединение с сервером связи с водителями.
  3. В поле «Сервер (рез.)» укажите внешний IP-адрес компьютера, на котором работает резервный сервер связи с водителями (если он имеется).
  4. В поле «Порт (рез.)» укажите порт, по которому происходит соединение с резервным сервером связи с водителями.
  5. В поле «ИД» укажите ИД водителя.
  6. В поле «Пароль» введите пароль, указанный в карточке водителя, для идентификации водителя сервер связи с водителямиом.
  7. Установите флажок «Template-checkbox-on.png Подсветка: всегда включена», чтобы телефон не выключал подсветку при отсутствии активности.
  8. Установите флажок «Template-checkbox-off.png Автообновление списков», чтобы обновление списков стоянок и заказов происходило автоматически каждые 5 секунд.

Все остальные функциональные параметры настраиваются в конфигураторе, в настройках модуля «Связь с водителями» и в настройках Такси-Мастер. Эти параметры распространяются на все копии TMDriver, подключенные к одному серверу связи с водителями.

Интересная информация

Обратите внимание, что для того, чтобы TMDriver начал работу, сервер связи с водителями должен быть включен, запущен и доступен извне (из интернета).

Работа с TMDriver

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

Запуск TMDriver

Чтобы запустить TMDriver, найдите его в каталоге файлов сотового телефона и запустите. Как правило, после загрузки в сотовых телефонах Nokia TMDriver можно найти в списке приложений (пункт меню «Приложения»).

Загрузка TMDriver

Окно приветствия

Если TMDriver может быть запущен на вашем сотовом телефоне, во время загрузки он выведет окно приветствия?. В это время TMDriver в фоновом режиме загружает все функции в память телефона. Дождитесь появления меню стоянок, чтобы начать настройку, если приложение еще не сконфигурировано, или начать работу.

Интересная информация

В окне приветствия вы можете увидеть версию TMDriver.

Соединение с сервером

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

Выход на смену и уход со смены

Выход на смену и уход со смены с помощью TMDriver выполняется через главное меню, которое вызывается нажатием правой или левой кнопки , либо нажатием в списке стоянок. Чтобы выйти на смену, если вы еще не вышли на смену, или сняться со смены, если вы уже на смене, откройте главное меню и выберите пункт «Н/З смену». При этом индикатор, отображающий состояние водителя, исчезнет.

Регистрация на стоянке

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

Представление данных об автомобилях и заказах

Напротив каждой стоянки в списке стоянок отображаются данные в виде «водители:заказы», где «водители» — это количество водителей, зарегистрированных на стоянке, а «заказы» — число свободных заказов по стоянке. Также есть третий параметр — позиция в очереди. Этот параметр присутствует напротив той стоянке, на которой водитель зарегистрировался:

Картинка
Tmdriver-parking-not-mine.png
Информация по стоянке, на которой на данный момент нет машин и заказов.
Картинка
Tmdriver-parking-mine.png
Информация по стоянке, на которой находится водитель. Он первый в очереди, всего в очереди 2 машины, заказов по стоянке нет.

Выполнение заказа

Рекомендуется почитать статью: Настройка модуля «Связь с водителями» и схемы работы с заказами

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

Если диспетчер назначает водителя на заказ

  1. Диспетчер принимает заказ и назначает исполнителем определенного водителя. Водитель при этом свободен — С.
  2. Водитель получает сообщение о том, что он назначен на заказ, и ему дается время, чтобы отреагировать на это сообщение. Водитель должен обозначить время, в течение которого он подъедет к месту отправки (либо отреагировать отказом — этот случай не рассматривается).
  3. TMDriver переходит в меню стоянок. Индикатор показывает состояние ожидания подтверждения — !.
  4. Диспетчер подтверждает заказ. Водитель получает сообщение «Заказ подтвержден». Индикатор состояния заказа изменяется на З.
  5. Водитель выполняет заказ. Для изменения состояния заказа или просмотра информации по нему водитель нажимает 9.
  6. Чтобы успешно завершить заказ, водитель нажимает кнопку .
  7. Водитель снова нажимает , чтобы завершить заказ с суммой, указанной оператором, либо вводит свою и затем нажимает .
  8. После завершения заказа водитель снова становится свободным — С.

Если водитель берет свободный заказ самостоятельно

  1. Водитель выбирает в списке свою стоянку и нажимает или 6.
  2. Водитель выбирает заказ и просматривает информацию по нему.
  3. Водитель обозначает время, в течение которого он подъедет к месту отправки (или нажимает Назад, уходя обратно в список заказов, переходя на пункт назад).
  4. Диспетчер получает заявку на подтверждение. Водитель при этом переходит в список стоянок и находится в состоянии ожидания подтверждения!.
  5. Водитель дожидается подтверждения и получается сообщение «Заказ подтвержден». При этом его состояние меняется — З.
  6. Водитель выполняет заказ. Для изменения состояния заказа или просмотра информации по нему водитель нажимает 9.
  7. Водитель снова нажимает , чтобы завершить заказ с суммой, указанной оператором, либо вводит свою и затем нажимает .
  8. После завершения заказа водитель снова становится свободным — С.

В картинках

Картинка
Нажмите на изображение, чтобы открыть его спецстраницу. На спецстранице вы сможете открыть изображение в оригинальном размере.
Нажмите на изображение, чтобы открыть его спецстраницу. На спецстранице вы сможете открыть изображение в оригинальном размере.

Сообщение оператору или водителю

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

  1. «0», если нужно отправить сообщение операторам.
  2. Позывной водителя в виде числа, если нужно отправить сообщение конкретному водителю.
  3. «*», если нужно отправить сообщение всем водителям. Например, для оповещения о ДТП или пробке.

Текст сообщения может содержать любые символы, его размер не ограничен. Также текст сообщения может быть автоматически заполнен содержимым одного из шаблонов (доступно через меню в форме ввода сообщения).

Установка состояния экипажа

Водитель имеет возможность вручную установить состояние экипажа. Это происходит через пункт меню «Уст. состояние» — вызвав его, водитель получает в TMDriver список возможных состояний и может установить одно из них.

Интересная информация

По умолчанию подписи состояний экипажа в TMDriver пусты. Заполните их следующим образом:

  1. Откройте справочник «Состояния экипажа».
  2. Последовательно откройте каждую карточку и в поле «Наименование для водителей» укажите короткий эквивалент названия состояния.
  3. Сохраните настройки, перезапустив Такси-Мастер, TMDriver и по возможности сервер связи с водителями.

Настройки компонентов, влияющих на работу TMDriver

Помимо настроек TMDriver существуют также другие компоненты системы, которые оказывают влияние на работу водителя с приложением. Их несколько:

  1. Настройки клиентской части модуля «Связь с водителями».
  2. Справочник «Автомобили».
  3. Справочник «Состояния заказа».

Регулирование прав в TMDriver

Рекомендуется почитать статью: Параметры доступа к заказам из TMDriver

Каждый водитель имеет права на определенные действия. Эти права настраиваются в нескольких ступенях:

  1. Глобально (в настройках модуля «Связь с водителями»).
  2. Для отдельного типа автомобилей (см. справочник «Автомобили»).

Водители наследуют права так:

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

О том, права на какие именно действия могут иметь водители, см. параметры доступа к заказам из TMDriver.

Ссылки