Работа с номерным планом
Материал из Oktell
Версия от 08:56, 20 марта 2014; Oktell Support (обсуждение | вклад)
Методы для работы с отображением номерного плана
Набор методов и событий для реализации модуля отображения объектов номерного плана и их состояний. Методы осуществления вызовов в разделе логики АТС (здесь).
- string GetPersonalStates ( ). Возвращает состояния объектов номерного плана. Объемный XML установленного образца. Формат обсуждаем. Перечень всех номеров с кодами GUID, префиксами набора, признаком типа номера, в случае если номер индивидуальный стандартный - состояние объекта. Также для каждого стандартного номера перечислены все объекты, входящие в структуру номера. По каждому объекту - код, тип (user, fxsline, usbline, sipline) и ссылкой на отдел, на который назначен. В случае если объект входит в несколько номеров, информация по нему дублирутся в каждом номере.
Формат возвращаемого xml (на примере):
<?xml version="1.0" encoding="utf-16"?> <oktellcommapper version="80710"> <property_set name="number" id="ea156be4-b496-4ddc-9217-fa708cb3a904"> <property_simple key="guid" value="ea156be4-b496-4ddc-9217-fa708cb3a904" /> <property_simple key="prefix" value="12" /> <property_cdata key="caption"><![CDATA[Сметчики]]></property_cdata> <property_simple key="isgroup" value="1" /> <property_simple key="grouptype" value="0" name="standard" /> <property_collection name="elements" count="2"> <property_set name="reactobject" id="cf8330f4-a0bf-4779-9539-ab8ea6c49df7"> <property_simple key="guid" value="cf8330f4-a0bf-4779-9539-ab8ea6c49df7" /> <property_cdata key="department" value="37ccb224-ff71-3836-c410-a73782ef8d19"><![CDATA[Сметный отдел]]></property_cdata> <property_simple key="type" value="0" name="user" /> </property_set> <property_set name="reactobject" id="3145962b-2141-4b63-960e-9fb7142e0c7b"> <property_simple key="guid" value="3145962b-2141-4b63-960e-9fb7142e0c7b" /> <property_cdata key="department" value="00000000-0000-0000-0000-000000000000"><![CDATA[Прочие подразделения]]></property_cdata> <property_simple key="type" value="1" name="fxsline" /> </property_set> </property_collection> </property_set> <property_set name="number" id="a4bb8d39-082a-4fde-957b-ff14ddd66f4e"> <property_simple key="guid" value="a4bb8d39-082a-4fde-957b-ff14ddd66f4e" /> <property_simple key="prefix" value="03" /> <property_cdata key="caption"><![CDATA[Портал знакомств - Главное меню]]></property_cdata> <property_simple key="isgroup" value="1" /> <property_simple key="grouptype" value="2" name="ivr" /> </property_set> </oktellcommapper>
Поле isgroup означает не групповой номер сам по себе, а любой непростой номер, по которому не передается состояния. Возможные типы непростых номеров (поле grouptype):
- standard = 0, //Стандартный групповой.
- fast = 1, //Быстрый набор.
- ivr = 2 //Запуск сценария IVR.
Типы элементов, участвующих в формировании стандартных номеров (поле type ветки reactobject):
- user = 0, //Пользователь
- fxsline = 1, //Внутреннаяя аналоговая линия
- usbline = 2, //USB линия
- sipline = 3 //Внутренний SIP-канал
- void SetListenPersonalChanges ( bool newvalue ). Осуществляет подписку/отписку от режима прослушивания серверных сообщений о факте смены состояния одним из объектов номерного плана. Рекомендуется в целях экономии ресурсов и трафика подключаться только при работе с интерфейсом номерного плана, и отписываться при закрытии интерфейса. На старте работы с интерфейсом - загружать весь перечень и выстраивать по нему, после чего отслеживать изменения. События поступают через канал сервисного оповещения OnCommunicate
- PersonalStateChanged (115). Событие смены состояния объектом номерного плана. Возникает только в случае подписки на события этого типа методом SetListenPersonalChanges.
Пример:
<?xml version="1.0" encoding="utf-16"?> <oktellcommapper version="80710"> <event id="115" name="personalstatechanged"> <property_simple key="guid" value="916351c3-be6a-4a29-877a-6c8c4b54f8af" /> <property_simple key="newstate" value="1" name="usReady" /> </event> </oktellcommapper>