Changes for page Transfer Property

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -10,17 +10,17 @@
10	10	* [[transfer property personalizzate (create dall'utente)>>||anchor="Letransferpropertypersonalizzate"]]
11	11
12	12
13		-== Le Transfer Property di Sistema ==
	13	+== Le transfer property di sistema ==
14	14
15	15	Le transfer property di sistema vengono create dal Messenger ed alcune possono ricevere soltanto dei valori specifici, ossia compresi all'interno di un arco ben definito.
16	16
17		-|**Transfer Property**|(% style="width:356px" %)**Valore**|(% style="width:587px" %)**Descrizione**
18		-|**~_~_CallerParty**|(% style="width:356px" %)Numero di telefono|(% style="width:587px" %)Contiene il numero del chiamante se disponibile dalla rete pubblica. E' il numero che #phones passa nel CallData ExternalParty.
19		-|**~_~_CalledParty**|(% style="width:356px" %)Numero di telefono|(% style="width:587px" %)Contiene il numero composto dal chiamante, ma è disponibile solo con schede di flusso e se la centrale lo mette a disposizione.
20		-|**~_~_CallMediaType**|(% style="width:356px" %)1 = audio
	17	+|**Transfer Property**|(% style="width:280px" %)**Valore**|(% style="width:663px" %)**Descrizione**
	18	+|**~_~_CallerParty**|(% style="width:280px" %)Numero di telefono|(% style="width:663px" %)Contiene il numero del chiamante se disponibile dalla rete pubblica. E' il numero che #phones passa nel CallData ExternalParty.
	19	+|**~_~_CalledParty**|(% style="width:280px" %)Numero di telefono|(% style="width:663px" %)Contiene il numero composto dal chiamante, ma è disponibile solo con schede di flusso e se la centrale lo mette a disposizione.
	20	+|**~_~_CallMediaType**|(% style="width:280px" %)1 = audio
21	21	2 = @Phones
22		-5 = video|(% style="width:587px" %)Specifica il tipo di chiamata in corso.
23		-|**~_~_RecognizeResult~_~_**|(% style="width:356px" %)vvpMaxNonSilence = 4
	22	+5 = video|(% style="width:663px" %)Specifica il tipo di chiamata in corso.
	23	+|**~_~_RecognizeResult~_~_**|(% style="width:280px" %)vvpMaxNonSilence = 4
24	24	vvpMaxSilence = 3
25	25	vvpRunTimeError = -1
26	26	vvpStopped = 1
...	...	@@ -27,77 +27,75 @@
27	27	vvpTermDigit = 2
28	28	vvpTimeOut = 6
29	29	vvpEngineUnavailable = 18
30		-vvpNotRecognized = 19|(% style="width:587px" %)Contiene l'esito dell'ultima operazione di riconoscimento vocale (ASR).
31		-|**_ASR_Source**|(% style="width:356px" %)ASR
32		-DTMF|(% style="width:587px" %)Indica la modalità di riconoscimento: ASR o DTMF.
33		-|**~_~_CallForwardingResult~_~_**|(% style="width:356px" %)(((
	30	+vvpNotRecognized = 19|(% style="width:663px" %)Contiene l'esito dell'ultima operazione di riconoscimento vocale (ASR).
	31	+|**_ASR_Source**|(% style="width:280px" %)ASR o DTMF|(% style="width:663px" %)Indica la modalità di riconoscimento: ASR o DTMF.
	32	+|**~_~_CallForwardingResult~_~_**|(% style="width:280px" %)(((
34	34	0: se l'operazione è andata a buon fine
35	35	1: se l'operazione ha generato un errore
36		-)))|(% style="width:587px" %)Esito del CallForwarding.
37		-|**~_~_CallForwardingCallGuid~_~_**|(% style="width:356px" %)GUID|(% style="width:587px" %)Contiene la GUID della chiamata outbound emessa a seguito della richiesta di CallForwarding.
38		-|**~_~_CallForwardingCallID~_~_**|(% style="width:356px" %)CallID|(% style="width:587px" %)Contiene la CallID di #phones della chiamata outbound emessa a seguito della richiesta di CallForwarding.
39		-|**~_~_CallForwardingCallResult~_~_**|(% style="width:356px" %)Numero intero|(% style="width:587px" %)Se la chiamata outbound fallisse, riporta la causa dell'errore ([[Codice fallimento>>../input/hashphones.phonebar-oggetti-interfaccia-programmazione#fallimento||anchor="Linkdaimpostare"]]).
40		-|**~_~_CallForwardingCallProtocolSpecificCause~_~_**|(% style="width:356px" %)Numero intero|(% style="width:587px" %)Se la chiamata outbound fallisse, la transfer property riporta la causa dell'errore connessa al protocollo usato ([[Cause di disconnessione SIP>>../input/hashphones.phonebar-oggetti-interfaccia-programmazione#causedsconnessione||anchor="Linkdaimpostare"]], [[Cause di disconnessione ISDN>>../input/hashphones.phonebar-oggetti-interfaccia-programmazione#ISDN||anchor="Linkdaimpostare"]]).
41		-|**~_~_CallForwardingReportingError~_~_**|(% style="width:356px" %)0: operazione eseguita
42		-1: operazione fallita|(% style="width:587px" %)Il CallForwarding può salvare l'esito dentro un database. Contiene il risultato dell'operazione di salvataggio dentro il database.
43		-| |(% style="width:356px" %) |(% style="width:587px" %)
	35	+)))|(% style="width:663px" %)Esito del CallForwarding.
	36	+|**~_~_CallForwardingCallGuid~_~_**|(% style="width:280px" %)GUID|(% style="width:663px" %)Contiene la GUID della chiamata outbound emessa a seguito della richiesta di CallForwarding.
	37	+|**~_~_CallForwardingCallID~_~_**|(% style="width:280px" %)CallID|(% style="width:663px" %)Contiene la CallID di #phones della chiamata outbound emessa a seguito della richiesta di CallForwarding.
	38	+|**~_~_CallForwardingCallResult~_~_**|(% style="width:280px" %)Numero intero|(% style="width:663px" %)Se la chiamata outbound fallisse, riporta la causa dell'errore ([[Codice fallimento>>path:../input/hashphones.phonebar-oggetti-interfaccia-programmazione#fallimento]]).
	39	+|**~_~_CallForwardingCallProtocolSpecificCause~_~_**|(% style="width:280px" %)Numero intero|(% style="width:663px" %)Se la chiamata outbound fallisse, la transfer property riporterebbe la causa dell'errore connessa al protocollo usato ([[Cause di disconnessione SIP>>path:../input/hashphones.phonebar-oggetti-interfaccia-programmazione#causedsconnessione]], [[Cause di disconnessione ISDN>>path:../input/hashphones.phonebar-oggetti-interfaccia-programmazione#ISDN]]).
	40	+|**~_~_CallForwardingReportingError~_~_**|(% style="width:280px" %)0: operazione eseguita
	41	+1: operazione fallita|(% style="width:663px" %)Il CallForwarding può salvare l'esito dentro un database; la transfer property //~_~_CallForwardingReportingError~_~_// contiene il risultato dell'operazione di salvataggio dentro il database.
	42	+| |(% style="width:280px" %) |(% style="width:663px" %)
44	44
45		-Le transfer property di sistema tipicamente sono in sola lettura, vengono create e valorizzate dal Messenger e sono usate all'interno dei servizio del Messenger, siano essi i [[servizi base del Messenger>>doc:MessengerServiziBase.WebHome||target="_blank"]] o i [[servizi del Messenger personalizzati>>doc:MessengerConcetti.ServiziMessenger.WebHome||anchor="HServizipersonalizzati" target="_blank"]].
	44	+Le transfer property di sistema tipicamente sono in sola lettura, vengono create e valorizzate dal [[Messenger>>path:../input/hashphones.messenger]] e sono usate all'interno dei [[servizio del Messenger>>path:../input/hashphones.messenger-configurator-servizi]], siano essi i [[servizi base del Messenger>>path:../input/hashphones.messenger-configurator-servizi#Base]] o i [[servizi del Messenger personalizzati>>path:../input/hashphones.messenger-configurator-servizi#Personalizzati]].
46	46
47		-==== Esempio ====
	46	+=== Esempio ===
48	48
49		-Ipotizziamo un [[servizio di #phones>>doc:ServiziPhones.WebHome||target="_blank"]], creato con il [[Call Designer>>doc:CallDesigner.WebHome||target="_blank"]], concepito per acquisire un codice alfanumerico immesso dall'utente del contact center. Il codice alfanumerico può essere fornito in due modi differenti:
	48	+Ipotizziamo un [[servizio di #phones>>path:../input/hashphones.servizi]], creato con il [[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]], concepito per acquisire un codice alfanumerico immesso [[dall'utente del contact center>>path:../input/hashphones.glossario#Cliente]]. Il codice alfanumerico può essere fornito in due modi differenti:
50	50
51	51	* tramite tastiera
52	52	* o in forma vocale
53	53
54		-Il servizio di #phones deve essere in grado di individuare il meccanismo appropriato di acquisizione, ossia [[toni DTMF>>doc:Glossario.WebHome||anchor="HDualToneMultipleFrequencyDetection" target="_blank"]] o [[ASR>>doc:Glossario.WebHome||anchor="HASR"]].
	53	+Il [[servizio di #phones>>path:../input/hashphones.servizi]] deve essere in grado di individuare il meccanismo appropriato di acquisizione, ossia [[toni DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]] o [[ASR>>path:../input/hashphones.glossario#_ASR-automaticspeechrecognition_]].
55	55
56		-[[image:hashphones.messenger-le-transfer-property.html_html_m36a08770.png||height="342" width="642" style="margin-bottom:20px; margin-top:20px"]]
	55	+[[image:hashphones.messenger-le-transfer-property.html_html_m36a08770.png||height="342" width="642"]]
57	57
58		-Nell'immagine precedente è raffigurato un grafo nel quale è presente una [[campagna di #phones>>doc:CampagnePhones.WebHome||target="_blank"]] contenente due blocchetti (ossia due servizi del Messenger):
	57	+Nell'immagine precedente è raffigurato un grafo nel quale è presente una [[campagna di #phones>>path:../input/hashphones.campagne]] contenente due blocchetti (ossia due [[servizi del Messenger>>path:../input/hashphones.messenger-configurator-servizi]]):
59	59
60		-* [[GetAlfaNumCode>>doc:MessengerServiziBase.VoiceRecognition.WebHome||anchor="HGetAlfaNumCode28CGetAlfaNumCode29" target="_blank"]]
61		-* [[UserSwitch>>doc:MessengerServiziBase.DiramazioneFlusso.WebHome||anchor="HUserSwitch28CUserSwitch29" target="_blank"]]
	59	+* [[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]]
	60	+* [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]
62	62
63		-Poiché si tratta di un esempio, il port "Failure" del blocchetto GetAlfaNumCode si limita ad eseguire un servizio contenuto nel blocchetto [[PlayBack>>doc:MessengerServiziBase.TrasferimentoControlloChiamata.WebHome||anchor="HPlayBack28CPlayBack29" target="_blank"]], il quale di fatto recita un messaggio ed esce.
	62	+Poiché si tratta di un esempio, il [[port "Failure">>path:#BlockConnection]] del blocchetto [[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]] si limita ad eseguire un servizio contenuto nel blocchetto [[PlayBack>>path:../input/hashphones.messenger-configurator-servizi-base#_Cplayback_]], il quale di fatto recita un messaggio ed esce.
64	64
65		-(% style="text-align:center" %)
66		-[[image:hashphones.messenger-le-transfer-property.html_html_m5eb524cc.png||height="401" width="533" style="margin:20px 0"]]
	64	+[[image:hashphones.messenger-le-transfer-property.html_html_m5eb524cc.png||height="401" width="533"]]
67	67
68		-Il blocchetto //GetAlfaNumCode //è concepito per identificare un codice fornito dall'utente del contact center. Questo codice può essere inserito attraverso la tastiera telefonica (toni DTMF) oppure l'utente del contact center può letteralmente recitarlo (ASR). A seconda del segnale individuato, il blocchetto //GetAlfaNumCode//, all'interno della transfer property di sistema// [[_ASR_Source>>||anchor="HLeTransferPropertydiSistema"]]//, registra un valore che indica appunto il tipo di riconoscimento effettuato; il valore della transfer property// _ASR_Source// potrà dunque assumere uno dei seguenti valori:
	66	+Il blocchetto [[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]] è concepito per identificare un codice fornito [[dall'utente del contact center>>path:../input/hashphones.glossario#Cliente]]. Questo codice può essere inserito attraverso la tastiera telefonica ([[toni DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]]) oppure [[l'utente del contact center>>path:../input/hashphones.glossario#Cliente]] può letteralmente recitarlo. A seconda del segnale individuato, il blocchetto [[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]], all'interno della [[transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]], registra un valore che indica appunto il tipo di riconoscimento effettuato; il valore [[della transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]] potrà dunque assumere uno dei seguenti valori:
69	69
70		-* **DTMF**: se il riconoscimento è stato effettuato tramite i toni DTMF
71		-* **ASR**: se il riconoscimento è stato effettuato tramite l'ASR.
	68	+* **DTMF**: se il riconoscimento è stato effettuato tramite i [[toni DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]];
	69	+* **ASR**: se il riconoscimento è stato effettuato tramite l'[[ASR>>path:../input/hashphones.glossario#_ASR-automaticspeechrecognition_]].
72	72
73		-In un secondo momento, la transfer property di sistema //_ASR_Source//, valorizzata dal blocchetto //GetAlfaNumCode//, viene //passata// al blocchetto successivo, che nell'esempio illustrato è appunto il blocchetto //UserSwitch//. Quest'ultimo utilizza il valore della transfer property //_ASR_Source// per selezionare il port di uscita:
	71	+In un secondo momento, la [[transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]], valorizzata dal blocchetto [[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]], viene //passata// al blocchetto successivo, che nell'esempio illustrato è appunto il blocchetto [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]. Quest'ultimo utilizza il valore della [[transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]] per selezionare il [[port>>path:#BlockConnection]] di uscita:
74	74
75		-* se //DTMF// (tono DTMF): verrà usato il port denominato **DTMF**
76		-* se //ASR// (ASR): verrà usato il port denominato **ASR**.
	73	+* se //DTMF// ([[tono DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]]): verrà usato il [[port>>path:#BlockConnection]] denominato **DTMF**
	74	+* se //ASR// ([[ASR>>path:../input/hashphones.glossario#_ASR-automaticspeechrecognition_]]): verrà usato il [[port>>path:#BlockConnection]] denominato **ASR**.
77	77
78		-Per comprendere questo comportamento è necessario aprire la finestra delle proprietà del blocchetto //UserSwitch//, come raffigurato nell'immagine seguente.
	76	+Per comprendere questo comportamento è necessario aprire la finestra delle proprietà del blocchetto [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]], come raffigurato nell'immagine seguente.
79	79
80		-Nella scheda **Tipo oggetto** impostare **Transfer Property**: questa attiva la scheda **Transfer Property** (vedere immagine seguente).
	78	+Nella scheda **Tipo oggetto** impostare **Transfer Property**: questa attiva la scheda **Transfer Property** (immagine successiva).
81	81
82		-[[image:hashphones.messenger-le-transfer-property.html_html_6f04bbf8.png||height="447" width="400" alt="" 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-top:20px; margin-bottom:20px;"]]
	80	+[[image:hashphones.messenger-le-transfer-property.html_html_6f04bbf8.png||height="511" width="400"]]
83	83
84	84	Nella sezione **Transfer Property** va inserito il nome della [[transfer property>>path:../input/hashphones.messenger-le-transfer-property]] della quale si intendono utilizzare i valori; in questo caso la [[transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]] (immagine precedente).
85	85
86		-[[image:hashphones.messenger-le-transfer-property.html_html_m1146f627.png||height="511" width="400" 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-top:20px; margin-bottom:20px;"]]
	84	+[[image:hashphones.messenger-le-transfer-property.html_html_m1146f627.png||height="511" width="400"]]
87	87
88	88	Affinché il blocchetto [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]] operi correttamente, è necessario inserire i [[port>>path:#BlockConnection]] che intendiamo usare.
89	89
90	90	Nella sezione **Associazioni** possiamo associare (appunto) il valore contenuto [[nella transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]] ad un [[port>>path:#BlockConnection]] specifico. Infatti come illustrato nell'immagine, i due valori possibili della [[transfer property>>path:../input/hashphones.messenger-le-transfer-property]], ossia //DTMF// e //ASR//, contenuti nel campo **Valore**, sono associati al [[port>>path:#BlockConnection]] indicato nel campo **Port**.
91	91
92		-[[image:hashphones.messenger-le-transfer-property.html_html_7a0e058d.png||height="511" width="400" 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-top:20px;margin-bottom:20px;"]]
	90	+[[image:hashphones.messenger-le-transfer-property.html_html_7a0e058d.png||height="511" width="400"]]
93	93
94	94	Il risultato di questa operazione è visibile nel blocchetto [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]] raffigurato nell'immagine all'inizio di questo paragrafo.
95	95
96		-== Le Transfer Property Personalizzate ==
	94	+== Le transfer property personalizzate ==
97	97
98	98	Le **transfer property personalizzate** sono delle transfer property create dall'utente; ma come le [[transfer property di sistema>>path:#tp-sistema]], possono essere usate in tutti i [[servizi del Messenger>>path:../input/hashphones.messenger-configurator-servizi]]: [[servizi base>>path:../input/hashphones.messenger-configurator-servizi#Base]] o [[servizi personalizzati>>path:../input/hashphones.messenger-configurator-servizi#Personalizzati]]. Ciò che differenzia le transfer property tra loro, è la definizione del nome. Quello delle [[transfer property di sistema>>path:#tp-sistema]] è definito dal sistema stesso, come i loro valori, mentre il nome delle transfer property personalizzate è imposto dall'utente.
99	99
100		-==== Esempio ====
	98	+=== Esempio ===
101	101
102	102	Immaginiamo un [[servizio di #phones>>path:../input/hashphones.servizi]], creato con il [[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]], concepito per leggere dei dati dalla tabella di un database e trasferirli dentro una transfer property personalizzata.
103	103
...	...	@@ -166,4 +166,4 @@
166	166	[[image:hashphones.messenger-le-transfer-property.html_html_m3a562169.png||height="447" width="350"]]
167	167
168	168
169		-
	167	+