Macro()

Выполняет макрос, определённый в контексте macro-имя_макроса, переходя в добавочный номер s этого контекста и выполняя каждый шаг. Возвращается после того, как все шаги были выполнены.

Вызывающий добавочный номер, контекст и приоритет хранятся в переменных ${MACRO_EXTEN}, ${MACRO_CONTEXT} и ${MACRO_PRIORITY} соответственно. Аргументы arg1, arg2 и т.д. становятся в контексте макроса переменными ${ARG1}, ${ARG2} и т.д.

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

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

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

Описание макроса

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

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

Имена макросов должны начинаться со служебного слова "macro-". Это отличает их от обычных контекстов. Команды внутри макроса формируются практически аналогично всем остальным элементам диалплана; единственное ограничение - макросы используют только добавочный номер "s". Введём логику голосовой почты в макрос, заменяя по ходу добавочные номера на "s":

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

Вызов макроса из диалплана

Использовать макрос в диалплане нам поможет приложение Macro(). Оно вызывает заданный макрос и передаёт в него необходимые аргументы. Например, чтобы вызвать наш макрос голосовой почты из диалплана, можно сделать следующее:

Приложение Macro() определяет также несколько специальных переменных. К
ним относятся:

${MACRO_CONTEXT}
	исходный контекст, в котором был вызван макрос.

${MACRO_EXTEN}
	исходный добавочный номер, в котором был вызван макрос.

${MACRO_PRIORITY}
	исходный приоритет, в котором был вызван макрос.

${ARGn}
	n-ный аргумент, передаваемый в макрос. Например, первым быь бы
	аргумент ${ARG1}, вторым - ${ARG2} и т.д.

Как говорилось ранее, описанный выше макрос был жёстко определён для Джона, тогда как должен быть универсальным. Давайте изменим его и вместо номера почтового ящика 101 будем использовать переменную ${MACRO_EXTEN}. Таким образом, при вызове макроса из добавочного номера 101 сообщения голосовой почты будут приходить в почтовый ящик 101; если макрос будет вызван из добавочного номера 102, сообщения пойдут в почтовый ящик 102 и т.д.:

Использование аргументов в макросе

Итак, мы уже близки к получению того макроса, какой нам нужен, осталось внести последнее изменение. Необходимо передать в макрос канал, по которому будут выполняться вызовы, потому что до сих пор в нём был жёстко прописан канал ${JOHN} (помните, мы определяли переменную JOHN как канал для звонков Джону?). Передадим канал как аргумент - и наш первый макрос будет готов:

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

И для 50 или более пользователей этот диалплан сохранит свою чёткость и организованность; для каждого пользователя просто будет создана строка со ссылкой на макрос, который может быть настолько сложным, насколько это необходимо. Может существовать даже несколько разных макросов для различных типов пользователей, таких как executives (руководство), courtesy_phones (телефоны справочной службы), call_center_agents (агенты центра обработки вызовов), analog_sets (аналоговые телефоны), sales_department (отдел продаж) и т.д.

Более сложная версия макроса может выглядеть примерно так:

Этот макрос использует замечательный побочный эффект приложения Dial(): Dial() задаёт переменную ${DIALSTATUS} как индикатор успешности или неуспешности вызова. В данном случае обрабатываются варианты NOANSWER (не отвечает) и BUSY (занято), а все остальные результаты трактуются как NOANSWER.