Использование AEL в диалплане

Asterisk начиная с версии 1.4 поддерживает также и диалплан, написанный на Asterisk Extension Language (AEL), который прописывается в файле extensions.ael. Возможно одновременное использование как традиционного диалплана, прописанного в extensions.conf, так и extensions.ael. Если присутствуют оба файла extensions.conf будет переписывать идентичные части. В Asterisk присутствует утилита для преобразования ael в формат extensions.conf, которая называется aelparse. Утилита aelparse также используется для поиска синтаксических ошибок в extensions.ael.

Команды для ael в CLI

Для применения изменений в extensions.ael в консоли Asterisk необходимо выполнить команду

ael reload

Введенная в консоли Asterisk команда

dialplan show

выведет совокупный диалплан, загруженный Asterisk из extensions.conf и extensions.ael.

Источник каждого правила отображается в квадратных скобках, предшествующих правилу.

Сравнение extensions.conf и extensions.ael

Конец строки – команды в AEL должны  заканчиваться символом “;” так как в одной строке может быть несколько команд.

Контекст, экстеншены, приоритеты.

В AEL используются фигурные скобки. Указание приоритетов (1…n) больше не требуется.

extensions.conf:

[from-internal]
exten => _1XX,1,Dial(SIP/${EXTEN})
exten => _2XX,1,Dial(SIP/${EXTEN})

extensions.ael

context from-internal {
  _1XX => {
    Dial(SIP/${EXTEN});
  }
  _2XX => {
    Dial(SIP/${EXTEN});
  }
}

Если для экстеншена выполняется только одна команда, то фигурные скобки можно опустить:

context default {
  222 => Playback(hello);
}

Комментарии

Комментарии инициируются в AEL через „//“ (две косые черты). Для многострочных комментариев, введите каждую строку отдельно с помощью „//“ .

extensions.conf

; комментарий
exten => _2XX,1,Dial(SIP/${EXTEN}) ; Dial

extensions.ael

// комментарий
_2XX => {
  Dial(SIP/${EXTEN});  // Dial
}

Включение других контекстов (include).

extensions.conf

[office1]
exten => _1XX,1,Dial(SIP/${EXTEN})
exten => 0101,1,Dial(SIP/89990001122)

[office2]
exten => 3001,1,Dial(SIP/${EXTEN})

[from-internal]
include => office1
include => office2

extensions.ael

context office1 {
  _1XX => {
    Dial(SIP/${EXTEN});
  }
  0101 => {
    Dial(SIP/89990001122);
  }
}

context office2 {
  _2XX => {
    Dial(SIP/${EXTEN});
  }
}

context from-internal {
  includes {
    office1;
    office2;
  }
}

extensions.conf

[globals]
PREFIX=2
FORMAT=wav

extensions.ael

globals {
  PREFIX=2;
  FORMAT=wav;
}

Выражения и назначения

AEL не является полноценным языком программирования, но поддерживает конструкции if(), while(), for(). Для получения предсказуемых результатов при назначении переменных лучше использовать Set:

extensions.conf

exten => 77,1,Set(action=saypin)
exten => 77,n,ExecIf($["${action}" = "saypin"],SayDigits,56558)

extensions.ael

77 => {
  Set(action=saypin);
  if ("${action}" = "saypin") {
    SayDigits(56558);
  }
}
}

Метки (именованные приоритеты) и переходы к ним — goto и jump

Как и в extensions.conf в ael является необязательным указание контекста (в goto, jump), экстеншена(в goto). Т.е. для того, чтобы перейти к какой либо метке в пределах текущего контекста, экстеншена в ael необходимо ввести goto label.

Следующие примеры переходов эквивалентны:

extensions.conf

Goto(from-internal,200,1)

ael(goto)

goto from-internal|200|1

ael(jump)

jump 200@from-internal

Циклы
В extensions.conf можно было использовать только 
В AEL присутствуют циклы for и while. В extensions.conf можно использовать приложения While() и EndWhile(), с помощью которых также можно описать логику цикла for.
В AEL также есть команды break и continue, которые можно использовать в циклах. break переходит к концу цикла, continue - переходит к началу.
extensions.conf

exten => 555,1,Set(x=0)
exten => 555,n,While($[${x} <= 5])
exten => 555,n,NoOp(x ist ${x})
exten => 555,n,Playback(beep)
exten => 555,n,Set(x=$[${x} + 1])
exten => 555,n,EndWhile()
exten => 555,n,NoOp(End)

extensions.ael (for)

555 => {
  for (x=0; ${x}<=5; x=${x}+1) {
    NoOp(x is ${x});
    Playback(beep);
  }
  NoOp(End);
}

extensions.ael (while)

555 => {
  x=0;
  while (${x} <= 5) {
    NoOp(x is ${x});
    // также в цикле в extensions.ael поддерживаются
    // конструкции выполняющие проверку и выход из цикла
    // if (${x} > 4) {
    //  break;
    // }
    //
    Playback(beep);
    x=${x} + 1;
  }
  NoOp(End);
}

Фильтрация по CallerID

В extensions.conf диалплан, предназначенный для определенного CallerID прописывался так:

 ;нежелательный звонок
exten => 110/89990001122,1,NoOp(Blacklist)
exten => 110/89990001122,n,Busy()
;остальные звонки
exten => 110,1,Dial(SIP/${EXTEN})

;нежелательный звонок
exten => 110/89990001122,1,NoOp(Blacklist)
exten => 110/89990001122,n,Busy()
;остальные звонки
exten => 110,1,Dial(SIP/${EXTEN})

extensions.ael

//нежелательный звонок
110/89990001122 => {
  NoOp(Blacklist);
  Busy();
}
//остальные звонки
110 => {
  Dial(SIP/${EXTEN});
}

Также вместо конкретного CallerID можно указывать шаблоны вида _23X.