Работа с номерным планом — различия между версиями

Текущая версия на 08:05, 26 марта 2015

Методы для работы с отображением номерного плана

Набор методов и событий для реализации модуля отображения объектов номерного плана и их состояний. Методы осуществления вызовов в разделе логики АТС (здесь).

• string GetPersonalStates ( ). Возвращает состояния объектов номерного плана. Объемный XML установленного образца. Формат обсуждаем. Перечень всех номеров с кодами GUID, префиксами набора, признаком типа номера, в случае если номер индивидуальный стандартный - состояние объекта. Также для каждого стандартного номера перечислены все объекты, входящие в структуру номера. По каждому объекту - код, тип (user, fxsline, usbline, sipline) и ссылкой на отдел, на который назначен. В случае если объект входит в несколько номеров, информация по нему дублирутся в каждом номере.

Формат возвращаемого xml (на примере):

<?xml version="1.0" encoding="utf-16"?>
 <oktellcommapper version="80710">
 <data name="personal" count="2">
   <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>
 </data>
 </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">
 <data>
   <event id="115" name="personalstatechanged">
     <property_simple key="guid" value="916351c3-be6a-4a29-877a-6c8c4b54f8af" />
     <property_simple key="newstate" value="1" name="usReady" />
   </event>
 </data>
 </oktellcommapper>