TMManager (Архив) — различия между версиями
Материал из TaxiMaster
м (→Синтаксис) |
|||
| (не показано 15 промежуточных версий 3 участников) | |||
| Строка 1: | Строка 1: | ||
| + | {{url|{{корень FTP|Utilities/TMMgr.exe}}}} | ||
| + | |||
'''TMManager''' — это COM-приложение, позволяющее какому-либо программному средству взаимодействовать с системой Такси-Мастер с помощью технологии COM. | '''TMManager''' — это COM-приложение, позволяющее какому-либо программному средству взаимодействовать с системой Такси-Мастер с помощью технологии COM. | ||
| + | |||
| + | {{warning|Обратите внимание! Данная утилита устарела, сейчас её функции выполняет [[TM API|CommonAPI]].}} | ||
== Установка TMManager == | == Установка TMManager == | ||
Установка COM-объекта TMManager происходит в один шаг: нужно просто запустить исполняемый файл. | Установка COM-объекта TMManager происходит в один шаг: нужно просто запустить исполняемый файл. | ||
| − | При этом объект | + | При этом объект {{code|TMMgr}} зарегистрируется в списке приложений DCOM через службу компонентов, и его можно использовать для вызова методов из стороннего приложения (например, из скрипта {{коммент|VBS|Visual Basic script}}). |
| − | |||
| − | |||
== Создание объекта == | == Создание объекта == | ||
| Строка 19: | Строка 21: | ||
Объект TMManager имеет несколько методов, которые могут быть использованы сторонними приложениями. | Объект TMManager имеет несколько методов, которые могут быть использованы сторонними приложениями. | ||
| − | === | + | === {{code|DBConnect}} === |
| − | С помощью метода | + | С помощью метода {{code|DBConnect}} организуется подключение к Такси-Мастер. |
| + | |||
| + | При этом будет создан файл с настройками TMMgr.ini, в котором нужно указать актуальные TMServerIP, TMServerPort, TMAPISecretKey. | ||
==== Синтаксис ==== | ==== Синтаксис ==== | ||
| − | Синтаксис метода | + | Синтаксис метода {{code|DBConnect}}: |
HRESULT DBConnect (BSTR ServerName, BSTR FilePath, BSTR Login, BSTR Password); | HRESULT DBConnect (BSTR ServerName, BSTR FilePath, BSTR Login, BSTR Password); | ||
| − | # | + | # {{code|ServerName}} — это строка, обозначающая имя сервера, например, {{путь|LOCALHOST}}. |
| − | # | + | # {{code|FilePath}} — строка, обозначающая путь к файлу базы данных. Путь должен быть указан полностью, включая имя диска. |
| − | # | + | # {{code|Login}}/{{code|Password}} — текущие логин и пароль для вашей базы данных. |
| − | |||
| − | === | + | === {{code|DBDisconnect}} === |
| − | Вызов метода DBDisconnect закрывает подключение к | + | Вызов метода {{code|DBDisconnect}} закрывает подключение к Такси-Мастер. |
==== Синтаксис ==== | ==== Синтаксис ==== | ||
| − | Синтаксис метода | + | Синтаксис метода {{code|DBDisconnect}}: |
HRESULT DBDisconnect(); | HRESULT DBDisconnect(); | ||
| Строка 42: | Строка 45: | ||
Метод вызывается без параметров. | Метод вызывается без параметров. | ||
| − | === | + | === {{code|BeginCoordsSending}} === |
| − | + | Метод {{code|BeginCoordsSending}} создает объект для передачи в Такси-Мастер ряда координат. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | === | ||
| − | |||
| − | Метод | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | { | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |} | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==== Синтаксис ==== | ==== Синтаксис ==== | ||
| − | Синтаксис метода | + | Синтаксис метода {{code|BeginCoordsSending}}: |
HRESULT BeginCoordsSending(); | HRESULT BeginCoordsSending(); | ||
| Строка 213: | Строка 55: | ||
Метод вызывается без параметров. | Метод вызывается без параметров. | ||
| − | === | + | === {{code|SendCoords}} === |
| − | Метод | + | Метод {{code|SendCoords}} добавляет в объект координаты и время их передачи. |
==== Синтаксис ==== | ==== Синтаксис ==== | ||
| − | Синтаксис метода | + | Синтаксис метода {{code|SendCoords}}: |
HRESULT SendCoords(INT Identifier, SINGLE Latitude, SINGLE Longitude); | HRESULT SendCoords(INT Identifier, SINGLE Latitude, SINGLE Longitude); | ||
| − | # | + | # {{code|Identifier}} — идентификатор водителя (см. поле {{field|Идентификатор}} в [[Справочник «Экипажи»|карточке экипажа]]. Для удобства можно использовать [[ИД водителя]], его можно посмотреть в [[Справочник «Водители»|карточке водителя]]. |
| − | # | + | # {{code|Latitude}} — число с плавающей запятой, обозначающее широту. |
| − | # | + | # {{code|Longitude}} — число с плавающей запятой, обозначающее долготу. |
| − | === | + | === {{code|EndCoordsSending}} === |
| − | Метод | + | Метод {{code|EndCoordsSending}} завершает набор координат и отправляет объект с координатами в Такси-Мастер. |
==== Синтаксис ==== | ==== Синтаксис ==== | ||
| − | Синтаксис метода | + | Синтаксис метода {{code|EndCoordsSending}}: |
HRESULT EndCoordsSending(); | HRESULT EndCoordsSending(); | ||
| Строка 242: | Строка 84: | ||
{| {{table}} | {| {{table}} | ||
| − | ! Проблема | + | ! {{table/th}} | Проблема |
| − | ! Картинка | + | ! {{table/th}} |Картинка |
<small>(нажмите, чтобы посмотреть)</small> | <small>(нажмите, чтобы посмотреть)</small> | ||
| − | ! Решение | + | ! {{table/th}} |Решение |
|- | |- | ||
| − | | Невозможно создать объект | + | | {{table/td}} | Невозможно создать объект |
| − | | [[Image:Tmmanager-exception-on-create.png|150px]] | + | | {{table/td}} | [[Image:Tmmanager-exception-on-create.png|150px]] |
| − | | | + | | {{table/td}} | |
COM-объект не установлен в системе, поэтому невозможно создать его экземпляр. | COM-объект не установлен в системе, поэтому невозможно создать его экземпляр. | ||
| − | Чтобы иметь возможность использовать объект, установите его (см. выше). | + | Чтобы иметь возможность использовать объект, установите его (см. [[#Установка TMManager|выше]]). |
|} | |} | ||
== Ссылки == | == Ссылки == | ||
| − | * | + | * [[Справка:TMManager|Справочный пример работы с TMManager]]. |
| − | * | + | * {{code/url|http://ru.wikipedia.org/wiki/Windows_Script_Host}} — о Windows Script Host, под управлением которой работают примеры. |
| + | * {{code/url|http://ru.wikipedia.org/wiki/DCOM}} — о DCOM на Википедии. | ||
[[Категория:COM-приложения]] | [[Категория:COM-приложения]] | ||
| − | [[Категория: | + | [[Категория:Архив]] |
| − | |||
Текущая версия на 11:21, 27 августа 2021
TMManager — это COM-приложение, позволяющее какому-либо программному средству взаимодействовать с системой Такси-Мастер с помощью технологии COM.
Обратите внимание! Данная утилита устарела, сейчас её функции выполняет CommonAPI.
Содержание
Установка TMManager
Установка COM-объекта TMManager происходит в один шаг: нужно просто запустить исполняемый файл. При этом объект TMMgr зарегистрируется в списке приложений DCOM через службу компонентов, и его можно использовать для вызова методов из стороннего приложения (например, из скрипта VBS?).
Создание объекта
Создание объекта в вашей программе происходит довольно просто. Пример на VBS:
dim mgrInstance
mgrInstance = WScript.CreateObject("TMMgr.TMManager")
Методы TMManager
Объект TMManager имеет несколько методов, которые могут быть использованы сторонними приложениями.
DBConnect
С помощью метода DBConnect организуется подключение к Такси-Мастер.
При этом будет создан файл с настройками TMMgr.ini, в котором нужно указать актуальные TMServerIP, TMServerPort, TMAPISecretKey.
Синтаксис
Синтаксис метода DBConnect:
HRESULT DBConnect (BSTR ServerName, BSTR FilePath, BSTR Login, BSTR Password);
- ServerName — это строка, обозначающая имя сервера, например, LOCALHOST.
- FilePath — строка, обозначающая путь к файлу базы данных. Путь должен быть указан полностью, включая имя диска.
- Login/Password — текущие логин и пароль для вашей базы данных.
DBDisconnect
Вызов метода DBDisconnect закрывает подключение к Такси-Мастер.
Синтаксис
Синтаксис метода DBDisconnect:
HRESULT DBDisconnect();
Метод вызывается без параметров.
BeginCoordsSending
Метод BeginCoordsSending создает объект для передачи в Такси-Мастер ряда координат.
Синтаксис
Синтаксис метода BeginCoordsSending:
HRESULT BeginCoordsSending();
Метод вызывается без параметров.
SendCoords
Метод SendCoords добавляет в объект координаты и время их передачи.
Синтаксис
Синтаксис метода SendCoords:
HRESULT SendCoords(INT Identifier, SINGLE Latitude, SINGLE Longitude);
- Identifier — идентификатор водителя (см. поле Идентификатор в карточке экипажа. Для удобства можно использовать ИД водителя, его можно посмотреть в карточке водителя.
- Latitude — число с плавающей запятой, обозначающее широту.
- Longitude — число с плавающей запятой, обозначающее долготу.
EndCoordsSending
Метод EndCoordsSending завершает набор координат и отправляет объект с координатами в Такси-Мастер.
Синтаксис
Синтаксис метода EndCoordsSending:
HRESULT EndCoordsSending();
Метод вызывается без параметров.
Пример
См. пример сценария на языке Basic.
Возможные проблемы
Проблемы, которые могут возникнуть, описаны? в таблице:
| Проблема | Картинка
(нажмите, чтобы посмотреть) |
Решение |
|---|---|---|
| Невозможно создать объект | 
|
COM-объект не установлен в системе, поэтому невозможно создать его экземпляр. Чтобы иметь возможность использовать объект, установите его (см. выше). |
Ссылки
- Справочный пример работы с TMManager.
- http://ru.wikipedia.org/wiki/Windows_Script_Host — о Windows Script Host, под управлением которой работают примеры.
- http://ru.wikipedia.org/wiki/DCOM — о DCOM на Википедии.
