Служебный сценарий обработки контента — различия между версиями
(Новая страница: «В ходе обработки внешнего звонка сервером производится сбор так называемого контента. Эт...») |
|||
(не показано 7 промежуточных версии этого же участника) | |||
Строка 1: | Строка 1: | ||
− | + | [[Практики|'''Наверх''']] | |
− | + | ||
− | + | ||
− | + | ||
− | Прежде чем обрабатывать контент,нужно ознакомиться в каком виде он нам становиться доступным. | + | В ходе обработки внешнего звонка сервером производится сбор так называемого контента. Это идентификационная информация по линии, абоненту, времени, а также перечень всех коммутаций с указанием имени сценария, идентификатора и имени оператора, времени начала, времени конца, продолжительности и пр. |
− | Для этого создадим простой служебный сценарий - "обработка контента". | + | |
+ | Запуск данного сценария происходит автоматически после окончания звонка. Какой именно служебный сценарий будет отвечать за обработку контента выбираем и назначаем в разделе Администрирование / Общие настройки / Сценарии АТС / Служебный сценарий обработки контента. | ||
+ | |||
+ | Прежде чем обрабатывать контент,нужно ознакомиться в каком виде он нам становиться доступным. Для этого создадим простой служебный сценарий - "обработка контента". | ||
+ | |||
+ | |||
+ | [[Файл:con01.png|center]] | ||
− | |||
В компоненте старт, выбираем параметры запуска, а точнее создаем переменную в которую система передаст эти самые параметры запуска,в нашем случае это и будет контент. | В компоненте старт, выбираем параметры запуска, а точнее создаем переменную в которую система передаст эти самые параметры запуска,в нашем случае это и будет контент. | ||
− | |||
− | Далее используем компонент "Сохранение контента" для того что бы создать физический файл в который сохраниться наш контент. | + | [[Файл:con02.png|center]] |
− | Для этого,в качестве контента указываем нашу переменную "Контент" | + | |
− | + | Далее используем компонент "Сохранение контента" для того что бы создать физический файл в который сохраниться наш контент. Для этого,в качестве контента указываем нашу переменную "Контент", затем для удобства последующего просмотра выбираем тип - txt. | |
− | + | ||
− | + | ||
+ | Файл - выбираем категорию где наш файл создастся и указываем название файла. После этого сохраняем сценарий,назначаем его в качестве "Служебного сценария сбора контента", после чего производим звонок. | ||
Переходим в категорию,которую указали для сохранения контента и раскрываем с помощью блокнота. | Переходим в категорию,которую указали для сохранения контента и раскрываем с помощью блокнота. | ||
− | |||
− | + | [[Файл:con1.png|center]] | |
− | |||
− | |||
− | ''<property_simple key="idchain" value="21819d69-6d1e-40b5-898b-a6c387a555bc" />'' | + | Как видно из данного файла - весь контент "обрамлен" в xml. Соответственно для последующего разбора данных мы будем использовать компонент парсер текста, с использованием поискового языка OQuery. |
+ | |||
+ | Давайте рассмотрим структуру более подробно. Для примера возьмем строчку из контента: | ||
+ | |||
+ | :'''<property_simple key="idchain" value="21819d69-6d1e-40b5-898b-a6c387a555bc" />''' | ||
В данной строке property_simple - является тегом, | В данной строке property_simple - является тегом, | ||
Строка 37: | Строка 38: | ||
Таким образом для того что бы получить значение ID цепочки коммутации строим следующий поисковый запрос: | Таким образом для того что бы получить значение ID цепочки коммутации строим следующий поисковый запрос: | ||
− | ''property_simple[key="idchain"]'' | + | :'''property_simple[key="idchain"]''' |
− | Где следуя синтаксису OQuery property_simple - тег,[key="idchain"] - атрибут с известным нам значением и названием. | + | Где, следуя синтаксису OQuery, property_simple - тег,[key="idchain"] - атрибут с известным нам значением и названием. |
− | Далее рассмотрим служебный сценарий сбора контента, в котором используя последовательный парсинг контента,мы получим необходимые значения и сохраним все в БД. | + | Далее рассмотрим служебный сценарий сбора контента, в котором используя последовательный парсинг контента, мы получим необходимые значения и сохраним все в БД. |
− | Во первых создадим таблицу в БД, в которую будем в итоге складировать все полученные данные. | + | Во первых создадим таблицу в БД, в которую будем в итоге складировать все полученные данные. В ходе примера получим следующие данные: |
− | В ходе примера получим следующие данные: | + | *ID цепочки коммутации, |
− | ID цепочки коммутации, | + | *Номер внешней линии, |
− | Номер внешней линии, | + | *CallerID, |
− | CallerID, | + | *CalledID, |
− | CalledID, | + | *Время начала, |
− | Время начала, | + | *Время конца, |
− | Время конца, | + | *Имя пользователя, обслужившего вызов последним, |
− | Имя пользователя, обслужившего вызов последним, | + | *Номер линии,обслужившей вызов последней, |
− | Номер линии,обслужившей вызов последней, | + | *ID пользователя,обслужившего вызов последним. |
− | ID пользователя,обслужившего вызов последним. | + | |
Из такого набора данным все поля делаем NVarchar,кроме Время начала,Время конца,которые создаем как Date/time. | Из такого набора данным все поля делаем NVarchar,кроме Время начала,Время конца,которые создаем как Date/time. | ||
− | [[Файл:con7.png]] | + | |
+ | [[Файл:con7.png|center]] | ||
+ | |||
Далее переходим непосредственно к нашему сценарию. | Далее переходим непосредственно к нашему сценарию. | ||
− | [[Файл:con2.png]] | + | [[Файл:con2.png|center]] |
Рассмотрим настройки компонента "Парсер" | Рассмотрим настройки компонента "Парсер" | ||
− | Документ - переменная "Контент". | + | *Документ - переменная "Контент". |
− | Алгоритм - Язык OQuery | + | *Алгоритм - Язык OQuery |
− | Поисковый запрос - property_simple[key="idchain"] | + | *Поисковый запрос - property_simple[key="idchain"] |
− | Функция - что нужно нам найти в документе - значение атрибута. | + | *Функция - что нужно нам найти в документе - значение атрибута. |
− | Номер элемента - оставляем пустым. | + | *Номер элемента - оставляем пустым. |
− | Атрибут - value | + | *Атрибут - value |
− | Результат в переменную - указываем переменную в которую будем сохранять результат парсера. | + | *Результат в переменную - указываем переменную в которую будем сохранять результат парсера. |
− | [[Файл:con3.png]] | + | [[Файл:con3.png|center]] |
− | Таким же образом настраиваем и все последующие парсеры,не забывая изменять значение атрибута key в поисковом запросе на соответствующий нашему запросу, т.е. следующий парсер будет уже искать номер линии соответственно: property_simple[key="linenumber"] | + | Таким же образом настраиваем и все последующие парсеры,не забывая изменять значение атрибута |
+ | key в поисковом запросе на соответствующий нашему запросу, т.е. следующий парсер будет уже искать | ||
+ | номер линии соответственно: property_simple[key="linenumber"] | ||
а так же указываем другую переменную. | а так же указываем другую переменную. | ||
− | Стоит отметить, что парсер позволяет сохранить информацию только в текстовом виде, соответственно при получении временных данных, их прежде всего сохраняем в строковую переменную,а затем при необходимости преобразуем в | + | Стоит отметить, что парсер позволяет сохранить информацию только в текстовом виде, соответственно |
+ | при получении временных данных, их прежде всего сохраняем в строковую переменную,а затем при | ||
+ | необходимости преобразуем в переменную типа Дата/время. | ||
Так же для того что бы найти первый тег можно использовать указательный суффикс ":first" и для поиска последнего значения ":last". | Так же для того что бы найти первый тег можно использовать указательный суффикс ":first" и для поиска последнего значения ":last". | ||
Таким образом для поиска времени поступления звонка воспользуемся суффиксом :first, поисковый запрос будет выглядеть так: | Таким образом для поиска времени поступления звонка воспользуемся суффиксом :first, поисковый запрос будет выглядеть так: | ||
− | (property_simple[key="timestart"]):first. | + | :'''(property_simple[key="timestart"]):first'''. |
− | |||
− | + | [[Файл:con4.png|center]] | |
− | |||
− | Так же суффиксом ":last" воспользуемся,для того что бы определить имя последнего оператора,принявшего звонок,его id и номер его линии. | + | А для поиска времени окончания коммутации используем суффикс ":last" - '''(property_simple[key="timestop"]):last'''. |
+ | |||
+ | |||
+ | [[Файл:con5.png|center]] | ||
+ | |||
+ | |||
+ | Так же суффиксом ":last" воспользуемся,для того что бы определить имя последнего оператора,принявшего звонок, его id и номер его линии. | ||
Затем произведем преобразование строчной даты и времени в тип Дата\время и произведем запись в БД,в нашу таблицу. | Затем произведем преобразование строчной даты и времени в тип Дата\время и произведем запись в БД,в нашу таблицу. | ||
− | |||
− | После чего | + | [[Файл:con6.png|center]] |
+ | |||
+ | |||
+ | После чего сохраним сценарий на сервере и совершим тестовый звонок. Открыв нашу таблицу мы увидим данные,которые мы собрали с помощью служебного сценария сбора контента. | ||
+ | |||
+ | |||
+ | [[Файл:con8.png|center]] | ||
− | |||
− | [[ | + | Пример сценария: [[Media:Content.zip|Content.zip]] |
Текущая версия на 10:54, 31 марта 2023
В ходе обработки внешнего звонка сервером производится сбор так называемого контента. Это идентификационная информация по линии, абоненту, времени, а также перечень всех коммутаций с указанием имени сценария, идентификатора и имени оператора, времени начала, времени конца, продолжительности и пр.
Запуск данного сценария происходит автоматически после окончания звонка. Какой именно служебный сценарий будет отвечать за обработку контента выбираем и назначаем в разделе Администрирование / Общие настройки / Сценарии АТС / Служебный сценарий обработки контента.
Прежде чем обрабатывать контент,нужно ознакомиться в каком виде он нам становиться доступным. Для этого создадим простой служебный сценарий - "обработка контента".
В компоненте старт, выбираем параметры запуска, а точнее создаем переменную в которую система передаст эти самые параметры запуска,в нашем случае это и будет контент.
Далее используем компонент "Сохранение контента" для того что бы создать физический файл в который сохраниться наш контент. Для этого,в качестве контента указываем нашу переменную "Контент", затем для удобства последующего просмотра выбираем тип - txt.
Файл - выбираем категорию где наш файл создастся и указываем название файла. После этого сохраняем сценарий,назначаем его в качестве "Служебного сценария сбора контента", после чего производим звонок.
Переходим в категорию,которую указали для сохранения контента и раскрываем с помощью блокнота.
Как видно из данного файла - весь контент "обрамлен" в xml. Соответственно для последующего разбора данных мы будем использовать компонент парсер текста, с использованием поискового языка OQuery.
Давайте рассмотрим структуру более подробно. Для примера возьмем строчку из контента:
- <property_simple key="idchain" value="21819d69-6d1e-40b5-898b-a6c387a555bc" />
В данной строке property_simple - является тегом, key="idchain" - уточняющий атрибут, value="21819d69-6d1e-40b5-898b-a6c387a555bc" - конкретизирующий атрибут.
Таким образом для того что бы получить значение ID цепочки коммутации строим следующий поисковый запрос:
- property_simple[key="idchain"]
Где, следуя синтаксису OQuery, property_simple - тег,[key="idchain"] - атрибут с известным нам значением и названием.
Далее рассмотрим служебный сценарий сбора контента, в котором используя последовательный парсинг контента, мы получим необходимые значения и сохраним все в БД.
Во первых создадим таблицу в БД, в которую будем в итоге складировать все полученные данные. В ходе примера получим следующие данные:
- ID цепочки коммутации,
- Номер внешней линии,
- CallerID,
- CalledID,
- Время начала,
- Время конца,
- Имя пользователя, обслужившего вызов последним,
- Номер линии,обслужившей вызов последней,
- ID пользователя,обслужившего вызов последним.
Из такого набора данным все поля делаем NVarchar,кроме Время начала,Время конца,которые создаем как Date/time.
Далее переходим непосредственно к нашему сценарию.
Рассмотрим настройки компонента "Парсер"
- Документ - переменная "Контент".
- Алгоритм - Язык OQuery
- Поисковый запрос - property_simple[key="idchain"]
- Функция - что нужно нам найти в документе - значение атрибута.
- Номер элемента - оставляем пустым.
- Атрибут - value
- Результат в переменную - указываем переменную в которую будем сохранять результат парсера.
Таким же образом настраиваем и все последующие парсеры,не забывая изменять значение атрибута key в поисковом запросе на соответствующий нашему запросу, т.е. следующий парсер будет уже искать номер линии соответственно: property_simple[key="linenumber"] а так же указываем другую переменную.
Стоит отметить, что парсер позволяет сохранить информацию только в текстовом виде, соответственно при получении временных данных, их прежде всего сохраняем в строковую переменную,а затем при необходимости преобразуем в переменную типа Дата/время.
Так же для того что бы найти первый тег можно использовать указательный суффикс ":first" и для поиска последнего значения ":last". Таким образом для поиска времени поступления звонка воспользуемся суффиксом :first, поисковый запрос будет выглядеть так:
- (property_simple[key="timestart"]):first.
А для поиска времени окончания коммутации используем суффикс ":last" - (property_simple[key="timestop"]):last.
Так же суффиксом ":last" воспользуемся,для того что бы определить имя последнего оператора,принявшего звонок, его id и номер его линии.
Затем произведем преобразование строчной даты и времени в тип Дата\время и произведем запись в БД,в нашу таблицу.
После чего сохраним сценарий на сервере и совершим тестовый звонок. Открыв нашу таблицу мы увидим данные,которые мы собрали с помощью служебного сценария сбора контента.
Пример сценария: Content.zip