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" style="margin:20px 10px" 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 (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+([0-9]*)$|000\1|d"
36
37 dove,
38
39 1. La prima parte (% class="mark" style="font-family:Courier New,Courier,monospace" %)|^\+([0-9]*)$|(%%) contiene il pattern che verrà usato per individuare il numero chiamato.
40 1. La seconda parte (% class="mark" style="font-family:Courier New,Courier,monospace" %)|000\1|(%%) contiene le istruzioni dell’operazione di sostituzione da applicare ai risultati ottenuti nella prima parte.
41 1. La terza (% class="mark" style="font-family:Courier New,Courier,monospace" %)|d”|(%%) è opzionale e contiene i flag che impostano alcuni attributi addizionali.
42
43 == Le sostituzioni ==
44
45 Le espressioni di sostituzione si 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 esempio "\1"
48 * il segnaposto **"d"**, ad esempio "\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 fare riferimento alla sezione [[//Account//>>doc:IFM SoftPhone 2\.1.Impostazioni.WebHome||anchor="HAccount"]]).
53
54 Ad esempio la seguente regular expression (% class="mark" style="font-family:Courier New,Courier,monospace" %)|*|sip:\1@\d|(%%) antepone la stringa //sip~:// al numero individuato dall’espressione “*”, secondo 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 inoltre 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 (% class="mark" style="font-family:Courier New,Courier,monospace" %)|([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 esempio:
66
67 (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d"
68
69
70 (% class="box errormessage" %)
71 (((
72 **Attenzione**: i doppi apici vanno utilizzati soltanto in presenza di concatenazione.
73 )))
74
75
76 == Esempi di dial plan ==
77
78 === Comporre il numero di un interno ed eseguire automaticamente la chiamata ===
79
80 Per comporre il numero di un interno ed eseguire automaticamente la chiamata, impostare il seguente dial plan:
81
82 (% class="mark" style="font-family:Courier New,Courier,monospace" %)|([1-9]{3})|\1|d
83
84 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 ( **d** ).
85
86 === Inserire il prefisso di impegno del centralino ===
87
88 Per inserire il prefisso di impegno del centralino, impostare il seguente dial plan:
89
90 (% class="mark" style="font-family:Courier New,Courier,monospace" %)“|^\+39([0-9]*)$|0\1|d”
91
92 Il pattern intercetta il codice internazionale appartenente all’Italia ( **+39 **) e lo sostituisce con il valore **"0"**; infine esegue automaticamente la chiamata.
93
94 La variante senza codice internazionale appartenente all’Italia ( **+39 **):
95
96 (% class="mark" style="font-family:Courier New,Courier,monospace" %)“|^0([0-9]*)$|00\1|d”
97
98 Il pattern intercetta il valore “0” del prefisso telefonico e lo sostituisce con valore “00”; infine esegue automaticamente la chiamata.
99
100 === Gestione dei numeri internazionali ===
101
102 Per gestire i numeri internazionali, impostare i seguenti dial plan concatenati:
103
104 * "|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d"
105
106 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:
107
108 1. il primo dial plan analizza il numero in ingresso e, se possibile, effettua le sostituzioni indicate;
109 1. il secondo analizza il risultato del primo dial plan e, se possibile, effettua le sostituzioni previste.
110
111 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.
112
113
114
115