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: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
	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
21	21	2 = @Phones
22		-5 = video|(% style="width:663px" %)Specifica il tipo di chiamata in corso.
23		-|**~_~_RecognizeResult~_~_**|(% style="width:280px" %)vvpMaxNonSilence = 4
	22	+5 = video|(% style="width:587px" %)Specifica il tipo di chiamata in corso.
	23	+|**~_~_RecognizeResult~_~_**|(% style="width:356px" %)vvpMaxNonSilence = 4
24	24	vvpMaxSilence = 3
25	25	vvpRunTimeError = -1
26	26	vvpStopped = 1
...	...	@@ -27,75 +27,77 @@
27	27	vvpTermDigit = 2
28	28	vvpTimeOut = 6
29	29	vvpEngineUnavailable = 18
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" %)(((
	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" %)(((
33	33	0: se l'operazione è andata a buon fine
34	34	1: se l'operazione ha generato un errore
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" %)
	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" %)
43	43
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]].
	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"]].
45	45
46		-=== Esempio ===
	47	+==== Esempio ====
47	47
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:
	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:
49	49
50	50	* tramite tastiera
51	51	* o in forma vocale
52	52
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_]].
	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"]].
54	54
55		-[[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" width="642" style="margin-bottom:20px; margin-top:20px"]]
56	56
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]]):
	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):
58	58
59		-* [[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]]
60		-* [[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"]]
61	61
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.
	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.
63	63
64		-[[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" width="533" style="margin:20px 0"]]
65	65
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:
	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:
67	67
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_]].
	70	+* **DTMF**: se il riconoscimento è stato effettuato tramite i toni DTMF
	71	+* **ASR**: se il riconoscimento è stato effettuato tramite l'ASR.
70	70
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:
	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:
72	72
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**.
	75	+* se //DTMF// (tono DTMF): verrà usato il port denominato **DTMF**
	76	+* se //ASR// (ASR): verrà usato il port denominato **ASR**.
75	75
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.
	78	+Per comprendere questo comportamento è necessario aprire la finestra delle proprietà del blocchetto //UserSwitch//, come raffigurato nell'immagine seguente.
77	77
78		-Nella scheda **Tipo oggetto** impostare **Transfer Property**: questa attiva la scheda **Transfer Property** (immagine successiva).
	80	+Nella scheda **Tipo oggetto** impostare **Transfer Property**: questa attiva la scheda **Transfer Property** (vedere immagine seguente).
79	79
80		-[[image:hashphones.messenger-le-transfer-property.html_html_6f04bbf8.png||height="511" width="400"]]
	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;"]]
81	81
82	82	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).
83	83
84		-[[image:hashphones.messenger-le-transfer-property.html_html_m1146f627.png||height="511" width="400"]]
	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;"]]
85	85
86	86	Affinché il blocchetto [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]] operi correttamente, è necessario inserire i [[port>>path:#BlockConnection]] che intendiamo usare.
87	87
88	88	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**.
89	89
90		-[[image:hashphones.messenger-le-transfer-property.html_html_7a0e058d.png||height="511" width="400"]]
	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;"]]
91	91
92	92	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.
93	93
94		-== Le transfer property personalizzate ==
	96	+== Le Transfer Property Personalizzate ==
95	95
96	96	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.
97	97
98		-=== Esempio ===
	100	+==== Esempio ====
99	99
100	100	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.
101	101
...	...	@@ -164,4 +164,4 @@
164	164	[[image:hashphones.messenger-le-transfer-property.html_html_m3a562169.png||height="447" width="350"]]
165	165
166	166
167		-
	169	+