Anhang D. Funktionen im Dialplan

Seit Asterisk 1.2 gibt es im Dialplan nicht nur Applikationen, sondern auch sogenannte Funktionen. Anders als Applikationen können Funktionen nicht direkt aufgerufen werden. Stattdessen geben sie einen Wert zurück, oder man kann – was dem klassischen Verständnis einer Funktion widerspricht – auch (oder nur) in Verbindung mit der Applikation Set() (siehe Abschnitt C.149, „Set()“) schreibend auf sie zugreifen. Funktionsnamen werden immer ganz in Großbuchstaben geschrieben. Funktionen werden erstaunlicherweise wie Variablen durchweg in ${} eingeklammert, was notwendig ist, da Strings nicht immer in Hochkommata stehen müssen.
Würde man die in Asterisk nicht unbedingt intuitive Trennung zwischen Applikationen, Funktionen und sogar Variablen kritisieren, hätte man damit wahrscheinlich nicht ganz unrecht. Auch die Benennung ist nicht einheitlich: SIP_HEADER(), aber SIPCHANINFO() – ein Problem vieler Programmiersprachen, das letztlich nichts aussagt, aber die Einprägsamkeit erschwert. Die Idee, in Funktionen zu schreiben, ist recht ungewöhnlich und weicht vom üblichen Verständnis einer Funktion ab. Eine „Funktion“ in Asterisk kann man sich eher vorstellen wie ein assoziatives Array[213] (auch Hash-Tabelle genannt) in anderen Programmiersprachen. Beispiel:
Set(CHANNEL(language)=de);
NoOp(Sprache: ${CHANNEL(language)});
Dies würde in PHP so aussehen:
$channel["language"] = "de";
echo "Sprache: ", $channel["language"];
Bei vielen Funktionen kann der Schlüssel in dem (gedachten) assoziativen Array allerdings auch leer sein. Beispiel:
Set(GROUP()=ausgehend);
Insgesamt wirkt die Dialplan-Programmierung – trotz der Neuerungen in Version 1.4 – im Vergleich zu „richtigen“ Programmiersprachen sehr starr und wenig erweiterungsfähig. Wenn das Sie stört, sollten Sie sich vielleicht mit AEL (Asterisk Extension Language) befassen, die die gleichen Funktionen und Applikationen verwendet, aber eine etwas robustere Struktur bietet und oft übersichtlicher ist.
Im Asterisk-CLI[214] können Sie mit core show functions und core show function Funktionsname herausfinden, welche Funktionen in Ihrer Installation verfügbar sind. Dabei ist die komplette Großschreibung des Funktionsnamens wichtig.

[213] http://de.wikipedia.org/wiki/Assoziatives_Array

[214] Command Line Interface, kann durch asterisk -r aufgerufen werden