Skip to Content

Wiki source code of 07 - Dial plan

Hide last authors
administrator BDP 25.1 1 (% class="box infomessage" style="width:225px; padding: 5px; font-family:verdana; font-size:12px; color: #04ace3; background-color: #fafbfc;" %)
2 (((
3 [[image:acrobat-logo.png]] [[Scarica la pagina come pdf>>https://wiki.ifmgroup.it/bin/export/IFMSoftPhone/Dialplan/?format=pdf||rel="noopener noreferrer" target="new"]]
4 )))
5
6
administrator BDP 7.1 7 {{box cssClass="floatinginfobox" title="**Sommario**" width="300px"}}
8 {{toc start=2 depth="3"/}}
9 {{/box}}
administrator BDP 2.1 10
administrator BDP 9.2 11 == Introduzione ==
administrator BDP 2.1 12
administrator BDP 9.3 13 Il **dial plan** permette di impostare delle regole che possono intervenire sul numero quando un utente effettua una chiamata.
administrator BDP 2.1 14
administrator BDP 9.3 15 Un dial plan può avere diverse funzioni connesse ai piani di numerazione. Di seguito riportiamo alcuni esempi:
administrator BDP 9.2 16
17 * impostare l’esecuzione automatica di numeri interni composti da tre cifre.
18 * Individuare i numeri telefonici appartenenti ad apparecchi esterni ed impostare il codice di impegno previsto dal centralino (ad esempio "0") .
19 * Eliminare il codice //+39// per le chiamate dirette in Italia.
administrator BDP 9.3 20 * 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 21
administrator BDP 9.3 22 Per impostare il dial plan, effettuare la seguente procedura:
administrator BDP 9.2 23
administrator BDP 19.1 24 1. Fare doppio clic sull’icona //IFM SoftPhone// della traybar per aprire il [[display>>doc:IFMSoftPhone2\.1.PanoramicaInterfaccia.InterfacciaCore.WebHome||anchor="HIldisplay" target="_blank"]].
25 1. Espandere il [[pannello dei controlli avanzati>>doc:IFMSoftPhone2\.1.PanoramicaInterfaccia.InterfacciaCore.WebHome||anchor="HIlpannellodeicontrolliavanzati" target="_blank"]].
administrator BDP 7.1 26 1. Premere il pulsante **Settings**.
administrator BDP 23.1 27 [[image:sp_settings.jpg||height="210" style="margin:20px 10px" width="350"]]
administrator BDP 7.1 28 1. Viene visualizzata la finestra //Settings//. L'utente può configurare e personalizzare le principali caratteristiche e funzioni di IFM SoftPhone.
administrator BDP 23.1 29 [[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 30 1. Cliccare sul pulsante **Advanced settings**. Viene visualizzata la finestra //Advanced account settings//.
administrator BDP 23.1 31 [[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 32 1. Impostare il **Dial Plan**.
33 1. Premere **OK** per confermare.
administrator BDP 9.1 34
administrator BDP 3.1 35 == Struttura del dial plan ==
administrator BDP 2.1 36
administrator BDP 20.1 37 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 38
administrator BDP 9.5 39 Ad esempio analizziamo la seguente regular expression:
40
administrator BDP 23.1 41 (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+([0-9]*)$|000\1|d"
administrator BDP 9.5 42
43 dove,
44
administrator BDP 23.1 45 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.
46 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.
47 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 48
administrator BDP 3.1 49 == Le sostituzioni ==
administrator BDP 2.1 50
administrator BDP 10.1 51 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 52
administrator BDP 10.1 53 * di tipo numerico, ad esempio "\1"
administrator BDP 10.2 54 * il segnaposto **"d"**, ad esempio "\d".
administrator BDP 2.1 55
56 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.
57
administrator BDP 18.1 58 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:IFMSoftPhone2\.1.Impostazioni.WebHome||anchor="HAccount"]]).
administrator BDP 2.1 59
administrator BDP 23.1 60 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".
administrator BDP 2.1 61
administrator BDP 3.1 62 == I flag ==
administrator BDP 2.1 63
administrator BDP 10.2 64 Sono inoltre disponibili i seguenti flag:
administrator BDP 2.1 65
administrator BDP 10.6 66 * **"d"**: permette di chiamare il numero visualizzato nel display senza premere il pulsante di chiamata. Ad esempio la seguente regular expression
administrator BDP 23.1 67 \\(% class="mark" style="font-family:Courier New,Courier,monospace" %)|([0-9]{3})|sip:\1@ifminfomaster.com|d(%%)
administrator BDP 11.1 68 \\esegue immediatamente la chiamata al numero indicato, ma solo se esso è composto da tre cifre ( {3}** **).
administrator BDP 10.2 69 * **"i"**: indica che le operazioni di confronto sono case-sensitive.
administrator BDP 2.1 70
administrator BDP 9.3 71 == Dial plan complessi ==
administrator BDP 2.1 72
administrator BDP 10.5 73 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:
administrator BDP 2.1 74
administrator BDP 23.1 75 (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d"
administrator BDP 10.3 76
administrator BDP 10.5 77
administrator BDP 10.3 78 (% class="box errormessage" %)
79 (((
administrator BDP 2.1 80 **Attenzione**: i doppi apici vanno utilizzati soltanto in presenza di concatenazione.
administrator BDP 10.3 81 )))
administrator BDP 3.1 82
83
84 == Esempi di dial plan ==
85
86 === Comporre il numero di un interno ed eseguire automaticamente la chiamata ===
87
administrator BDP 23.1 88 Per comporre il numero di un interno ed eseguire automaticamente la chiamata, impostare il seguente dial plan (senza doppi apici):
administrator BDP 3.1 89
administrator BDP 23.1 90 (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|([1-9]{3})|\1|d"
administrator BDP 3.1 91
administrator BDP 23.1 92 Il pattern intercetta tutti i numeri telefonici composti da 3 cifre ( (% class="mark" style="font-family:Courier New,Courier,monospace" %){3}(%%) ) che contengono i numeri da 1 a 9 ( (% class="mark" style="font-family:Courier New,Courier,monospace" %)[1-9](%%)** **) ed esegue la chiamata in modo automatico senza che l'utente debba premere nessun tasto ( (% class="mark" %)d(%%) ).
administrator BDP 3.1 93
94 === Inserire il prefisso di impegno del centralino ===
95
administrator BDP 23.1 96 Per inserire il prefisso di impegno del centralino, impostare il seguente dial plan (senza doppi apici):
administrator BDP 3.1 97
administrator BDP 23.1 98 (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+39([0-9]*)$|0\1|d"
administrator BDP 3.1 99
administrator BDP 10.8 100 Il pattern intercetta il codice internazionale appartenente all’Italia ( +39** **) e lo sostituisce con il valore "0"; infine esegue automaticamente la chiamata.
administrator BDP 3.1 101
administrator BDP 10.8 102 La variante senza codice internazionale appartenente all’Italia ( +39** **):
administrator BDP 3.1 103
administrator BDP 23.1 104 (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^0([0-9]*)$|00\1|d"
administrator BDP 3.1 105
administrator BDP 10.7 106 Il pattern intercetta il valore "0" del prefisso telefonico e lo sostituisce con valore "00". Infine esegue automaticamente la chiamata.
administrator BDP 3.1 107
administrator BDP 10.8 108 === Gestire i numeri internazionali ===
administrator BDP 3.1 109
administrator BDP 10.4 110 Per gestire i numeri internazionali, impostare i seguenti dial plan concatenati:
administrator BDP 3.1 111
administrator BDP 23.1 112 (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d"
administrator BDP 3.1 113
114
administrator BDP 10.8 115 Il primo dial plan sostituisce il valore letterale del codice telefonico assegnato all'Italia ( +39** **) con il 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:
administrator BDP 10.6 116
administrator BDP 10.8 117 1. la prima regola del dial plan analizza il numero in ingresso e, se possibile, effettua le sostituzioni indicate;
118 1. la seconda analizza il risultato del primo dial plan e, se possibile, effettua le sostituzioni previste.
administrator BDP 3.1 119
administrator BDP 10.8 120 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.
administrator BDP 3.1 121
122
123