Клиент «OnFly»
Назначение программы
- Обеспечение быстрого доступа к основным функциям CRM-системы, работающей через веб-интерфейс. Отслеживание присутствия пользователя за компьютером и уведомление CRM-системы об отсутствии активности в течение определенного времени и последующем возвращении пользователя. Поддержание связи с CRM-системой (путем переводческой отправки запросов к CRM-системе) и показ уведомлений, актуальных для пользователя. Создание скриншотов.
Основные принципы работы программы
Название файла: OnFly. exe
Название процесса в списке процессов всегда совпадает с названием файла.
Возможные операционные системы: Windows XP, Windows 7.
При запуске программы происходит проверка на отсутствие запуска двух экземпляров программы: если программа уже запущена, то новый экземпляр закрывается.
Программа все время находится в трее.
При щелчке по иконке программы происходит вызов JavaScript-функции, который приводит к показу небольшого окна программы (если окно еще не показано, или скрытию окна, если оно уже было на экране) в правой нижней части экрана.
При щелчке правой кнопкой по иконке программы открывается меню, которое строится на основе XML-файла.
Содержимое окна представляет собой фрейм Internet Explorer, в который загружается указанная в конфигурационном файле веб-страница.
Действия, выполняемые программой
Под действием понимается смена URL-адреса основного фрейма программы, либо запуск JavaScript-функции в этом фрейме.
Действие «init»
Действие вызывается при запуске программы.
Действие «start»
Действие вызывается при запуске программы (после init).
Действие «end»
Действие вызывается всегда при закрытии программы.
Действие «refresh»
Действие постоянно вызывается через равные интервалы времени, указанные в настройках.
Действие «user_away»
Действие вызывается при отсутствии активности пользователя в течение некоторого времени. Время (в секундах) определяется в настройках программы. Принцип определения активности по движению мышки и использовании клавиатуры.
Действие «user_return»
Действие вызывается при возврате пользователя за компьютер после вызова действия «user_away».
Действие «error_connect»
Если какое-либо действие не выполняется (нет ответа от сервера, либо ответ не содержит параметра «success» при загрузке страницы по HTTP), выполняется действие «error_connect».
Обработка получаемых параметров
success
Параметр подтверждает успешную загрузку страницы. Обрабатывать его не требуется.
window_display
Если данные параметр равен «Y» - окно OnFly показывается (точнее: происходит вызов JavaScript-функции: onflyWindowShow).
window_width
Устанавливаем ширину окна OnFly в пикселях.
window_height
Устанавливаем высоту окна OnFly в пикселях.
Важное замечание!
Если в параметрах ширины или высоты передано пустое или нечисловое значение размеры окна не меняются. Если переданные размеры совпадают с предыдущими, ничего не происходит (чтобы не получать мерцание окна).
При изменении размеров окна, окно перемещается таким образом, чтобы нижний правый край оставался на том же месте, что и до изменения размеров. То есть при смене размеров изменяются и координаты top-left окна.
refresh_after
Определяет интервал времени (в секундах), через который следует выполнять действие «refresh».
away_after
Определяет время (в секундах), при отсутствии активности в течение которого, следует выполнить действие «user_away». Активность определяется по движению мыши и использованию клавиатуры, либо через стандартные функции Windows API.
icon_text
Задает текст подсказки для иконки программы в трее.
icon_file
Задает путь к PNG-файлу для иконки программы в трее.
Иконки могут быть в формате PNGA (анимированной).
menu_path
Задает путь к файлу меню, открываемому при щелчке правой кнопкой по иконке.
Пример файла с меню в приложении.
play_sound
При установке данного параметра в “Y” проигрывается звуковой файл data/sound/notify. wav
play_sound_file
Проиграть звуковой файл по указанному пути.
screenshot_after
Указывает интервал (в секундах), через которые следует делать скриншоты (за исключением режима ожидания программы).
Скриншоты можно делать, только если это разрешено в локально конфигурацинном файле программы.
screenshot_make
Команда вызывает создание скриншота (если значение параметра не пустое).
Если значение параметра «Y» - используется стандартное имя файла.
В ином случае название берется из параметра.
Способ разбора путей
В конфигурационном файле или в некоторых параметрах передаются пути.
Они обрабатываются, в зависимости, от начальных символов, следующим образом.
«local_file:» путь к файлу, начиная от папки программы.
«local_icon:» путь к файлу в папке с иконками
«local_html:» путь к файлу в папке с html-документами (в папке программы)
«http:» или «https:» путь к файлу, расположенному в интернете.
Важно! При отсылке запроса следует передавать тот же идентификатор сессии, что и у основного фрейма, чтобы избежать появления окна авторизации вместо получения данных.
«javascript:» JavaScript-код, который следует выполнить в основном фрейме.
JavaScript функции
onflyWindowShow()
Показать окно OnFly
onflyWindowHide()
Скрыть окно OnFly
onflyWindowRefresh()
Выполнить действие «refresh» и обнулить таймер до следующего обновления.
onflyClientClose()
Закрыть программу (после вопроса «Вы уверены, что хотите завершить работу?»).
При положительном ответе окно сворачивается, выполняется действие «end», после чего программа закрывается.
onflyClientSetParams (sParams)
Функции передается строка, которая содержит параметры в следующем формате:
название_параметра_1: значение_параметра
название_параметра_2: значение_параметра
Эти параметры обрабатываются.
onflyClientSetMenu (sXml)
Функции передается строка, которая содержит XML-код с пунктами меню.
На ее основе изменяется меню программы, отображаемое при щелчке по иконке правой кнопкой.
onlflyScreenshotMake (sFilePath)
Сделать скриншот в формате PNG-8 и сохранить его в папке screens.
Если указано имя файла – то скриншот сохраняется с учетом указанного пути относительно папки screens.
Если имя файла не указано – оно берется по формату даты и времени: YYYY-MM-DD HH:MM:SS. png
Особенности показа окна
Окно показывается в нижней правой части экрана.
При изменении размеров окна, окно перемещается таким образом, чтобы нижний правый край оставался на той же точке, что и до изменения размеров. То есть при смене размеров изменяются и координаты top-left окна.
В HTML-коде окна есть слой с id=”onfly_title”. Зажатие клавиши на этом слое запускает режим перетаскивания окна.
В конфигурационном файле имеются параметры “window_margin_x” и “window_margin_y”. Они определяют отступ окна от угла экрана (+ высота панели задач) от края экрана.
Если выполнение действия предполагает загрузку страницы (http или https), то после загрузки проводится поиск и применение параметров.
В фрейме Internet Explorer запрещен показ меню по нажатию правой кнопки мыши и отключен показ ошибок JavaScript.
В приложении – вариант окна программы.
