Das Asterisk Buch

Ein Pattern wird immer mit einem Unterstrich (_) vor dem eigentlichen Suchmuster eingeleitet:

exten => _Regular Expression,Prioritaet,Applikation

Eine Regular Expression kann in Asterisk aus den folgenden Elementen^[9] bestehen:

Wichtig

Ein beliebter Fehler ist es, am Anfang einer Regular Expression das Underscore-Zeichen "_" zu vergessen. Für Asterisk ist aber die Extension XXX ebenfalls eine vollkommen sinnvolle Extension (da SIP ja nicht nur Zahlen, sondern auch Buchstaben als Zieladresse kennt). Entsprechend wird es auch keine Fehlermeldung geben. Dummerweise wird das Pattern aber auch nie matchen, weil es nicht als Pattern (also mit dem _) eingegeben wurde.

Nehmen wir einmal an, dass in unserer extensions.conf der folgende Dialplan steht:

[general]

[meine-telefone]
exten => 23,1,Answer()
exten => 23,2,Playback(hello-world)
exten => 23,3,Hangup()

Dann können wir im CLI von Asterisk (das ist das Interface, das bei einem bereits laufenden Asterisk mit asterisk -r gestartet werden kann) mit dem Befehl dialplan show (auf Asterisk 1.2: show dialplan) den aktuellen Dialplan anzeigen:

*CLI> dialplan show
[ Context 'default' created by 'pbx_config' ]

[ Context 'meine-telefone' created by 'pbx_config' ]
  '23' =>           1. Answer()                                   [pbx_config]
                    2. Playback(hello-world)                      [pbx_config]
                    3. Hangup()                                   [pbx_config]

[ Context 'parkedcalls' created by 'res_features' ]
  '700' =>          1. Park()                                     [res_features]

-= 2 extensions (4 priorities) in 3 contexts. =-
*CLI>

Das CLI zeigt jetzt alle Wählregeln an, die Asterisk bekannt sind. Deshalb gibt es auch noch einen Context "parkedcalls", den wir gar nicht wissentlich aktiviert haben (dieser wird standardmäßig in der features.conf aktiviert und stört uns jetzt nicht weiter). Wenn wir uns nur für den Dialplan für den Context meine-telefone interessieren, so können wir diesen mit dialplan show meine-telefone abrufen:

*CLI> dialplan show meine-telefone
[ Context 'meine-telefone' created by 'pbx_config' ]
  '23' =>           1. Answer()                                   [pbx_config]
                    2. Playback(hello-world)                      [pbx_config]
                    3. Hangup()                                   [pbx_config]

-= 1 extension (3 priorities) in 1 context. =-
*CLI> 

Der Befehl dialplan show kann aber nicht nur ganze Contexte anzeigen, sondern auch sagen, was passiert, wenn ich eine bestimmte Nummer wähle. Wenn ich mit einem Telefon, das im Context meine-telefone ist, die Nummer 25 anrufe, dann kann ich mit dialplan show 25@meine-telefone anzeigen, was passiert:

*CLI> dialplan show 25@meine-telefone
There is no existence of 25@meine-telefone extension
*CLI>

Es wird also nichts passieren, weil es keinen Match für die von mir gewählte Extension 25 gibt. Wenn ich das Gleiche für die 23 mache, dann gibt es folgende Ausgabe:

*CLI> dialplan show 23@meine-telefone
[ Context 'meine-telefone' created by 'pbx_config' ]
  '23' =>           1. Answer()                                   [pbx_config]
                    2. Playback(hello-world)                      [pbx_config]
                    3. Hangup()                                   [pbx_config]

-= 1 extension (3 priorities) in 1 context. =-
*CLI> 

Wenn ich in allen verfügbaren Contexten nach einem Match für die 23 suchen möchte, so geht das mit dialplan show 23@:

*CLI> dialplan show 23@
[ Context 'meine-telefone' created by 'pbx_config' ]
  '23' =>           1. Answer()                                   [pbx_config]
                    2. Playback(hello-world)                      [pbx_config]
                    3. Hangup()                                   [pbx_config]

-= 1 extension (3 priorities) in 1 context. =-
*CLI>

Erweitern wir unseren Dialplan einmal um einen weiteren Context:

[general]

[meine-telefone]
exten => 23,1,Answer()
exten => 23,2,Playback(hello-world)
exten => 23,3,Hangup()

[abteilung-z]
exten => _2X,1,Answer()
exten => _2X,2,Playback(hello-world)
exten => _2X,3,Hangup()

Und jetzt führen wir noch einmal dialplan show 23@ aus (vorher müssen wir natürlich Asterisk mit reload im CLI sagen, dass es den neuen Dialplan einlesen soll):

*CLI> dialplan show 23@
[ Context 'abteilung-z' created by 'pbx_config' ]
  '_2X' =>          1. Answer()                                   [pbx_config]
                    2. Playback(hello-world)                      [pbx_config]
                    3. Hangup()                                   [pbx_config]

[ Context 'meine-telefone' created by 'pbx_config' ]
  '23' =>           1. Answer()                                   [pbx_config]
                    2. Playback(hello-world)                      [pbx_config]
                    3. Hangup()                                   [pbx_config]

-= 2 extensions (6 priorities) in 2 contexts. =-
*CLI> 

Es werden also alle matchenden Extensions anzeigt. Um im obigen Beispiel zu bleiben, probieren wir das jetzt auch noch einmal mit dialplan show 25@ aus:

*CLI> dialplan show 25@
[ Context 'abteilung-z' created by 'pbx_config' ]
  '_2X' =>          1. Answer()                                   [pbx_config]
                    2. Playback(hello-world)                      [pbx_config]
                    3. Hangup()                                   [pbx_config]

-= 1 extension (3 priorities) in 1 context. =-
*CLI>

Logischerweise gibt es dabei nur einen Treffer, und der ist im Context abteilung-z. Sollten Sie also mit einem Telefon, das im Context meine-telefone arbeitet, die 25 wählen, so werden Sie trotzdem kein hello-world hören, denn dies funktioniert nur bei Telefonen, die auch im Context abteilung-z arbeiten.

Das Pattern Matching in Asterisk ist bei großen Dialplänen eine trickreiche Angelegenheit. Asterisk geht nämlich nicht, wie allgemein angenommen wird, plump von oben nach unten den Dialplan durch. Nein, es priorisiert innerhalb der Patterns!

Je exakter ein Pattern matcht, desto höher ist die Wahrscheinlichkeit, dass es matcht. Asterisk geht allerdings – bevor es eine Entscheidung trifft – den ganzen Context durch. Es könnte ja sein, das ein anderes Pattern noch besser matcht.

Beispiel:

[verkauf]
exten => _12X.,1,NoOp{12X}
exten => 12345,1,NoOp(12345}
exten => _1234.,1,NoOp{1234.}

Um herauszufinden, welches Pattern matcht, wenn die 12345 gewählt wird, können wir dies mit dialplan show 12345@verkauf überprüfen:

*CLI> dialplan show 12345@verkauf
[ Context 'verkauf' created by 'pbx_config' ]
  '12345' =>        1. NoOp(12345})                               [pbx_config]
  '_1234.' =>       1. NoOp{1234.}()                              [pbx_config]
  '_12X.' =>        1. NoOp{12X}()                                [pbx_config]

-= 3 extensions (3 priorities) in 1 context. =-
*CLI> 

Asterisk zeigt alle Treffer, aber priorisiert die Zeile, in der 12345,1,NoOP{12345} steht. Die höchste Priorität wird immer ganz oben angezeigt.

Jetzt kontrollieren wir das noch für die Nummer 12346 mit dem Befehl dialplan show 12346@verkauf:

*CLI> dialplan show 12346@verkauf
[ Context 'verkauf' created by 'pbx_config' ]
  '_1234.' =>       1. NoOp{1234.}()                              [pbx_config]
  '_12X.' =>        1. NoOp{12X}()                                [pbx_config]

-= 2 extensions (2 priorities) in 1 context. =-
*CLI> 

Auch hier bekommt das Pattern mit dem "besten" Treffer die höchste Priorität.

	Wichtig
	Es ist nicht wichtig, in welcher Reihenfolge Patterns im Dialplan geschrieben werden! Es ist nur wichtig, wie genau ein Pattern matcht. Je genauer es matcht, desto höher wird es priorisiert.

	Warnung
	Es gibt eine Sonderregel für das Pattern _. "_." matcht immer und hat auch immer die höchste Priorität. Es ist also egal, was Sie sonst noch in diesem Context für Regeln haben! Es wird immer nur die Regel mit dem Pattern "_." ausgeführt. Man sollte also lieber ein "_X." nehmen, außer man ist sich absolut sicher und weiß, was das Pattern "_." bewirkt.

Auch wenn die Reihenfolge von Pattern nicht immer ganz trival ist, gibt es eine einfache Debugging-Möglichkeit. Mit show dialplan 12345@verkauf lässt sich der Dialplan für die gewählte Nummer 12345 im Context verkauf auflisten. So können Sie für spezielle Nummern überprüfen, ob auch die dafür vorgesehene Regel matcht.

Sonderregel für das Pattern _. in Asterisk 1.2

Damit das Leben eines Asterisk-Administrators nicht zu einfach wird, hat sich Digium noch eine Besonderheit für das Pattern "_." in der Asterisk-Version 1.2 ausgedacht. Obwohl dieses Pattern das allgemeinste und damit von der Logik her das Pattern mit der geringsten Priorität sein müsste, ist es genau andersherum!

	Warnung
	_. bekommt in der Asterisk-Version 1.2 immer die höchste Priorität!

	Anmerkung
	Bitte beachten Sie, dass der CLI-Befehl show dialplan zwar auch noch in der Version 1.4 funktioniert, aber unerwünscht ist. Deshalb lauten die Aufrufe in der Version 1.2 show dialplan und in der Version 1.4 dialplan show.

Probieren wir noch einmal unseren obigen Dialplan mit einer zusätzlichen Extension "_." aus:

[verkauf]
exten => _12X.,1,NoOp{12X}
exten => 12345,1,NoOp(12345}
exten => _1234.,1,NoOp{1234.}

exten => _.,1,NoOp{Bingo}

Wenn wir jetzt die Rufnummer 12346 ausprobieren wollen, bekommen wir mit dem Befehl dialplan show 12346@verkauf in der Version 1.4 folgende Ausgabe:

*CLI> dialplan show 12346@verkauf
[ Context 'verkauf' created by 'pbx_config' ]
  '_1234.' =>       1. NoOp{1234.}()                              [pbx_config]
  '_12X.' =>        1. NoOp{12X}()                                [pbx_config]
  '_.' =>           1. NoOp{Bingo}()                              [pbx_config]

-= 3 extensions (3 priorities) in 1 context. =-
*CLI>

In Asterisk 1.2 bekommt der Befehl show dialplan 12346@verkauf aber folgende Ausgabe:

*CLI> dialplan show 12346@verkauf
[ Context 'verkauf' created by 'pbx_config' ]
  '_.' =>           1. NoOp{Bingo}()                              [pbx_config]
  '_1234.' =>       1. NoOp{1234.}()                              [pbx_config]
  '_12X.' =>        1. NoOp{12X}()                                [pbx_config]

-= 3 extensions (3 priorities) in 1 context. =-
*CLI>

Deshalb sollte man als "Restesammler" (wenn überhaupt) nur das Pattern _X. benutzen. Der folgende Dialplan wird in den Asterisk-Versionen 1.2 und 1.4 gleich behandelt:

[verkauf]
exten => _12X.,1,NoOp{12X}
exten => 12345,1,NoOp(12345}
exten => _1234.,1,NoOp{1234.}

exten => _X.,1,NoOp{Bingo}

Die Prioritäten sind in beiden Asterisk-Versionen wie folgt:

*CLI> dialplan show 12346@verkauf
[ Context 'verkauf' created by 'pbx_config' ]
  '_1234.' =>       1. NoOp{1234.}()                              [pbx_config]
  '_12X.' =>        1. NoOp{12X}()                                [pbx_config]
  '_X.' =>          1. NoOp{Bingo}()                              [pbx_config]

-= 3 extensions (3 priorities) in 1 context. =-
*CLI>