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 Un dial plan può avere diverse funzioni connesse ai piani di numerazione; le seguenti costituiscono solo un esempio:
6
7 * Impostare l’esecuzione automatica di numeri interni composti da tre cifre.
8 * Individuare i numeri telefonici appartenenti ad apparecchi esterni ed impostare il codice di impegno previsto dal centralino (ad es. “0”) .
9 * Eliminare il codice “+39” per le chiamate dirette in Italia, oppure riconoscere le chiamate dirette all’estero, di conseguenza sostituire il codice “+” con quello previsto per le chiamate internazionali, ossia “00”.
10
11 Come indicato precedentemente, il dial plan deve essere impostato nella finestra “Advanced account settings” che può essere attivata premendo il pulsante “Advanced settings” che si trova nella scheda “Account” della finestra “Settings” (per maggiori dettagli consultare il paragrafo “Account”).
12
13 Per accedere alla finestra delle impostazioni, effettuare la seguente procedura:
14
15 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"]].
16 1. Espandere il [[pannello dei controlli avanzati>>doc:IFM SoftPhone 2\.1.PanoramicaInterfaccia.InterfacciaCore.WebHome||anchor="HIlpannellodeicontrolliavanzati" target="_blank"]].
17 1. Premere il pulsante **Settings**.
18 \\[[image:sp_settings.jpg||height="210" width="350"]]
19
20 1. Viene visualizzata la finestra //Settings//. L'utente può configurare e personalizzare le principali caratteristiche e funzioni di IFM SoftPhone.
21 [[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"]]
22
23 Il pulsante **Advanced settings** visualizza la finestra //Advanced account settings//.
24
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
27 Se necessario, occorre indicare:
28
29 * **Dial Plan**: permette l’inserimento di regular expression che possono intervenire sul numero della chiamata e modificare il comportamento della sua esecuzione (fare riferimento alla sezione [[//Dial plan//>>doc:IFM SoftPhone 2\.1.Dial plan.WebHome||target="_blank"]])//.//
30
31
32
33
34
35
36 // //
37
38 == Struttura del dial plan ==
39
40 Il dial plan è composto da regular expression tipicamente suddivise in tre parti. Queste possono essere separate dai caratteri “|” o “!”; ad esempio, prendiamo la regular expression "|^\+([0-9]*)$|000\1|d":
41
42 1. La prima parte (“|^\+([0-9]*)$|”) contiene il pattern che verrà usato per individuare il numero chiamato.
43 1. La seconda parte (“|000\1|”) contiene le istruzioni dell’operazione di sostituzione da applicare ai risultati ottenuti nella prima parte.
44 1. La terza (“|d”|) è opzionale e contiene i flag che impostano alcuni attributi addizionali.
45
46 == Le sostituzioni ==
47
48 Le espressioni di sostituzione trovano nella seconda parte del dial plan e sono sempre indicate dal carattere “\” seguito da un valore. Questo può essere di due tipi:
49
50 * di tipo numerico, ad es. “\1”;
51 * il segnaposto “d”, ad es. “\d”.
52
53 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.
54
55 Nel secondo caso l’istruzione “\d” indica sempre il valore del registrar server (per maggiori informazioni su quest’ultimo consultare il paragrafo “Account”).
56
57 Ad esempio la seguente regular expression “|*|sip:\1@\d|” antepone la stringa “[[sip:>>path:sip:]]” al numero individuato dall’espressione “*”, secondo appunto l’istruzione di sostituzione “\1”, ed aggiunge il nome del dominio SIP dopo il carattere “@”, come indicato dal segnaposto “\d”.
58
59 == I flag ==
60
61 Sono altresì disponibili i seguenti flag:
62
63 * “d”: permette di chiamare il numero visualizzato nel display senza premere il pulsante di chiamata. Ad esempio la seguente regular expression “|([0-9]{3})|sip:\1@ifminfomaster.com|d” esegue immediatamente la chiamata al numero indicato, ma solo se esso è composto da tre cifre (“{3}”).
64 * “i”: indica che le operazioni di confronto sono case-sensitive.
65
66 == Dial plan complessi (concatenazione di dial plan) ==
67
68 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 es. "|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d".
69
70 **Attenzione**: i doppi apici vanno utilizzati soltanto in presenza di concatenazione.
71
72
73 == Esempi di dial plan ==
74
75 === Comporre il numero di un interno ed eseguire automaticamente la chiamata ===
76
77 Impostare il seguente dial plan:
78
79 * “|([1-9]{3})|\1|d”
80
81 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.
82
83 === Inserire il prefisso di impegno del centralino ===
84
85 Impostare il seguente dial plan:
86
87 * “|^\+39([0-9]*)$|0\1|d”
88
89 Il pattern intercetta il codice internazionale appartenente all’Italia (“+39”) e lo sostituisce col valore “0”; infine esegue automaticamente la chiamata.
90
91 La variante senza codice internazionale appartenente all’Italia (“+39”):
92
93 * “|^0([0-9]*)$|00\1|d”
94
95 Il pattern intercetta il valore “0” del prefisso telefonico e lo sostituisce con valore “00”; infine esegue automaticamente la chiamata.
96
97 === Gestione dei numeri internazionali (dial plan concatenati) ===
98
99 Impostare i seguenti dial plan:
100
101 * "|^\+39([0-9]*)$|0\1|d" "|^\+([0-9]*)$|000\1|d"
102
103 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:
104
105 1. il primo dial plan analizza il numero in ingresso e, se possibile, effettua le sostituzioni indicate;
106 1. il secondo analizza il risultato del primo dial plan e, se possibile, effettua le sostituzioni previste.
107
108 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.
109
110
111
112