Wiki source code of 07 - Dial plan
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 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 | |||
| 7 | {{box cssClass="floatinginfobox" title="**Sommario**" width="300px"}} | ||
| 8 | {{toc start=2 depth="3"/}} | ||
| 9 | {{/box}} | ||
| 10 | |||
| 11 | == Introduzione == | ||
| 12 | |||
| 13 | Il **dial plan** permette di impostare delle regole che possono intervenire sul numero quando un utente effettua una chiamata. | ||
| 14 | |||
| 15 | Un dial plan può avere diverse funzioni connesse ai piani di numerazione. Di seguito riportiamo alcuni esempi: | ||
| 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. | ||
| 20 | * Riconoscere le chiamate dirette all’estero, e sostituire di conseguenza il prefisso "+" con quello previsto per le chiamate internazionali, ossia "00". | ||
| 21 | |||
| 22 | Per impostare il dial plan, effettuare la seguente procedura: | ||
| 23 | |||
| 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"]]. | ||
| 26 | 1. Premere il pulsante **Settings**. | ||
| 27 | [[image:sp_settings.jpg||height="210" style="margin:20px 10px" width="350"]] | ||
| 28 | 1. Viene visualizzata la finestra //Settings//. L'utente può configurare e personalizzare le principali caratteristiche e funzioni di IFM SoftPhone. | ||
| 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"]] | ||
| 30 | 1. Cliccare sul pulsante **Advanced settings**. Viene visualizzata la finestra //Advanced account settings//. | ||
| 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"]] | ||
| 32 | 1. Impostare il **Dial Plan**. | ||
| 33 | 1. Premere **OK** per confermare. | ||
| 34 | |||
| 35 | == Struttura del dial plan == | ||
| 36 | |||
| 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"]]). | ||
| 38 | |||
| 39 | Ad esempio analizziamo la seguente regular expression: | ||
| 40 | |||
| 41 | (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+([0-9]*)$|000\1|d" | ||
| 42 | |||
| 43 | dove, | ||
| 44 | |||
| 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. | ||
| 48 | |||
| 49 | == Le sostituzioni == | ||
| 50 | |||
| 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: | ||
| 52 | |||
| 53 | * di tipo numerico, ad esempio "\1" | ||
| 54 | * il segnaposto **"d"**, ad esempio "\d". | ||
| 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 | |||
| 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"]]). | ||
| 59 | |||
| 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". | ||
| 61 | |||
| 62 | == I flag == | ||
| 63 | |||
| 64 | Sono inoltre disponibili i seguenti flag: | ||
| 65 | |||
| 66 | * **"d"**: permette di chiamare il numero visualizzato nel display senza premere il pulsante di chiamata. Ad esempio la seguente regular expression | ||
| 67 | \\(% class="mark" style="font-family:Courier New,Courier,monospace" %)|([0-9]{3})|sip:\1@ifminfomaster.com|d(%%) | ||
| 68 | \\esegue immediatamente la chiamata al numero indicato, ma solo se esso è composto da tre cifre ( {3}** **). | ||
| 69 | * **"i"**: indica che le operazioni di confronto sono case-sensitive. | ||
| 70 | |||
| 71 | == Dial plan complessi == | ||
| 72 | |||
| 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: | ||
| 74 | |||
| 75 | (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d" | ||
| 76 | |||
| 77 | |||
| 78 | (% class="box errormessage" %) | ||
| 79 | ((( | ||
| 80 | **Attenzione**: i doppi apici vanno utilizzati soltanto in presenza di concatenazione. | ||
| 81 | ))) | ||
| 82 | |||
| 83 | |||
| 84 | == Esempi di dial plan == | ||
| 85 | |||
| 86 | === Comporre il numero di un interno ed eseguire automaticamente la chiamata === | ||
| 87 | |||
| 88 | Per comporre il numero di un interno ed eseguire automaticamente la chiamata, impostare il seguente dial plan (senza doppi apici): | ||
| 89 | |||
| 90 | (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|([1-9]{3})|\1|d" | ||
| 91 | |||
| 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(%%) ). | ||
| 93 | |||
| 94 | === Inserire il prefisso di impegno del centralino === | ||
| 95 | |||
| 96 | Per inserire il prefisso di impegno del centralino, impostare il seguente dial plan (senza doppi apici): | ||
| 97 | |||
| 98 | (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+39([0-9]*)$|0\1|d" | ||
| 99 | |||
| 100 | Il pattern intercetta il codice internazionale appartenente all’Italia ( +39** **) e lo sostituisce con il valore "0"; infine esegue automaticamente la chiamata. | ||
| 101 | |||
| 102 | La variante senza codice internazionale appartenente all’Italia ( +39** **): | ||
| 103 | |||
| 104 | (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^0([0-9]*)$|00\1|d" | ||
| 105 | |||
| 106 | Il pattern intercetta il valore "0" del prefisso telefonico e lo sostituisce con valore "00". Infine esegue automaticamente la chiamata. | ||
| 107 | |||
| 108 | === Gestire i numeri internazionali === | ||
| 109 | |||
| 110 | Per gestire i numeri internazionali, impostare i seguenti dial plan concatenati: | ||
| 111 | |||
| 112 | (% class="mark" style="font-family:Courier New,Courier,monospace" %)"|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d" | ||
| 113 | |||
| 114 | |||
| 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: | ||
| 116 | |||
| 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. | ||
| 119 | |||
| 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. |