Wiki source code of Dialer

Last modified by administrator BDP on 2019/03/05 14:51

version	line-number	content
36.1	1	(% class="box infomessage" style="width:225px; padding: 5px; font-family:verdana; font-size:12px; background-color: #fafbfc;" %)
35.1	2	(((
37.1	3	[[image:acrobat-logo.png]] [[Scarica la pagina come pdf>>https://wiki.ifmgroup.it/bin/export/ifmhelpplatform/Dialer/?format=pdf\|\|rel="noopener noreferrer" target="new"]]
35.1	4	)))
	5
4.3	6	{{box cssClass="floatinginfobox" title="Sommario" width="300px"}}
	7	{{toc start=2 depth="3"/}}
	8	{{/box}}
2.1	9
19.1	10	Il Dialer è il componente client/server che genera le chiamate per i [[servizi di outbound di #phones>>doc:ifmhelpplatform.ServiziPhones.WebHome]] configurati su [[#phones Client>>doc:ifmhelpplatform.ClientPhones.WebHome]] sfruttando l’algoritmo di [[Predictive Dialing>>doc:ifmhelpplatform.Outbound.Algoritmi.WebHome]].
2.1	11
7.1	12	Il Dialer è così diviso:
	13
32.1	14	* Dialer Server: contiene la logica di generazione delle chiamate
31.1	15	* Dialer Client: provvede alle funzioni di amministrazione.
2.1	16
20.1	17	Il Dialer riceve i contatti da chiamare attraverso il [[Contact Provider>>doc:03 - Sviluppo Moduli Applicativi.ContactProvider.WebHome\|\|target="_blank"]]. Quando il Dialer riceve dal modulo di Predictive Dialing l'indicazione che è arrivato il momento di fare una nuova chiamata, chiede al 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.
2.1	18
7.1	19	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.
	20
4.3	21	== Dialer Client ==
2.1	22
13.1	23	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 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>>doc:ifmhelpplatform.Phones.WebHome]].
2.1	24
20.1	25	[[image:hashphones.dialer.html_html_5b9df356.png\|\|queryString="width=642&height=315" height="315" width="642"]]
2.1	26
4.3	27	== Comandi della barra dei menu ==
2.1	28
7.1	29	I comandi della barra dei menu sono i seguenti:
	30
2.1	31	\|Menu\|Comando\|Descrizione
	32	\|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//).
	33	\| \|Disconnetti\|Disconnette Dialer Client da Dialer Server.
	34	\| \|Opzioni\|Apre la finestra di dialogo //Opzioni// che permette di impostare le opzioni per il logging.
	35	\| \|Esci\|Chiude DialerClient.
	36	\|Modifica\|Cancella Log in tempo reale\|Cancella i log presenti sul Dialer Client (vista "Log in Tempo Reale").
	37	\|Help\|About\|Visualizza informazioni relative alla versione del prodotto.
7.1	38	\| \| \|
2.1	39
4.3	40	== Finestra di dialogo Opzioni ==
2.1	41
	42	* Selezionando il menu File, quindi Opzioni oppure
	43	* nella barra degli strumenti facendo clic sul seguente pulsante(((
20.1	44	[[image:hashphones.dialer.html_html_m244fe3ea.png\|\|queryString="width=24&height=23" height="23" width="24"]]
4.6	45	)))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).
2.1	46
	47	\|Area\|Voce\|Descrizione
	48	\|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).
	49	\| \|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).
	50	\| \|Log sulla console\|Visualizza i messaggi di logging su Dialer Server. L'impostazione di default è //false//.
	51	\| \|Log su file\|Esegue il logging su file. L'impostazione di default è //true//.
	52	\| \|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.
	53	\|Filtro Log\|Tutto\|Imposta il logging in modo da visualizzare tutti i messaggi di log del Dialer.
	54	\| \|Persistency\|Visualizza i messaggi di log relativi alla //persistency//.
	55	\| \|Connessione\|Visualizza i messaggi di log relativi alla connessione //#phones/Dialer// e //Dialer Server /Dialer Client//.
	56	\| \|Predictor\|Visualizza i messaggi di log relativi al //Predictive Dialer// (il //Predictive Dialer// produce un file di log dedicato a parte).
	57	\| \|Application\|Visualizza i messaggi di log relativi all'applicazione del Dialer.
	58	\| \|Contatti\|Visualizza i messaggi di log relativi ai contatti.
19.1	59	\| \|Servizi Inbound\|Visualizza messaggi di log relativi alla gestione dei [[servizi di inbound di #phones>>doc:ifmhelpplatform.ServiziPhones.WebHome]], perché in fase di partenza il dialer legge tutta la persistency.
5.1	60	\| \|Servizi Outbound\|Visualizza messaggi di log relativi alla gestione dei servizi di outbound di #phones.
	61	\| \|Contact Provider\|Visualizza i messaggi di log relativi alla gestione del Contact Provider.
2.1	62	\| \|Dialer\|Visualizza messaggi di log relativi al Dialer Server.
	63	\| \|Delayer\|Visualizza messaggi di log relativi alla gestione dei contatti da richiamare.
	64	\| \|Data / Ora\|Visualizza data e ora dell'evento loggato.
	65	\| \|Thread\|Visualizza il nome del thread che ha prodotto il messaggio di log.
	66	\| \|ClientManager\|Visualizza i messaggi di log relativi al gestore dei Dialer Client connessi.
	67	\|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).
	68	\| \|Info\|
	69	\| \|Warning\|
	70	\| \|Error\|
7.1	71	\| \| \|
2.1	72
4.3	73	== Vista Chiamate ==
2.1	74
	75	La vista Chiamate visualizza le informazioni relative alle chiamate in corso richieste dal Dialer.
	76	\\Chiamate correnti
	77
	78	\|Colonna\|Descrizione
	79	\|Id chiamata\|Id della chiamata assegnata da #phones.
	80	\|Id contatto\|Id del contatto chiamato.
	81	\|Id servizio\|Id del servizio per il quale viene fatta la chiamata.
7.1	82	\| \|
2.1	83
	84	Dettagli chiamata
	85
	86	\|Colonna\|Descrizione
	87	\|Stato\|Stato attuale della chiamata.
	88	\|Risultato\|Risultato della chiamata (completata/fallita).
	89	\|Causa\|Causa del fallimento della chiamata (//busy//, //no answer//, //recall//).
	90	\|Data\|Data della chiamata.
	91	\|Ora\|Ora della chiamata.
7.1	92	\| \|
2.1	93
	94	Facendo doppio clic su una determinata chiamata si passa alla visualizzazione del contatto corrispondente e viceversa.
	95
4.3	96	== Vista Contatti ==
2.1	97
	98	La vista //Contatti// visualizza gli estremi dei contatti nel database e le informazioni relative alle chiamate generate verso di loro.
	99	\\Contatti correnti
	100
	101	\|Colonna\|Descrizione
	102	\|Id Contatto\|Id del contatto.
	103	\|Nome\|Nome del contatto.
	104	\|Cognome\|Cognome del contatto.
	105	\|Id chiamata\|Id della chiamata.
7.1	106	\| \|
2.1	107
	108	Dettagli contatti
	109
	110	\|Colonna\|Descrizione
	111	\|Descrizione\|Informazioni relative al contatto.
	112	\|Data\|Data della chiamata al contatto.
	113	\|Ora\|Ora della chiamata al contatto.
7.1	114	\| \|
2.1	115
4.3	116	== Vista Contatti ritardati ==
2.1	117
	118	La vista Contatti Ritardati visualizza le informazioni relative ai contatti che devono essere richiamati.
	119
4.5	120	Contatti ritardati correnti
	121
2.1	122	\|Colonna\|Descrizione
	123	\|Id contatto\|Id del contatto.
	124	\|Nome\|Nome del contatto.
	125	\|Cognome\|Cognome del contatto.
	126	\|Causa del ritardo\|Causa per cui il contatto è richiamato (per esempio "persona non trovata").
	127	\|Richiamati\|Numero di volte che il contatto è già stato chiamato.
	128	\|Numero massimo di tentativi\|Numero massimo di chiamate consentite.
	129	\|Prossima data\|Data della prossima chiamata.
	130	\|Prossima ora\|Ora della prossima chiamata.
7.1	131	\| \|
2.1	132
4.3	133	== Vista Log in Tempo Reale ==
2.1	134
	135	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.
	136
	137	\|Colonna\|Descrizione
	138	\|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//.
	139	\|Thread\|Indica il thread che ha prodotto il messaggio di log.
	140	\|Data\|Data dell'occorenza dell'evento loggato.
	141	\|Ora\|Ora dell'occorenza dell'evento loggato.
	142	\|Informazioni\|Informazioni relative all'evento loggato.
7.1	143	\| \|
2.1	144
4.3	145	== Vista Principale ==
2.1	146
19.1	147	La vista //Principale// presenta delle informazioni generali sul funzionamento del Dialer e in dettaglio su tutti i [[servizi di outbound>>doc:ifmhelpplatform.ServiziPhones.WebHome]], tutte le chiamate e tutti i contatti. Sono visualizzati esclusivamente i dati relativi alla sessione corrente del Dialer.
2.1	148
	149	\|Area\|Voce\|Descrizione
18.1	150	\|Servizi Outbound\|Totale\|Numero dei servizi di outbound configurati su [[#phones Client>>doc:ifmhelpplatform.ClientPhones.WebHome]].
5.1	151	\| \|Attivi\|Numero dei servizi di outbound correntemente attivi su #phones Client.
2.1	152	\|Chiamate\|Proposte dal Predictor\|Numero di chiamate correntemente proposte dal //Predictor//.
	153	\| \|Rifiutate\|Numero di chiamate rifiutate a causa di mancanza di risorse.
	154	\| \|Completate\|Numero di chiamate completate.
	155	\| \|Fallite\|Numero di chiamate fallite.
	156	\| \|Iniziate\|Numero di chiamate richieste dal Dialer.
5.1	157	\|Contatti\|Caricati dal DB\|Numeri di contatti caricati dal database del [[Contact Provider>>doc:Glossario.WebHome]].
2.1	158	\| \|Ritardati\|Contatti da richiamare.
	159	\| \|Completati\|Contatti chiamati con successo.
	160	\| \|Occupati\|Contatti che sono stati trovati occupati.
	161	\| \|Senza risposta\|Contatti che non hanno risposto la chiamata.
	162	\| \|Operatore non disponibile\|Contatti chiamati con successo per cui però nessun operatore è stato disponibile.
	163	\| \|Da chiamare\|Contatti già caricati dal database ma ancora da chiamare.
	164	\| \|Errati/Falliti\|Contatti errati o irraggiungibili.
5.1	165	\| \|Ritornati al DB\|Contatti processati dal Dialer e ritornati al database del Contact Provider.
7.1	166	\| \| \|
2.1	167
	168	Esistono le seguenti relazioni fra le singoli voci:
	169
	170	* Chiamate completate + Chiamate Fallite = Chiamate Iniziate
	171	* Contatti caricati dal DB = Contatti ritornati al DB
	172	* Contatti Completati + Occupati + Senza risposta + Operatore non disponibile + Da chiamare + Errati/Falliti = Contatti Ritornati al DB
	173
	174	Nota: se il Dialer si trova ancora in esecuzione è possibile che i valori non siano congruenti.
	175
4.3	176	== Vista Servizi ==
2.1	177
5.1	178	La vista Servizi visualizza le informazioni relative ai singoli servizi di outbound.
2.1	179
	180	\|Colonna\|Descrizione
5.1	181	\|ID servizio\|Id assegnato da #phones al servizio di outbound.
	182	\|Nome\|Nome del servizio di outbound.
	183	\|Stato\|Stato corrente del servizio di outbound: //Attivo//, //Inattivo//, //Autosospeso// (stato interno del Dialer), //EOF//, //Sospeso// (servizio di outbound sospeso in #phones).
2.1	184	\|Refresh\|Frequenza in minuti con cui viene attualizzato il database dei contatti.
5.1	185	\|Ritornati al DB dopo la sospensione del servizio\|Indica se il Contact Provider debba essere deinizializzato alla sospensione del servizio di outbound in #phones Client (quindi tutti gli eventuali contatti ancora ritardati verranno cancellati).
2.1	186	\|Chiamate iniziate\|Numero di chiamate richieste dal Dialer a #phones.
	187	\|Chiamate completate\|Numero di chiamate completate con successo.
	188	\|Chiamate fallite\|Numero di chiamate fallite per cause tecniche.
15.1	189	\|Chiamate rifiutate\|Numero di chiamate rifiutate per mancanza di risorse ([[linee>>doc:ifmhelpplatform.Linee.WebHome]]/[[agenti>>doc:ifmhelpplatform.AgentiPhones.WebHome]]).
5.1	190	\|Contatti ritornati al DB\|Contatti restituiti al database dal Contact Provider (numero dei setContact).
2.1	191	\|Contatti caricati dal DB\|Contatti caricati dal database (numero dei getContact eseguiti).
	192	\|Contatti completati\|Contatti chiamati con successo.
	193	\|Contatti occupati\|Contatti che sono stati chiamati e trovati occupati.
	194	\|Contatti senza risposta\|Contatti che sono stati chiamati e non hanno ricevuto risposta.
	195	\|Contatti con operatore non disponibile\|Contatti correttamente raggiunti, ma, al momento dell'assegnazione, nessun agente era disponibile.
5.1	196	\|Contatti da chiamare\|Contatti ritornati al Contact Provider con esito "da chiamare".
2.1	197	\|Numero errato/fallito\|Chiamate fallite a causa di numero errato del contatto.
	198	\|Contatti ritardati\|Contatti da richiamare.
17.1	199	\|Proposte dal Predictor\|Numero attuale di chiamate proposte dal [[Predictive Dialer>>doc:ifmhelpplatform.Outbound.WebHome]].
7.1	200	\| \|
2.1	201
4.3	202	=== Finestra di dialogo Opzioni Servizio ===
2.1	203
	204	Facendo doppio clic su un servizio viene visualizzata la finestra di dialogo //Opzioni servizio//.
	205
	206	\|Voce\|Descrizione
	207	\|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//.
	208	\|Esegui Refresh\|Facendo clic sul pulsante viene eseguito immediatamente il refresh del database dei contatti.
	209	\|Tempo di Refresh (min)\|Consente di modificare la frequenza con cui viene eseguito il refresh del database dei contatti.
	210	\|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.
5.1	211	\|Distruggere CP con Servizio Sospeso\|Selezionando questa opzione il Dialer deinizializza il Contact Provider quando il servizio di outbound corrispondente viene sospeso nel #phones Client (questa azione cancellerà tutti gli eventuali contatti ritardati ancora da processare). Alla nuova creazione dell'oggetto Contact Provider, le chiamate saranno generate partendo dal contatto 0.
7.1	212	\| \|
2.1	213
	214	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.
	215
4.3	216
	217
	218
4.2	219