Changes for page Transfer Property

Summary

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

Details

Page properties

Content

...	...	@@ -4,22 +4,23 @@
4	4
5	5	== Introduzione ==
6	6
7		-Le **Transfer Property** sono variabili utilizzate per trasferire dati da un [[servizio del Messenger>>path:../input/hashphones.messenger-configurator-servizi]] ad un altro. Dal punto di vista dell'utente, tuttavia le transfer property assumono la forma di coppie formate dal nome della proprietà seguito dal valore ad essa assegnato. Le transfer property possono essere utilizzate soltanto dai [[servizi del Messenger>>path:../input/hashphones.messenger-configurator-servizi]] appartenenti alla stessa [[campagna di #phones>>path:../input/hashphones.campagne]]. Esistono due tipi di transfer property:
	7	+Le **Transfer Property** sono variabili utilizzate per trasferire dati da un [[servizio del Messenger>>doc:MessengerConcetti.ServiziMessenger.WebHome||target="_blank"]] ad un altro. Dal punto di vista dell'utente, tuttavia le transfer property assumono la forma di coppie formate dal nome della proprietà seguito dal valore ad essa assegnato. Le transfer property possono essere utilizzate soltanto dai servizi del Messenger appartenenti alla stessa [[campagna di #phones>>doc:CampagnePhones.WebHome||target="_blank"]]. Esistono due tipi di transfer property:
8	8
9		-* [[transfer property di sistema>>path:#tp-sistema]]
10		-* [[transfer property personalizzate (create dall'utente)>>path:#tp-custom]]
	9	+* [[transfer property di sistema>>||anchor="Letransferpropertydisistema"]]
	10	+* [[transfer property personalizzate (create dall'utente)>>||anchor="Letransferpropertypersonalizzate"]]
	11	+
11	11
12		-== Le transfer property di sistema ==
	13	+== Le Transfer Property di Sistema ==
13	13
14		-Le transfer property di sistema vengono create dal [[Messenger>>path:../input/hashphones.messenger]] ed alcune possono ricevere soltanto dei valori specifici, ossia compresi all'interno di un arco ben definito.
	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.
15	15
16		-|**Transfer Property**|**Valore**|**Descrizione**
17		-|**~_~_CallerParty**|Numero di telefono|Contiene il numero del chiamante se disponibile dalla rete pubblica. E' il numero che #phones passa nel CallData ExternalParty.
18		-|**~_~_CalledParty**|Numero di telefono|Contiene il numero composto dal chiamante, ma è disponibile solo con schede di flusso e se la centrale lo mette a disposizione.
19		-|**~_~_CallMediaType**|1 = audio
	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
20	20	2 = @Phones
21		-5 = video|Specifica il tipo di chiamata in corso.
22		-|**~_~_RecognizeResult~_~_**|vvpMaxNonSilence = 4
	22	+5 = video|(% style="width:587px" %)Specifica il tipo di chiamata in corso.
	23	+|**~_~_RecognizeResult~_~_**|(% style="width:356px" %)vvpMaxNonSilence = 4
23	23	vvpMaxSilence = 3
24	24	vvpRunTimeError = -1
25	25	vvpStopped = 1
...	...	@@ -26,41 +26,45 @@
26	26	vvpTermDigit = 2
27	27	vvpTimeOut = 6
28	28	vvpEngineUnavailable = 18
29		-vvpNotRecognized = 19|Contiene l'esito dell'ultima operazione di riconoscimento vocale (ASR).
30		-|**_ASR_Source**|ASR o DTMF|Indica la modalità di riconoscimento: ASR o DTMF.
31		-|**~_~_CallForwardingResult~_~_**|0 se l'operazione è andata a buon fine;
32		-1 se l'operazione ha generato un errore|Esito del CallForwarding.
33		-|**~_~_CallForwardingCallGuid~_~_**|GUID|Contiene la GUID della chiamata outbound emessa a seguito della richiesta di CallForwarding.
34		-|**~_~_CallForwardingCallID~_~_**|CallID|Contiene la CallID di #phones della chiamata outbound emessa a seguito della richiesta di CallForwarding.
35		-|**~_~_CallForwardingCallResult~_~_**|Numero intero|Se la chiamata outbound fallisse, riporta la causa dell'errore ([[Codice fallimento>>path:../input/hashphones.phonebar-oggetti-interfaccia-programmazione#fallimento]]).
36		-|**~_~_CallForwardingCallProtocolSpecificCause~_~_**|Numero intero|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]]).
37		-|**~_~_CallForwardingReportingError~_~_**|0: operazione eseguita;
38		-1: operazione fallita|Il CallForwarding può salvare l'esito dentro un database; la transfer property //~_~_CallForwardingReportingError~_~_// contiene il risultato dell'operazione di salvataggio dentro il database.
39		-| | |
	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" %)(((
	34	+0: se l'operazione è andata a buon fine
	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" %)
40	40
41		-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]].
	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"]].
42	42
43		-=== Esempio ===
	47	+==== Esempio ====
44	44
45		-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:
	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:
46	46
47	47	* tramite tastiera
48	48	* o in forma vocale
49	49
50		-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_]].
	54	+Il servizio di #phones deve essere in grado di individuare il meccanismo appropriato di acquisizione, ossia [[toni DTMF>>doc:Glossario.WebHome||target="_blank"]] o [[ASR>>doc:Glossario.WebHome]].
51	51
52		-[[image:hashphones.messenger-le-transfer-property.html_html_m36a08770.png||height="342" width="642"]]
	56	+[[image:hashphones.messenger-le-transfer-property.html_html_m36a08770.png||height="342" style="margin-bottom:20px; margin-top:20px" width="642"]]
53	53
54		-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]]):
	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):
55	55
56		-* [[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]]
57		-* [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]
	60	+* [[GetAlfaNumCode>>doc:MessengerServiziBase.VoiceRecognition.WebHome||anchor="HGetAlfaNumCode28CGetAlfaNumCode29" target="_blank"]]
	61	+* [[UserSwitch>>doc:MessengerServiziBase.DiramazioneFlusso.WebHome||anchor="HUserSwitch28CUserSwitch29" target="_blank"]]
58	58
59		-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.
	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.
60	60
61		-[[image:hashphones.messenger-le-transfer-property.html_html_m5eb524cc.png||height="401" width="533"]]
	65	+(% style="text-align:center" %)
	66	+[[image:hashphones.messenger-le-transfer-property.html_html_m5eb524cc.png||height="401" style="margin:20px 0" width="533"]]
62	62
63		-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:
	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. A seconda del segnale individuato, il blocchetto GetAlfaNumCode, 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:
64	64
65	65	* **DTMF**: se il riconoscimento è stato effettuato tramite i [[toni DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]];
66	66	* **ASR**: se il riconoscimento è stato effettuato tramite l'[[ASR>>path:../input/hashphones.glossario#_ASR-automaticspeechrecognition_]].
...	...	@@ -88,11 +88,11 @@
88	88
89	89	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.
90	90
91		-== Le transfer property personalizzate ==
	96	+== Le Transfer Property Personalizzate ==
92	92
93	93	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.
94	94
95		-=== Esempio ===
	100	+==== Esempio ====
96	96
97	97	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.
98	98
...	...	@@ -161,4 +161,3 @@
161	161	[[image:hashphones.messenger-le-transfer-property.html_html_m3a562169.png||height="447" width="350"]]
162	162
163	163
164		-