Работа с голосовой почтой - История изменений

Oktell Support в 08:02, 26 марта 2015

2015-03-26T08:02:33Z

Oktell Support в 10:44, 1 апреля 2014

2014-04-01T10:44:33Z

Oktell Support в 08:33, 24 марта 2014

2014-03-24T08:33:51Z

Oktell Support в 07:47, 24 марта 2014

2014-03-24T07:47:36Z

Oktell Support: Новая страница: «Наверх === Методы для работы с голо...»

2014-03-24T07:40:43Z

Новая страница: «Наверх === Методы для работы с голо...»

Новая страница

[[Использование_COM_библиотеки_Oktell_из_других_приложений|Наверх]]

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

*'''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>

@@ Строка 22: / Строка 22: @@
 Примеры входного параметра:
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellcommapper version="80710">
   <data name="voicemail_get">
@@ Строка 30: / Строка 30: @@
     </property_set>
   </data>
-  </oktellcommapper>
+  </oktellcommapper></nowiki>
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellcommapper version="80710">
   <data name="voicemail_get">
@@ Строка 40: / Строка 40: @@
     </property_set>
   </data>
-  </oktellcommapper>
+  </oktellcommapper></nowiki>
 Формат возвращаемого значения (на примере):
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellcommapper version="80710">
   <data name="voicemail" count="1">
@@ Строка 60: / Строка 60: @@
   </property_set>
   </data>
-  </oktellcommapper>
+  </oktellcommapper></nowiki>
@@ Строка 78: / Строка 78: @@
 Примеры входного параметра:
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellcommapper version="80710">
   <data name="voicemail_delete">
@@ Строка 85: / Строка 85: @@
     </property_set>
   </data>
-  </oktellcommapper>
+  </oktellcommapper></nowiki>
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellcommapper version="80710">
   <data name="voicemail_get">
@@ Строка 99: / Строка 99: @@
     </property_set>
   </data>
-  </oktellcommapper>
+  </oktellcommapper></nowiki>
@@ Строка 106: / Строка 106: @@
 Пример входного параметра:
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellcommapper version="80710">
   <data name="voicemail_setlistened">
@@ Строка 113: / Строка 113: @@
     </property_set>
   </data>
-  </oktellcommapper>
+  </oktellcommapper></nowiki>

@@ Строка 1: / Строка 1: @@
-[[Использование_COM_библиотеки_Oktell_из_других_приложений|Наверх]]
+{|cellpadding="10" cellspacing="0" border="0"
 == Методы для работы с голосовой почтой ==
@@ Строка 108: / Строка 114: @@
   </data>
   </oktellcommapper>

@@ Строка 8: / Строка 8: @@
 Сами записи голосовой почты (файлы) располагаются на сервере. Их абсолютный путь содержится в свойстве <span style="color:green">FilePath</span> каждой записи в возвращаемом значении. Файлы следует доставать методом <span style="color:gray">FileOperation</span> (подробнее в разделе [[Файловые операции на сервере|«Файловые операции»]]).
 Все поля в возвращаемом значении являются прямым отображением таблицы базы данных Oktell A_VoiceMail.
 Голосовая почта формируется в сценариях всех типов компонентом «Голосовая почта».
 Примеры входного параметра: