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

Материал из Oktell
Перейти к: навигация, поиск
(Новая страница: «Наверх === Методы для работы с голо...»)
 
 
(не показаны 3 промежуточные версии этого же участника)
Строка 1: Строка 1:
[[Использование_COM_библиотеки_Oktell_из_других_приложений|Наверх]]
+
{|cellpadding="10" cellspacing="0" border="0"
 +
| [[Использование_COM_библиотеки_Oktell_из_других_приложений|Наверх]]
 +
| [[Работа с правилами переадресации|Работа с правилами переадресации<<<]]
 +
| [[Работа с голосовой почтой]]
 +
| [[Работа с заказами на встречные звонки|>>>Работа с заказами на встречные звонки]]
 +
|-
 +
|}
  
=== Методы для работы с голосовой почтой ===
+
== Методы для работы с голосовой почтой ==
  
 
*'''<span style="color:blue">string</span> VoiceMail_Get ( <span style="color:blue">string</span> xml )'''. Возвращает XML-строку с метаданными о голосовых сообщениях, адресованных непосредственно авторизованному пользователю или на группу (отдел, групповой номер), куда он относится. В случае ошибки возвращается <span style="color:blue">NULL</span>.
 
*'''<span style="color:blue">string</span> VoiceMail_Get ( <span style="color:blue">string</span> xml )'''. Возвращает XML-строку с метаданными о голосовых сообщениях, адресованных непосредственно авторизованному пользователю или на группу (отдел, групповой номер), куда он относится. В случае ошибки возвращается <span style="color:blue">NULL</span>.
Строка 8: Строка 14:
  
 
Сами записи голосовой почты (файлы) располагаются на сервере. Их абсолютный путь содержится в свойстве <span style="color:green">FilePath</span> каждой записи в возвращаемом значении. Файлы следует доставать методом <span style="color:gray">FileOperation</span> (подробнее в разделе [[Файловые операции на сервере|«Файловые операции»]]).
 
Сами записи голосовой почты (файлы) располагаются на сервере. Их абсолютный путь содержится в свойстве <span style="color:green">FilePath</span> каждой записи в возвращаемом значении. Файлы следует доставать методом <span style="color:gray">FileOperation</span> (подробнее в разделе [[Файловые операции на сервере|«Файловые операции»]]).
 +
  
 
Все поля в возвращаемом значении являются прямым отображением таблицы базы данных Oktell A_VoiceMail.
 
Все поля в возвращаемом значении являются прямым отображением таблицы базы данных Oktell A_VoiceMail.
  
 
Голосовая почта формируется в сценариях всех типов компонентом «Голосовая почта».
 
Голосовая почта формируется в сценариях всех типов компонентом «Голосовая почта».
 
  
 
Примеры входного параметра:
 
Примеры входного параметра:
  
  <?xml version="1.0" encoding="utf-16"?>
+
  <nowiki><?xml version="1.0" encoding="utf-16"?>
 
  <oktellcommapper version="80710">
 
  <oktellcommapper version="80710">
 
  <data name="voicemail_get">
 
  <data name="voicemail_get">
Строка 24: Строка 30:
 
   </property_set>
 
   </property_set>
 
  </data>
 
  </data>
  </oktellcommapper>
+
  </oktellcommapper></nowiki>
  
  
  <?xml version="1.0" encoding="utf-16"?>
+
  <nowiki><?xml version="1.0" encoding="utf-16"?>
 
  <oktellcommapper version="80710">
 
  <oktellcommapper version="80710">
 
  <data name="voicemail_get">
 
  <data name="voicemail_get">
Строка 34: Строка 40:
 
   </property_set>
 
   </property_set>
 
  </data>
 
  </data>
  </oktellcommapper>
+
  </oktellcommapper></nowiki>
  
  
 
Формат возвращаемого значения (на примере):
 
Формат возвращаемого значения (на примере):
  
  <?xml version="1.0" encoding="utf-16"?>
+
  <nowiki><?xml version="1.0" encoding="utf-16"?>
 
  <oktellcommapper version="80710">
 
  <oktellcommapper version="80710">
 
  <data name="voicemail" count="1">
 
  <data name="voicemail" count="1">
Строка 54: Строка 60:
 
  </property_set>
 
  </property_set>
 
  </data>
 
  </data>
  </oktellcommapper>
+
  </oktellcommapper></nowiki>
  
  
Строка 72: Строка 78:
 
Примеры входного параметра:
 
Примеры входного параметра:
  
  <?xml version="1.0" encoding="utf-16"?>
+
  <nowiki><?xml version="1.0" encoding="utf-16"?>
 
  <oktellcommapper version="80710">
 
  <oktellcommapper version="80710">
 
  <data name="voicemail_delete">
 
  <data name="voicemail_delete">
Строка 79: Строка 85:
 
   </property_set>
 
   </property_set>
 
  </data>
 
  </data>
  </oktellcommapper>
+
  </oktellcommapper></nowiki>
  
  
  <?xml version="1.0" encoding="utf-16"?>
+
  <nowiki><?xml version="1.0" encoding="utf-16"?>
 
  <oktellcommapper version="80710">
 
  <oktellcommapper version="80710">
 
  <data name="voicemail_get">
 
  <data name="voicemail_get">
Строка 93: Строка 99:
 
   </property_set>
 
   </property_set>
 
  </data>
 
  </data>
  </oktellcommapper>  
+
  </oktellcommapper></nowiki>  
  
  
Строка 100: Строка 106:
 
Пример входного параметра:
 
Пример входного параметра:
  
  <?xml version="1.0" encoding="utf-16"?>
+
  <nowiki><?xml version="1.0" encoding="utf-16"?>
 
  <oktellcommapper version="80710">
 
  <oktellcommapper version="80710">
 
  <data name="voicemail_setlistened">
 
  <data name="voicemail_setlistened">
Строка 107: Строка 113:
 
   </property_set>
 
   </property_set>
 
  </data>
 
  </data>
  </oktellcommapper>
+
  </oktellcommapper></nowiki>
 +
 
 +
 
 +
{|cellpadding="10" cellspacing="0" border="0"
 +
| [[Использование_COM_библиотеки_Oktell_из_других_приложений|Наверх]]
 +
| [[Работа с правилами переадресации|Работа с правилами переадресации<<<]]
 +
| [[Работа с голосовой почтой]]
 +
| [[Работа с заказами на встречные звонки|>>>Работа с заказами на встречные звонки]]
 +
|-
 +
|}

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

Наверх Работа с правилами переадресации<<< Работа с голосовой почтой >>>Работа с заказами на встречные звонки

Методы для работы с голосовой почтой

  • string VoiceMail_Get ( string xml ). Возвращает XML-строку с метаданными о голосовых сообщениях, адресованных непосредственно авторизованному пользователю или на группу (отдел, групповой номер), куда он относится. В случае ошибки возвращается NULL.

В качестве входного параметра может выступать пустая строка или NULL, тогда возвращены будут все сообщения. Параметр может содержать стандартную XML структуру, содержащую информацию о фильтре. Свойство onlynew осуществляет фильтр голосовых сообщений по признаку прослушано/не прослушано (по умолчанию «0» - возвращать все записи, «1» - возвращать только непрослушанные). Свойство topcount позволяет задать количество возвращаемых записей (по умолчанию «-1» - возвращать все записи). При этом будут отбираться преимущественно самые последние записи.

Сами записи голосовой почты (файлы) располагаются на сервере. Их абсолютный путь содержится в свойстве FilePath каждой записи в возвращаемом значении. Файлы следует доставать методом FileOperation (подробнее в разделе «Файловые операции»).


Все поля в возвращаемом значении являются прямым отображением таблицы базы данных Oktell A_VoiceMail.

Голосовая почта формируется в сценариях всех типов компонентом «Голосовая почта».

Примеры входного параметра:

<?xml version="1.0" encoding="utf-16"?>
 <oktellcommapper version="80710">
 <data name="voicemail_get">
   <property_set>
     <property_simple key="onlynew" value="0" />
     <property_simple key="topcount" value="10" />     
   </property_set>
 </data>
 </oktellcommapper>


<?xml version="1.0" encoding="utf-16"?>
 <oktellcommapper version="80710">
 <data name="voicemail_get">
   <property_set>
     <property_simple key="onlynew" value="1" />
   </property_set>
 </data>
 </oktellcommapper>


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

<?xml version="1.0" encoding="utf-16"?>
 <oktellcommapper version="80710">
 <data name="voicemail" count="1">
 <property_set name="voicemail" id="0">
   <property_cdata key="datetimeformat"><![CDATA[dd.MM.yyyy HH:mm:ss]]></property_cdata>
   <property_simple key="id" value="6d2cd2d7-6c30-47e2-9389-3183a07801ee" />
   <property_cdata key="senttime"><![CDATA[25.02.2009 13:55:22]]></property_cdata>
   <property_cdata key="receivedtime"><![CDATA[25.02.2009 13:55:29]]></property_cdata>
   <property_cdata key="callerid"><![CDATA[8435109940]]></property_cdata>
   <property_cdata key="info"><![CDATA[IVR: Входящий в офис]]></property_cdata>
   <property_cdata key="filepath"><![CDATA[H:\VoiceMail\ln_16016__2009_02_25__13_55_20_546.wav]]></property_cdata>
   <property_simple key="isnew" value="0" />
   <property_cdata key="firstreceiver" value="6d2cd2d7-6c30-47e2-9389-3183a07801ee"><![CDATA[Евграфов Антон Львович]]></property_cdata>
 </property_set>
 </data>
 </oktellcommapper>


  • Поле datetimeformat устанавливает текущий формат строкового представления значений типа дата/время. Именно указанным образом его и следует преобразовывать обратно.
  • id - guid-идентификатор сообщения голосовой почты.
  • senttime - время отправки голосового сообщения из сценария.
  • receivedtime - время первого прослушивания голосового сообщения.
  • callerid - номер абонента, оставившего сообщение.
  • info - информация о сценарии-отправителе.
  • filepath - абсолютный путь на сервере к файлу с записью голосового сообщения.
  • isnew - различает, было ли сообщение уже прослушано/не прослушано.
  • firstreceiver - идентификатор и имя пользователя, первым прослушавшим сообщение.


  • void VoiceMail_Delete ( string xml ). Удаляет запись голосовой почты из БД по указанному идентификатору, не затрагивая сам файл записи. Может быть указано сразу несколько идентификаторов для удаления.

Примеры входного параметра:

<?xml version="1.0" encoding="utf-16"?>
 <oktellcommapper version="80710">
 <data name="voicemail_delete">
   <property_set>
     <property_simple key="id" value="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" />
   </property_set>
 </data>
 </oktellcommapper>


<?xml version="1.0" encoding="utf-16"?>
 <oktellcommapper version="80710">
 <data name="voicemail_get">
   <property_set>
     <property_simple key="id" value="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" />
     <property_simple key="id" value="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" />
     <property_simple key="id" value="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" />
     <property_simple key="id" value="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" />
     <property_simple key="id" value="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" />
   </property_set>
 </data>
 </oktellcommapper> 


  • void VoiceMail_SetListened ( string xml ). Выставляет для указанной записи флаг «Прослушано». В дальнейшем при обращении к голосовой почте методом VoiceMail_Get() в метаданных будет указано, что запись была прослушана, а также будет заполнено свойство FirstReceiver, устанавливая идентификатор пользователя, первым прослушавшим запись. Также запись будет исключена при запросе только новой почты.

Пример входного параметра:

<?xml version="1.0" encoding="utf-16"?>
 <oktellcommapper version="80710">
 <data name="voicemail_setlistened">
   <property_set>
     <property_simple key="id" value="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" />
   </property_set>
 </data>
 </oktellcommapper>


Наверх Работа с правилами переадресации<<< Работа с голосовой почтой >>>Работа с заказами на встречные звонки