Wiki source code of Dialer

Version 4.6 by administrator BDP on 2017/09/01 14:38

Hide last authors
administrator BDP 4.3 1 {{box cssClass="floatinginfobox" title="**Sommario**" width="300px"}}
2 {{toc start=2 depth="3"/}}
3 {{/box}}
administrator BDP 2.1 4
administrator BDP 4.3 5 Il Dialer è il componente client/server che genera le chiamate per i [[servizi di outbound di #phones>>path:../input/hashphones.servizi#ServiziOutbound]] configurati su [[#phones Client>>path:../input/hashphones.phonesenterprise-client]] sfruttando l’algoritmo di [[Predictive Dialing>>path:../input/hashphones.outbound-algoritmi#_PredictiveDialing_]].
administrator BDP 2.1 6 \\Il Dialer è così diviso:
7
8 * Dialer Server: possiede la logica di generazione delle chiamate
9 * Dialer Client: provvede alle funzioni di amministrazione.
10
administrator BDP 4.3 11 Il Dialer riceve i contatti da chiamare attraverso [[Contact Provider>>path:../input/hashphones.contact-provider]]. Quando il Dialer riceve dal modulo di [[Predictive Dialing>>path:../input/hashphones.outbound-algoritmi#_PredictiveDialing_]] l'indicazione che è arrivato il momento di fare una nuova chiamata, chiede al [[Contact Provider>>path:../input/hashphones.contact-provider]] di fornirgli i dati di un nuovo contatto telefonico. Una volta ricevuti i dati, chiede a #phones di generare una nuova chiamata al numero indicato.
administrator BDP 2.1 12 \\Se la chiamata ha avuto successo, il contatto viene messo sulla lista dei contatti completati. Nel caso in cui una chiamata non fosse andata a buon fine, il Dialer organizza una nuova chiamata rimettendo il numero sulla lista dei contatti ancora da chiamare.
13
administrator BDP 4.3 14 == Dialer Client ==
administrator BDP 2.1 15
administrator BDP 4.3 16 L'interfaccia del Dialer, cioè il Dialer Client, è divisa in due riquadri: il riquadro di sinistra contiene una struttura ad albero. Sotto la voce **Principale** è collocata la lista delle viste che possono essere visualizzate nel riquadro di destra. Inoltre esiste una [[barra dei menu>>path:#_BarradeimenuDialer_]] che dà accesso ai diversi comandi, che sono in parte anche richiamabili tramite due pulsanti sulla barra degli strumenti. Nella barra di stato sono mostrate le informazioni relative allo stato della connessione al Dialer Server e [[#phones Server>>path:../input/hashphones.phones#_Server_]].
administrator BDP 2.1 17
administrator BDP 4.4 18 [[image:hashphones.dialer.html_html_5b9df356.png||height="315" width="642"]]
administrator BDP 2.1 19
administrator BDP 4.3 20 == Comandi della barra dei menu ==
administrator BDP 2.1 21
22 |**Menu**|**Comando**|**Descrizione**
23 |**File**|**Connetti**|Apre la finestra di dialogo //Login// che chiede l'inserimento del nome dell'host e la porta di connessione al Dialer Server (in tale finestra sono caricati i valori di default dal file //DialerClient.exe.config//).
24 | |**Disconnetti**|Disconnette Dialer Client da Dialer Server.
25 | |**Opzioni**|Apre la finestra di dialogo //Opzioni// che permette di impostare le opzioni per il logging.
26 | |**Esci**|Chiude DialerClient.
27 |**Modifica**|**Cancella Log in tempo reale**|Cancella i log presenti sul Dialer Client (vista "Log in Tempo Reale").
28 |**Help**|**About**|Visualizza informazioni relative alla versione del prodotto.
29
administrator BDP 4.3 30 == Finestra di dialogo Opzioni ==
administrator BDP 2.1 31
32 * Selezionando il menu **File**, quindi **Opzioni **oppure
33 * nella barra degli strumenti facendo clic sul seguente pulsante(((
administrator BDP 4.4 34 [[image:hashphones.dialer.html_html_m244fe3ea.png||height="23" width="24"]]
administrator BDP 4.6 35 )))appare la finestra di dialogo //Opzioni// che consente di modificare le impostazioni di default nel file //Dialer.xml// (uno dei due file di configurazione di Dialer Server).
administrator BDP 2.1 36
37 |**Area**|**Voce**|**Descrizione**
38 |**Opzioni Client**|**Log sul Client**|Visualizza i messaggi di log nell'interfaccia di Dialer Client (vista Log in Tempo reale). La selezione di questa opzione viene sconsigliata in caso di traffico pesante (più di 20 chiamate contemporanee).
39 | |**Mostra chiamate e contatti**|Visualizza su Dialer Client le informazioni relative alle chiamate e contatti in corso e da richiamare (viste //Chiamate// e //Contatti//) La selezione di questa opzione viene sconsigliata in caso di traffico pesante (più di 20 chiamate contemporanee).
40 | |**Log sulla console**|Visualizza i messaggi di logging su Dialer Server. L'impostazione di default è //false//.
41 | |**Log su file**|Esegue il logging su file. L'impostazione di default è //true//.
42 | |**Numero max di righe di Log**|Consente di impostare quante righe di log saranno visualizzate sulla vista //Log// in tempo reale. Il valore di default è 500.
43 |**Filtro Log**|**Tutto**|Imposta il logging in modo da visualizzare tutti i messaggi di log del Dialer.
44 | |**Persistency**|Visualizza i messaggi di log relativi alla //persistency//.
45 | |**Connessione**|Visualizza i messaggi di log relativi alla connessione //#phones/Dialer// e //Dialer Server /Dialer Client//.
46 | |**Predictor**|Visualizza i messaggi di log relativi al //Predictive Dialer// (il //Predictive Dialer// produce un file di log dedicato a parte).
47 | |**Application**|Visualizza i messaggi di log relativi all'applicazione del Dialer.
48 | |**Contatti**|Visualizza i messaggi di log relativi ai contatti.
administrator BDP 4.3 49 | |**Servizi Inbound**|Visualizza messaggi di log relativi alla gestione dei [[servizi di inbound di #phones>>path:../input/hashphones.servizi#ServiziInbound]], perché in fase di partenza il dialer legge tutta la persistency.
50 | |**Servizi Outbound**|Visualizza messaggi di log relativi alla gestione dei [[servizi di outbound di #phones>>path:../input/hashphones.servizi#ServiziOutbound]].
51 | |**Contact Provider**|Visualizza i messaggi di log relativi alla gestione del [[Contact Provider>>path:../input/hashphones.contact-provider]].
administrator BDP 2.1 52 | |**Dialer**|Visualizza messaggi di log relativi al Dialer Server.
53 | |**Delayer**|Visualizza messaggi di log relativi alla gestione dei contatti da richiamare.
54 | |**Data / Ora**|Visualizza data e ora dell'evento loggato.
55 | |**Thread**|Visualizza il nome del thread che ha prodotto il messaggio di log.
56 | |**ClientManager**|Visualizza i messaggi di log relativi al gestore dei Dialer Client connessi.
57 |**Trace level del logging**|**Verbose**|Indica il livello di importanza del messaggio di log da visualizzare. Selezionare il livello "Verbose" per loggare i messaggi di log relativi a tutti gli eventi. Selezionare il level "Info" per loggare tutto, meno i messaggi relativi alla persistency e alla connessione //Server-Client// (impostazione raccomandata per clienti con grande persistency).
58 | |**Info**|
59 | |**Warning**|
60 | |**Error**|
61
administrator BDP 4.3 62 == Vista Chiamate ==
administrator BDP 2.1 63
64 La vista Chiamate visualizza le informazioni relative alle chiamate in corso richieste dal Dialer.
65 \\**Chiamate correnti**
66
67 |**Colonna**|**Descrizione**
68 |**Id chiamata**|Id della chiamata assegnata da #phones.
69 |**Id contatto**|Id del contatto chiamato.
70 |**Id servizio**|Id del servizio per il quale viene fatta la chiamata.
71
72 **Dettagli chiamata**
73
74 |**Colonna**|**Descrizione**
75 |**Stato**|Stato attuale della chiamata.
76 |**Risultato**|Risultato della chiamata (completata/fallita).
77 |**Causa**|Causa del fallimento della chiamata (//busy//, //no answer//, //recall//).
78 |**Data**|Data della chiamata.
79 |**Ora**|Ora della chiamata.
80
81 Facendo doppio clic su una determinata chiamata si passa alla visualizzazione del contatto corrispondente e viceversa.
82
administrator BDP 4.3 83 == Vista Contatti ==
administrator BDP 2.1 84
85 La vista //Contatti// visualizza gli estremi dei contatti nel database e le informazioni relative alle chiamate generate verso di loro.
86 \\**Contatti correnti**
87
88 |**Colonna**|**Descrizione**
89 |**Id Contatto**|Id del contatto.
90 |**Nome**|Nome del contatto.
91 |**Cognome**|Cognome del contatto.
92 |**Id chiamata**|Id della chiamata.
93
94 **Dettagli contatti**
95
96 |**Colonna**|**Descrizione**
97 |**Descrizione**|Informazioni relative al contatto.
98 |**Data**|Data della chiamata al contatto.
99 |**Ora**|Ora della chiamata al contatto.
100
administrator BDP 4.3 101 == Vista Contatti ritardati ==
administrator BDP 2.1 102
103 La vista **Contatti Ritardati** visualizza le informazioni relative ai contatti che devono essere richiamati.
104
administrator BDP 4.5 105 **Contatti ritardati correnti**
106
administrator BDP 2.1 107 |**Colonna**|**Descrizione**
108 |**Id contatto**|Id del contatto.
109 |**Nome**|Nome del contatto.
110 |**Cognome**|Cognome del contatto.
111 |**Causa del ritardo**|Causa per cui il contatto è richiamato (per esempio "persona non trovata").
112 |**Richiamati**|Numero di volte che il contatto è già stato chiamato.
113 |**Numero massimo di tentativi**|Numero massimo di chiamate consentite.
114 |**Prossima data**|Data della prossima chiamata.
115 |**Prossima ora**|Ora della prossima chiamata.
116
administrator BDP 4.3 117 == Vista Log in Tempo Reale ==
administrator BDP 2.1 118
119 La vista //Log// in tempo reale visualizza i messaggi di log del Dialer. E' possibile impostare le opzioni di logging selezionando il menu **File**, quindi **Opzioni**.
120
121 |**Colonna**|**Descrizione**
122 |**Origine**|Componente che notifica il messaggio di log. Di default, tutti i componenti producono i messaggi di log. E' possibile sceglierne solo alcuni configurandoli nel Dialer Client nella finestra di dialogo //Opzioni// nell'area //Filtro log//.
123 |**Thread**|Indica il thread che ha prodotto il messaggio di log.
124 |**Data**|Data dell'occorenza dell'evento loggato.
125 |**Ora**|Ora dell'occorenza dell'evento loggato.
126 |**Informazioni**|Informazioni relative all'evento loggato.
127
administrator BDP 4.3 128 == Vista Principale ==
administrator BDP 2.1 129
administrator BDP 4.3 130 La vista //Principale// presenta delle informazioni generali sul funzionamento del Dialer e in dettaglio su tutti i [[servizi di outbound>>path:../input/hashphones.servizi#ServizioOutboud]], tutte le chiamate e tutti i contatti. Sono visualizzati esclusivamente i dati relativi alla sessione corrente del Dialer.
administrator BDP 2.1 131
132 |**Area**|**Voce**|**Descrizione**
administrator BDP 4.3 133 |**Servizi Outbound**|**Totale**|Numero dei [[servizi di outbound>>path:../input/hashphones.servizi#ServizioOutboud]] configurati su [[#phones Client>>path:../input/hashphones.phonesenterprise-client]].
134 | |**Attivi**|Numero dei [[servizi di outbound>>path:../input/hashphones.servizi#ServizioOutboud]] correntemente attivi su [[#phones Client>>path:../input/hashphones.phonesenterprise-client]].
administrator BDP 2.1 135 |**Chiamate**|**Proposte dal Predictor**|Numero di chiamate correntemente proposte dal //Predictor//.
136 | |**Rifiutate**|Numero di chiamate rifiutate a causa di mancanza di risorse.
137 | |**Completate**|Numero di chiamate completate.
138 | |**Fallite**|Numero di chiamate fallite.
139 | |**Iniziate**|Numero di chiamate richieste dal Dialer.
administrator BDP 4.3 140 |**Contatti**|**Caricati dal DB**|Numeri di contatti caricati dal database del [[Contact Provider>>path:../input/hashphones.contact-provider]].
administrator BDP 2.1 141 | |**Ritardati**|Contatti da richiamare.
142 | |**Completati**|Contatti chiamati con successo.
143 | |**Occupati**|Contatti che sono stati trovati occupati.
144 | |**Senza risposta**|Contatti che non hanno risposto la chiamata.
145 | |**Operatore non disponibile**|Contatti chiamati con successo per cui però nessun operatore è stato disponibile.
146 | |**Da chiamare**|Contatti già caricati dal database ma ancora da chiamare.
147 | |**Errati/Falliti**|Contatti errati o irraggiungibili.
administrator BDP 4.3 148 | |**Ritornati al DB**|Contatti processati dal Dialer e ritornati al database del [[Contact Provider>>path:../input/hashphones.contact-provider]].
administrator BDP 2.1 149
150 Esistono le seguenti relazioni fra le singoli voci:
151
152 * Chiamate completate + Chiamate Fallite = Chiamate Iniziate
153 * Contatti caricati dal DB = Contatti ritornati al DB
154 * Contatti Completati + Occupati + Senza risposta + Operatore non disponibile + Da chiamare + Errati/Falliti = Contatti Ritornati al DB
155
156 **Nota**: se il Dialer si trova ancora in esecuzione è possibile che i valori non siano congruenti.
157
administrator BDP 4.3 158 == Vista Servizi ==
administrator BDP 2.1 159
administrator BDP 4.3 160 La vista **Servizi** visualizza le informazioni relative ai singoli [[servizi di outbound>>path:../input/hashphones.servizi#ServizioOutbound]].
administrator BDP 2.1 161
162 |**Colonna**|**Descrizione**
administrator BDP 4.3 163 |**ID servizio**|Id assegnato da #phones al [[servizio di outbound>>path:../input/hashphones.servizi#ServizioOutboud]].
164 |**Nome**|Nome del [[servizio di outbound>>path:../input/hashphones.servizi#ServizioOutboud]].
165 |**Stato**|Stato corrente del [[servizio di outbound>>path:../input/hashphones.servizi#ServizioOutboud]]: //Attivo//, //Inattivo//, //Autosospeso// (stato interno del Dialer), //EOF//, //Sospeso// ([[servizio di outbound>>path:../input/hashphones.servizi#ServizioOutboud]] sospeso in #phones).
administrator BDP 2.1 166 |**Refresh**|Frequenza in minuti con cui viene attualizzato il database dei contatti.
administrator BDP 4.3 167 |**Ritornati al DB dopo la sospensione del servizio**|Indica se il [[Contact Provider>>path:../input/hashphones.contact-provider]] debba essere deinizializzato alla sospensione del [[servizio di outbound>>path:../input/hashphones.servizi#ServizioOutboud]] in [[#phones Client>>path:../input/hashphones.phonesenterprise-client]] (quindi tutti gli eventuali contatti ancora ritardati verranno cancellati).
administrator BDP 2.1 168 |**Chiamate iniziate**|Numero di chiamate richieste dal Dialer a #phones.
169 |**Chiamate completate**|Numero di chiamate completate con successo.
170 |**Chiamate fallite**|Numero di chiamate fallite per cause tecniche.
administrator BDP 4.3 171 |**Chiamate rifiutate**|Numero di chiamate rifiutate per mancanza di risorse ([[linee>>path:../input/hashphones.linee]]/[[agenti>>path:../input/hashphones.agenti]]).
172 |**Contatti ritornati al DB**|Contatti restituiti al database dal [[Contact Provider>>path:../input/hashphones.contact-provider]] (numero dei setContact).
administrator BDP 2.1 173 |**Contatti caricati dal DB**|Contatti caricati dal database (numero dei getContact eseguiti).
174 |**Contatti completati**|Contatti chiamati con successo.
175 |**Contatti occupati**|Contatti che sono stati chiamati e trovati occupati.
176 |**Contatti senza risposta**|Contatti che sono stati chiamati e non hanno ricevuto risposta.
177 |**Contatti con operatore non disponibile**|Contatti correttamente raggiunti, ma, al momento dell'assegnazione, nessun agente era disponibile.
administrator BDP 4.3 178 |**Contatti da chiamare**|Contatti ritornati al [[Contact Provider>>path:../input/hashphones.contact-provider]] con esito "da chiamare".
administrator BDP 2.1 179 |**Numero errato/fallito**|Chiamate fallite a causa di numero errato del contatto.
180 |**Contatti ritardati**|Contatti da richiamare.
administrator BDP 4.3 181 |**Proposte dal Predictor**|Numero attuale di chiamate proposte dal [[Predictive Dialer>>path:../input/hashphones.outbound#PredictiveDialer]].
administrator BDP 2.1 182
administrator BDP 4.3 183 === Finestra di dialogo Opzioni Servizio ===
administrator BDP 2.1 184
185 Facendo doppio clic su un servizio viene visualizzata la finestra di dialogo //Opzioni servizio//.
186
187 |**Voce**|**Descrizione**
188 |**Usa valori custom**|Consente di modificare i valori di default definiti nel file //Dialer.exe.config//. Selezionando questa voce si abilitano le opzioni dell'area //Valori Custom//.
189 |**Esegui Refresh**|Facendo clic sul pulsante viene eseguito immediatamente il refresh del database dei contatti.
190 |**Tempo di Refresh (min)**|Consente di modificare la frequenza con cui viene eseguito il refresh del database dei contatti.
191 |**Tempo di Refresh EOF (secs)**|Consente di modificare la frequenza in secondi con cui viene attualizzato il database dei contatti quando si trova in stato EOF.
administrator BDP 4.3 192 |**Distruggere CP con Servizio Sospeso**|Selezionando questa opzione il Dialer deinizializza il [[Contact Provider>>path:../input/hashphones.contact-provider]] quando il [[servizio di outbound>>path:../input/hashphones.servizi#ServizioOutboud]] corrispondente viene sospeso nel [[#phones Client>>path:../input/hashphones.phonesenterprise-client]] (questa azione cancellerà tutti gli eventuali contatti ritardati ancora da processare). Alla nuova creazione dell'oggetto [[Contact Provider>>path:../input/hashphones.contact-provider]], le chiamate saranno generate partendo dal contatto 0.
administrator BDP 2.1 193
194 I valori definiti in questa finestra sono salvati nel file //Dialer.xml//. Al prossimo avvio il Dialer controlla //Dialer.xml// e, se trova delle definizioni custom, le usa, altrimenti sono usate le definizioni di default.
195
administrator BDP 4.3 196
197
198
administrator BDP 4.2 199