Работа с голосовой почтой — различия между версиями
(Новая страница: «Наверх === Методы для работы с голо...») |
|||
(не показаны 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>
Наверх | Работа с правилами переадресации<<< | Работа с голосовой почтой | >>>Работа с заказами на встречные звонки |