Welab Developer's Blog

GpsGate Server имеет одну хорошую особенность, он позволяет добавлять свои web-расширения (дополнительные окна), реализующие необходимую Вам бизнес логику. Реализуются данные расширения с помощью DisplayKit, построенного, в прочем, как и весь web-интерфейс, на базе MochaUI и MochiKit.Для начала полезные ссылки:

• DisplayKit можно найти здесь;
• Официальный сайт MochaUI;
• Официальный сайт MochiKit;
• Пример разработки расширения здесь.

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

Первое, главными и необходимыми файлами модуля расширения являются следующие:

• Dispatcher.xml – здесь размещается описание расширения, а также страница (ScriptPage), на которой будет возможность открывать окно расширения, и файл JavaScript (ScriptFile), который создаст окно расширения.
• DispatcherPackage.xml используется для предоставления информации активатору/установщику расширений в SiteAdmin. В Description тект, который отобразиться в списке Script Plugins в  SiteAdmin, в module имя файла с описанием модуля расширения.
• DispatcherModule.xml – здесь задается ссылка на модуль ASP.NET и его зависимости.
• Dispatcher.js является конструктором окон расширения, создаваемых на базе MochaUI.
• DispatcherContent.aspx – собственно страница, которая отображается в окне расширения и реализует необходимую логику.

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

В Dispatcher.js должно быть реализовано, как минимум, следующее:

• Конструктор окна Franson.DispatcherWindow, который создает окно и задает все его необходимые параметры и атрибуты;
• А также необходимо подписаться на получение сообщения инициализации пользовательского интерфейса с помощью вызова метода Franson.Event.subscribe.

Сама логика расширения реализуется обычным для ASP.NET способом.

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

• Поместить файлы в папку %HOME_DIR%\IIS\Resources\ScriptPlugins\%SITE%\%NAME%, где %HOME_DIR% – папка, куда установлен GpsGate Server, %SITE% – название вашего сайта или фирмы или еще что-то (например, com.mysite), %NAME% – название вашего расширения.
• Зайти в SiteAdmin и перейти на закладку Script Plugins.
• Надавить кнопку Refresh Script Plugins.
• Выбрать в списке рядом с кнопкой расширение.
• Поставить галочку рядом с расширением ниже и надавить кнопку Save.

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