Skip to Content

Wiki source code of 07 - Dial plan

Show last authors
1 {{box cssClass="floatinginfobox" title="**Sommario**" width="300px"}}
2 {{toc start=2 depth="3"/}}
3 {{/box}}
4
5 == Introduzione ==
6
7 Il **dial plan** permette di impostare delle regole che possono intervenire sul numero quando un utente effettua una chiamata.
8
9 Un dial plan può avere diverse funzioni connesse ai piani di numerazione. Di seguito riportiamo alcuni esempi:
10
11 * impostare l’esecuzione automatica di numeri interni composti da tre cifre.
12 * Individuare i numeri telefonici appartenenti ad apparecchi esterni ed impostare il codice di impegno previsto dal centralino (ad esempio "0") .
13 * Eliminare il codice //+39// per le chiamate dirette in Italia.
14 * Riconoscere le chiamate dirette all’estero, e sostituire di conseguenza il prefisso "+" con quello previsto per le chiamate internazionali, ossia "00".
15
16 Per impostare il dial plan, effettuare la seguente procedura:
17
18 1. Fare doppio clic sull’icona //IFM SoftPhone// della traybar per aprire il [[display>>doc:IFM SoftPhone 2\.1.PanoramicaInterfaccia.InterfacciaCore.WebHome||anchor="HIldisplay" target="_blank"]].
19 1. Espandere il [[pannello dei controlli avanzati>>doc:IFM SoftPhone 2\.1.PanoramicaInterfaccia.InterfacciaCore.WebHome||anchor="HIlpannellodeicontrolliavanzati" target="_blank"]].
20 1. Premere il pulsante **Settings**.
21 \\[[image:sp_settings.jpg||height="210" width="350"]]
22 1. Viene visualizzata la finestra //Settings//. L'utente può configurare e personalizzare le principali caratteristiche e funzioni di IFM SoftPhone.
23 [[image:sp_settings_acc.jpg||height="496" style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px" width="400"]]
24 1. Cliccare sul pulsante **Advanced settings**. Viene visualizzata la finestra //Advanced account settings//.
25 [[image:sp_settings_acc_ads.jpg||height="274" style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin:20px 10px" width="400"]]
26 1. Impostare il **Dial Plan**.
27 1. Premere **OK** per confermare.
28
29 == Struttura del dial plan ==
30
31 Il dial plan è composto da regular expression tipicamente suddivise in tre parti. Queste possono essere separate dai caratteri "|" o "!". Inoltre è possibile impostare differenti regole, concatendanole con doppi apici (vedere sotto la sezione [[//Dial plan complessi//>>||anchor="HDialplancomplessi"]]).
32
33 Ad esempio analizziamo la seguente regular expression:
34
35 (% style="font-family:Courier New,Courier,monospace" class="mark" %)"|^\+([0-9]*)$|000\1|d"
36
37 dove,
38
39 1. La prima parte (“|^\+([0-9]*)$|”) contiene il pattern che verrà usato per individuare il numero chiamato.
40 1. La seconda parte (“|000\1|”) contiene le istruzioni dell’operazione di sostituzione da applicare ai risultati ottenuti nella prima parte.
41 1. La terza (“|d”|) è opzionale e contiene i flag che impostano alcuni attributi addizionali.
42
43 == Le sostituzioni ==
44
45 Le espressioni di sostituzione trovano nella seconda parte del dial plan e sono sempre indicate dal carattere “\” seguito da un valore. Questo può essere di due tipi:
46
47 * di tipo numerico, ad es. “\1”;
48 * il segnaposto “d”, ad es. “\d”.
49
50 Nel primo caso l’istruzione di sostituzione deve essere applicata alla stringa che costituisce il primo risultato del match compiuto dalla prima parte del dial plan.
51
52 Nel secondo caso l’istruzione “\d” indica sempre il valore del registrar server (per maggiori informazioni su quest’ultimo consultare il paragrafo “Account”).
53
54 Ad esempio la seguente regular expression “|*|sip:\1@\d|” antepone la stringa “[[sip:>>path:sip:]]” al numero individuato dall’espressione “*”, secondo appunto l’istruzione di sostituzione “\1”, ed aggiunge il nome del dominio SIP dopo il carattere “@”, come indicato dal segnaposto “\d”.
55
56 == I flag ==
57
58 Sono altresì disponibili i seguenti flag:
59
60 * “d”: permette di chiamare il numero visualizzato nel display senza premere il pulsante di chiamata. Ad esempio la seguente regular expression “|([0-9]{3})|sip:\1@ifminfomaster.com|d” esegue immediatamente la chiamata al numero indicato, ma solo se esso è composto da tre cifre (“{3}”).
61 * “i”: indica che le operazioni di confronto sono case-sensitive.
62
63 == Dial plan complessi ==
64
65 In alcune circostanze, affinché si possano compiere operazioni complesse, i dial plan possono essere concatenati tra loro. Per fare ciò è necessario che i singoli dial plan siano racchiusi tra doppi apici, ad es. "|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d".
66
67 **Attenzione**: i doppi apici vanno utilizzati soltanto in presenza di concatenazione.
68
69
70 == Esempi di dial plan ==
71
72 === Comporre il numero di un interno ed eseguire automaticamente la chiamata ===
73
74 Impostare il seguente dial plan:
75
76 * “|([1-9]{3})|\1|d”
77
78 Il pattern intercetta tutti i numeri telefonici composti da 3 cifre (“{3}”) che contengono i numeri da 1 a 9 (“[1-9]”) ed esegue la chiamata in modo automatico senza che l’utente debba premere nessun tasto.
79
80 === Inserire il prefisso di impegno del centralino ===
81
82 Impostare il seguente dial plan:
83
84 * “|^\+39([0-9]*)$|0\1|d”
85
86 Il pattern intercetta il codice internazionale appartenente all’Italia (“+39”) e lo sostituisce col valore “0”; infine esegue automaticamente la chiamata.
87
88 La variante senza codice internazionale appartenente all’Italia (“+39”):
89
90 * “|^0([0-9]*)$|00\1|d”
91
92 Il pattern intercetta il valore “0” del prefisso telefonico e lo sostituisce con valore “00”; infine esegue automaticamente la chiamata.
93
94 === Gestione dei numeri internazionali (dial plan concatenati) ===
95
96 Impostare i seguenti dial plan:
97
98 * "|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d"
99
100 Il primo dial plan sostituisce il valore letterale del codice telefonico assegnato all’Italia (“+39”) col carattere “0”. Il secondo rimpiazza il carattere “+” con la stringa “000” (codice di impegno del centralino più il codice di chiamata internazionale). Il meccanismo è il seguente:
101
102 1. il primo dial plan analizza il numero in ingresso e, se possibile, effettua le sostituzioni indicate;
103 1. il secondo analizza il risultato del primo dial plan e, se possibile, effettua le sostituzioni previste.
104
105 Quindi poniamo che l’utente richieda (tramite la rubrica) di effettuare una chiamata al numero “+390103747811”. Il primo dial plan intercetta la stringa letterale “+39” e la sostituisce con “0”; il valore finale sarà “00103747811”. Il secondo dial plan esamina quest’ultimo e non potendo individuare il carattere “+”, non effettua nessuna modifica. Infine il flag “d” attiva la chiamata automatica.
106
107
108
109