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