РУКОВОДСТВО ПРОГРАММИСТА ПО РАБОТЕ С СИСТЕМОЙ ЛОКАЛИЗАЦИИ СЕРВИСОВ IP ТЕЛЕФОНОВ «TAMPING PROXY».
Содержание
1 Введение. 1
2 Конфигурирование. 1
3 Функционирование. 2
4 Форма URL запроса. 3
4.1 Обработка URI из HTTP запроса. 3
4.2 Обработка URL, содержащихся в тэге <a>. 3
5 Настройка преобразования. 3
6 Поддерживаемые HTML тэги с доступными для использования атрибутами 4
7 Наборы символов. 4
2 Введение
Данное программное изделие, именуемое далее просто система, предназначено для обеспечения отображения информации на языках, отличных от английского, на IP телефонах Cisco-7960 и аналогичных им.
Система функционирует как прокси-сервер. Запросы от телефонов перенаправляются на требуемый сервер (см. раздел форма URL запроса), получаемая информация, в зависимости от типа, либо передается телефону без изменений, либо трансформируется в графическое изображение и отправляется на телефон уже в виде картинки.
Таким образом, система в состоянии корректно отображать информацию на любых языках, поддержка которых установлена на машине, на которой данная система запущена. Система поддерживает постраничный вывод информации автоматически.
3 Конфигурирование
Для настройки системы используется конфигурационный файл TampingProxy. ini
§ Секция “Common” – содержит параметры, определяющие функционирование системы в целом.
· MaxThreadCount – задает максимальное число потоков, которое может одновременно использоваться системой для обработки запросов. По умолчанию 10. Изменять не рекомендуется.
· WorkThreadCount – задает число потоков, которые система оставляет в спящем состоянии для обработки вновь приходящих запросов. По умолчанию 2. Изменять не рекомендуется.
· CheckTimeout – задает интервал проверки состояния системы в секундах. По умолчанию 600. Изменять не рекомендуется.
· ModulesPath – абсолютный путь к каталогу, содержащему загружаемые модули системы, в данном случае, файл Tamper. dll (путь без слеша). Необходимо прописать корректное значение этого пути при установке системы.
· CurrentHostOverride – содержит сетевое имя или IP адрес машины, на которой установлена система. При отсутствии этого параметра система пытается сама определить его, что не всегда позволяет получить корректный результат. Поэтому рекомендуется при установке системы прописывать корректное значение этого параметра.
· CurrentPortOverride – задает IP порт, на который система будет получать запросы от телефонов. По умолчанию установлен в 85. Использовать 80-й порт можно лишь в том случае, когда на машине не работает Web-сервер.
· TransferHost – содержит сетевое имя или IP адрес машины с Web-сервером, на которую по умолчанию будут переадресовываться запросы (подробнее см. раздел форма URL запроса). Необходимо прописать корректное значение этого параметра при установке системы.
· TransferPort – содержит номер IP порта для Web-сервера, определяемого параметром TransferHost. По умолчанию – 80. Его необходимо корректировать, только если Web-сервер, который Вы планируете использовать, использует порт отличный от 80-го.
· EnableRedirection – разрешает использование перенаправления запросов на произвольный Web-сервер с использованием специальной формы URL (подробнее см. раздел форма URL запроса). По умолчанию установлен в 1. Изменять не рекомендуется.
§ Секция “Tamper” – содержит настройки специфичные для модуля Tamper.
· DefaultCharacterSet - номер используемого набора символов (см. список Наборы символов). По умолчанию установлен русский.
· PageUpKey – номер клавиши телефона, которая будет использоваться для пролистывания изображения на страницу вверх. По умолчанию – 1. Могут использоваться клавиши 1..9.
· PageDownKey – номер клавиши телефона, которая будет использоваться для пролистывания изображения на страницу вниз. По умолчанию – 3. Могут использоваться клавиши 1..9.
· StyleLibrariesPath – путь к файлам стилевых описаний, в данном случае, default. tss (путь без слеша) (подробнее см. раздел Настройка преобразования). Необходимо прописать корректное значение этого пути при установке системы.
· StyleLibrariesForLoad – имена библиотек стилей, которые будут загружены при загрузке системы, кроме default. tss. Библиотеки стилей загружаются последовательно, начиная с default. tss, а затем в порядке, указанном в этом параметре. При этом одноименные стили замещаются. По умолчанию «».
4 Функционирование.
Система играет роль промежуточного преобразователя между различными информационными системами с одной стороны и IP-телефоном с другой.
Поскольку в настоящее время отсутствует возможность отображать информацию на языках, отличных от английского, средствами телефона, система передает информацию на телефон в виде графического изображения. Если изображение не помещается на экране телефона целиком, система генерирует необходимый набор ссылок, для того, чтобы можно было пролистать изображение постранично вверх и вниз. Пролистывание вправо и влево отсутствует. Это было сделано из-за того, что количество доступных органов управления на телефоне весьма ограничено.
Управление постраничным отображением осуществляется добавлением к URI специальных параметров. Настоятельно не рекомендуется самостоятельно генерировать эти параметры, поскольку в этом случае велика вероятность возникновения конфликтов со следующими версиями системы.
Система перенаправляет запросы от телефона на указанный Web-сервер, обрабатывает полученные ответы и отправляет их на телефон. Также имеется возможность обратиться к произвольному Web-серверу, используя специальную форму URI в запросе.
Система распознает стандартные HTTP1.0 и HTTP1.1 запросы. Все поля запроса, кроме метода запроса, URI, версии протокола, mime-типа и размера содержимого передаются без изменения как в одну, так и в другую стороны. Также сохраняются все параметры, указанные в URI. Таким образом, система не препятствует работе cookies и передаче параметров (необходимо учитывать, что не все версии прошивок для телефонов поддерживают работу с cookies). Запросы к Web-серверу соответствуют протоколу HTTP1.0.
Система распознает следующие mime-типы:
1. text/plain – вся полученная информация конвертируется в изображение без дополнительной обработки.
2. text/html – полученная информация подвергается разбору как HTML страница. Наличие тэга <body> в информации в этом случае обязательно. Распознаваемый набор тэгов ограничен (подробнее см. список Поддерживаемые HTML тэги). Также необходимо отметить, что интерпретация HTML тэгов отличается от стандартной (подробнее см. раздел Настройка преобразования).
3. text/xml – информация без обработки передается телефону.
4. Любые другие mime-типы – информация без обработки передается телефону.
При работе под управлением OC Windows2000/NT система инсталлируется как сервис, под ОС Windows95/98 – работает как консольное приложение.
5 Форма URL запроса.
5.1 Обработка URI из HTTP запроса.
URI подвергается коррекции в двух случаях: абсолютный URI и URI в специальной форме для обращения к произвольному Web-серверу. Относительные URI передаются Web-серверу без изменений.
В абсолютном URI, в случае совпадения имени сервера с конфигурационным параметром CurrentHostOverride, заменяется имя сервера и номер порта на конфигурационные значения TransferHost и TransferPort соответственно. Иначе запрос передается указанному в запросе серверу без изменений.
Специальная форма URI для обращения к произвольному серверу имеет вид: /tp_redirect? TPRURL=’<абсолютный URL>’. Обязательно указывать именно абсолютный URL с протоколом и т. д. В этом случае URI в запросе заменяется на указанный URL и обращение производится к указанному в нем Web-серверу.
5.2 Обработка URL, содержащихся в тэге <a>.
Абсолютные URL, содержащиеся в тэге <a> не изменяются. Для телефона генерируется ссылка, по которой осуществляется запрос в форме обращения к произвольному серверу.
Относительные URL расширяются до абсолютных с использованием URL данной страницы. Если эта страница была запрошена через URL в форме обращения к произвольному серверу, то полученный абсолютный URL также помещают в эту форму.
Рекомендуется внутри информационной системы использовать в тэге <a> относительные URL.
6 Настройка преобразования.
Данный раздел относится, главным образом, к обработке содержимого с mime-типом text/html. Обработка типа text/plain осуществляется с использованием стиля “body” и является частным случаем.
Для управления формой преобразования информации используется механизм стилей.
Стили определяются в файлах с расширением. tss. При загрузке система загружает сначала файл default. tss, а затем файлы, указанные в конфигурационном параметре StyleLibrariesForLoad, в том порядке, в котором они перечислены. Одноименные стили замещают уже загруженные с тем же именем.
Имя стиля имеет вид: <имя тэга>[.<имя класса>]
При отображении тэга стиль выбирается по следующим правилам:
1. Если в тэге присутствует атрибут class, то ищется стиль с именем <тэг>.<класс>
2. Если такой стиль не найден или атрибут class отсутствует, то ищется стиль с именем <тэг>
3. Если и он не найден, то производится попытка отобразить информацию с параметрами по умолчанию для ОС.
Тэги интерпретируются нестандартным образом:
1. Стили, определяемые тэгами, не накладываются друг на друга, а замещаются по принципу стека.
2. Любой тэг автоматически вызывает перевод строки.
3. Любой неизвестный тэг игнорируется, но перевод строки при этом также осуществляется.
Файлы описания стилей имеют следующий формат:
[<имя стиля>]
<параметр>=<значение>
...
В качестве параметров могут использоваться:
· Height – высота фонта в логических единицах (0 или не указано – системное значение по умолчанию)
· AverageWidth – средняя ширина фонта в логических единицах (0 или не указано – системное значение по умолчанию)
· Weight – толщина линий фонта в логических единицах в диапазоне 0..1– по умолчанию, 400 – нормальный, 700 – жирный)
· Attributes – атрибуты, для указания нескольких атрибутов их значения складываются (0 – нормальный, 1 – курсив, 2 – подчеркнутый, 3 – перечеркнутый)
· CharacterSet – набор символов (см. список Наборы символов)
· Face – имя фонта
7 Поддерживаемые HTML тэги с доступными для использования атрибутами
§ <body class=></body>
§ <h1 class=></h1> - <h6 class=></h6>
§ <b class=></b>
§ <i class=></i>
§ <a href=”” class=></a>
8 Наборы символов
§ 0 – ANSI
§ 1 – По умолчанию, выбирается Windows.
§ 2 – Символы.
§ 128 – ShiftJIS
§ 129 – Hangul
§ 130 - Johab
§ 134 – GB2312
§ 136 – Китайский (BIG5)
§ 177 – Hebrew
§ 178 – Арабский
§ 161 – Греческий
§ 162 – Турецкий
§ 163 – Вьетнамский
§ 222 – Тайский
§ 238 – Восточноевропейский
§ 204 – Русский
§ 186 – Стран Балтии
