Компоненты сценариев IVR — различия между версиями

Материал из Oktell
Перейти к: навигация, поиск
Строка 460: Строка 460:
 
|-
 
|-
 
|Тип команды
 
|Тип команды
Определяет способ преобразования номера в команду, отсылаемую на набор. По умолчанию без преобразования.
+
|Определяет способ преобразования номера в команду, отсылаемую на набор. По умолчанию без преобразования.
 
* Без преобразования. Отправляет номер как есть в зарезервированную линию.  
 
* Без преобразования. Отправляет номер как есть в зарезервированную линию.  
 
* Использовать команду направления. Если зарезервированная линия взята из [[Линии|направления]], и в нем  настроено преобразование номера, то перед отправкой на набор номер будет преобразован в строку-команду по указанной в направлении схеме.[[Линии|Подробно здесь]].   
 
* Использовать команду направления. Если зарезервированная линия взята из [[Линии|направления]], и в нем  настроено преобразование номера, то перед отправкой на набор номер будет преобразован в строку-команду по указанной в направлении схеме.[[Линии|Подробно здесь]].   
Строка 516: Строка 516:
 
|-
 
|-
 
|Код отказа SIP в переменную
 
|Код отказа SIP в переменную
|Переменная, куда сохраняется код отказа при переходе по ветке «Занято». Имеет смысл при осуществлении звонков через внешнии SIP-транки. Например «480 Temporarily not available, sip:12@192.168.0.1» или «486 Busy Here, sip:12@192.168.0.1». Полный список вариантов ответов доступен в документации по протоколу SIP (RFC 3261, http://www.ietf.org/rfc/rfc3261).  
+
|Переменная, куда сохраняется код отказа при переходе по ветке «Занято». Имеет смысл при осуществлении звонков через внешнии SIP-транки. Например «480 Temporarily not available, sip:12@192.168.0.1» или «486 Busy Here, sip:12@192.168.0.1». Полный список вариантов ответов доступен в документации по протоколу SIP (<nowiki>RFC 3261</nowiki>, [[http://www.ietf.org/rfc/rfc3261]]).  
 
Если переменная числовая, то в нее сохраняется только код ответа.
 
Если переменная числовая, то в нее сохраняется только код ответа.
 
|-  
 
|-  

Версия 12:56, 25 апреля 2011

В данном разделе в справочном порядке приведены лишь узкоспециализированные компоненты, доступные только сценариям IVR. Наличие таких компонентов обусловлено тем, что в отличие от других типов сценариев, IVR управляет одной конкретной линией и имеет доступ к аппаратным ресурсам. Среди появляющихся в этой связи возможностей: Проигрывание звуков, запись звуков, прием нажатых клавиш, возможность снять/положить трубку, переключение звонка на указанный номер и пр. Остальные компоненты являются общими для всех типов сценариев и описаны выше в разделе Общие компоненты сценариев.


Поднять трубку

Cl cc scr i31.png


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

Необходимо осуществлять подъем трубки перед компонентами, занимающимися интерактивным взаимодействием с абонентом: воспроизведение, запись, ввод dtmf, вход в задачу, переключения. Исключением может являться случай сквозного переключения, когда трубку требуется снять только после ответа удаленного или внутреннего абонента. В этом случае мелодии ожидания не воспроизводятся, внешний абонент слышит сигнал КПВ.


Свойства:

Команда Режим ответа. Используется фактически только в главном (и/или зависимых от него) сценариях, когда на управляемой линии входящий вызов и реализация сценария начинается с компонента «Старт». Для SIP каналов позволяет установить требуемый режим ответа в линию:
  • 200 OK. Абонент ответил, медиа-канал организован, тарификация начата.
  • 180 Ringing. Абонент вызывается, вызывающему воспроизводятся длинные гудки.
  • 183 Session Progress. Абонент вызывается/вызов транслируется, медиа канал организован и вызывающему можно и следует начать воспроизводить в сценарии звуковые файлы. Тарификация еще не производится.

Для SIP каналов возможны последовательные ответы в зависимости от специфики выстраиваемого алгоритма.


ВНИМАНИЕ! Для CTI-каналов любое выбранный режим приводит к простому снятию трубки при входящем вызове.

Переход Компонент, на который передается управление.
Имя Название компонента для отображения в визуальной среде и выбора в списке.


Cl cc scr i32.png

Положить трубку

Осуществляет разрыв связи на обслуживаемой линии и производит завершение сценария. Компонент нельзя использовать после проведения успешного переключения (коммутации).


Свойства:

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


Cl cc scr i33.png

Воспроизведение звукового файла

Осуществляется проигрывание указанного звукового файла в линию абонента.


Файл можно указать явно и по имени. В случае явного указания файл копируется и присоединяется к сценарию. В случае указания файла по имени – в соответствующей форме определяется принцип построения полного пути, состоящего из каталога и имени, определяющихся отдельно друг от друга.


Проигрывание можно прервать одной из набора указанных последовательностей символов прерывания, при необходимости сохранив ее в буфер-переменную. Для длинного файла можно указать время, после которого прервать звучание, вне зависимости от того, завершился файл или нет. Таким образом завершение действия компонента осуществляется как только происходит одно из событий:

  • файл закончился;
  • сработал таймер установленного времени звучания;
  • набрана последовательность или символ прерывания.


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


Компонент может активировать фоновое воспроизведение при выборе соответствующего режима. Осуществляет запуск воспроизведения указанного файла и сразу передает управление на следующий элемент сценария. Таким образом все следующие компоненты работают на фоне воспроизводимого файла. Даже вся цепочка переключений и ожиданий в очередях будет происходить на стартовавшем ранее фоне. Только после достижения конца фонового файла компоненты переключений начнут осуществлять собственное воспроизведение в канал (мелодии ожидания). Остановка фонового воспроизведения производится при достижении конца файла, при обработке другого компонента Воспроизведение, при явной остановке фонового воспроизведения (режим Остановка фона), при коммутации с другим каналом или конференцией, а также при обрыве связи.


У компонента в контекстном меню доступна команда «Воспроизвести». При использовании прикрепленного файла он будет открыт во встроенном проигрывателе.


Свойства:

Файл Окно ввода выбора проигрывающегося файла.

Файл может быть прикреплен к сценарию (выбран в момент редактирования и скопирован к сценарию), а также найден по сформированному пути в момент обработки сценария. Путь строится из составных частей: каталог и имя файла. Каталог, в котором лежит файл может быть задан

  • локальной категорией (в папке сценария);
  • глобальной категорией (в папке, где хранятся все сценарии);
  • абсолютным путем (C:\AAA\BBB);
  • пустота – в этом случае считается, что значение имени файла уже содержит весь путь.

Имя файла берется из значения указанной переменной сценария.

Режим Определяет режим проигрывания файла:
  • Файл полностью.
  • Предпрослушивание.
  • Файл + дополнительное время.
  • Фоновое воспроизведение.
  • Остановка фона.
Время предпрослушивания Доступно только в режиме предпрослушивания.

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


ВНИМАНИЕ! В зависимости от значения (при наличии) ключа «EnableGuaranteePlayTimeout» в файле конфигурации сервера обработчик сценария может ждать или пропускать ожидание сигнала об окончании воспроизведения.

Дополнительное время Доступно только в режиме «файл + дополнительное время».

Числовой аргумент, определяющий дополнительную задержку после воспроизведения, в ходе которой воспроизводится тишина и производится аналогичное ожидание набора символов.

Символы прерывания Недоступно в режиме фонового воспроизведения.

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

Буфер Недоступно в режиме фонового воспроизведения.

Переменная, в которую сохранится последовательность, прервавшая воспроизведение.

Очистить буфер Недоступно в режиме фонового воспроизведения.

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

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

Компонент, на который передается управление в случае, если по какой либо причине произошел сбой и файл не начал воспроизводиться. Например незаданное имя, отсутствие файла или доступа к нему, неверный формат и т.п.

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



Cl cc scr i34.png

Проигрывание числа

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


Свойства:

Число Аргумент (значение, переменная, функция, значение), строковое представление которого в числовом формате нужно проговорить текстом.
Голос Выбор голоса для воспроизведения. Каждый голос представляет собой папку с набором файлов, озвучивающих достаточно большой набор числительных и используемых дополнительных слов. Папки хранятся в каталоге со сценариями. В комплект входят 3 голоса.

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

Формат Формат проигрываемого значения:
  • «ПО ФОРМАТУ» — определяет расширенную настройку типа воспроизводимого числа
  • Количество
  • Порядковое числительное
  • Телефонный номер
  • Дата
  • Время
  • Дата/время
  • День недели
  • Время без нулей
  • Время в секундах
  • Деньги, USD
  • Деньги, EUR
  • Деньги, RUR
  • Деньги, UAH
Тип проигрывания Используется, если формат задан «По формату»
  • Посимвольно (один ноль два три семь…)
  • По 2 символа (двадцать два сорок четыре…)
  • По 3 символа (триста пять двести тридцать четыре…)
  • Целиком (Двести тридцать четыре триллиона пятьсот двадцать…)
  • Буквы и числа посимвольно (один а б в X Y Z тире слэш.. )
  • Слова и фразы (пожалуйста_введите_свой_код занято...). Ожидаются через любой пустой разделитель. В папке осуществляется поиск соответствующих файлов и их последовательное воспроизведение.

Поле доступно только при выборе значения «По формату» в свойстве «Формат».

Род Доступно только при выборе одного из значений «По формату», «Количество», «Порядковое числительное» в свойстве «Формат».
  • Мужской (один, двадцатитрехмиллионный)
  • Женский (одна, сто двадцать шестая)
  • Средний (одно, однотысячное)
Понижение тона Осуществляет понижение тона в конце. Для этого в качестве последнего файла подставляется аналогичный с символом "_" в конце, озвученный как окончание речи. При его отсутствии берется обычный файл.
Переход Компонент, на который передается управление после завершения воспроизведения.
Имя Название компонента для отображения в визуальной среде и выбора в списке.


Cl cc scr i34.png

Ввод числа

Ввод числа сопровождается тишиной в трубке. Принимает от пользователя число, набираемое с клавиатуры телефона, и сохраняет в буфер-переменную. Ввод прекращается, когда происходит одно из событий: сработал таймер назначенного времени ввода, набралось указанное количество символов, набрана последовательность или символ прерывания. При этом, в случае срабатывания таймера переход осуществляется по ветке «Время», имитируя неудавшийся ввод. В других случаях ввод считается успешным.


Свойства:

Символы прерывания Символы прерывания или их последовательности, разделенные запятыми или пробелами. При вводе с клавиатуры абонента указанной последовательности проигрывание прекращается, и управление переходит к следующему компоненту.
Буфер Переменная, в которую сохранится введенное значение. Последовательность прерывания сохранена не будет.
Очистить буфер Флаг, определяющий, будет ли введенное значение дописано в конец к уже существующим в буфере данным, либо очистит их и запишется с начала.
Максимальное время Аргумент, определяющий число - время ожидания ввода в секундах. По истечению времени введенное значение не сохраняется, и переход осуществляется по ветке «если время вышло». Если задан 0 – время не ограничивается.
Количество символов Аргумент, определяющий количество символов, ввода которых будет ждать компонент. По приему указанного количества – сразу осуществляется переход. Если задан 0 – число не ограничено. Компонент ожидает ввода указанного количества символов безотносительно предварительного содержимого буфера (даже если он не очищается).
Переход Компонент, на который передается управление после успешного завершения ввода.
Переход, время Компонент, на который передается управление, если отведенное время истечет.
Имя Название компонента для отображения в визуальной среде и выбора в списке.


Cl cc scr i36.png

Воспроизведение звукового файла с преднабором

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


У компонента в контекстном меню доступна команда «Воспроизвести». При использовании прикрепленного файла он будет открыт во встроенном проигрывателе.


Свойства:

Файл Окно ввода выбора проигрывающегося файла.

Файл может быть прикреплен к сценарию (выбран в момент редактирования и скопирован к сценарию), а также найден по сформированному пути в момент обработки сценария. Путь строится из составных частей: каталог и имя файла. Каталог, в котором лежит файл может быть задан

  • локальной категорией (в папке сценария);
  • глобальной категорией (в папке, где хранятся все сценарии);
  • абсолютным путем (C:\AAA\BBB);
  • пустота – в этом случае считается, что значение имени файла уже содержит весь путь.

Имя файла берется из значения указанной переменной сценария.

Символы прерывания Символы прерывания или их последовательности, разделенные запятыми или пробелами. При вводе с клавиатуры абонента указанной последовательности проигрывание прекращается, и управление переходит к следующему компоненту.
Буфер Переменная, в которую сохранится введенное значение. Последовательность прерывания сохранена не будет.
Очистить буфер Флаг, определяющий, будет ли введенное значение дописано в конец к уже существующим в буфере данным, либо очистит их предварительно.
Максимальное время Аргумент, определяющий число, которое толкуется как время ожидания ввода в секундах. По истечению времени введенное значение не сохраняется, и переход осуществляется по ветке «если время вышло». Если задан 0 – время не ограничивается.

Время засекается по набору первого символа, либо по завершению воспроизведения файла.

Количество символов Аргумент, определяющий число, которое толкуется как количество символов будет ждать компонент. По приему указанного количества – сразу осуществляется переход. Если задан 0 – число не ограничено.
Переход Компонент, на который передается управление после успешного завершения ввода.
Переход, время Компонент, на который передается управление, если отведенное время истечет.
Имя Название компонента для отображения в визуальной среде и выбора в списке.


Cl cc scr i37.png

Запись звукового файла

Компонент позволяет записывать звуковые данные с микрофона абонента. Указывается составное путь к файлу (отдельно каталог и имя), в который нужно сохранить данные. Имя файла можно генерировать случайно, после чего сохранять в буфер-переменную для дальнейшего использования или сохранения в БД. Остановка записи производится при срабатывании одного из событий: набрана одна из заданных в компоненте последовательностей прерывания или установленное время записи вышло (переход осуществляется по ветке «Время вышло»).


Свойства:

Файл Окно ввода выбора пути к файлу для записи.

Файл задается при помощи правила построения пути. Путь формируется из двух частей: каталог и имя файла. Каталог, в котором лежит файл

  • локальная категория (в папке сценария);
  • глобальная категория (в папке, где хранятся все сценарии);
  • абсолютный путь (C:\AAA\BBB);
  • не задан (в этом случае считается, что значение имени файла уже содержит весь путь).

Имя файла

  • задается и фиксировано;
  • генерируется, и значение сгенерированное сохраняется в переменную;
  • из значения указанной переменной сценария.
Имя файла в переменную Сохраняется имя файла, в который записали (используется, если имя генерируется).
Возвращать полный путь Да/нет. Устанавливает формат возвращаемого имени файла. Только имя и расширение или полный путь к файлу с указанием диска.
Символы прерывания Символы прерывания или их последовательности, разделенные запятыми или пробелами. При вводе с клавиатуры абонента указанной последовательности запись прекращается, и управление переходит к следующему компоненту, определенному веткой «Переход».
Буфер Переменная, в которую сохранится последовательность прерывания.
Очистить буфер Флаг, определяющий, будет ли введенная последовательность дописана в конец к уже существующим в буфере данным, либо очистит их предварительно.
Максимальное время Аргумент, определяющий число, которое толкуется как время ожидания ввода в секундах. По истечению времени введенное значение не сохраняется, и переход осуществляется по ветке «если время вышло». Если задан 0 – время не ограничивается.

Время засекается по набору первого символа, либо по завершению воспроизведения файла.

Начинать новую папку Определяет, вставлять ли между указанным именем файла и указанной папкой еще папку, и как часто их начинать. Возможные варианты:
  • Никогда
  • Каждый час
  • Каждый день
  • Каждую неделю
  • Каждый месяц
  • Каждые 3 месяца
  • Каждый год
Переход Компонент, на который передается управление после успешного завершения ввода.
Переход, время Компонент, на который передается управление, если отведенное время истечет.
Имя Название компонента для отображения в визуальной среде и выбора в списке.


Cl cc scr i38.png

Переключение на номер

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


В случае успеха коммутации переход осуществляется по ветке «Переход» и ожидается появление компонента Стоп, который прервет выполение сценария без разрыва коммутации и без возврата управления в родительские сценарии. Если номер занят – по ветке «Занято», если не отвечает – по ветке «Не отвечает».

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

Для переключения на город (или на внешнюю АТС) существует также компонент «Переключение на внешний номер с указанием последовательности выделения внешних линий», в котором явно устанавливается перечень и последовательность выделения внешних линий, а также существует возможность выбора воспроизводимой мелодии ожидания.


Переключение внутри АТС может осуществляться на все типы внутренних номеров:

  • Стандартный номер. Производится попытка соединения абонента с одним из операторов или одной из внутренних линий, назначенных в номере. В случае, если все операторы/линии номера заняты возможно использование очереди ожидания.
  • Быстрый номер. Переключение осуществляется внутрь АТС, однако физически производится набор номера во внешнюю линию. В зависимости от типа быстрого номера (АТС/Город) производится выбор соответствующей внешней линии. Если свободных внешних линий не найдено, производится возврат управления по ветке «Занято». При успешном резервировании линии возврат происходит после получения ответа городской (или внешней) АТС по соответствующей ветке.
  • Запуск IVR. Производится безвозвратный запуск назначенного в номере сценария. Текущий сценарий прекращает свое исполнение и дальнейший переход по веткам компонента не осуществляется.
  • Служебный номер. Среди внутренних служебных номеров, на которые возможно переключение из компонента, доступны «Выход в город», «Выход в АТС» и «Перехват». В первых двух случаях при наборе номера осуществляется резервирование соответствующей служебному номеру внешней линии (или коммутация с ней в зависимости от установки способа набора в модуле Общие настройки. АТС). Если операция успешно выполнена, управление в сценарий возвращается по ветке «Переход», и ожидается завершение сценария компонентом Стоп. Дальше абонент попадает в условия как если бы он на внутренней линии после снятия трубки набрал соответствующий служебный номер.Это дает возможность пользоваться соответствующими служебными номерами пользователям и абонентам, находящимся на внешних линиях системы. «Перехват» работает стандартным способом и в основном необходим только в случае использования режима входа в АТС через установленный сценарий IVR (здесь).

В случаяе отсутствия в системе указанного номера или несоответствия его типа одному из описанных выше происходит возврат управления по ветке «Не отвечает».

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


Свойства:

Назначение Номер может быть городским (внешним) и внутренним АТС.

Режим «Авто» позволяет установить автоматическое распознавание номера и в случае его наличия во внутреннем номерном плане производить переключение внутрь системы, в противном случае набирать номер в город. Назначение «Возврат к оператору» может быть использовано в call-центре для принудительного разрыва коммутации абонента, отбоя второго участника и возврата звонка на зарезервированного в этот момент оператора, который в задаче ожидает обратного соединения. Подробнее в разделе Голосовые задачи. Дополнительно. Поведение при переключении на IVR. Оставлять оператора ожидающим соединения. Также режим может использоваться для разрыва только что начавшейся коммутации по некоторому событию (истечению времени, набора команды DTMF, появления в БД некоторых данных и т.п.) и перевести его на дальнейшую полноценную обработку в сценарии IVR.

Номер Аргумент, определяющий номер, по которому производить дозвон.
CallerId Аргумент, определяющий номер дозванивающегося абонента, который будет отправлен в качестве caller-id в IP-канал. Если свойство не указано или определяет пустое значение, в качестве caller-id выступит стандартный, настроенный общим образом номер или определившийся при звонке из-вне, либо основной внутренний номер пользователя/линии в рамках текущей АТС при внутреннем звонке.

Этот номер будет отображен также во всплывающем окне у вызываемого пользователя.

Дополнительная информация об абоненте Аргумент, задающий внешним образом некоторые дополнительные данные об абоненте. Эти данные попадают в окно уведомления о входящем вызове при звонке на внутреннего пользователя, а также в комментарий к осуществленной коммутации и доступный для просмотра и поиска в журналах звонков Статистики АТС и Моих звонков. При осуществлении flash-переключения или flash-удержания последующие коммутации не будут содержать установленного значения в комментарии. При дальнейших переводах абонента при необходимости следует вновь указывать это же или иное значение.
Очередь ожидания Активировать ли очередь ожидания для внутреннего переключения, в случае, если номер занят.

Поле доступно только при выборе значения «Внутри АТС» в свойстве «Назначение».

Время ожидания Определяет, сколько секунд необходимо ожидать соединения перед отбоем.

ВНИМАНИЕ! В случае набора стандартного внутреннего номера свойство применяется только в случае, если запрещено ожидание в очереди. В противном случае время ожидания не лимитируется.

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

Поле доступно только при выборе значения «В город» в свойстве «Назначение».

Запись разговора Параметр, определяющий необходимость записи. По умолчанию выбран вариант «Согласно настройкам», при котором используется стандартная процедура поиска правил записи для звонка. Также доступны варианты «Записывать» и «Не записывать», производящие соответствующие безусловные действия.
Переход Компонент, на который передается управление в случае успешной коммутации
Переход, занято Компонент, на который передается управление, если номер занят (для внутренних, если очередь ожидания не активирована).
Переход, не отвечает Компонент, на который передается управление, если время ожидания истекло.
Переход, отсутствует Компонент, на который передается управление, если номер не обнаружен, нет ни одного активного абонента, отсутствует внешняя линия при попытке набора быстрого номера.
Переход, прервано Компонент, на который передается управление, если абонентом было прервано ожидание нажатием последовательности символов прерывания.
Имя Название компонента для отображения в визуальной среде и выбора в списке.


Cl cc scr i39.png

Переключение на внешний номер с указанием последовательности выделения линий

Переключение на номер позволяет коммутировать обслуживаемую линию с другой (внешней) линией, на противоположном конце которой находится абонент с указанным внешним (городским/АТС) номером. В ходе набора номера производится поиск свободной внешней линии в соответствии с установленным списком, резервирование, набор номера и ожидание ответа в течение установленного интервала времени (по умолчанию 40 секунд). В ходе ожидания воспроизводится выбранная мелодия. В зависимости от установленных свойств поведение компонента может меняться кардинальным образом.


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


Свойства:

Номер Аргумент, определяющий номер, по которому производить дозвон.

В качестве номера может быть принята команда (строка, содержащая DTMF символы и командные спец. символы w, q, z, {, }). Подробнее о командах в разделе Администрирование. Направления.

ВНИМАНИЕ! Если номер пустой или не указан, то вместо набора номеров производится выход на одну из назначенных внешних линий, аналогичный служебному номеру «Выход в город» или «Выход в АТС». Выборка линий производится в установленной компонентом последовательности. Исключение составляет случай, когда значение свойства «Коммутировать сразу» - нет.

CallerId Подставляемый для звонка номер. При отсутствии или некорректном значении будет взят номер по умолчанию для канала.
Тип команды Определяет способ преобразования номера в команду, отсылаемую на набор. По умолчанию без преобразования.
  • Без преобразования. Отправляет номер как есть в зарезервированную линию.
  • Использовать команду направления. Если зарезервированная линия взята из направления, и в нем настроено преобразование номера, то перед отправкой на набор номер будет преобразован в строку-команду по указанной в направлении схеме.Подробно здесь.

В некоторых случаях преобразование номера в команду может быть произведено предварительно в самом сценарии, или вовсе команда как итог может быть указана в таблице абонентов (номер в чистом виде - частный случай команды). В этом случае дополнительно преобразовывать команду не следует, и стоит оставить режим "без преобразования". Конечный режим реализации зависит от задач и целей.

Тип вызова Обычный / экстренный.

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

ВНИМАНИЕ! Значение «экстренный» следует выставлять в сценарии входа в АТС в случае набора экстренного номера в явном виде (без использования внутреннего номера с типом «экстренный»). В других случаях рекомендуется оставлять тип со значением по умолчанию «обычный». Возможны вариации, но их следует тщательно продумывать во избежание незапланированных разрывов.

Подробно об экстренных номерах в разделах Администрирование. Внутренние номера. Экстренные и Администрирование. Общие настройки. Экстренные номера.

Линии, направления Осуществляет выбор линий и направлений для осуществления звонка.

На вкладке «Список объектов» предоставляется возможность указать явно последовательность существующих в системе линий и направлений для осуществления звонка. Можно отключить использование некоторых элементов, а для выбранных установить последовательность поиска свободной линии.

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

На вкладке «Аргумент» возможно динамическое указание линии через ее код или Guid-идентификатор в строковом представлении. Также здесь может быть указан идентификатор или код направления, потока или шлюза. В этом случае будут последовательно перебираться все линии указанного объекта до обнаружения свободной и готовой к совершению вызова. Режим введен для использования совместно со шлюзами с динамической регистрацией потоков и компонентом сценариев Регистрация потока.

Фильтровать по правам Да/нет. При задействовании режима в случае, если осуществляется обработка канала пользователя системы, может быть осуществлена дополнительная фильтрация перечисленных в компоненте линий в соответствии с настройками прав выхода на внешние линии для пользователя. По умолчанию «Нет» - не фильтровать.
Время ожидания Аргумент определяет, сколько секунд необходимо ожидать соединения перед отбоем.
Коммутировать сразу Определяет поведение компонента. По умолчанию "нет, воспроизводить мелодию".
  • Да.

После нахождения доступной внешней линии и начала набора в нее номера сразу производится ее коммутация с каналом, обслуживаемым в сценарии. Ожидание ответа внешнего абонента производится уже в коммутации, строка о разговоре в статистике появится даже при неответе абонента, а запись будет включать в себя КПВ-сигнал. Возврат из компонента осуществляется сразу же по стандартной ветке «Переход». Если происходит сбой при ожидании набора номера или при коммутации, то возврат происходит по ветке «Ошибка». При отсутствии доступной линии - возврат по ветке «Линий не найдено».

ВНИМАНИЕ! В случае, если одновременно с установкой значения «да» этому свойству в компоненте назначен пустой номер, то поведение CTI каналов (FXO, E1) меняется. После снятия трубки на внешнем канале производится его коммутация с обслуживаемым каналом. Необходимо крайне аккуратно пользоваться этим режимом в случае работы с потоками Е1, так как в общем случае без дополнительных устройств-преобразователей протокол не поддерживает посимвольного набора номера через звуковой интерфейс, и, следовательно, такая комбинация параметров повлечет невозможность дальнейшего набора номера и коммутации с абонентом. Также описанный режим небходимо осмотрительно использовать при назначении в компоненте последовательности линий из разных потоков, и тем более линий разного типа (E1, FXO, IP).

ВНИМАНИЕ! При переключении на SIP-каналы фактическая коммутация возможна только после получения SDP от удаленной стороны, поэтому фактическая коммутация и выход из компонента производятся отложенно (ответы 183 и 200). А в случае получения ответов серии 4xx коммутация не производится.

  • Нет, воспроизводить мелодию.

Компонент осуществляет коммутацию только после ответа абонента. Компонент работает с ожиданием ответа абонента. Все время ожидания ответа (в рамках установленного максимального времени ожидания) в канал воспроизводится указанная мелодия ожидания. Возможны возвраты управления по веткам «Занято» и «Не отвечает». Если ранее в сценарии стартовало фоновое воспроизведения, то фон не прерывается. Если в компоненте не указан номер, то осуществляется резервирование внешней линии согласно общим принципам работы сервера АТС с возвратом управления сразу же по ветке «Переход».

  • Нет, прослушивать медиа-поток.

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

Мелодия ожидания Окно выбора мелодии ожидания, аналогичное выбору файла компонента «Воспроизведение». Мелодия будет воспроизводиться вплоть до окончания работы компонента. Может быть выбрана непосредственно и прикреплена к сценарию, а также быть взята по сформированному пути на сервере.
Параметр команды Свойство для служебных сценариев. Не используется в обычном режиме. Служит для передачи пароля пользователя и автоматической подстановки его в статистику в качестве инициатора звонка.
Символы прерывания Символы прерывания или их последовательности, разделенные запятыми или пробелами. При вводе с клавиатуры абонента указанной последовательности ожидание переключения прекращается, и управление переходит к следующему компоненту, определенному веткой «Переход, прервано».
Запись разговора Параметр, определяющий необходимость записи. По умолчанию выбран вариант «Согласно настройкам», при котором используется стандартная процедура поиска правил записи для звонка. Также доступны варианты «Записывать» и «Не записывать», производящие соответствующие безусловные действия.
Код отказа SIP в переменную Переменная, куда сохраняется код отказа при переходе по ветке «Занято». Имеет смысл при осуществлении звонков через внешнии SIP-транки. Например «480 Temporarily not available, sip:12@192.168.0.1» или «486 Busy Here, sip:12@192.168.0.1». Полный список вариантов ответов доступен в документации по протоколу SIP (RFC 3261, [[1]]).

Если переменная числовая, то в нее сохраняется только код ответа.

Переход Компонент, на который передается управление в случае успешной коммутации.

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

Переход, занято Компонент, на который передается управление, если номер занят (для внутренних, если очередь ожидания не активирована).

Свойство доступно только если не установлен режим коммутирования сразу.

Переход, не отвечает Компонент, на который передается управление, если время ожидания истекло.

Свойство доступно только если не установлен режим коммутирования сразу.

Переход, линия не найдена Компонент, на который передается управление, если не обнаружена доступная для совершения вызова внешняя линия из списка.
Переход, прервано Компонент, на который передается управление, если абонентом было прервано ожидание нажатием последовательности символов прерывания.
Переход, ошибка Компонент, на который передается управление, если в ходе проверки пароля, набора номера, ожидания событий или коммутации двух каналов возникла какая-либо ошибка.
Имя Название компонента для отображения в визуальной среде и выбора в списке.




Вход в задачу

Вход в задачу инициирует существующую в системе и указанную в сценарии задачу и осуществляет переключение на оператора . Оператор выбирается менеджером задач из списка свободных и назначенных на задачу операторов по заложенному в нее алгоритму. В случае если операторы все заняты, может быть задействована очередь ожидания, для этого установите свойство компонента «Очередь». В зависимости от текущего состояния задачи выход производится по одному из свойств перехода. Переключение также может осуществляться на входящую задачу автоматической обработки звонка. В этом случае производится переключение сценария с формированием записи в статистической БД. Вход в задачу может быть осуществлен как из основного сценария IVR, так и из принадлежащего проекту. В последнем случае в списке доступных задач отображаются только задачи текущего проекта.


Свойства:


Режим выбора задачи

Вариант указания задачи:

· Из списка

· По ключу (идентификатор, код, название)


Задача

Доступно только в случае режима «Из списка».

Одна из списка входящих голосовых задач системы Oktell или текущего проекта. Привязка осуществляется в момент создания сценария.

Ключ задачи

Доступно только в случае режима «По ключу».

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

Тип идентификации

Идентификацией является определение строки в таблице абонентов, прикрепленной к запускаемой задаче. Режим идентификации задействуется только если в запускаемой входящей голосовой задаче установлено свойство «Модифицировать записи». Противоположным режимом является создание новых записей при каждом звонке вне зависимости от того, найден или не найден абонент в таблице. Также возможно, совместно установив свойства «Модифицировать записи» в задаче и «Возврат, если абонент не найден» в текущем компоненте, задействовать режим входа в задачу только при успешном обнаружении абонента в таблице.


Среди способов идентификации выделяются два:

· По АОН среди полей таблицы, обозначенных типом «Телефон»;

· По значению в указанном поле таблице (используются свойства «Идентификатор абонента» и «Поле идентификации» текущего компонента.


В некоторых случаях, когда одного поля недостаточно, и нужна более серьезная проверка условий идентификации, можно использовать «Запрос в БД» с произвольной проверкой условий и возвратом уникального значения строки в таблице с последующим входом в задачу и идентификацией по основному полю «Id», обозначенного в таблице абонентов как «Идентификатор».

Идентификатор абонента

Аргумент, значение которого берется для идентификации абонента.  Ожидается, что значение уникально определяет абонента.  Используется совместно со свойством «Поле идентификации».

Поле доступно только при выборе значения «По столбцу» в свойстве «Тип идентификации».

Поле идентификации

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

Поле доступно только при выборе значения «По столбцу» в свойстве «Тип идентификации».

Возврат, если абонент не найден

Да/Нет. Определяет способ запуска задачи с идентификацией абонентов. Имеет смысл только при входе в задачу с установленным свойством «Модифицировать записи прикрепленной таблицы». 

При установке значения «Да» в случае неудачного поиска абонента в таблице осуществляет возврат по ветке «Переход, абонент не найден».

При установке значения «Нет» осуществляется стандартная процедура добавления новой записи в таблицу с установкой поля идентификаторов, по которому осуществлялся поиск.

Очередь ожидания

Активировать ли очередь ожидания в случае, если номер занят.

Расширенная настройка

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

Запись

Доступно только при расширенной настройке компонента. Позволяет установить индивидуальные параметры записи коммутаций для текущего звонка в задаче (текущей сессии - цепочки коммутаций).

· Согласно настройкам задачи

· Записывать

· Не записывать


Режим обхода операторов

Доступно только при расширенной настройке компонента. Позволяет установить индивидуальный режим выбора оператора для текущего звонка, вне зависимости от того, какой вариант обхода выбран в самой задаче. Список возможных вариантов можно посмотреть в соответствующем свойстве голосовой задачи на вкладке «Ресурсы».

Переход

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

Переход, превышено число подключений

Компонент, на который передается управление, если данным звонком превышено установленное в задаче максимальное число подключений (одновременных звонков во входящей задаче). Максимальное число задается в свойствах голосовой задачи на вкладке «Ресурсы».

Переход, задача не найдена

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

Переход, абонент не найден

Компонент, на который передается управление, если абонент не идентифицирован в прикрепленной таблице. Это может произойти в случае, если установлено свойство «Возврат, если абонент не найден» текущего компонента, а также в запускаемой задаче установлено свойство «Модифицировать записи прикрепленной таблицы».

Поле доступно только при выборе значения «Да» в свойстве «Возврат, если абонент не найден».

Переход, вне расписания

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

Переход, вне периода активности

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

Переход, параметры не подходят

Компонент, на который передается управление, если задача неактивна, задача не является входящей или звонок осуществляется с линии, не поддерживающей обработку в задаче (внутренние линии или линии, подключенные к АТС).

Переход, превышено время в очереди

Компонент, на который передается управление, если абонент попал в очередь задачи и находился в ожидании более установленного времени (свойства задачи на вкладке «Дополнительно»).

Переход, занято

Компонент, на который передается управление, если все операторы заняты, и не включена очередь ожидания.

Переход, не отвечает

Компонент, на который передается управление, если не найдено ни одного оператора, либо время ожидания ответа последнего оператора истекло.

Имя

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




Вход в проект


Администратор комплекса, не владея информацией о задачах, может настроить переадресацию потока звонков на проект. Компонентом «Вход в проект» производится поиск и запуск главного сценария IVR указанного в свойстве проекта. Тот в свою очередь может иметь любую структуру: запускать задачи, ветвиться, запускать вложенные сценарии и пр.

Непосредственно перед запуском осуществляется упаковка текущего сценария в стэк. Таким образом, обработка звонка продолжится по общему принципу, заложенному администратором, если главный сценарий проекта вернет управление (с помощью компонента «Стоп» с установленным свойством «Возврат управления»). В случае успеха, или отсутствия необходимости возврата управления в основной сценарий, в сценарии проекта должен присутствовать компонент «Стоп» с неустановленным свойством «Возврат управления» (в случае успешного переключения) или «Положить трубку».


Свойства:


Проект

Один из списка существующих проектов системы Oktell.

Переход

Компонент, на который передается управление в случае возврата управления из главного сценария запускаемого проекта (с помощью компонента «Стоп» с установленным свойством «Возврат управления»).

Переход, проект не найдена

Компонент, на который передается управление, если проект не указан или не найден среди существующих в системе.

Переход, параметры не подходят

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

Имя

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




Управление контентом


Осуществляет чтение или изменение пользовательского поля выбранного контента. В ходе работы с каналом системой производится сбор и формирование контента. Это XML документ, который существует в памяти сервера и постоянно пополняется происходящими действиями в ходе обработки вызова. Контент линии существует только у внешних линий, формируется при поступлении или совершении звонка по каналу, и сбрасывается при завершении этого звонка. Может быть передан в служебный сценарий, запускаемый по окончании обработки вызова по внешнему каналу. Также существует контент цепочки коммутаций, который формируется пока существует обозначенная цепочка. При присоединении или отбое каналов из цепочки ее контент существует, наполняется и может быть обработан внешним образом.


Свойства:


Объект

Линия (канал) / цепочка коммутаций. 

Источник обрабатываемого контента (контент в системе двух видов - для канала и для цепочки коммутаций)

Элемент

Заголовок/коммутация.

Пользовательское поле может быть взято в заголовке всего контента или в поле конкретной коммутации.

Действие

Получить/установить.

Определяет действие, которое производится с пользовательским полем

Переменная/Аргумент

В зависимости от действия назначается либо аргумент (значение которого будет установлено в определенное пользовательское поле контента) или переменная, в которую будет размещено значение определенного пользовательского поля контента.

Переход

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

Имя

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




Вход в конференцию


Производит подключение канала к конференции. Подробно о конференц-связи и управлении в разделе «Клиентское приложение. Телефон. Конференц-связь».

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


Свойства:


Ключ конференции

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

В каждый момент времени уникальным образом идентифицирует активную конференцию. Номера комнат могут повторяться в истории, однако в каждый момент времени не существует двух активных конференций с одним номером. Идентификаторы же конференций повторяться не должны.

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

Определять участника

Да/нет. Активирует/деактивирует режим проверки уникальности и привязки к существующим участникам.

Ключ участника

Доступен только при активации режима определения участника.

Числовой или строковый аргумент, идентифицирующий вновь подключаемого участника конференции. В случае, если в указанной конференции не существует участника с таким ключом (идентификатором или кодом идентификатора), происходит вход в конференцию, при этом указанный ключ регистрируется в качестве идентификатора. Если же существует активный участник с таким идентификатором, то вход блокируется во избежание дублирования. Исключением является участник конференции, находящийся в состоянии ожидания ответа - в этом случае происходит привязка вновь подключаемой линии к этому участнику без проверки на уровень доступа к конференции.

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

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

Создать, если отсутствует

Да/нет. Определяет поведение компонента в случае, если конференции с указанным номером комнаты не существует на текущий момент. «Да» - производит создание конференции и подключается к ней, «Нет» - отклоняет вход и производит выход по ветке «Отсутствует».

Разрешать вход в закрытую

Да/нет. В случае «Да» вход будет разрешен и пройдет без запроса к управляющему при любой настройке типа доступа.

Таймаут ожидания разрешения, с

Время в секундах, в течение которого компонент будет ожидать ответа управляющего в случае, если конференция имеет режим входа с подтверждением.

Расширенная настройка

Доступно только если активирован режим создания в случае отсутствия конференции.

Да/нет. Открывает для настройки ряд свойств создаваемой конференции.

Название конференции

Доступно при расширенной настройке и применяется, если конференция не существует, и компонентом производится ее создание. По умолчанию «Автоконференция номер дата/время».

Название конференции для отображения в клиентском интерфейсе и в статистических модулях.

Описание конференции

Доступно при расширенной настройке и применяется, если конференция не существует, и компонентом производится ее создание. По умолчанию пустая строка.

Строковая идентификация или описание конференции. Передается в клиентские модули и в сценарий обработки завершения конференции.

Запись

Доступно при расширенной настройке и применяется, если конференция не существует, и компонентом производится ее создание. По умолчанию запись активирована.

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

Вид

Доступно при расширенной настройке и применяется, если конференция не существует, и компонентом производится ее создание. По умолчанию создается неуправляемая конференция.

· Неуправляемая конференция.

· Селекторное совещание.


Тип доступа

Доступно при расширенной настройке и применяется, если конференция не существует, и компонентом производится ее создание. По умолчанию создается открытая конференция.

· Открытое совещание.

· Закрытое, с возможностью подать заявку на вход.

· Закрытое, вход только по приглашениям.


Ключ управляющего

Доступно при расширенной настройке и применяется, если конференция не существует, и компонентом производится ее создание. По умолчанию управляющим назначается пользователь на обслуживаемой текущим сценарием линии.

Аргумент, определяющий управляющего участника конференции.

Модель поведения

Доступно при расширенной настройке и применяется, если конференция не существует, и компонентом производится ее создание. По умолчанию устанавливается обычный режим.

· Обычный режим.

· Преобразовать в коммутацию.

Режим преобразования в коммутацию ожидает появления второго участника конференции и сразу после его присоединения инициирует преобразование. Совместно с активацией воспроизведения первому участнику режим может использоваться для организации парковочных секций.

ВНИМАНИЕ! Следует помнить, что в конференции у каждого участника своя уникальная сессия (идентификатор цепочки коммутаций), после преобразования в коммутацию сессия одного из участников наследуется другим.

Воспроизведение первому участнику

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

· Согласно общим настройкам.

· Да.

· Нет.


Сохранить идентификаторы

Да/нет. Осуществляет сохранение параметров обнаруженной/созданной конференции в указанных переменных.

Идентификатор в переменную

Доступно в режиме сохранения идентификаторов. Строковая переменная, в которую сохранится GUID-идентификатор обнаруженной/созданной конференции.

Код идентификатора в переменную

Доступно в режиме сохранения идентификаторов. Числовая/строковая переменная, в которую сохранится код GUID-идентификатора обнаруженной/созданной конференции. 

Код идентификатора - это функция от Guid-идентификатора, возвращающая довольно уникальное целое число.

Номер комнаты в переменную

Доступно в режиме сохранения идентификаторов. Числовая/строковая переменная, в которую сохранится номер комнаты обнаруженной/созданной конференции.

Переход

Компонент, на который передается управление после успешного входа в конференцию.

Переход, отсутствует

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

Переход, нет доступа

Компонент, на который передается управление в случае, если конференция существует, и доступ к конференции заблокирован (закрытая конференция или управляющий отклонил запрос на вход).

Переход, таймаут ожидания разрешения

Компонент, на который передается управление в случае, если при входе в конференцию требуется разрешение управляющего, реакции которого не последовало в течение установленного свойством «Таймаут» времени.

Переход, участник уже существует

Компонент, на который передается управление в случае, если установлен режим определения участника, указан ключ участника, и этот ключ обнаружен среди активных участников указанной конференции.

Переход, неудача

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

Имя

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




Отправка факсимильного сообщения


Компонент открывает факс сеанс на линии и в случае успеха отправляет документы, определенные в параметрах. Для корректной работы необходимо наличие в текущей плате возможности работы с факсимильными сообщениями, наличие свободных портов для факс-сеансов.

Для плат семейства Ольха-9 необходим ключ, лицензирующий работу с факсами.

Для плат Synway необходимо наличие мезонина для работы с факсами.

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


Компонент отправки предоставляет возможность автоматического преобразования изображения в необходимый формат. Однако в зависимости от используемых параметров (тип преобразования, размер исходного документа и т.д.) это может занять некоторое время. Поэтому настоятельно рекомендуется во избежание пауз готовить файлы в нужном формате.


Свойства:


Документ 1

Файл изображения для отправки. Окно выбора изображения. Допускаются статические файлы, хранящиеся вместе со сценариями, а также динамически прикрепляемые файлы, имя которых формируется в компоненте на этапе исполнения.

Документ 2

Аналогичено свойству Документ 1.

Документ 3

Аналогичено свойству Документ 1.

Тип преобразования к битовому изображению

Один из вариантов преобразования отправляемых изображений к битовому, поддерживаемому формату факсимильной передачи. 


Среди способов преобразования допускаются:

· Без изменений. Файл будет передан в исходном виде. В случае если он не подходит, будет возвращена ошибка;

· По фиксированной границе яркости. В соответствии с коэффициентом;

· По границе яркости от крайних точек;

· По проценту заполнения листа;

· Случайный офсет.


Коэффициент границы контрастности

Аргумент, представляющий собой действительное число от 0 до 1, являющееся параметром для функции преобразования к битовому изображению. Например при выборе пункта "По фиксированной границе яркости" определяет уровень яркости, ниже которого производится преобразование к черному цвету, остальные к белому.

Приведение ширины

Для отправки факса в битовом изображении требуется строго фиксированная ширина. 


Среди способов преобразования допускаются:

· Без изменений. Файл будет передан в исходном виде с исходной шириной. В случае, если он не подходит, будет возвращена ошибка.

· Достраивать без изменения размера. Если изображение меньше требуемой ширины, его ширина будет увеличена за счет белых полос по краям.

· Приводить по X. Ширина будет изменена до требуемой, высота останется без изменений.

· Приводить по XY пропорционально. Ширина будет изменена до требуемой, высота будет изменена аналогично изменению ширины для сохранения пропорций.

· Растягивать по X. Если изображение меньше требуемой ширины, ширина будет увеличена до необходимой, высота останется без изменений.

· Растягивать по XY пропорционально. Если изображение меньше требуемой ширины, ширина будет увеличена до необходимой, высота будет изменена аналогично для сохранения пропорций.

· Сужать по X. Если изображение больше требуемой ширины, ширина будет уменьшена до необходимой, высота останется без изменений.

· Сужать по XY пропорционально. Если изображение больше требуемой ширины, ширина будет уменьшена до необходимой, высота будет уменьшена аналогично для сохранения пропорций.


Таймаут, с

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

Код ошибки в переменную

Переменная, в которую будет записан числовой код ошибки.


Коды возвращаемых ошибок:

0 - Ошибок нет.

1 - Канал не поддерживает факс сеанс.

3 - Таймаут.

4 - Исключение при вызове аппаратной функции.

5 - Неверные параметры.

65281 - Системная ошибка.

65282 - Ошибка драйвера.

65283 - Ошибка ввода-вывода устройства.

65284 - Ошибка памяти.

65285 - Факс сессия уже открыта.

65288 - Ошибка файла.

65289 - Страницы не обнаружены.

65290 - Превышение количества строк.

65292 - Несоответствие версии драйвера.

65295 - Некорректная версия.

Переход, успех

Компонент, на который передается управление после успешно проведенной операции.

Переход, неудача

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

Имя

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




Прием факсимильного сообщения


Компонент открывает факс сеанс на линии и в случае успеха принимает факсимильные сообщения и сохраняет в определенное в параметрах место. Для корректной работы необходимо наличие в текущей плате возможности работы с факсимильными сообщениями, наличие свободных портов для факс-сеансов.

Для плат семейства Ольха-9 необходим ключ, лицензирующий работу с факсами.

Для плат Synway необходимо наличие мезонина для работы с факсами.

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


В случае если принимается более одного документа, производится формирование нескольких файлов, с добавлением к имени исходного определенного в параметрах файла расширениях, например «_pageN».


Свойства:


Файл

Файл изображения для отправки. Окно выбора изображения. Допускаются статические файлы, хранящиеся вместе со сценариями, а также динамически прикрепляемые файлы, имя которых формируется в компоненте на этапе исполнения.

Имя файла в переменную

Аналогичено свойству Документ 1.

Возвращать полный путь

Аналогичено свойству Документ 1.

Таймаут, с

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

Код ошибки в переменную

Переменная, в которую будет записан числовой код ошибки.

Перечень в\озможных ошибок см. в описании аналогичного свойства компонента «Отправка факсимильного сообщения».

Переход, успех

Компонент, на который передается управление после успешно проведенной операции.

Переход, неудача

Компонент, на который передается управление, если прием завершился неудачей.

Имя

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