WWW.MASH.DOBROTA.BIZ
БЕСПЛАТНАЯ  ИНТЕРНЕТ  БИБЛИОТЕКА - онлайн публикации
 

«Оглавление 1 WebAPI Client для 3CX 2 Системные требования. 3 Лицензирование. 4 Установка. 4.1 Сетевые ключи. 4.1.1 Установка сервера лицензирования 4.1.2 Активация ...»

WebAPI Client for 3CX

2.8.0 for 3CX v14 SP2, SP3

Оглавление

1 WebAPI Client для 3CX

2 Системные требования.

3 Лицензирование.

4 Установка.

4.1 Сетевые ключи.

4.1.1 Установка сервера лицензирования

4.1.2 Активация программного сетевого ключа.

4.1.3 Подготовительный этап.

4.1.4 Установка WebAPI Client.

4.1.5 Установка WebAPI Client plugin на пользовательском ПК.

4.2 Однопользовательские ключи.

4.3 Trial версия.

5 Плагин «WebAPI Client Plugin».

5.1 Системные требования для WebAPI Client Plugin

6

Работа с ПО на терминальном сервере.

7 Описание интерфейса внешнего компонента

7.1 Свойства

7.2 Методы

7.2.1 Подключение к АТС, управление статусом.

7.2.2 Общие методы для работы с вызовами

7.2.3 Методы для работы с софтфоном 3CXPhone

7.2.4 Методы для работы с аппаратными телефонами, поддерживающими CTI

7.2.5 Работа с конференциями

7.2.6 Работа с чатом

7.2.7 Работа с телефонной книгой

7.2.8 Получение истории вызовов

7.2.9 Воспроизведение записи вызова

7.3 События

7.4 Структура параметра Данные для обработчика события.

7.4.1 Тип события «channel»

7.4.2 Тип события «phone»

7.4.3 Тип события «plugin»

7.4.4 Тип события «group»

7.4.5 Тип события «groupmember»

7.4.6 Тип события «extensioninfo»

7.4.7 Тип события «localconnection»

7.4.8 Тип события «3cxphonecall»

7.4.9 Тип события «3cxphoneline»

7.4.10 Тип события «conf»

7.4.11 Тип события «queueagent»

7.4.12 Тип события «chatmessage»

7.4.13 Тип события «chathistory»

7.4.14 Тип события «contact»

7.4.15 Тип события «addcontact»

7.4.16 Тип события «updatecontact»

7.4.17 Тип события «deletecontact»

7.4.18 Тип события «findcontact»

7.4.19 Тип события «callhistory»

8 Примеры кода для 1С 8

8.1 Загрузка ВК 1С.

8.2 Обработка внешних событий в 1С.

8.3 Обработка параметра Данные.

9 Тестовая обработка ТФ3_Панель_ОП_2_5.epf

10 Контактная информация.

1 WebAPI Client для 3CX Компонент WebAPI Client для 3CX предназначен для интеграции IP-АТС 3CX Phone System с программным обеспечением, поддерживающим использование компонентов Component Object Model (COM). С помощью WebAPI Client можно осуществить полнофункциональную интеграцию IP-АТС 3CX Phone System с 1С:Предприятие, продуктами Microsoft, различными CRM системами; сценариями VBScript и JavaScript и т.д.. Функционал компонента полностью идентичен функционалу софтфона 3CXPhone for 3CX Phone System, находящегося в режиме CTI (управления настольным телефоном). Компонент работает с любыми моделями аппаратных или программных телефонов .

Функционал компонента .

Управление состоянием оператора:

- регистрация / отмена регистрации на сервере 3CX;

- управление статусом присутствия;

- управление статусом DND (не беспокоить);

- регистрация / отмена регистрации в очередях;

- выбор абонентского устройства для управления, при наличии нескольких устройств .

Работа с собственными вызовами оператора из 1С:





- осуществление исходящего вызова;

- ответ на входящий вызов (при использовании софтфона 3CXPhone или аппаратного телефона с поддержкой CTI);

- сброс входящего или активного вызова;

- перевод входящего вызова без поднятия трубки;

- слепой (безконсультативный) перевод вызова;

- сопроводительный перевод (консультативный);

- удержание / снятие с удержания;

- отключение / включение микрофона;

- отправка DTMF сигналов;

- получение истории вызовов с возможностью фильтрации по датам, номерам телефонов и типу вызовов;

- воспроизведение записей вызовов .

Работа с вызовами других операторов из 1С:

- перехват входящего не отвеченного вызова;

- сброс вызова;

- перевод вызова;

- вмешательство в активный разговор;

- подслушивание разговора;

- режим «подсказки» .

Работа с конференциями:

- создание конференции;

- добавление / удаление участников конференции;

- включение / отключение звука участнику конференции;

- завершение конференции .

Работа с внутренним чатом 3CX Phone System:

- отправка, прием, удаление сообщений;

- получение истории сообщений чата .

Работа с телефонной книгой:

- получение контактов из персональной и корпоративной телефонных книг;

- поиск контакта в телефонной книге;

- добавление, редактирование и удаление контактов в телефонной книге .

On-line получение информации и событий с АТС:

- информация обо всех внутренних номерах 3CX Phone System: номер, фамилия и имя абонента; номер мобильного телефона; статусы регистрации на АТС, DND, занятости, регистрации в очереди; регистрации в чате; текстового статуса;

- события при изменении каких-либо данных внутренних абонентов;

- информация обо всех активных вызовах 3CX Phone System: номер, имя, фамилия вызывающего; номер, имя, фамилия вызываемого; время начала вызова; время ответа на вызов; текущее состояние вызова; тип линии;

- события при возникновении или изменения статуса соединений .

2 Системные требования .

1. Операционная система: Windows 7, Windows 8, Windows Server 2003 - 2012 (x86 или x64) .

2. IP-АТС 3CX Phone System следующих редакций: Standart v.14 SP2; PRO v.14 SP2 .

3. Установленный софтфон 3CXPhone for 3CX Phone System, идущий в составе 3CX Phone System. Запуск 3CXPhone при работе с аппаратными телефонами и сторонними софтфонами не требуется .

4. Наличие звуковой карты и аудио устройств (при работе с софтфонами в качестве абонентского устройства) .

5. Возможность подключения к ПК, на котором установлена АТС 3CX Phone System, по TCP/IP портам 5000, 5001, 80, 443 или других, в зависимости от того какие порты были выбраны при установке АТС .

3 Лицензирование .

Продукт является распространяемым по принципу "попробуй перед тем, как купить". Вы можете бесплатно использовать WebAPI Client для 3CX на протяжении 30 дней с момента установки Продукта (пробный период). После окончания пробного периода продукт прекратит работу с выдачей соответствующего сообщения. Для использования WebAPI Client для 3CX после окончания пробного периода необходимо приобрести лицензию на использование .

4 Установка .

4.1 Сетевые ключи .

4.1.1 Установка сервера лицензирования .

1. Загрузите Сервер лицензий Guardant 7 по ссылке: http://www.guardant.ru/support/download/server/ .

2. Установите Сервер лицензий Guardant 7 на ПК\Сервер, который будет использоваться в качестве сервера лицензирования .

3. Подключите аппаратный ключ к серверу лицензирования. Если вы приобрели программный ключ, выполните действия из п.4.1.2 .

4. Сохраните конфигурационный файл настроек клиента Сервера лицензирования, для распространения .

4.1. Зайдите на панель управления сервера лицензирования ("http://localhost:3185/" с сервера лицензирования или "http://IP_адрес_сервера_лицензирования:3185/" с любого ПК в сети .

4.2. Кликните на ссылке "Client's setting" .

4.3. Создайте файл gnclient.ini и скопируйте в него строки со страницы настроек "Client's setting", начиная со строки [CLIENT] .

4.1.2 Активация программного сетевого ключа .

1. Запустите на сервере лицензирования "Activation Wizard" (GuardantActivationWizard.exe) .

2. В открывшемся окне "Мастера активации Guardant" нажмите кнопку "Указать файл лицензии" и укажите высланный вам шаблон ключа (файл ххххххх.grdvd) и нажмите "Далее" .

3. Введите в поле предоставленный вам серийный номер и нажмите "Далее", при успешной активации появится соответствующее сообщение .

4.1.3 Подготовительный этап .

1. Если вы работаете с 1С:Предприятие на терминальном сервере, то установите софтфон 3CXPhone на терминальном сервере, в противном случае установите софтфон на пользовательский ПК .

2. Настройте аккаунт на софтфоне (проще всего и быстрее это сделать через Welcome Email) .

3. Проверьте работоспособность софтфона .

4. Важно!!! Если на панели софтфона отсутствует "статус присутствия", или окно "Сведения о присутствии"» не открывается, или в нем отсутствует список абонентов, то это говорит о некорректной работе софтфона из-за средств безопасности ОС, антивирусного ПО, настроек Веб сервера и т.п., и, соответственно, это влияет на работоспособность WebAPI Client, добейтесь полной работоспособности 3CXPhone .

5. Если в качестве абонентского устройства используется аппаратный телефон или 1С расположено на терминальном сервере, а софтфон 3CXPhone - на пользовательском ПК, то последующий запуск софтфона не требуется .

6. Зарегистрируйте библиотеку 1С addnmrs.dll (находится в каталоге bin, например C:\Program Files (x86)\1cv82\8.2.19.76\bin) .

7. Зарегистрируйте библиотеку 1С comctrl.dll (находится в каталоге bin, например C:\Program Files (x86)\1cv82\8.2.19.76\bin) .

4.1.4 Установка WebAPI Client .

1. Запустите установщик от имени администратора на сервере терминалов или на пользовательском ПК, в зависимости от того где у вас запускается 1С:Предприятие .

2. В окне выбора компонентов отметьте "WebAPI Client for 3CX" .

3. Если в качестве абонентского устройства используется софтфон 3CXPhone, расположеный там же, где и 1С, то в окне выбора компонентов дополнительно отметьте "WebAPI Client Plugin for 3CX" .

4. Если 1С используется на терминальном сервере, а софтфон используется на клиентском ПК, то требуется отдельная установка плагина на клиентском ПК (п.4.1.5) .

5. Выполните все действия для завершения установки выбранных компонентов .

6. Скопируйте файл gnclient.ini (п.4.1.1 п.п. 4) в каталог установки WebAPI Client (c:\program files(x86)\Interface Ltd\WebAPI Client for 3CX\) .

7. Предоставьте пользователям сервера терминалов \ ПК права на запись и изменение файлов в каталоге установки .

4.1.5 Установка WebAPI Client plugin на пользовательском ПК .

Если 1С используется на терминальном сервере, а софтфон используется на клиентском ПК, то установите WebAPI Client Plugin на ПК .

1. Запустите установщик от имени администратора на ПК .

2. В окне выбора компонентов отметьте "WebAPI Client Plugin for 3CX" .

3. Выполните все действия для завершения установки выбранных компонентов .

4. Скопируйте файл gnclient.ini (п.4.1.1 п.п. 10) в каталог установки WebAPI Client (c:\program files(x86)\Interface Ltd\WebAPI Client for 3CX\) .

5. Предоставьте пользователям ПК права на запись и изменение файлов в каталоге установке .

4.2 Однопользовательские ключи .

Важно!!! Однопользовательские ключи не работают в терминальных сессиях .

1. Выполните подготовительный этап (п.4.1.3) применительно к ПК .

2. Запустите установщик от имени администратора .

3. В окне выбора компонентов отметьте «WebAPI Client for 3CX» и «Драйвер Giardant» .

4. Если в качестве абонентского устройства используется софтфон 3CXPhone, то в окне выбора компонентов дополнительно отметьте "WebAPI Client Plugin for 3CX" .

5. Выполните все действия для завершения установки выбранных компонентов .

6. Подключите аппаратный ключ к ПК .

7. Если вы приобрели программный ключ, запустите "Activation Wizard" из меню "Пуск" - "WebAPI Client for 3CX" и выполните активацию лицензии согласно п.4.1.2 п.п.2-3 .

4.3 Trial версия .

1. Выполните подготовительный этап (п.4.1.3) применительно к ПК или к серверу терминалов .

2. Установите WebAPI Client согласно п.4.1.4 п.п.1-5 и, при необходимости, согласно п.4.1.4 п.п.1-3 .

3. Запустите "Activation Wizard" из меню "Пуск" - "WebAPI Client for 3CX" на терминальном сервере или клиентском ПК, в зависимости от того, где вы запускаете 1С .

4. В открывшемся окне "Мастера активации Guardant" выделите лицензию "ifClient Trial" и нажмите "Далее" .

5. Введите в поле серийный номер и нажмите "Далее", при успешной активации появится соответствующее сообщение .

6. Если 1С используется на терминальном сервере, а софтфон используется на клиентском ПК, то выполните активацию плагина на клиентском согласно п.4.3 п.п.3-5 .

Возможные проблемы .

1. В 1С не отображаются абоненты, доступные для пользователя (из тех же групп, участником которых он является) .

Решение .

При запуске софтфона 3CXPhone не должно появляться сообщение «3CX Phone для Windows не удалось установить соединение с 3CX Phone System Web API. В результате некоторые функции …». Данное сообщение говорит об отсутствии трафика между АТС и софтфоном и, соответственно, между АТС и компонентом .

Проверьте работоспособность окна «Сведения о присутствии» софтфона 3CXPhone, предварительно настроив 3CXPhone на работу с АТС. Правильнее всего осуществлять настройку аккаунта в софтфоне через отправку «Welcome Email». Если на панели софтфона отсутствует «статус присутствия», или окно «Сведения о присутствии» не открывается, или в нем отсутствует список абонентов, то это говорит о некорректной работе софтфона из-за средств безопасности ОС, антивирусного ПО, настроек Веб сервера и т.п., и, соответственно, это влияет на работоспособность компонента. Добейтесь полной работоспособности 3CXPhone .

Если у вас недостаточно опыта настройки IIS, то рекомендуем использовать Abyss Web Server .

2. 3CXPhone работает корректно, но события телефонии не поступают в 1С .

Решение. Зарегистрируйте библиотеку 1С addnmrs.dll .

3. 1С не загружает компонент, 1С выбивает при загрузке компонента .

Решение. Зарегистрируйте библиотекe 1С comctrl.dll .

4. События в 1С поступают с большой задержкой (На текущий момент данная проблемы выявлена при использовании антивирусного ПО Kaspersky) .

Решение. Исключите из контроля сетевых портов порты, используемые веб-сервисом сведений о присутствии .

5. В 1С недоступен некоторый функционал, например, подсказка, перехват .

Решение. Установите соответствующие права пользователю на АТС .

5 Плагин «WebAPI Client Plugin» .

Плагин предназначен для повышения удобства использования софтфона 3CXPhone for 3CX Phone System в качестве абонентского устройства. При установке плагина вносятся изменения в файл 3CXWin8Phone.user.config .

Изменения в файле 3CXWin8Phone.user.config. В строку с ключем CRMPlugin добавляется ссылка на плагин:

add key="CRMPlugin" value="CallTriggerCmdPlugin,WebAPI_3CX_1C_Plugin"/

–  –  –

5.1 Системные требования для WebAPI Client Plugin

1. Операционная система: Windows 7, Windows 8, Windows Server 2003 - 2012 (x86 или x64) .

2. Microsoft.NET Framework 4.5 и выше .

3. Софтфон 3CXPhone, подключенная к ПК гарнитура .

Важно! Плагин версии 2.6.0 работает только с 3CXPhone из состава 3CX Phone System 14 SP2, 14 SP3 .

6 Работа с ПО на терминальном сервере .

Для работы с ПО, расположенным на терминальном сервере, компонент должен устанавливаться на терминальном сервере. Если в качестве абонентского устройства на клиентском ПК используется софтфон 3CXPhone, то на клиентский ПК необходимо установить плагин WebAPI Client Plugin .

7 Описание интерфейса внешнего компонента .

7.1 Свойства Address Использование: чтение и запись .

Тип: строка .

Описание: URL сервиса 3CX следующего вида http://IPAddress|FQDN:порт/MyPhone/MPWebService.asmx .

Получить URL для 3CX v14 SP2 можно в консоли управления 3CX Server Manager: «Troubleshooting» «Parameters»

«Пользовательские параметры», затем набрать в строке поиска «MYPHONE_LINK» .

CallerIdMinMatch Использование: чтение и запись .

Тип: число .

Описание: минимальное количество цифр в номере телефона для идентификации при поиске в истории и записях вызовов. CallerId сравниваются справа налево по количеству цифр, заданных CallerIdMinMatch. По умолчанию 10 (оптимальное значение) .

CurrentPhoneId Использование: чтение и запись .

Тип: число .

Описание: Id текущего устройства. Свойство позволяет задавать каким устройством будет происходить управление .

Переключение устройства можно производить в процессе работы. Если в качестве текущего устройства выбрать аппаратный телефон, то также возможно управление софтфоном 3CXPhone при помощи методов, предназначенных для работы с 3CXPhone .

Внимание! Компонент не задает текущее устройство. Выбор устройства необходимо осуществить непосредственно в интегрируемом приложении, даже при наличии только одного устройства .

CurrentProfileId Использование: чтение и запись .

Тип: число .

Описание: Id текущего статуса. Свойство позволяет задать статус присутствия .

IsSupportsCTI Использование: только чтение .

Тип: булево .

Описание: поддержка текущим абонентским устройством (аппаратным телефоном) удаленного управления (CTI) .

«Истина» - поддерживает, «Ложь» - не поддерживает. Список моделей телефонов, поддерживающих удаленное управление, можно найти в файле C:\ProgramData\3CX\Data\Http\Interface\MyPhone\cti_template.xml. Так же информацию о поддержке CTI можно получить из свойства UserPhonesList .

При поддержке телефоном CTI доступны следующие методы:

- SupportedCTICommands;

- AnswerCallCTI;

- MakeCallCTI;

- HoldCTI;

- DropCallCTI;

- AttendantTransferCTI;

- BlindTransferCTI;

- FinalizeTransferCTI;

- PressDialKeyCTI;

- MuteCTI;

- SpeakerOnOffCTI;

- PressLineKeyCTI .

OnlyMyConnection Использование: чтение и запись .

Тип: булево .

Описание: выводить события только о собственных соединениях оператора. Истина – только собственные, ложь – события обо всех соединениях, доступных оператору в соответствии с правами на 3CX RequestTimeOut Использование: чтение и запись .

Тип: число .

Описание: время ожидания ответа от Web-сервиса 3CX, после которого происходит разрыв соединения. В 3CX по умолчанию 30 секунд .

UserName Использование: чтение и запись .

Тип: строка .

Описание: внутренний номер / User ID для аутентификации на 3CX Phone System .

UserPassword Использование: чтение и запись .

Тип: строка .

Описание: пароль для аутентификации на 3CX Phone System .

UserPhonesList Использование: только чтение .

Тип: COMSafeArray .

Описание: список всех устройств, зарегистрированных под User ID пользователя. Каждый элемент массива –

COMОбъект со следующими свойствами:

Id Тип: число Описание: уникальный идентификатор устройства на АТС. Внимание! Уникальность только в рамках регистрации. При разрегистрации-регистрации устройства или при перезагрузке АТС Id изменяется .

UserAgent Тип: строка Описание: наименование устройства Type Тип: число Описание: тип устройства .

Значения:

- 1 – софтфон 3CXPhone

- 2 – аппаратный телефон с поддержкой CTI (совместимый с 3CXPhone System)

- 3 – телефон без поддержки CTI, сторонний софтфон Contact Тип: COMОбъект

Описание: сетевая информация об устройстве. Объект содержит следующие свойства:

–  –  –

UserProfilesList Использование: только чтение .

Тип: COMSafeArray .

Описание: список статусов присутствия. Каждый элемент массива – COMОбъект со следующими свойствами:

–  –  –

ExtendedStatus Тип: строка Описание: собственное сообщение статуса AddressWin8Phone - с версии 1.2.0 свойство не используется, оставлено для совместимости .

Использование: чтение и запись .

Тип: строка .

Значение по умолчанию: 127.0.0.1 Описание: IP адрес ПК с 3CXPhone for 3CX Phone System2 .

PortWin8Phone - с версии 1.2.0 свойство не используется, оставлено для совместимости .

Использование: чтение и запись .

Тип: целое .

Значение по умолчанию: 8031 Описание: порт 3CXPhone for 3CX Phone System1 .

Для изменения порта слушателя в плагине WebAPI_3CX_1C_Plugin можно задать параметр в файле конфигурации 3CXWin8Phone.exe.config:

add key="Connector3CXListenPort" value="8031" / UsePlugin – c версии 2.5.0 не используется, оставлено для совместимости. C версии 2.5.0 при использовании методов, предназначенных для работы с 3CXPhone, подразумевается работоспособность плагина для 3CXPhone. Свойство необходимо использовать если для исходящего вызова через софтфон используется метод MakeCall2 .

Использование: чтение и запись .

Тип: булево .

Значение по умолчанию: Ложь .

Описание: использовать плагин WebAPI_3CX_1C_Plugin2. Установка свойства в значение «Истина» имеет смысл, только при использовании в качестве абонентского устройства софтфона 3CXPhone .

Если свойство установлено как «Ложь», то методы выполняются путем запросов к АТС. Если свойство установлено в «Истина», то становится доступным выполнение части методов, а выполнение ряда методов происходит непосредственно на 3CXPhone .

Методы, становящиеся доступными для выполнения:

- AnswerCall;

- AnswerCall3CXPhone;

- ChangeLine3CXPhone;

- DropCall3CXPhone;

- GetLinesStatus3CXPhone;

- MicMute;

- MicUnMute;

- StopRecordCall .

Методы, выполняющиеся на софтфоне 3CXPhone при использовании плагина:

- MakeCall2;

- StartRecordCall .

7.2 Методы Все методы ВК реализованы как асинхронные, то есть ни один метод не ожидает завершения операции, что позволяет исключить зависания при ожидании ответа. Таким образом, все методы компонента не имеют возвращаемых значений (кроме метода Connected) .

Используются для взаимодействия с 3CXPhone. Требует установленного плагина WebAPI_3CX_1C_Plugin .

После асинхронного выполнения метода внешняя компонента инициирует внешнее событие 1С с соответствующим маркером, что позволяет обрабатывать результаты вызова методов независимо .

7.2.1 Подключение к АТС, управление статусом .

Connect() Описание: осуществляет подключение компонента к серверу 3CX. Вызов метода инициирует передачу компонентом ряда событий: group; groupmember; localconnection. Пользователю передаются события только по тем группам внутренних абонентов, участником которых он является .

Connected() Описание: возвращает истину, если компонент подключен к серверу 3CX, ложь - не подключен .

Disconnect() - отключение от сервера 3CX .

Описание: осуществляет отключение компонента от сервера 3CX .

GetAllExtensions() Описание: получение данных о внутренних номерах АТС. Вызов метода инициирует передачу компонентом событий extensioninfo. На каждый внутренний номер передается отдельное событие .

GetAllGroups() .

Описание: с версии 1.1.5 не используется, метод оставлен для совместимости .

SetDND(Значение)

Параметры:

Значение (обязательный) Тип: Целое .

1 – включить режим DND, 0 – выключить режим DND .

Описание: включить или отключить режим DND (не беспокоить) .

SetQueue(Значение)

Параметры:

Значение (обязательный) Тип: Целое .

1 – зарегистрироваться в очередях, 0 – отменить регистрацию в очередях .

Описание: регистрация или отмена регистрации во всех очередях .

7.2.2 Общие методы для работы с вызовами DivertCall(Номер, Id соединения )

Параметры:

Номер (обязательный) Тип: Строка .

Номер или SIP Id на который необходимо выполнить перевод вызова .

Id соединения (обязательный) Тип: Целое .

Значение ключа Id из события type=localconnection (см. п. 7.5.4) .

Описание: Осуществить трансфер неотвеченного вызова (входящего). Возможен трансфер как собственного вызова, так и входящих вызовов на других внутренних абонентов, в зависимости от прав пользователя на 3CX .

DropCall(Id соединения)

Параметры:

Id соединения (обязательный) Тип: Целое .

Значение ключа Id из события type=localconnection (см. п. 7.5.4) .

Описание: В версиях до 1.1.7 включительно - сбросить собственный вызов (входящий/исходящий) пользователя. С версии 1.1.8 - сбросить соединение любого абонента. При выполнении следующих условий: 3CXPhone в качестве абонентского устройства; установлен плагин WebAPI_3CX_1C_Plugin; свойство UsePlugin установлено в «Истина», собственные вызовы будут сбрасываться непосредственно софтфоном 3CXPhone, во все остальных случаях сброс вызова будет происходить путем отправки запроса к АТС .

MakeCall(Номер)

Параметры:

Номер (обязательный) Тип: Строка .

Номер или SIP Id вызываемого абонента .

Описание: осуществление исходящего вызова. Метод оставлен для совместимости, рекомендуется использовать метод MakeCall2 .

MakeCall2(Номер, Интерком)

Параметры:

Номер (обязательный) Тип: Строка .

Номер или SIP Id вызываемого абонента .

Интерком (обязательный) Тип: Булево .

Признак поддержки абонентским устройством интерком. Если абонентское устройство поддерживает интерком и данный параметр Интерком=Истина, то на устройстве произойдет автоответ на обратный вызов от АТС (Make Call) .

Внимание!!! Если абонентское устройство не поддерживает интерком и значение параметра Интерком=Истина, то вызов осуществлен не будет. При совместном использовании 3CXPhone и плагина WebAPI_3CX_1C_Plugin значение параметра Интерком не влияет на осуществление исходящего вызова, т.к. в этом случае осуществляется прямой набор c 3CXPhone .

Описание: осуществление исходящего вызова .

SetBargeInCall( Id соединения )

Параметры:

Id соединения (обязательный) Тип: Целое .

Значение ключа Id из события type=localconnection (см. п. 7.5.4) .

Описание: вмешаться в разговор. Метод доступен для пользователя при наличии у него соответствующих прав на 3CX. При использовании в качестве абонентского устройства 3CXPhone произойдет автоматическое подключение к вызову вне зависимости от наличия плагина WebAPI_3CX_1C_Plugin, в остальных случаях АТС инициирует обратный вызов «Barge In» на абонентское устройство пользователя .

SetListenCall( Id соединения )

Параметры:

Id соединения (обязательный) Тип: Целое .

Значение ключа Id из события type=localconnection (см. п. 7.5.4) .

Описание: подслушать разговор. Метод доступен для пользователя при наличии у него соответствующих прав на 3CX. При использовании в качестве абонентского устройства 3CXPhone произойдет автоматическое подключение к вызову вне зависимости от наличия плагина WebAPI_3CX_1C_Plugin, в остальных случаях АТС инициирует обратный вызов «Barge In» на абонентское устройство пользователя .

SetPickupCall( Id соединения )

Параметры:

Id соединения (обязательный) Тип: Целое .

Значение ключа Id из события type=localconnection (см. п. 7.5.4) .

Описание: перехватить входящий не отвеченный вызов. Метод доступен для пользователя при наличии у него соответствующих прав на 3CX .

SetWhisperCall( Id соединения )

Параметры:

Id соединения (обязательный) Тип: Целое .

Значение ключа Id из события type=localconnection (см. п. 7.5.4) .

Описание: подсказка. Метод доступен для пользователя при наличии у него соответствующих прав на 3CX. При использовании в качестве абонентского устройства 3CXPhone произойдет автоматическое подключение к вызову вне зависимости от наличия плагина WebAPI_3CX_1C_Plugin, в остальных случаях АТС инициирует обратный вызов «Barge In» на абонентское устройство пользователя .

StartRecordCall( Id соединения )Параметры:

Id соединения (обязательный) Тип: Целое .

Значение ключа Id из события type=localconnection (см. п. 7.5.4) .

Описание: включение записи вызова. Позволяет записывать как свои, так и чужие вызовы. Если у одного из абонентов, участвующих в вызове, включен флажок «Записывать все звонки» в настройках 3CX Phone System, то вызов метода игнорируется .

.

TransferCall(Номер, Id соединения )

Параметры:

Номер (обязательный) Тип: Строка .

Номер или SIP Id на который необходимо выполнить перевод вызова .

Id соединения (обязательный) Тип: Целое .

Значение ключа Id из события type=localconnection (см. п. 7.5.4) .

Описание: Осуществить трансфер отвеченного вызова (входящего/исходящего). Возможен трансфер как собственного вызова, так и вызовов других внутренних абонентов, в зависимости от прав пользователя на 3CX .

7.2.3 Методы для работы с софтфоном 3CXPhone Методы доступны только при выполнении следующих условий: 3CXPhone в качестве абонентского устройства;

установлен плагин WebAPI_3CX_1C_Plugin; свойство UsePlugin установлено в «Истина» .

AnswerCall() Описание: ответить на входящий вызов на 3CXPhone на текущей линии. Метод аналогичен методу AnswerCall3CXPhone c параметром Линия, не лежащим в диапазоне от 1 до 5 .

AnswerCall3CXPhoneByCallId (Id вызова)

Параметры:

Id вызова (обязательный) Тип: Целое .

Значение ключа CallId из события record=localconnection или события record=3cxphonecall .

Описание: ответить на входящий вызов на 3CXPhone .

AnswerCall3CXPhone (Линия)

Параметры:

Линия (обязательный) Тип: Целое .

Номер линии софтфона (от 1 до 5), по которой необходимо ответить на входящий вызов. Если Линия не лежит в диапазоне от 1 до 5, то будет осуществлена попытка ответа по текущей линии .

Описание: ответить на входящий вызов на 3CXPhone .

AnswerCall3CXPhone (Линия)

Параметры:

Линия (обязательный) Тип: Целое .

Номер линии софтфона (от 1 до 5), по которой необходимо ответить на входящий вызов. Если Линия не лежит в диапазоне от 1 до 5, то будет осуществлена попытка ответа по текущей линии .

Описание: ответить на входящий вызов на 3CXPhone .

AttendantTransfer3CXPhoneByCallId (Id вызова)

Параметры:

Id вызова (обязательный) Тип: Целое .

Значение ключа CallId из события record=localconnection или события record=3cxphonecall .

Описание: перевод вызова с консультацией .

BlindTransfer3CXPhoneByCallId (Id вызова)

Параметры:

Id вызова (обязательный) Тип: Целое .

Значение ключа CallId из события record=localconnection или события record=3cxphonecall .

Описание: слепой перевод вызова .

CancelTransfer3CXPhoneByCallId (Id вызова)

Параметры:

Id вызова (обязательный) Тип: Целое .

Значение ключа CallId из события record=localconnection или события record=3cxphonecall .

Описание: отмена перевода вызова с консультацией .

ChangeLine3CXPhone(Линия)

Параметры:

Линия (обязательный) Тип: Целое .

Номер линии софтфона, на которую необходимо переключиться (от 1 до 5) .

Описание: переключение между линиями 3CXPhone. Метод инициирует передачу события 3cxphoneline .

DropCall3CXPhoneByCallId (Id вызова)

Параметры:

Id вызова (обязательный) Тип: Целое .

Значение ключа CallId из события record=localconnection или события record=3cxphonecall .

Описание: завершение вызова .

DropCall3CXPhone(Линия)

Параметры:

Линия (обязательный) Тип: Целое .

Номер линии софтфона, на которой необходимо сбросить вызов (от 1 до 5). Если Линия не лежит в диапазоне от 1 до 5, то будет осуществлен сброс вызова на текущей линии .

Описание: завершение вызова .

FinalizeTransfer3CXPhoneByCallId (Id вызова)

Параметры:

Id вызова (обязательный) Тип: Целое .

Значение ключа CallId из события record=localconnection или события record=3cxphonecall .

Описание: завершение перевода вызова с консультацией .

GetLinesStatus3CXPhone(Линия)

Параметры:

Линия (обязательный) Тип: Целое .

Номер линии софтфона, по которой необходимо получить статус (от 1 до 5). Если в качестве параметра передать 0, то возникнет событие с информацией о состоянии всех линий .

Описание: получить данные о состоянии линии/линий 3CXPhone. Метод инициирует передачу события 3cxphonecall .

HoldCall3CXPhone() Параметры: нет Описание: удержание / снятие с удержания активного вызова .

MakeCall3CXPhone() Параметры: нет Описание: осуществление исходящего вызова по первой свободной линии .

MicMute() Параметры: нет Описание: выключение микрофона на софтфоне 3CXPhone. Метод работает только при условии существования активного вызова .

MicUnMute() Параметры: нет Описание: включение микрофона на софтфоне 3CXPhone. Метод работает только при условии существования активного вызова .

SendDTMF3CXPhoneByCallId(Id вызова, Строка)

Параметры:

Id вызова (обязательный) Тип: Целое .

Значение ключа CallId из события record=localconnection или события record=3cxphonecall .

Строка (обязательный) Тип: Строка .

Цифры от 0 до 9 и символы *, #. Параметр может состоять из нескольких символов .

Описание: отправка DTMF .

StopRecordCall( Id соединения )

Параметры:

Id соединения (обязательный) Тип: Целое .

Значение ключа Id из события type=localconnection (см. п. 7.5.4) .

Описание: выключение записи вызова. Если у одного из абонентов в настройках 3CX Phone System включен флажок «Записывать все звонки», то запись вызова остановить невозможно .

7.2.4 Методы для работы с аппаратными телефонами, поддерживающими CTI

SupportedCTICommands() Параметры: нет

Возвращаемое значение:

Тип: Целое .

Целое число, представляющее сумму значений:

0 – CTI команды не поддерживаются;

1 – включение/отключение громкой связи SpeakerOnOffCTI();

2 – ответ на входящий вызов AnswerCallCTI();

4 – отбой вызова DropCallCTI();

8 – осуществление вызова MakeCallCTI();

16 – слепой перевод вызова BlindTransferCTI();

32 – перевод с консультацией AttendantTransferCTI();

64 – завершить перевод с консультацией FinalizeTransferCTI();

128 – не используется (зарезервировано);

256 – удержание, снятие с удержания HoldCTI();

512 – отключение/включение микрофона MuteCTI();

1024 – нажатие кнопки на номеронабирателе PressLineKeyCTI() .

Описание: получение информации о командах, поддерживаемых телефоном .

AnswerCallCTI()Параметры: нет.Описание: ответ на входящий вызов .

AttendantTransferCTI(Номер)

Параметры:

Номер (обязательный) Тип: Строка .

Номер абонента, на который необходимо перевести вызов .

Описание: перевод вызова с консультацией. Если после консультации принимается решение о переводе вызова, то необходимо выполнить метод FinalizeTransferCTI(), в противном случае - DropCallCTI() HoldCTI() для продолжения вызова, либо DropCallCTI() DropCallCTI() для завершения вызова .

BlindTransferCTI(Номер)

Параметры:

Номер (обязательный) Тип: Строка .

Номер абонента, на который необходимо перевести вызов .

Описание: слепой перевод вызова .

DropCallCTI() Параметры: нет .

Описание: сбросить текущий вызов .

FinalizeTransferCTI() Параметры: нет .

Описание: завершение перевода с консультацией .

HoldCTI() Параметры: нет .

Описание: удержание, снятие с удержания текущего вызова .

MakeCallCTI(Номер)

Параметры:

Номер (обязательный) Тип: Строка .

Номер вызываемого абонента .

Описание: осуществление исходящего вызова .

MuteCTI() Параметры: нет .

Описание: отключить/включить микрофон .

PressDialKeyCTI(Строка)

Параметры:

Строка (обязательный) Тип: Строка .

Цифры от 0 до 9 и символы *, #. Параметр может состоять из нескольких символов .

Описание: метод имитирует нажатие кнопок на номеронабирателе телефона .

PressLineKeyCTI(Линия)

Параметры:

Линия (обязательный) Тип: Целое .

Номер линии на телефоне .

Описание: выбор SIP линии на телефоне .

SpeakerOnOffCTI() Параметры: нет Описание: включение или отключение режима громкой связи .

7.2.5 Работа с конференциями SetConferenceAdd(Номер)

Параметры:

Номер (обязательный) Тип: Строка .

Номер или SIP Id добавляемого в конференцию абонента .

Описание: добавить участника в конференцию и начать конференцию. Метод вызывается последовательно для каждого участника конференции. Для номера инициирующего конференцию метод вызывать не требуется .

SetConferenceDelete(Id участника)

Параметры:

Id участника (обязательный) Тип: Целое .

Id участника конференции из события type=conf (см. п. 7.5.5) .

Описание: удалить участника из конференции .

SetConferenceMute(Id участника)

Параметры:

Id участника (обязательный) Тип: Целое .

Id участника конференции из события type=conf (см. п. 7.5.5) .

Описание: отключить звук (входящий и исходящий) участнику конференции .

SetConferenceUnMute(Id участника)

Параметры:

Id участника (обязательный) Тип: Целое .

Id участника конференции из события type=conf (см. п. 7.5.5) .

Описание: включить звук участнику конференции .

7.2.6 Работа с чатом DeleteChatMessages(Номер )

Параметры:

Номер (обязательный) Тип: Строка .

Номер или SIP Id абонента, чат с которым удаляется Описание: Удаление всех сообщений чата с абонентом. Сообщения удаляются только у абонента, вызвавшего метод, у абонента, по которому удаляется чат, сообщения остаются .

GetChatMessages(Номер, ТолькоНовые)

Параметры:

Номер (обязательный) Тип: Строка .

Номер или SIP Id абонента, переписку с которым требуется получить .

ТолькоНовые(обязательный) Тип: Булево Получить только новые (непрочитанные) или все сообщения .

Описание: Получение истории общения с абонентом .

SendChatMessage(Номер,Текст)

Параметры:

Номер (обязательный) Тип: Строка .

Номер или SIP Id на который необходимо послать сообщение .

Текст (обязательный) Тип: Строка .

Текст сообщения чата Описание: передача указанному абоненту текстового сообщения .

SetChatMessagesReceived(Id сообщения )

Параметры:

Ид сообщения (обязательный) Тип: Число .

Значение ключа Id из событий type=chatmessage (см. п. 7.5.7) или type=chathistory (см. п. 7.5.8) .

Описание: Пометка сообщения как прочитанного. При открытии формы чата в софтфоне 3CXPhone новые сообщения помечаются как прочитанные .

7.2.7 Работа с телефонной книгой GetPhonebookContacts() Параметры: Нет .

Описание: Получение все контактов из корпоративной телефонной книги 3CX Phone System и персональной телефонной книги абонента. Вызов метода инициирует передачу компонентом событий contact .

UpdatePhonebookContact(Данные контакта)

Параметры:

Данные контакта(обязательный) Тип: Строка Строка в формате Ключ=Значение

Набор ключей-значений:

id – ID контакта;

number – основной номер контакта;

firstname – имя;

lastname – фамилия;

contacttype – тип контакта, может принимать следующие значения значения:

PersonalPhonebook - контакт персональной телефонной книги;

CompanyPhonebook - контакт телефонной книги компании .

company – название компании контакта;

data0 – в 3CX в этом поле хранится значение Мобильный 2 (далее – только соответствия);

data1 – домашний;

data2 – домашний2;

data3 – рабочий;

data4 – рабочий2;

data5 – электронная почта;

data6 – другой;

data7 – рабочий факс;

data8 – основной факс;

data9 – пейджер .

Описание: Изменить данные контакта в телефонной книге, поиск контакта в телефонной книге осуществляется по значению ключей id и contacttype .

Примечание: Контакты с типом LocalUser могут быть добавлены или отредактированы только в консоли управления 3CX .

Пример:

ВладелецФормы.ТФ3_Компонента.UpdatePhonebookContact(“id=13;number=9228118811; firstname=Артем;

lastname=Селекзянов;contacttype=CompanyPhonebook;company=ООО Интерфейс”);

AddPhonebookContact(Данные контакта)

Параметры:

Данные контакта (обязательный) Тип: Строка .

Строка в формате Ключ=Значение Набор ключей см. в методе UpdatePhonebookContact, ключ Id передавать не требуется .

Описание: Добавить контакт в телефонную книгу .

Примечание: Контакты с типом LocalUser могут быть добавлены или отредактированы только в консоли управления 3CX .

DeletePhonebookContact(Id контакта)

Параметры:

Id контакта (обязательный) Тип: Число Идентификатор контакта .

Описание: Удалить контакт из телефонной книги 3CX .

Примечание: Контакты с типом LocalUser могут быть удалены только в консоли управления 3CX .

FindPhonebookContact(Строка поиска)

Параметры:

Строка поиска (обязательный) Тип: Строка Строка для поиска .

Описание: Найти контакты в телефонной книге .

Примечание: Поиск производится по всем полям телефонной книги .

Например при задании строки «905» будут найдены абоненты (9058887766, 9228905461, abonent905@mail.ru и т. п.) 7.2.8 Получение истории вызовов Внимание! Доступна только история собственных вызовов оператора .

GetCallHistory(Начальная запись, Количество, Тип вызовов, Номер)

Параметры:

Начальная запись (обязательный) Тип: Число .

Номер записи истории вызовов, с которой необходимо получить данные. 0 – соответствует последнему по времени вызову .

Количество (обязательный) Тип: Число .

Количество записей, которое необходимо получить .

Тип вызовов (обязательный) Тип: Число .

0 – все вызовы, 1 – пропущенные, 2 – входящие, 3 - исходящие .

Номер (обязательный) Тип: Строка .

Фильтр по номерам телефонов – регулярное выражение (RegExp). Например:

"" – не фильтровать;

"222" – фильтровать по номерам, включающим «222»;

"222|333" – фильтровать по номерам, включающим «222» или «333» .

Внимание! Фильтр по номерам накладывается на массив заданный параметром Количество, соответственно при фильтрации результирующее количество записей будет меньше параметра Количество .

Описание: Получить историю вызовов. Метод может применяться для начального заполнения истории при подключении к АТС. История возвращается в хронологическом порядке от более поздней даты к более ранней .

GetCallHistoryByDate(Дата с, Дата по, Тип вызовов, Номер)

Параметры:

Дата с (обязательный) Тип: Дата .

Начальная дата (более ранняя) .

Дата по (обязательный) Тип: Число .

Конечная дата (более поздняя) .

Тип вызовов (обязательный) Тип: Число .

0 – все вызовы, 1 – пропущенные, 2 – входящие, 3 - исходящие .

Номер (обязательный) Тип: Строка .

Фильтр по номерам телефонов – регулярное выражение (RegExp). Например:

"" – не фильтровать;

"222" – фильтровать по номерам, включающим «222»;

"222|333" – фильтровать по номерам, включающим «222» или «333»;

Описание: Получить историю вызовов за период. История возвращается в хронологическом порядке от более поздней даты к более ранней .

7.2.9 Воспроизведение записи вызова Внимание! Воспроизводятся только собственные записи оператора!

PlayMyRecord (Имя файла)

Параметры:

Имя файла (обязательный) Тип: Строка .

Имя файла вызова, должен быть равен значению ключа recfile из типов событий localconnection и callhistory .

Описание: Воспроизводит файл записи вызова в проигрывателе по умолчанию .

PlayMyRecordOnPhone (Имя файла)

Параметры:

Имя файла (обязательный) Тип: Строка .

Имя файла вызова, должен быть равен значению ключа recfile из типов событий localconnection и callhistory .

Описание: Воспроизводит файл записи вызова на телефоне оператора .

7.3 События

OnEvent (Источник, Источник в 3CX, Данные)

Данные:

Источник Тип: Строка Всегда «COM_3CX_1C»

Источник в 3CX Тип: Строка

Значения:

myinfo – события о собственных соединениях абонента;

group – события о группах абонентов, участниках групп и соединений у участников групп, в том числе и собственных соединений абонента, события возникают только для тех групп, участником которых является абонента, в соответствии с правами абонента и других участников;

queue – события об очередях, участниках очередей и соединений в очередях, в том числе и собственных соединений абонента;

3cxphone – события от софтфона 3CXPhone, если используется плагин WebAPI Client Plugin .

Другие значения параметра на текущий момент не структурированы и могут меняться в следующих версиях .

События о соединениях поступают от всех источников, если свойство OnlyMyConnection выставлено в ложь .

Например, если абонент зарегистрирован в очереди и поступил вызов на очередь, то абоненту придут события localconnection об этом вызове от трех источников .

Данные Тип: Строка Данные события (см. п.7.4) .

7.4 Структура параметра Данные для обработчика события .

Этот параметр представляет собой набор строк, разделенных символами переноса строки « \r\n ».

Каждая строка состоит из набора пар ключ-значение «ключ_n=знач_n», разделенных символом «;» (точка с запятой):

record=ТипЗаписи;Ключ1=Значение1;Ключ2=Значение2;...КлючN=ЗначениеN;\r\n;

Ключ record определяет тип передаваемого события и имеет следующие значения:

group – информация о группе;

groupmember – информация о состоянии внутреннего абонента;

extensioninfo – регистрационная информация об абоненте;

localconnection – информация о соединении;

conf – информация соединении с конференцией;

queueagent –информация о регистрации абонента в очереди .

Важно!!! В событии могут содержаться данные о нескольких объектах одного типа (группе, абоненте, соединении и т.д.) .

Важно!!! Для минимизации трафика в событии передаются ТОЛЬКО ИЗМЕНЕННЫЕ значения с момента последнего события по объекту. Полные наборы ключей передаются при подключении к АТС, либо при создании нового объекта (например, нового соединения), либо в ответ на специальный запрос GetAllExtensions() .

Например, при осуществлении внутреннего вызова в параметре Данные присутствуют 4 строки (по две строки на каждого абонента):

-изменение состояния абонента 1 «Занят»:

groupid=2;record=groupmember;isbusy=True;id=26;

- соединение для абонента 1:

memberid=26;record=localconnection;id=153;callid=24;legid=2;state=WaitingForNewParty;originatortype=None;

otherpartytype=Extension;otherpartydisplayname=Алексей Иванов; otherpartycallerid=25;isincoming=False;

startedat=15.05.2014 11:39:14;answeredat=15.05.2014 11:39:17;ownertype=Extension;ownerdn=23; ownerdisplayname=Петр Петров;localid=;otherpartydn=25;ownercallerid=23;

-изменение состояния абонента 2 «Занят»:

groupid=2;record=groupmember;isbusy=True;id=28;

-описание соединения для абонента 2:

memberid=28;record=localconnection;id=154;callid=24;legid=3;state=Ringing;originatortype=None;originatordn=;

originatorname=;otherpartytype=Extension;otherpartydisplayname=Петр Петров;otherpartycallerid=23;

isincoming=True;startedat=15.05.2014 11:39:17;ownertype=Extension;ownerdn=25;ownerdisplayname=Алексей Иванов;localid=;otherpartydn=23;ownercallerid=25;

Набор ключей разный для каждого типа записи .

7.4.1 Тип события «channel»

Возникает в следующих случаях:

при успешном подключении к АТС;

при отключении от АТС;

при неудачном подключении или при разрыве соединения .

Набор ключей-значений:

record=channel – тип события;

state – состояние подключения:

connected – произошло подключение к АТС;

disconnected – произошло отключение от АТС;

error – ошибка при подключении, разрыв соединения с АТС;

msg – сообщение об ошибке .

Примеры:

record=channel;state=connected record=channel;state=error;msg=Invalid password 7.4.2 Тип события «phone»

Возникает в следующих случаях:

при обнаружении устройства, зарегистрированного на АТС под User Id пользователя, во время подключения к АТС, но до события channel;

при регистрации на АТС нового устройства под User Id пользователя;

при разрегистрации на АТС устройства под User Id пользователя;

при выборе устройства в качестве текущего изменением свойства CurrentPhoneId .

Набор ключей-значений:

record=phone – тип события;

id – уникальный идентификатор устройства в рамках регистрации на АТС:

action – действие:

add – обнаружено зарегистрированное устройство при подключении, устройство зарегистрировалось на АТС;

delete – произошла разрегистрация устройства на АТС;

set – устройство выбрано в качестве текущего (для управления из интегрируемого приложения) .

useragent – User-Agent телефона или софтфона;

type – тип устройства:

1 – софтфон 3CXPhone;

2 – аппаратный телефон с поддержкой CTI (совместимый с 3CXPhone System);

3 – аппаратный телефон без поддержки CTI, сторонний софтфон;

host – ip адрес устройства;

port – порт устройства (SIP);

uri – SIP URI устройства .

Примеры:

record=phone;action=add;id=75;useragent=Yealink SIP-T28P 2.72.14.3;type=2;host=192.168.1.249;port=5062;

uri=sip:21@192.168.1.249:5062 record=phone;action=add;id=2629;useragent=3CXPhone for Windows 14.0.47020.0;type=1;host=192.168.1.97;port=0;

uri=sip:21@192.168.1.97:32534:rinstance=0-894c0f8ac3d54065a2cd1c048d19e39e:ob record=phone;action=set;id=75 7.4.3 Тип события «plugin»

Возникает в следующих случаях:

при загрузке софтфоном 3CXPhone плагина WebAPI_3CX_1C_Plugin.dll;

при соединении / ошибке соединения компонента с плагином через Named Pipes .

Набор ключей-значений:

record=plugin – тип события;

id – ID устройства;

loaded – признак загрузки плагина (на текущий момент значение всегда "true"), возникает если в процессе работы с компонентом был запущен софтфон и софтфон загрузил плагин;

channel – тип канала (на текущий момент значение всегда "pipe");

state – состояние канала "connected | error";

msg – описание ошибки .

Пример:

record=plugin;id=4260;loaded=true record=plugin;id=4260;channel=pipe;state=connected 7.4.4 Тип события «group»

Возникает в следующих случаях:

при подключении к АТС;

при изменении названия группы внутренних номеров на АТС;

Событие приходит только к участникам группы. Если внутренний номер является участником нескольких групп, то при подключении компонента к АТС, абонент получит данное событие для каждой группы, участником которой он является .

Набор ключей-значений:

record=group – тип события;

id – ID группы;

name – наименование группы .

Пример:

record=group;id=2;name=DEFAULT;

7.4.5 Тип события «groupmember»

Возникает в следующих случаях:

1. при подключении к АТС;

2. при изменении состояния занятости абонента;

3. при включении или отключении режима DND («Не беспокоить»);

4. при изменении текущего статуса абонента;

5. при регистрации или отмене регистрации в очереди;

6. при включении или отключении режима DND («Не беспокоить») .

7. При изменении имени, фамилии или мобильного номера абонента на АТС .

Набор ключей-значений:

groupid – ID группы абонента, соответствует ключу Id в событии group;

record=groupmember – тип события;

id – уникальный ID абонента на АТС;

extensionnumber – внутренний номер абонента;

firstname – имя абонента;

lastname – фамилия абонента;

isregistered – информация о регистрации абонента на АТС, True – зарегистрирован, False - не зарегистрирован;

lastname – фамилия абонента;

currentprofile – наименование текущего профиля пользователя;

currentprofileinternalname – внутреннее наименование в АТС текущего профиля пользователя;

currentstatus – текущий статус абонента, в версии 3CXPhone v12.5, произвольная текстовая информация, задаваемая в 3CXPhone – Настройки Переключение вызова Выбранный статус (Доступен | Нет на месте | и т.д.) Редактируемое поле «Статус». В версии 3CXPhone v12.0 данный статус находится непосредственно на форме софтфона 3CXPhone;

queuestatus – информация о регистрации абонента в очередях, True – зарегистрирован, False - не зарегистрирован;

isbusy – информация о занятости абонента, True – занят, False - не занят;

chatstatus – информация о регистрации абонента в чате, True – зарегистрирован, False - не зарегистрирован;

mobilenumber – мобильный номер абонента .

Примеры .

Первичная информации о состоянии абонента:

groupid=2;record=groupmember;id=22;extensionnumber=14;firstname=Иван;lastname=Иванов;isregistered=True;

isdnd=False;currentstatus=В офисе;queuestatus=False;isbusy=False;chatstatus=Offline;mobilenumber=9229229292;

Изменилось состояние занятости абонента:

groupid=2;record=groupmember;isbusy=True;id=22;

7.4.6 Тип события «extensioninfo»

Возникает в следующих случаях:

при выполнении метода GetAllExtensions() .

–  –  –

Пример:

record=extensioninfo;id=23;type=Extension;number=15;firstname=Петр;lastname=Сидоров;mobilenumber=;

emailaddress=PSid@xxx.ru;

Набор ключей может быть разный для различных типов номеров .

7.4.7 Тип события «localconnection»

Возникает при любом изменении состояния вызова. При вызовах между внутренними абонентами 3CX создаст отдельное соединение (id) для каждого абонента в рамках одного вызова (callid). Следует также учесть, что при наличии нескольких зарегистрированных устройств на одном внутреннем номере, на этапе дозвона на этот номер (state=Ringing), 3CX создаст отдельное соединение для каждого зарегистрированного устройства .

Набор ключей-значений:

memberid – Id владельца соединения, ключ id из событий groupmember и extensioninfo;

record=localconnection – тип события;

id – Id соединения АТС с абонентским устройством;

callid – Id вызова, по значению данного ключа возможно осуществить связку c информацией, поступающей от сервиса 3CX CDR Client (http://if56.ru/3cx-ip-phone-call-log-for-1c-database) .

state – состояние вызова, может принимать следующие значения:

Dialing – дозвон до вызываемого абонента;

Connected – вызов установлен;

Ringing – поступает входящий вызов;

TryingToTransfer – вызов ожидает перевода, возникает у абонента переводящего вызов;

WaitingForNewParty – ожидание соединения с вызываемым абонентом, данное значение возможно при осуществлении набора методом обратного вызова – после ответа вызывающего абонента на Make Call от 3CX и перед непосредственным дозвоном до вызываемого (перед событием localconnection с ключем state=Ringing у вызываемого абонента), либо при ожидании перевода вызова у абонента, которого переводят, либо при ответе на вызов из очереди или голосового меню;

UnknownState – неизвестное состояние;

isincoming – признак входящего вызова, True – входящий, False - исходящий;

startedat – время начала вызова, поступает при начале вызова;

answeredat – время ответа на вызов, поступает при окончании вызова;

duration – длительность вызова, поступает при окончании вызова;

originatortype –тип линии автора?, ключ имеет значение только на входящем соединении, может принимать значения:

None;

RingGroup – вызов абоненту поступил от группы вызова;

originatordn – номер группы вызова, от которой поступил вызов;

originatorname – имя группы вызова, от которой поступил вызов;

otherpartytype – тип абонента на другом конце линии, возможные значения:

None – неизвестно;

Conference – конференция;

Extension – внутренний абонент;

ExternalLine – внешняя линия (VOIP оператор или VOIP/PSTN шлюз);

Fax – факс;

IVR – автосекретарь;

Parking - парковка;

SpecialMenu – меню голосовой почты;

Queue – очередь;

otherpartydisplayname – имя абонента на другом конце линии, возможные значения:

для внутренних номеров - Имя и Фамилия из информации о пользователе;

для внешних - Имя и Фамилия из телефонной книги АТС;

для Автосекретаря – Наименование;

otherpartycallerid – caller ID абонента на другом конце линии;

otherpartydn – для внутренних вызовов – внутренний номер абонента на другом конце линии, для внешнихвходящих вызовов – виртуальный внутренний номер VOIP оператора или VOIP/PSTN шлюза;

ownertype – тип абонента владельца соединения, аналогично otherpartytype;

ownerdisplayname – имя абонента владельца соединения, Имя и Фамилия из информации о пользователе;

ownercallerid – caller ID владельца соединения;

ownerdn – внутренний номер владельца соединения;

recfile – имя файла записи вызова, ключ поступает при ответе на вызов, только в событиях с источником 3CX myinfo;

legid – Id устройства, участвующего в вызове (callid), уникальность в рамках этого вызова;

devicecontact – SIP URI устройства, к которому относится событие;

action – признак завершения соединения, всегда action=delete .

Важно!!! В событии никогда не передается полный набор ключей!

Пример:

1. Начало вызова абонентом 11 (id=22), абонента с номером 9229229292, соединению присвоен Id=786 memberid=22;record=localconnection;id=786;callid=224;legid=1;state=Dialing;originatortype=None;originatordn=;

originatorname=;otherpartytype=None;otherpartydisplayname=;otherpartycallerid=9229229292;isincoming=False;

startedat=25.05.201517:32:40;ownertype=Extension;ownerdn=11;ownerdisplayname=Тимур Хусаинов;localid=;

otherpartydn=;ownercallerid=11;

2. Изменение статуса занятости у абонента id=22 groupid=2;record=groupmember;isbusy=True;id=22;

3. Изменение информации о соединении Id=786: тип абонента на другом конце линии – внешняя линия; номер найден в адресной книге 3CX – это Петров Петр; вызов осуществляется через VOIP оператора с виртуальным номером 10004 memberid=22;record=localconnection;otherpartytype=ExternalLine;otherpartydisplayname=Петров, Петр;

otherpartycallerid=79229229292;otherpartydn=10004;id=786;

4. Изменение состояния соединения Id=786 – вызов установлен .

memberid=22;record=localconnection;state=Connected;id=786;

5. Изменение состояния соединения Id=786 – вызов завершен .

record=localconnection;id=786;endedat=25.05.2015 17:33:07;duration=00:00:18.1606330;action=delete;

6. Изменение статуса занятости у абонента id=22 groupid=2;record=groupmember;isbusy=False;id=22;

7. Создан файл записи вызова record=localconnection;id=7556;callid=1932;recfile=[21]_21-15_20160609135457(1932).wav;

7.4.8 Тип события «3cxphonecall»

Возникает в следующих случаях:

при изменении состояния вызова на софтфоне 3CXPhone;

при выполнении метода GetLinesStatus3CXPhone() .

Набор ключей-значений:

record=3cxphonecall – тип события;

line – номер линии 3CXPhone;

currentline – номер текущей линии 3CXPhone;

id – Id соединения АТС с абонентским устройством;

callid – Id вызова;

state – состояние линии, может принимать следующие значения:

Free – линия свободна;

Dialing – дозвон до вызываемого абонента Connected – соединение установлено;

Ringing – поступает входящий вызов;

TryingToTransfer – вызов ожидает перевода, возникает у абонента переводящего вызов (только при выполнении метода GetLinesStatus3CXPhone());

WaitingForNewParty – ожидание соединения с вызываемым абонентом (только при выполнении метода GetLinesStatus3CXPhone());

UnknownState – неизвестное состояние (только при выполнении метода GetLinesStatus3CXPhone());

callstate – состояние вызова:

hold – вызов поставлен на удержание;

held – вызов поставлен на удержание другим абонентом;

established – вызов активен .

Примеры:

record=3cxphonecall;line=1;currentline=1;id=4437;callid=864;state=Ringing;

record=3cxphonecall;line=1;currentline=2;id=;callid=;state=Free;

Рекомендуем использовать данное событие только для определения линии софтфона, по которой осуществляется вызов или для определения состояния занятости линии через вызов метода GetLinesStatus3CXPhone. Для изменения состояния и атрибутов вызова используйте событие localconnection .

7.4.9 Тип события «3cxphoneline»

Возникает в следующих случаях:

при изменении текущей линии на софтфоне 3CXPhone;

при выполнении метода ChangeLine3CXPhone() .

Набор ключей-значений:

record=3cxphonecall – тип события;

newline – номер вновь выбранной линии .

Примеры:

record=3cxphoneline;newline=2;

7.4.10 Тип события «conf»

Возникает при изменении статусов конференции .

Набор ключей-значений:

record=conf – тип события;

id – ID конференции;

number – номер участника конференции;

status – статус участника в конференции может принимать следующие значения:

JOINING – присоединение к конференции;

CONNECTED – подключение к конференции;

DISCONNECTED – отключение от конференции;

MUTED – отключен pder .

0 – окончание конференции, возникает у всех участников при завершении конференции инициатором;

Пример:

record=conf;id=10;number=25;status=JOINING;

7.4.11 Тип события «queueagent»

Возникает при регистрации или отмене регистрации абонента в очереди .

Набор ключей-значений:

record=queueagent – тип события;

queuestatus – информация о состоянии регистрации абонента в очереди;

id – ID абонента .

Пример:

record=queueagent;queuestatus=True;id=22;

7.4.12 Тип события «chatmessage»

Возникает при передаче текстового сообщения в чате .

Набор ключей-значений:

record= chatmessage – тип события;

id – Id сообщения;

from – номер абонента отправителя;

to – номер абонента получателя;

textmsg – текст сообщения .

Пример:

record=chatmessage;id=897;from=21;to=22;msg=Привет!;

7.4.13 Тип события «chathistory»

Возникает при выполнении метода GetChatMessages (запрос истории сообщений) .

Набор ключей-значений:

record=chathistory – тип события;

id – ID сообщения;

from – номер абонента отправителя;

to – номер абонента получателя;

time – дата и время передачи сообщения;

isnew – признак нового (непрочитанного) сообщения, True – новое, False - нет;

textmsg – текст сообщения .

Пример:record=chathistory;id=897;from=21;to=22;time=22.01.2015 23:59:59;isnew=False;msg=Привет!;

7.4.14 Тип события «contact»

Возникает при выполнении метода GetPhonebookContacts (получить записи телефонной книги) .

Событие возникает для каждого контакта .

Набор ключей-значений:

record=contact – тип события;

id – ID контакта;

number – основной номер контакта;

extnumber – номер контакта в системе 3CX (только для contacttype=LocalUser);

firstname – имя;

lastname – фамилия;

contacttype – тип контакта, может принимать следующие значения значения:

LocalUser – внутренний абонент 3CX;

PersonalPhonebook - контакт персональной телефонной книги;

CompanyPhonebook - контакт телефонной книги компании .

company – название компании контакта;

data0 – в 3CX в этом поле хранится значение Мобильный 2 (далее – только соответствия);

data1 – домашний;

data2 – домашний2;

data3 – рабочий;

data4 – рабочий2;

data5 – электронная почта;

data6 – другой;

data7 – рабочий факс;

data8 – основной факс;

data9 – пейджер .

Примечание: для экономии трафика пустые поля не передаются .

Пример:

record=contact;id=13;number=9228118811;extnumber=;firstname=Артем;lastname=Селекзянов;contacttype=CompanyPhon ebook;company=ООО Интерфейс;

7.4.15 Тип события «addcontact»

Возникает при выполнении метода AddPhonebookContact (добавить контакт в телефонную книгу) .

В поле данных передается добавленный контакт .

Набор ключей-значений соответствует событию contact .

Примечание: для экономии трафика пустые поля не передаются .

Пример:

record=addcontact;id=54;number=9998887766;extnumber=;firstname=Иван;lastname=Иванов;

contacttype=PersonalPhonebook;

7.4.16 Тип события «updatecontact»

Возникает при выполнении метода UpdatePhonebookContact (изменить данные контакта в телефонной книге) .

В поле данных передается измененный контакт .

Набор ключей-значений соответствует событию contact .

Примечание: для экономии трафика пустые поля не передаются .

Пример:

record=updatecontact;id=52;number=9998887766;firstname=Петр;lastname=Петров;contacttype=CompanyPhonebook;data0 =8887776655;

7.4.17 Тип события «deletecontact»

Возникает при выполнении метода DeletePhonebookContact (удалить контакт из телефонной книги) .

В поле данных передается удаленный контакт .

Набор ключей-значений соответствует событию contact .

Примечание: для экономии трафика пустые поля не передаются .

Пример:

record=deletecontact;id=53;number=9991112233;extnumber=;firstname=Семен;lastname=Семенов;contacttype=CompanyPh onebook;

7.4.18 Тип события «findcontact»

Возникает при выполнении метода FindPhonebookContact (найти контакт) .

В поле данных передается найденный контакт .

Набор ключей-значений соответствует событию «contact» .

Для каждого найденного контакта возникает отдельное событие .

Примечание: для экономии трафика пустые поля не передаются .

Пример:

record=findcontact;id=31;extnumber=25;firstname=Евгений;lastname=Гаврусь;contacttype=LocalUser;company=;

data5=emg@if56.ru;

7.4.19 Тип события «callhistory»

Возникает в следующих случаях:

при выполнении методов GetCallHistory() и GetCallHistoryByDate();

после завершения собственного вызова абонента и завершения всей цепочки соединений в вызове (при завершении последнего соединения с данным callid), .

Пример:

record=callhistory;callid=1932;callhistoryid=53539;startedat=11.06.2016 18:54:55;answeredat=11.06.2016 18:54:57;endedat=11.06.2016 18:55:05;calltype=Outgoing;partycallerid=Ext.15;partydn=15;partydnname=Наталья Коннова;partydntype=Extension;recfile=[21]_21-15_20160611135457(1932).wav;

8 Примеры кода для 1С 8

8.1 Загрузка ВК 1С .

Загрузка ВК производится на клиенте в модуле формы, обработки или общего модуля с установленным флагом

Клиент:

Если ПодключитьВнешнююКомпоненту("Addin.COM_3CX_1C") Тогда Попытка ТФ3_Компонента = Новый("Addin.COM_3CX_1C");

Исключение Сообщить("Ошибка загрузки компоненты 3CX WebAPI Client 1C. Подсистема 3CX будет недоступна.");

ТФ3_Компонента = Неопределено;

КонецПопытки;

Иначе Сообщить("Компонента 3CX WebAPI Client 1C не загружена. Подсистема 3CX будет недоступна.");

ТФ3_Компонента = Неопределено;

КонецЕсли;

8.2 Обработка внешних событий в 1С .

После подключения ВК нужно обработать внешние события от компоненты. Код может находиться либо в модуле управляемого приложения, либо в модуле формы. Во втором случае необходимо позаботиться, чтобы форма не могла быть закрыта пользователем .

Для модуля управляемого приложения:

Процедура ОбработкаВнешнегоСобытия(Источник, Событие, Данные) Если Источник = "COM_3CX_1C" Тогда //Здесь помещаем код обработки события телефонии Возврат;

КонецЕсли;

//Здесь, возможно, код других обработчиков КонецПроцедуры

Для модуля формы вызывается процедура ВнешнееСобытие:

Процедура ВнешнееСобытие(Источник, Событие, Данные) Если Источник = "COM_3CX_1C" Тогда //Здесь помещаем код обработки события телефонии Возврат;

КонецЕсли;

//Здесь, возможно, код других обработчиков КонецПроцедуры

8.3 Обработка параметра Данные .

Исходя из этой структуры данных, наиболее оптимальным будет следующий алгоритм:

Вспомогательная функция преобразования строки, состоящей из пар ключ-значение, разделенных символом «;» в структуру 1С:

Функция СтрокаВСтруктуру(Стр)

–  –  –

КонецФункции Некоторое усложнение функции вызвано тем, что при передаче строковых данных они могут сами содержать знак равенства «=». Функция корректно отрабатывает эти ситуации .

Пример процедуры обновления активных соединений в 1С. Предполагается, что есть какая-то структура ТЗВсеЗвонки, в которой хранится список активных звонков .

Процедура ОбновитьПредставлениеСоединения(Стр) ТекСтр = ТЗВсеЗвонки.Найти(Стр.ИдЗаписи, "ИдЗаписи");

ФлагУдаления = Ложь;

//Проверка, если есть свойство "Действие" и его значение равно "delete", //тогда соединение завершено и запись нужно удалить .

–  –  –

//Обновляем информацию соединения Если ТекСтр = Неопределено Тогда ТекСтр = ТЗВсеЗвонки.Добавить();

КонецЕсли;

ЗаполнитьЗначенияСвойств (ТекСтр, Стр);

КонецПроцедуры 9 Тестовая обработка ТФ3_Панель_ОП_2_5.epf Важно!!! Перед использованием обработки проверьте работоспособность софтфона 3CXPhone на том же ПК, где запускается 1С, даже если будет использоваться аппаратный телефон. Если в софтфоне не отображается статус присутствия, если не открывается окно «Сведения о присутствии», если в окне «Сведения о присутствии» не отображаются абоненты из вашей группы и их вызовы, то WebAPI Client работать не будет! Смотрите «Возможные проблемы» в данной документации .

Обработка является автономной и может быть запущена в любой конфигурации в режиме обычного приложения .

Например, можно создать пустую базу (без конфигурации) и запускать в ней обработку. Обработка копируется в каталог установки при инсталляции компонента .

Рис. 9.1 При запуске обработки необходимо произвести начальную настройку. Меню Система – Настройки .

1.Установите настройки в соответствии с вашим телефоном .

Рис. 9.2 Настройка «Номер аккаунта в телефоне» предназначена для удобства отладки компонента с телефоном, поддерживаемым CTI, (в нашем случае один аккаунт зарегистрирован на рабочей АТС, а второй на тестовой) и на данный момент используется в тестовой обработке только для определения, по какому SIP аккаунту будут производиться исходящие вызовы .

Важно! Все CTI методы управления вызовами выполняются только на активной линии телефона. В текущей версии WebAPI Client отсутствует прием событий с телефона (Action URL) .

При использовании софтфона 3CXPhone отметка параметра «Использовать плагин для …» дает возможность управления софтфоном 3CXPhone из 1С .

При использовании CTI телефона и софтфона 3CXPhone совместно с плагином большая часть часть функционала по работе с вызовами может осуществляться не посредством запросов к АТС, а отправкой команд софтфону или настольному телефону .

2. Настройте параметры подключения к 3CX Phone System .

Рис. 9.3 Получить URL для 3CX v14 SP2 можно в консоли управления 3CX Server Manager: «Troubleshooting» «Parameters», затем набрать в строке поиска «MYPHONE_LINK». Для подключения к АТС внутри локальной сети используйте значения параметров MYPHONE_LINK_LOCAL и MYPHONE_LINK_LOCAL_SEC .

Для проверки работоспособности Web-сервиса сведений о присутствии наберите в адресной строке браузера его URL .

Если сервис доступен, то окно браузера должно выглядеть следующим образом:

Рис. 9.4 Данная проверка подтверждает лишь работоспособность сервиса, но не подтверждает работоспособность с ним 3CXPhone, а значит и компонента, с конкретного ПК .

На вкладке «Настройки 1С» присутствует чекбокс «Включить режим отладки», который предназначен для просмотра событий и сообщений, приходящих в 1С. Использование данного параметра поможет определить проблемы в подключении к веб-сервису сведений о присутствии .

После заполнения полей нажмите кнопку «Сохранить» .

Теперь можно подключаться к серверу 3CX Phone System .

При успешном подключении на вкладке «Моя линия» отобразится текущий статус присутствия абонента и текущее абонентское устройств, на вкладке «Все линии» появится список линий с указанием статусов всех внутренних абонентов из групп 3CX, в которых вы являетесь участником, и текущие вызовы. После этого можно тестировать компонент .

Рис. 9.6 Рис. 9.7 Если у пользователя несколько абонентских устройств, то необходимо выбрать каким устройством будет осуществляться управление из 1С .

Рис. 9.8 Начинать тестирование лучше всего с вкладки «Моя линия» (рис. 9.1). При нажатии кнопки «Позвонить»

отображается окно ввода произвольного номера, на который требуется совершить звонок. Кнопки «Ответить», «Перевести», «Сбросить» и т.д. отражают действия с активным соединением (входящим или исходящим). Внимание!!!

«Ответить», «Микрофон», «Удержание» доступны только при использовании 3CXPhone и плагина WebAPI_3CX_1C_Plugin или телефона с поддержкой CTI. «Начать запись» и «Остановить запись» работают только при условии что у абонентов, участвующих в вызове, на АТС не установлена автоматическая запись разговоров «Записывать все звонки», причем «Остановить запись» работает только при использовании 3CXPhone и плагина WebAPI_3CX_1C_Plugin .

В нижней таблице вкладки «Моя линия» отражаются неотвеченные звонки. Эта информация содержит только вызовы, пропущенные в течение текущего сеанса 1С, и не сохраняется.. Нужно учитывать, что при поступлении вызова на группу номеров у всех членов группы, кроме ответившего, этот вызов попадет в пропущенные .

Из таблицы пропущенных звонков можно непосредственно набрать номер, с которого поступил звонок .

К собственному номеру относятся и пункты меню «Режим не беспокоить», «Очередь», а также выпадающий список с выбором текущего статуса присутствия. Выбор пунктов меню вызывает соответствующие действия. Статусы собственного номера отображаются в заголовке формы .

Рис. 9.9 Рис. 9.10 Рис. 9.11 Следующая вкладка «Все линии» отображает состояние всех линий системы, подобно тому, как это происходит в консоли управления 3CX Phone System. Надо заметить, что действия со звонками других абонентов требуют наличия соответствующих прав в системе 3CX Phone System .

В верхней таблице отображаются все абоненты из групп, которым принадлежит пользователям. Выделив коллегу и нажав кнопку «Позвонить», можно связаться с соответствующим абонентом .

Рис. 9.12

В нижней таблице отображаются все соединения устройств с АТС.

По каждому соединению можно выполнить следующие действия:

- вмешаться в разговор – оба собеседника будут слышать Вас, а Вы их;

- подслушать – Вы слышите всех, а Вас никто;

- шепот – Вы слышите всех, а Вас слышит только один собеседник .

Также есть возможность перехватить или перевести входящий неотвеченный вызов, а так же включить запись разговора (если ни у одного из абонентов, участвующих в вызове, не установлена автоматическая запись разговоров «Записывать все звонки») .

Вкладка «Конференция» управляет созданием, проведением и завершением конференций. В конференцию можно добавлять как внутренних абонентов, отметив их в списке, так и произвольный номер. После нажатия кнопки «Начать конференцию» система автоматически обзвонит участников конференции и подключит их к конференции Рис. 9.13 Есть возможность в ходе конференции добавлять или удалять участников, а также включать или отключать микрофон любому участнику .

При нажатии кнопки «Закончить конференцию» конференция завершится и все участники отключатся от конференции .

Вкладка «Сообщения» служит для демонстрации возможностей чата. Получить или удалить историю сообщений по абоненту можно через контекстное меню списка абонентов. Получить или удалить историю по всем абонентам можно через пункт главного меню «Система»

Рис. 9.14 Вкладка «Телефонная книга» демонстрирует возможности работы с корпоративной и персональной телефонными книгами 3CX Phone System .

Рис. 9.15 10 Контактная информация .

ООО «Интерфейс»

ИП Хусаинов Т.Р .

ул. Кутузова, д. 19 г. Орск Оренбургской области Российская Федерация Тел.: +7 (3537) 25-08-35, 20-38-38 E-mail: info@if56.ru Web: http://if56.ru ; http://sip1c.ru

–  –  –





Похожие работы:

«Дарчиев Анзор Валерьевич ОСЕТИНСКОЕ ПРЕДАНИЕ О САМЕЛИ, ПРИКОВАННОМ К ЛУНЕ: ПРОИСХОЖДЕНИЕ И МИФОЛОГИЧЕСКАЯ ОСНОВА Статья посвящена рассмотрению малоизученного предания о Самели, содержащего ценные свед...»

«ИДЕИ КО ДНЮ НАРОДНОГО ЕДИНСТВА ИДЕЯ 1 АКЦИИ Праздник ДЕНЬ НАРОДНОГО ЕДИНСТВА дань глубокого уважения к тем знаменательным страницам отечественной истории, когда патриотизм и гражданственность помогли нашему народу объединиться и защитить страну от захватчиков. Преодолеть времена безвластия и укрепить Росс...»

«IN MEMORIAM С.А. Корсун ЗАМЕТКИ ОБ ЭКСПЕДИЦИИ К НЕНЦАМ ПОД РУКОВОДСТВОМ В.А. КОЗЬМИНА В 1984 г., после окончания III курса кафедры антропологии и этнографии исторического факультета ЛГУ, я участвовал в экспедиции к ненцам полуострова Ямал под руководством Валериана Александровича Козьмина. Экспедиция состояла из трех студентов...»

«УДК 930 "1829/1864" (470,6) Хаджебиекова Фатима Мурсудиновна Hadzhebiekova Fatima Mursudinovna соискатель кафедры дореволюционной post-graduate student of the chair of отечественной истории prerevolutionary native history, Кубанского государственного университета Kuban State...»

«© 2012 г. Э.В. Рунг ТИССАФЕРН И ГИДАРНИДЫ В КОНТЕКСТЕ ПОЛИТИЧЕСКОЙ ИСТОРИИ АХЕМЕНИДСКОЙ ДЕРЖАВЫ в V в. до н.э. В статье рассматриваются ключевые аспекты политической карьеры персидского сатрапа Тиссаферна и рода Гидарнидов в целом в контексте политической истории Ахеменидской державы. Исследуется вопрос о происхождении и родственных связях Т...»

«Тарасов И. Т. Различие между органами внутреннего государственного управления РАЗЛИЧИЕ МЕЖДУ ОРГАНАМИ ВНУТРЕННЕГО ГОСУДАРСТВЕННОГО УПРАВЛЕНИЯ1 Иван Трофимович ТАРАСОВ (1849—1929) —  российский правовед, заслуженный профессор, выдающийся административист. Р...»

«Власова Жанна Николаевна Идеальный образ физически развитого человека в рос­ сийской культуре конца XX начала XXI вв. Специальность 24.00.01 теория и история культуры (культурология) АВТОРЕФЕРАТ диссертации на соискание ученой степени кандидата культурологии OQ3 1 T 5 6 8 8 Чита...»

«Забияко А.П., Забияко А.А. Магия, демонология и видения в религиозной культуре русских Трёхречья Публикация подготовлена в рамках работы по гранту РНФ "Этнические миграции как фактор цивилизационных взаимодействи...»

«Побочные эффекты транквилизаторов и их роль в пограничной психиатрии В.И. Бородин ГНЦ ССП им. В.П. Сербского, Москва Введение Проблема побочных эффектов лекарственных средств была актуальной на протяжении всей истории развития психофармакологии. В последние годы методология системного подхода, уж...»

«АКТ Государственной историко-культурной экспертизы проекта реставрации и приспособления (корректировка) по объекту культурного наследия федерального значения "Павильон "Народное образование" (бывший Северного Кавказа), 1954г., арх. Полупанов С.П." г. Москва, пр. Мира, д. 119, строение 2, ВВЦ 2...»

«Гастрономия / Gastronoma Внутренний дизайн ресторана. Interior del restaurante. Arzak РеcтоРан Restaurante Мария Величко / Maria Velichko Ресторан Арзак. Restaurante Arzak. Шеф Хуан Мари Арзак с дочерью Еленой Арзак. Chef Juan Mari Arzak y su hija Elena Arzak. ИсторИя со...»

«МИНИСТЕРСТВО Г Е О Л О Г И И СССР АКАДЕМИЯ НАУК СССР МИНИСТЕРСТВО ВЫСШЕГО И СРЕДНЕГО СПЕЦИАЛЬНОГО О Б Р А З О В А Н И Я СССР СТРАТИГРАФИЯ СССР СТРАТИГРАФИЯ ГЛАВНЫЙ РЕДАКТОР Д. В. Н А Л И В К И Н ЗАМЕСТИТЕЛИ ГЛАВНОГО РЕДАКТОРА: В. Н. В Е Р Е Щ А Г И Н, А. И. Ж А М О И Д А, В...»







 
2019 www.mash.dobrota.biz - «Бесплатная электронная библиотека - онлайн публикации»

Материалы этого сайта размещены для ознакомления, все права принадлежат их авторам.
Если Вы не согласны с тем, что Ваш материал размещён на этом сайте, пожалуйста, напишите нам, мы в течении 1-2 рабочих дней удалим его.