Asterisk™: будущее телефонии Второе издание - Меггелен Джим Ван
Этот макрос использует замечательный побочный эффект приложения Dial(): Dial() задает переменную DIALSTATUS как индикатор успешности или неуспешности вызова. В данном случае обрабатываются варианты NOANSWER (не отвечает) и BUSY (занято), а все остальные результаты трактуются как NOANSWER.
Использование базы данных Asterisk (AstDB)
Ну что, пока довольны? Дальше будет еще интереснее! В Asterisk есть мощный механизм для хранения значений, который называется базой данных Asterisk (AstDB). AstDB обеспечивает простой способ хранения данных для использования в диалплане.
Для тех, кто имеет опыт использования реляционных баз данных, таких как PostgreSQL или MySQL, заметим, что база данных Asterisk не является традиционной реляционной базой данных. Это база данных Berkeley DB версии 1. Существует несколько способов хранения данных из Asterisk в реляционной базе данных. Подробнее о реляционных базах данных рассказывается в главе 12.
База данных Asterisk хранит данные в группах, называемых семействами, значения которых идентифицируются ключами. Например, если бы у нас имелось семейство test, мы могли бы хранить только одно значение с ключом count. Каждое хранящееся значение должно быть ассоциировано с каким-то семейством.
Хранение данных в AstDB
Для сохранения нового значения в базе данных Asterisk используется приложение SetQ[77], но с его помощью задается переменная не канала, а AstDB. Например, чтобы присвоить ключу count семейства test значение 1, необходимо записать следующее:
exten => 456,1,Set(DB(test/count)=1)
Если в семействе test уже есть ключ count, его значение будет заменено на новое. Также можно сохранять значения из командной строки Asterisk, выполнив команду database put семейство ключ значение. Для нашего примера надо ввести следующее: data base put test count 1.
Извлечение данных из AstDB
Чтобы извлечь значение из базы данных Asterisk и присвоить его переменной, используется все то же приложение Set(). Давайте извлечем значение count (опять же из семейства test), присвоим его переменной COUNT и затем воспроизведем это значение абоненту:
exten => 456,1,Set(DB(test/count)=1) exten => 456,n,Set(COUNT=${DB(test/count)}) exten => 456,n,SayNumber(${COUNT})
Также можно проверять значение заданного ключа из командной строки Asterisk, выполнив команду database get семейство ключ. Для просмотра всего содержимого AstDB используется команда database show.
Удаление данных из AstDB
Существует два способа удаления данных из базы данных Asterisk.
Чтобы удалить ключ, можно использовать приложение DB DELETE().
Оно принимает путь к ключу в качестве аргумента:
; удаляет ключ и возвращает его значение за один шаг
exten => 457,1,Verbose(0, The value was ${DB_DELETE(test/count)})
Также можно удалить все семейство ключей, используя приложение DBdeltree(). Оно принимает всего один аргумент - имя семейства ключей, подлежащего удалению. Чтобы удалить все семейство test, делаем следующее:
exten => 457,1,DBdeltree(test)
Для удаления ключей и семейств ключей AstDB из командной строки используются команды database del ключ и database deltree семейство соответственно.
Использование AstDB в диалплане
Существует бесконечное число вариантов использования базы данных Asterisk в диалплане. Чтобы представить AstDB, рассмотрим два простых примера. Первый - простой пример вычисления, демонстрирующий постоянство базы данных Asterisk (имеется в виду, что она устойчива к перезагрузкам системы). Во втором примере с помощью функции BLACKLIST() будет определена принадлежность номера к черному списку и необходимость его блокировки.
Для начала в примере с воспроизведением счета извлечем число (значение ключа count) из базы данных и присвоим его переменной COUNT. Если такой ключ не существует, DB() возвратит NULL (нет значения). Чтобы проверить наличие значения в базе данных, введем функцию ISNULL(), которая будет контролировать, возвращено ли значение. В случае если этого не произошло, мы присвоим AstDB исходное значение 1 с помощью приложения Set(). Следующий приоритет возвратит нас к приоритету 1. Это произойдет при первом вызове данного добавочного номера:
exten => 678,1,Set(COUNT=${DB(test/count)})
exten => 678,n,GotoIf($[${ISNULL(${COUNT})}]?:continue)
exten => 678,n,Set(DB(test/count)=1)
exten => 678,n,Goto(1)
exten => 678,n(continue),NoOp()
Далее будет воспроизведено текущее значение COUNT. После этого оно будет увеличено на 1:
exten => 678,1,Set(COUNT=${DB(test/count)})
exten => 678,n,GotoIf($[${ISNULL(${COUNT})}]?:continue)
exten => 678,n,Set(DB(test/count)=1)
exten => 678,n,Goto(1)
exten => 678,n(continue),NoOp()
exten => 678,n,SayNumber(${COUNT})
exten => 678,n,Set(COUNT=$[${COUNT} + 1])
Теперь, после приращения COUNT, давайте поместим новое значение в базу данных. Не забудьте, что сохранение значения для существующего ключа приводит к перезаписи предыдущего значения:
exten => 678,1,Set(COUNT=${DB(test/count)})
exten => 678,n,GotoIf($[${ISNULL(${COUNT})}]?:continue)
exten => 678,n,Set(DB(test/count)=1)
exten => 678,n,Goto(1)
exten => 678,n(continue),NoOp()
exten => 678,n,SayNumber(${COUNT})
exten => 678,n,Set(COUNT=$[${COUNT} + 1])
exten => 678,n,Set(DB(test/count)=${COUNT})
Наконец вернемся к первому приоритету. Теперь приложение будет продолжать счет:
exten => 678,1,Set(COUNT=${DB(test/count)})
exten => 678,n,GotoIf($[${ISNULL(${COUNT})}]?:continue)
exten => 678,n,Set(DB(test/count)=1)
exten => 678,n,Goto(1)
exten => 678,n(continue),NoOp()
exten => 678,n,SayNumber(${COUNT})
exten => 678,n,Set(COUNT=$[${COUNT} + 1]
exten => 678,n,Set(DB(test/count)=${COUNT})
exten => 678,n,Goto(1)
Попробуйте этот пример. Послушайте немного, как приложение считает, и повесьте трубку. Когда вы наберете этот добавочный номер снова, счет должен быть продолжен с той цифры, на которой вы остановились. Значение, хранящееся в базе данных, будет постоянным даже при перезагрузке Asterisk.
В следующем примере логика диалплана будет организована вокруг функции BLACKLIST(), которая проверяет наличие Caller ID (ID звонящего) текущего абонента в черном списке. (Черный список - это просто семейство AstDB, называемое blacklist.) Если функция BLACKLIST() находит номер в черном списке, она возвращает значение 1, в противном случае возвращается 0. Эти значения в сочетании с приложением GotoIf() могут использоваться для управления выполнением приложения Dial() при вызове:
exten => 124,1,GotoIf($[${BLACKLIST()]?blocked,1) exten => 124,n,Dial(${JOHN})
exten => blocked,1,Playback(privacy-you-are-blacklisted) exten => blocked,n,Playback(vm-goodbye) exten => blocked,n,Hangup()
Чтобы добавить номер в черный список, выполните команду database put blacklist номер 1 из интерфейса командной строки Asterisk.
Полезные функции Asterisk
Теперь, рассмотрев дополнительные базовые возможности, давайте перейдем к ряду популярных функций, включенных в Asterisk.
Zapateller()
Zapateller() - это простое приложение Asterisk, которое воспроизводит специальный информационный тон в начале звонка. Устройства автоматического набора (обычно используемые в системах продаж по телефону) принимают этот тон за сигнал разъединения линии. Причем они не только прекратят вызов, но также пометят данный номер как не обслуживаемый, что поможет избежать всех видов телемаркетинговых звонков. Чтобы использовать эту функциональность в своем диалпла- не, вам надо просто вызвать приложение Zapateller().