Wiki source code of 07 - Dial plan


Hide last authors
administrator BDP 7.1 1 {{box cssClass="floatinginfobox" title="**Sommario**" width="300px"}}
2 {{toc start=2 depth="3"/}}
3 {{/box}}
administrator BDP 2.1 4
administrator BDP 9.2 5 == Introduzione ==
administrator BDP 2.1 6
administrator BDP 9.3 7 Il **dial plan** permette di impostare delle regole che possono intervenire sul numero quando un utente effettua una chiamata.
administrator BDP 2.1 8
administrator BDP 9.3 9 Un dial plan può avere diverse funzioni connesse ai piani di numerazione. Di seguito riportiamo alcuni esempi:
administrator BDP 9.2 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.
administrator BDP 9.3 14 * Riconoscere le chiamate dirette all’estero, e sostituire di conseguenza il prefisso "+" con quello previsto per le chiamate internazionali, ossia "00".
administrator BDP 9.2 15
administrator BDP 9.3 16 Per impostare il dial plan, effettuare la seguente procedura:
administrator BDP 9.2 17
administrator BDP 7.1 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**.
administrator BDP 10.2 21 [[image:sp_settings.jpg||height="210" style="margin:20px 10px" width="350"]]
administrator BDP 7.1 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"]]
administrator BDP 9.3 24 1. Cliccare sul pulsante **Advanced settings**. Viene visualizzata la finestra //Advanced account settings//.
administrator BDP 9.1 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"]]
administrator BDP 9.3 26 1. Impostare il **Dial Plan**.
27 1. Premere **OK** per confermare.
administrator BDP 9.1 28
administrator BDP 3.1 29 == Struttura del dial plan ==
administrator BDP 2.1 30
administrator BDP 9.5 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"]]).
administrator BDP 2.1 32
administrator BDP 9.5 33 Ad esempio analizziamo la seguente regular expression:
34
administrator BDP 10.2 35 (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+([0-9]*)$|000\1|d"
administrator BDP 9.5 36
37 dove,
38
administrator BDP 10.2 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.
administrator BDP 2.1 42
administrator BDP 3.1 43 == Le sostituzioni ==
administrator BDP 2.1 44
administrator BDP 10.1 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:
administrator BDP 2.1 46
administrator BDP 10.1 47 * di tipo numerico, ad esempio "\1"
administrator BDP 10.2 48 * il segnaposto **"d"**, ad esempio "\d".
administrator BDP 2.1 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
administrator BDP 10.2 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"]]).
administrator BDP 2.1 53
administrator BDP 10.2 54 Ad esempio la seguente regular expression (% style="font-family:Courier New,Courier,monospace" class="mark" %)|*|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".
administrator BDP 2.1 55
administrator BDP 3.1 56 == I flag ==
administrator BDP 2.1 57
administrator BDP 10.2 58 Sono inoltre disponibili i seguenti flag:
administrator BDP 2.1 59
administrator BDP 10.3 60 * **"d"**: permette di chiamare il numero visualizzato nel display senza premere il pulsante di chiamata. Ad esempio la seguente regular expression (% style="font-family:Courier New,Courier,monospace" class="mark" %)|([0-9]{3})|sip:\1@ifminfomaster.com|d(%%) esegue immediatamente la chiamata al numero indicato, ma solo se esso è composto da tre cifre ( **{3} **).
administrator BDP 10.2 61 * **"i"**: indica che le operazioni di confronto sono case-sensitive.
administrator BDP 2.1 62
administrator BDP 9.3 63 == Dial plan complessi ==
administrator BDP 2.1 64
administrator BDP 10.3 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: (% style="font-family:Courier New,Courier,monospace" class="mark" %)"|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d"(%%).
administrator BDP 2.1 66
administrator BDP 10.3 67
68 (% class="box errormessage" %)
69 (((
administrator BDP 2.1 70 **Attenzione**: i doppi apici vanno utilizzati soltanto in presenza di concatenazione.
administrator BDP 10.3 71 )))
administrator BDP 3.1 72
73
74 == Esempi di dial plan ==
75
76 === Comporre il numero di un interno ed eseguire automaticamente la chiamata ===
77
78 Impostare il seguente dial plan:
79
80 * “|([1-9]{3})|\1|d”
81
82 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.
83
84 === Inserire il prefisso di impegno del centralino ===
85
86 Impostare il seguente dial plan:
87
88 * “|^\+39([0-9]*)$|0\1|d”
89
90 Il pattern intercetta il codice internazionale appartenente all’Italia (“+39”) e lo sostituisce col valore “0”; infine esegue automaticamente la chiamata.
91
92 La variante senza codice internazionale appartenente all’Italia (“+39”):
93
94 * “|^0([0-9]*)$|00\1|d”
95
96 Il pattern intercetta il valore “0” del prefisso telefonico e lo sostituisce con valore “00”; infine esegue automaticamente la chiamata.
97
98 === Gestione dei numeri internazionali (dial plan concatenati) ===
99
100 Impostare i seguenti dial plan:
101
102 * "|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d"
103
104 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:
105
106 1. il primo dial plan analizza il numero in ingresso e, se possibile, effettua le sostituzioni indicate;
107 1. il secondo analizza il risultato del primo dial plan e, se possibile, effettua le sostituzioni previste.
108
109 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.
110
111
112
113